Demand Gen Günlük Bütçe Alt Sınırı API'de Nasıl Kontrol Edilir?

Kısa yanıt

Demand Gen kampanyası oluştururken günlük bütçe isteği hata veriyorsa önce hesabın para birimindeki güncel zorunlu alt sınırı kontrol edin. Google Ads API'deki CurrencyConstant.demand_gen_info.minimum_budget_per_day_micros alanı bu sınırı sorgulamak için tanımlanmıştır. Bir para biriminden diğerine elle çevrilmiş sabit bir sayı ya da eski bir ekran görüntüsüyle karar vermeyin. Google Ads API sürüm notu alanın zorunlu günlük alt sınır için eklendiğini ve API tarafından uygulanan sınır değiştikçe değerinin güncellendiğini belirtiyor.

Alt sınır ile önerilen bütçeyi ayırın

Zorunlu alt sınır, API'nin kampanya bütçesini kabul etmesi için teknik koşuldur. Pazarlama hedefi için seçilecek bütçe ise dönüşüm değeri, hedef kitle, yaratıcı kapasite ve işletmenin harcama sınırıyla değerlendirilir. Teknik olarak kabul edilen en düşük rakamın yeterli performans sağlayacağını varsaymayın. Tersine, önerilen bir harcama düzeyini API'nin zorunlu eşiği gibi sunmayın. Önce reddedilen isteğin hangi doğrulama aşamasında kaldığını görün; ardından ticari bütçe kararını ayrı masaya yatırın.

Bu rehber kampanya oluşturma veya güncelleme sırasındaki alt sınır hatasına odaklanır. Farklı Google Ads kanalları arasında kaynak dağıtımı için kanal önceliğiyle bütçe yönetimi yazısı ayrı bir karar çerçevesi sunar. Demand Gen'e geçişin kampanya tasarımı tarafı için de Display'den Demand Gen'e geçiş rehberini inceleyebilirsiniz.

Para birimi kaynağını doğrulayın

İlk adım, kampanya hesabının para birimini doğrulamaktır. Bütçe tutarı ile sorguladığınız CurrencyConstant.code aynı para birimini temsil etmelidir. Yönetici hesabının para birimiyle müşteri hesabını karıştırmak yanlış eşik karşılaştırmasına neden olabilir. Ardından kullanılan Google Ads API sürümünde alanın mevcut olup olmadığını test sorgusuyla görün. Google'ın Demand Gen kampanya oluşturma rehberi bu alan için sorgu örneği veriyor. Belgelerde alanın hangi sürümden itibaren sorgulanabildiği konusunda farklı ifadeler bulunduğundan, kurulu istemci sürümünüzde gerçek sorguyla doğrulayın.

Değer mikro birimde döndüğü için uygulama içindeki karşılaştırma birimini açıkça tanımlayın. Kullanıcı arayüzündeki para tutarı ile API'nin mikro tutarını doğrudan karşılaştırmak hatalı sonuç üretir. Tutarı dönüştüren katmanı tek yerde tutun, dönüşüm için otomatik test yazın ve hata kaydına hassas hesap bilgisi eklemeyin. Para birimi kodunu, uygulanan alan değerini ve gönderilen bütçenin normalize edilmiş tutarını anonim teknik kayıt olarak tutmak teşhis için yeterli olabilir.

Kampanya oluşturma sırası

Önce ilgili müşteri hesabı ve para birimini seçin. Sonra o para birimi için alt sınır alanını sorgulayın. Günlük bütçeyi bu değerin altında göndermeye çalışıyorsanız kullanıcıya kampanya oluşturma isteğinden önce açık bir doğrulama mesajı gösterin. Bütçe uygun görünüyorsa kampanya bütçesi ve kampanya kurulumunu gönderin; yine de API yanıtını kesin kaynak kabul edin. Sunucu tarafındaki kural değişmiş, yerel önbelleğiniz eskimiş veya para birimi yanlış eşleşmiş olabilir.

Uygulama bu değeri önbelleğe alıyorsa süresini ve yenileme kuralını belirleyin. Sürüm notu alan değerinin uygulanan alt sınırla birlikte güncellenebileceğini ifade ediyor. Bu nedenle uzun ömürlü sabit tutar, doğrulama mantığı için kırılgan bir temeldir. API yanıtı bütçeyi reddederse aynı isteği körlemesine tekrar göndermek yerine hatayı okuyun, güncel alanı yeniden sorgulayın ve kullanıcıya yeni tutarı onaylatın. Otomatik artırma, kullanıcı tarafından belirlenmiş harcama sınırını aşmamalıdır.

Hata senaryoları ve riskler

Alan sorgusu boş veya erişilemez gelirse uygulamanın varsayılan bir tutarı “güncel zorunlu sınır” diye göstermemesi gerekir. Kullanılan API sürümü, yetki, müşteri hesabı ve para birimi sorgusunu kontrol edin. Bütçe reddi başka bir kampanya kuralından kaynaklanıyorsa bu yazının çözümü uygulanmayabilir; hata türünü ayırın. Teknik alt sınır değişikliğinin reklam sonuçlarını artıracağına dair bir çıkarım yapmayın. Bu kontrol yalnızca kampanya kurulumunun geçerli bir bütçe isteğiyle ilerlemesini sağlar.

Birden çok hesap için aynı sayı kullanmak ayrı bir risktir. Her hesabın para birimini ve kampanya türünü doğrulayan test vakaları oluşturun. Hata mesajında genel “bütçe geçersiz” yerine hangi hesabın para biriminde hangi koşulun sağlanmadığını, gereksiz hesap verisi açmadan anlatın. Kullanıcı bütçeyi değiştirmeye karar vermezse kampanyayı taslakta bırakmak veya işlem akışını durdurmak daha anlaşılır bir davranıştır.

Kabul testi ve hizmet yolu

Kabul testinde sınırın altında, eşit ve üstünde bütçe örneklerini deneyin; gerçek API yanıtını, arayüz açıklamasını ve kullanıcının onay verdiği tutarı karşılaştırın. Mevcut sürümde sorgunun çalıştığını ve hata durumunda yeni alan değerinin okunabildiğini kaydedin. Dağıtımdan önce güncel API belgelerini yeniden açın; sınırın kalıcı olduğunu varsaymayın.

Webinle Google ve Meta reklam optimizasyonu hizmeti üzerinden kampanya kurulum akışınızın teknik doğrulaması ve bütçe karar süreci için görüşme isteyebilirsiniz. Hesap para birimi, kampanya türü, kullanılan API sürümü ve anonimleştirilmiş hata yanıtı kapsamı netleştirir. Teknik eşiği karşılamak ile iş hedeflerine uygun harcama seçmek, aynı görüşmede fakat ayrı kararlar olarak değerlendirilmelidir.

Ekipler arası karar akışı

Reklam yöneticisi hedef ve harcama üst sınırını belirler; geliştirme ekibi teknik alt sınırı sorgular ve isteği doğru birimde gönderir. İki tutar çakışıyorsa sistemi otomatik olarak daha yüksek bütçeyle başlatmayın. Önce bütçenin değişmesi mi, kampanya türünün gözden geçirilmesi mi, yoksa planın ertelenmesi mi gerektiğine karar verin. Karar, hesabın sahibine anlaşılır bir tutarla gösterilmelidir; API'den dönen mikro birim yalnızca teknik kayıt için anlamlıdır.

Bir entegrasyon birden fazla kampanya oluşturuyorsa her kampanya ve para birimi için aynı doğrulama mantığının uygulandığını test edin. Toplu işlemde tek kampanya reddedildiğinde diğerlerinin durumunu doğru raporlayın; bütün grubun başarısız olduğunu ya da hepsinin açıldığını varsaymayın. Kısmi başarı durumunda yeniden deneme, var olan kampanyayı iki kez oluşturmayacak biçimde tasarlanmalıdır. Test ortamında anonim hesap kimliği kullanarak istek ve yanıt eşleştirmesini tutmak, teknik teşhisi kolaylaştırır.

Son olarak, alt sınırın sağlanması kampanyanın yayın onayı, gösterim veya dönüşüm alacağı anlamına gelmez. Yaratıcılar, hedefleme ve hesap ayarları kendi ayrı kabul adımlarını gerektirir. Bu nedenle raporda “bütçe doğrulaması geçti” ifadesini kampanya sonucundan ayrı tutun ve sonuç değerlendirmesini eşit uzunlukta dönemlerde gerçek dönüşüm ölçümüyle yapın.