Änderungen zur Unterstützung der EU-Verordnung zu politischer Werbung in der Google Ads API und in Google Ads-Scripts

Donnerstag, 7. August 2025

Was ändert sich?

Wie bereits im vergangenen Jahr angekündigt, wird Google keine politische Werbung mehr in der Europäischen Union ausliefern. Grund dafür ist eine neue Verordnung, die im Oktober 2025 in Kraft tritt. Am 3. September 2025 werden für die Google Ads API und Google Ads-Scripts Maßnahmen im Zusammenhang mit dieser Änderung eingeführt. Wenn Sie eines dieser Produkte zum Erstellen oder Verwalten von Kampagnen verwenden, müssen Sie Ihre Anwendung möglicherweise vor dem 3. September 2025 aktualisieren, um diese Maßnahmen zu berücksichtigen.

API-Unterstützung für die Selbstdeklaration von politischer Werbung in der EU

In der Google Ads API und in Google Ads-Scripts wird jetzt die Selbsterklärung unterstützt, ob eine Kampagne politische Werbung in der EU enthält. Hier erfahren Sie, wie politische Werbung in der EU definiert wird. Die Versionen 19.2, 20.1 und 21 der API enthalten ein neues Feld namens contains_eu_political_advertising im Objekt Campaign.. Die möglichen Werte und ihre Bedeutung sind in der folgenden Tabelle aufgeführt.

Wert Bedeutung
CONTAINS_EU_POLITICAL_ADVERTISING Die Kampagne enthält politische Werbung in der EU.
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING Die Kampagne enthält keine politische Werbung in der EU.
UNSPECIFIED Für die Kampagne fehlt eine Selbsterklärung zu politischer Werbung in der EU.

Sie können den Status der Selbstdeklaration einer Kampagne in der Google Ads API abrufen, indem Sie die folgende Abfrage mit der Methode Search oder SearchStream des GoogleAdsService ausführen. Verwenden Sie für Google Ads-Scripts die Methode AdsApp.search oder AdsApp.report. 

select campaign.id, campaign.contains_eu_political_advertising from campaign

Wenn Sie die Google Ads API-Clientbibliotheken verwenden, müssen Sie möglicherweise die neueste Bibliotheksversion herunterladen, um diese Funktion in den Versionen 19 und 20 der API zu verwenden.

Änderungen bei der API-Validierung und -Erzwingung

Ab dem 3. September 2025 werden in der Google Ads API und in Google Ads-Scripts die folgenden Prüfungen in den Versionen 19 und 20 der API erzwungen.

  • Bei allen neuen Kampagnen, die über die Google Ads API oder Google Ads-Scripts erstellt werden, sollte das Feld contains_eu_political_advertising festgelegt werden. Wenn dieses Feld nicht festgelegt ist, schlägt der API-Aufruf zum Erstellen einer neuen Kampagne mit CampaignService.MutateCampaigns mit dem Fehler FieldError.REQUIRED fehl. In Google Ads-Scripts werden diese Prüfungen beim Erstellen von Kampagnen mit den Methoden AdsApp.mutate oder AdsApp.mutateAll durchgeführt.
  • Für alle bestehenden Kampagnen muss das Feld contains_eu_political_advertising festgelegt werden, bevor versucht wird, das Targeting für proximity, location, oder location_group auf Kampagnen- oder Anzeigengruppenebene zu ändern. Der API-Aufruf zum Erstellen oder Aktualisieren dieser Kampagnenkriterien mit der Methode CampaignCriterionService.MutateCampaignCriteria für bestehende Kampagnen schlägt mit dem Fehler CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION fehl, wenn die Selbstdeklaration für die Kampagne noch nicht abgeschlossen ist. Der API-Aufruf zum Erstellen oder Aktualisieren dieser Anzeigengruppenkriterien mit AdGroupCriterionService.MutateAdGroupCriteria schlägt ebenfalls fehl, wenn die Selbsterklärung für die Kampagne nicht abgeschlossen wurde. Google Ads-Scripts erzwingen diese Prüfungen, wenn versucht wird, das Targeting mit den Methoden AdsApp.mutate, AdsApp.mutateAll, AdsApp.Campaign.addProximity und AdsApp.Campaign.addLocation zu ändern.
  • Diese Maßnahmen gelten auch für andere Mechanismen, mit denen Sie Kampagnen erstellen können, z. B. für das Ausführen von Batch-Jobs und die Verwendung der Methode GoogleAdsService.Mutate zum Erstellen und Aktualisieren von Entitäten.
  • Wenn Sie versuchen, einen neuen Test mit der Methode ExperimentService.ScheduleExperiment zu planen, wird der Fehler ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION ausgegeben, wenn die contains_eu_political_advertising declaration in den Testentwurfskampagnen fehlt.
  • Wenn Sie die Bulk-Upload-Funktion in Google Ads-Scripts verwenden, finden Sie in der Produktdokumentation weitere Informationen zu den Änderungen an der Tabellenvorlage, die im Rahmen dieser Änderung erforderlich sind.

Diese Prüfungen werden bereits in Version 21 der Google Ads API erzwungen.

Wie wirkt sich das auf die Auslieferung meiner Kampagne aus?

In Kampagnen, für die politische Werbung in der EU deklariert wurde, indem contains_eu_political_advertising auf true festgelegt wurde, werden ab dem 22. September 2025. keine Anzeigen mehr in der EU ausgeliefert. Weitere Informationen finden Sie in der Hilfe.

Bestehende Kampagnen ohne Erklärung sind vorerst nicht betroffen. Wir empfehlen, die bestehenden Kampagnen in Ihren Konten so schnell wie möglich mit einer entsprechenden Erklärung zu aktualisieren. Sie können Kampagnen ohne Erklärung mit der folgenden GAQL-Abfrage abrufen. Verwenden Sie dazu entweder die Methode Search oder SearchStream des GoogleAdsService. 

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'
    )

Was muss ich tun?

Wenn Sie in Ihrer Anwendung die Google Ads API oder Google Ads-Scripts zum Erstellen oder Verwalten von Kampagnen verwenden, müssen Sie sie vor dem 3. September 2025 aktualisieren, damit diese Maßnahmen berücksichtigt werden.

Wo erhalte ich Hilfe?

Wenn Sie weitere Fragen zu dieser Änderung haben, wenden Sie sich bitte an den Google Ads API-Support oder den Google Ads-Scripts-Support.

Porträt des Autors – , Google Ads API-Team

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