Gruppenfilter in Batchjobs auflisten

Wenn Sie Filter für Eintragsgruppen im Zusammenhang mit einem AdGroupCriterion.listing_group oder einem AssetGroupListingGroupFilter verwenden, müssen Sie beim Entwerfen der Integration einige Aspekte beachten.

Batch-Aufteilung

Wichtiger Hinweis: Wir empfehlen, AssetGroupListingGroupFilterOperation-Vorgänge, die auf denselben AssetGroup ausgerichtet sind, und AdGroupCriterionOperation-Vorgänge mit einem listing_group-Objekt, das auf dasselbe AdGroup ausgerichtet ist, nacheinander zu einem Batchjob hinzuzufügen, damit diese Gruppe von Vorgängen während der Batchaufteilung atomar behandelt wird.

Falls es Vorgänge in einem Batch-Auftrag gibt, die Anzeigengruppenkriterien oder Filter für Asset-Gruppenlisten enthalten, werden die Vorgänge im Batch-Auftrag beim Empfang vom Google Ads API-Server in mehrere Unter-Batches aufgeteilt. Im Gegensatz zu Standardvorgängen in einem Batchjob wird jeder Teil-Batch, der Filtervorgänge für das Auflisten von Gruppen enthält, atomar behandelt.

Die Art und Weise, wie Batchjobs mit Listenfiltern in Teil-Batches aufgeteilt werden, hängt von den folgenden Faktoren ab:

1. Typ des Eintragsgruppenfilters
2. Die AdGroupCriterion oder AssetGroup, auf die der Filter für Eintragsgruppen ausgerichtet ist
3. Reihenfolge von Vorgängen

Beachten Sie die folgenden Punkte zur Gruppierung von Vorgängen:

• Alle aufeinanderfolgenden AssetGroupListingGroupFilterOperation-Vorgänge, die auf dasselbe AssetGroup-Ziel ausgerichtet sind, werden in einem atomaren Teil-Batch zusammengefasst (kein Verhalten zu partiellem Fehler).
• Alle aufeinanderfolgenden AdGroupCriterionOperation-Vorgänge, die eine listing_group enthalten, die auf denselben AdGroup ausgerichtet ist, werden in einem atomaren Teil-Batch zusammengefasst (kein Verhalten zu partiellen Fehlern).
• Alle anderen aufeinanderfolgenden Vorgänge werden in nicht atomaren Teil-Batches zusammengefasst (partielles Fehlerverhalten).

Wichtiger Begriff: Fortlaufend bezieht sich auf die Reihenfolge der Vorgänge im Batchjob.

Das folgende Diagramm veranschaulicht dieses Konzept. Jedes der grauen Felder stellt einen Batch-Auftrag dar, der über die Google Ads API gesendet wurde. Innerhalb der grauen Felder werden die einzelnen Vorgänge nach Farben gruppiert, um die vom Google Ads API-Server erstellten Teil-Batches darzustellen. Die Reihenfolge der Vorgänge in den grauen Feldern entspricht der Reihenfolge, in der die Vorgänge dem Batch-Auftrag hinzugefügt worden wären.

Beschränkungen

Bei der Arbeit mit Listenfiltern im Kontext von Batchjobs gelten die folgenden Einschränkungen:

• Ein einzelner Batch von AssetGroupListingGroupFilterOperation-Vorgängen mit einer listing_group und demselben Ziel (AdGroup) darf 20.000 Vorgänge nicht überschreiten. Es wird jedoch empfohlen, 10.000 Vorgänge nicht zu überschreiten.
• Ein einzelner Batch von AssetGroupListingGroupFilterOperation-Vorgängen, die auf dieselbe AssetGroup ausgerichtet sind, darf 10.000 Vorgänge nicht überschreiten.
• Wenn Sie eine dieser Bedingungen verletzen, schlägt der gesamte Batchjob fehl.