Google Ads API ve Google Ads komut dosyalarında Avrupa Birliği Siyasi Reklamlar Tüzüğü'nün desteklenmesiyle ilgili değişiklikler

7 Ağustos 2025, Perşembe

Neler değişecek?

Ekim 2025'te yeni bir tüzük yürürlüğe giriyor. Geçen yıl duyurulduğu üzere Google, bu tüzük yürürlüğe girmeden önce Avrupa Birliği'nde siyasi reklam yayınlamayı durduracak. Google Ads API ve Google Ads komut dosyaları, 3 Eylül 2025'te bu değişiklikle ilgili yaptırımları uygulamaya başlayacak. Kampanya oluşturmak veya yönetmek için bu ürünlerden birini kullanıyorsanız 3 Eylül 2025'ten önce bu yaptırımları işlemek için uygulamanızı güncellemeniz gerekebilir.

AB siyasi reklamlarının kişisel beyanı için API desteği

Google Ads API ve Google Ads komut dosyaları, bir kampanyanın AB siyasi reklamları içerip içermediğine dair öz beyan için destek ekledi. AB siyasi reklamlarının nasıl tanımlandığını buradan öğrenebilirsiniz. API'nin v19.2, v20.1 ve v21 sürümleri, Campaign nesnesinde contains_eu_political_advertising adlı yeni bir alan içerir. Olası değerler ve anlamları aşağıdaki tabloda gösterilmiştir.

Değer	Anlamı
CONTAINS_EU_POLITICAL_ADVERTISING	Kampanyada AB siyasi reklamları var.
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING	Kampanyada AB siyasi reklamları yok.
UNSPECIFIED	Kampanyada AB siyasi reklamlarıyla ilgili öz beyan eksik.

GoogleAdsService'nin Search veya SearchStream yöntemlerini kullanarak aşağıdaki sorguyu çalıştırıp Google Ads API'de bir kampanyanın kişisel beyan durumunu alabilirsiniz. Google Ads komut dosyaları için AdsApp.search veya AdsApp.report yöntemlerini kullanın.

select campaign.id, campaign.contains_eu_political_advertising from campaign

Google Ads API istemci kitaplıklarını kullanıyorsanız bu işlevi API'nin 19 ve 20 sürümlerinde kullanmak için en son kitaplık sürümünü indirmeniz gerekebilir.

API doğrulama ve yaptırım değişiklikleri

3 Eylül 2025'te Google Ads API ve Google Ads komut dosyaları, API'nin v19 ve v20 sürümlerinde aşağıdaki kontrolleri zorunlu kılmaya başlayacak.

• Google Ads API veya Google Ads komut dosyaları aracılığıyla oluşturulan tüm yeni kampanyalarda contains_eu_political_advertising alanı ayarlanmalıdır. Bu alan ayarlanmazsa CampaignService.MutateCampaigns kullanarak yeni bir kampanya oluşturmaya yönelik API çağrısı FieldError.REQUIRED hatasıyla başarısız olur. Google Ads komut dosyaları, AdsApp.mutate veya AdsApp.mutateAll yöntemlerini kullanarak kampanya oluştururken bu kontrolleri uygular.
• Mevcut tüm kampanyalar, kampanya veya reklam grubu düzeyinde proximity, location, ya da location_group hedeflemeyi değiştirmeye çalışmadan önce contains_eu_political_advertising alanını ayarlamalıdır. Kampanya, öz beyanı tamamlamadıysa mevcut kampanyalar için CampaignCriterionService.MutateCampaignCriteria yöntemini kullanarak bu kampanya ölçütlerini oluşturmaya veya güncellemeye yönelik API çağrısı CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION hatasıyla başarısız olur. Kampanya, öz beyanı tamamlamadıysa AdGroupCriterionService.MutateAdGroupCriteria kullanarak bu reklam grubu ölçütlerini oluşturmak veya güncellemek için yapılan API çağrısı da benzer şekilde başarısız olur. Google Ads komut dosyaları, AdsApp.mutate, AdsApp.mutateAll, AdsApp.Campaign.addProximity ve AdsApp.Campaign.addLocation yöntemlerini kullanarak hedeflemeyi değiştirmeye çalışırken bu kontrolleri zorunlu kılar.
• Bu yaptırımlar, kampanya oluşturmak için kullanabileceğiniz diğer mekanizmalar (ör. toplu işleri çalıştırma ve öğe oluşturup güncellemek için GoogleAdsService.Mutate yöntemini kullanma) için de geçerlidir.
• Deneme taslak kampanyalarında contains_eu_political_advertising declaration eksikse ExperimentService.ScheduleExperiment yöntemini kullanarak yeni bir deneme planlamaya çalışmak ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION hatasına neden olur.
• Google Ads komut dosyalarında toplu yükleme özelliğini kullanıyorsanız bu değişiklik kapsamında gereken e-tablo şablonu değişiklikleri hakkında daha fazla bilgi edinmek için ürün belgelerine bakın.

Bu kontroller, Google Ads API'nin v21 sürümünde zaten uygulanmaktadır.

Bu durum, kampanyamın yayınlanmasını nasıl etkileyecek?

contains_eu_political_advertising değerini true olarak ayarlayarak AB siyasi reklamları beyan eden tüm kampanyalar, 22 Eylül 2025.'te AB'de reklam yayınlamayı durduracak. Daha fazla bilgi için Yardım Merkezimizi ziyaret edin.

Beyanı olmayan mevcut kampanyalar şimdilik bu durumdan etkilenmeyecek. Hesaplarınızdaki mevcut kampanyaları en kısa sürede uygun bir beyanla güncellemenizi öneririz. GoogleAdsService'nin Search veya SearchStream yöntemlerini kullanarak aşağıdaki GAQL sorgusuyla beyan içermeyen kampanyaları alabilirsiniz.

select campaign.id, campaign.contains_eu_political_advertising
  from
    campaign
  where
    campaign.contains_eu_political_advertising NOT IN
    (
       'CONTAINS_EU_POLITICAL_ADVERTISING',
       'DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING'
    )

Ne yapmam gerekiyor?

Uygulamanız kampanya oluşturmak veya yönetmek için Google Ads API ya da Google Ads komut dosyalarını kullanıyorsa uygulamanızı 3 Eylül 2025'ten önce bu yaptırımları uygulayacak şekilde güncellediğinizden emin olun.

Nasıl yardım alabilirim?

Bu değişiklikle ilgili daha fazla sorunuz varsa Google Ads API destek veya Google Ads komut dosyaları destek kanalları ile iletişime geçebilirsiniz.

 - Anash P. Oommen, Google Ads API Ekibi

Etiketler: campaign, google-ads-api, google-ads-scripts