Gruppenfilter in Batchjobs auflisten

Wenn Sie Gruppenfilter auflisten, die im Kontext eines AdGroupCriterion.listing_group- oder AssetGroupListingGroupFilter-Elements verwendet werden, sollten Sie beim Entwerfen der Integration einige Aspekte berücksichtigen.

Batch-Aufteilung

Wichtiger Hinweis: Wir empfehlen, AssetGroupListingGroupFilterOperation-Vorgänge, die auf dieselben AssetGroup ausgerichtet sind, und AdGroupCriterionOperation-Vorgänge, die einen listing_group enthalten, der auf dasselbe AdGroup abzielt, nacheinander hinzuzufügen, damit die Vorgänge während der Batchaufteilung atomar behandelt werden.

Wenn in einem Batch-Auftrag Vorgänge mit Anzeigengruppenkriterien oder Gruppenfilter für Asset-Gruppen enthalten sind, 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 Unter-Batch, der Gruppenfiltervorgänge enthält, atomar behandelt.

Die Art und Weise, wie Batchjobs, die Listengruppenfilter enthalten, in Unter-Batches aufgeteilt werden, wird durch die folgenden Faktoren bestimmt:

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

Beachten Sie die folgenden Punkte in Bezug auf die Gruppierung von Vorgängen:

• Alle aufeinanderfolgenden AssetGroupListingGroupFilterOperation-Vorgänge, die auf dasselbe AssetGroup-Element ausgerichtet sind, werden in einem atomaren Unter-Batch zusammengefasst (kein teilweises Fehlerverhalten).
• Alle aufeinanderfolgenden AdGroupCriterionOperation-Vorgänge, die eine listing_group enthalten, die auf dasselbe AdGroup ausgerichtet ist, werden in einem atomaren Sub-Batch zusammengefasst (kein teilweises Fehlerverhalten).
• Alle anderen aufeinanderfolgenden Vorgänge werden in nicht atomaren Unterbatches zusammengefasst (Teilfehlerverhalten).

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

Das folgende Diagramm veranschaulicht dieses Konzept. Jedes der grauen Felder steht für einen Batch-Auftrag, der über die Google Ads API gesendet wurde. In den grauen Feldern sind die einzelnen Vorgänge nach Farbe gruppiert, um die vom Google Ads API-Server erstellten Unter-Batches darzustellen. Die Reihenfolge der Vorgänge in den grauen Feldern entspricht der Reihenfolge, in der die Vorgänge zum Batchjob hinzugefügt worden wären.

Beschränkungen

Wenn Sie im Kontext von Batchjobs mit dem Auflisten von Gruppenfiltern arbeiten, gelten die folgenden Einschränkungen:

• Ein einzelner Batch von AssetGroupListingGroupFilterOperation-Vorgängen, der eine listing_group enthält und auf dieselbe AdGroup abzielt, darf 20.000 Vorgänge nicht überschreiten. Wir empfehlen jedoch, nicht mehr als 10.000 Vorgänge auszuführen.
• Ein Batch von AssetGroupListingGroupFilterOperation-Vorgängen, die auf dieselbe AssetGroup ausgerichtet sind, darf 10.000 Vorgänge nicht überschreiten.
• Ein Verstoß gegen eine dieser Bedingungen führt dazu, dass der gesamte Batchjob fehlschlägt.