Gruppenfilter in Batchjobs auflisten

Wenn Sie mit Eintragsgruppenfiltern im Kontext von AdGroupCriterion.listing_group oder an AssetGroupListingGroupFilter, arbeiten, sollten Sie bei der Entwicklung Ihrer Integration Folgendes berücksichtigen.

Batchaufteilung

AssetGroupListingGroupFilterOperationAssetGroupAdGroupCriterionOperationlisting_groupAdGroup

Wenn ein Batchjob Vorgänge mit Anzeigengruppenkriterien oder Filtern für Asset-Eintragsgruppen enthält, werden die Vorgänge im Batchjob in mehrere Sub-Batches aufgeteilt, wenn sie vom Google Ads API-Server empfangen werden. Im Gegensatz zu Standardvorgängen in einem Batchjob wird jeder Sub-Batch mit Vorgängen für Eintragsgruppenfilter atomar behandelt.

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

1. Typ des Eintragsgruppenfilters
2. Die AdGroupCriterion oder AssetGroup, auf die der Eintragsgruppenfilter ausgerichtet ist
3. Reihenfolge von Vorgängen

Beachten Sie, wie Vorgänge gruppiert werden:

• Alle aufeinanderfolgenden AssetGroupListingGroupFilterOperation Vorgänge, die auf dieselbe AssetGroup ausgerichtet sind, werden in einem atomaren Sub-Batch gruppiert (kein Verhalten bei teilweisem Fehler).
• Alle aufeinanderfolgenden AdGroupCriterionOperation Vorgänge, die eine listing_groupenthalten, die auf dieselbe AdGroupausgerichtet ist, werden in einem atomaren Sub-Batch gruppiert (kein Verhalten bei teilweisem Fehler).
• Alle anderen aufeinanderfolgenden Vorgänge werden in nicht atomaren Sub-Batches gruppiert (Verhalten bei teilweisem Fehler).

Das folgende Diagramm veranschaulicht dieses Konzept. Jedes der grauen Felder stellt einen Batchjob dar, der über die Google Ads API eingereicht wurde. In den grauen Feldern sind die einzelnen Vorgänge nach Farbe gruppiert, um die Sub-Batches darzustellen, die der Google Ads API-Server erstellt. Die Reihenfolge der Vorgänge in den einzelnen grauen Feldern entspricht der Reihenfolge, in der die Vorgänge dem Batchjob hinzugefügt wurden.

Beschränkungen

Bei der Arbeit mit Eintragsgruppenfiltern im Kontext von Batchjobs gelten die folgenden Beschränkungen:

• Ein einzelner Batch von AdGroupCriterionOperation -Vorgängen, der eine listing_group enthält und auf dieselbe AdGroup ausgerichtet ist, darf nicht mehr als 20.000 Vorgänge umfassen. Wir empfehlen jedoch, 10.000 Vorgänge nicht zu überschreiten.
• Ein einzelner Batch von AssetGroupListingGroupFilterOperation Vorgängen , die auf dasselbe AssetGroup ausgerichtet sind, darf nicht mehr als 10.000 Vorgänge umfassen.
• Wenn eine dieser Bedingungen nicht erfüllt ist, schlägt der gesamte Batchjob fehl.

Fehlerbehebung

Vorgänge für Eintragsgruppenfilter in einem Batchjob werden als eine Transaktion verarbeitet. Dies kann dazu führen, dass viele Vorgänge aufgrund einer kleinen Anzahl fehlerhafter Vorgänge fehlschlagen. Aufgrund der Art und Weise, wie BatchJob-Vorgänge verarbeitet werden, kann die Ursache der Fehler an einem Index vor oder nach den nachgelagerten Fehlern auftreten.

Wenn Sie beispielsweise eine Antwort von ListBatchJobResults verarbeiten, stellen Sie möglicherweise fest, dass mehrere Vorgänge mit der Statusmeldung Ad group is invalid due to the listing groups it contains fehlgeschlagen sind. Diese Meldung bedeutet in der Regel, dass der Vorgang an diesem Index aufgrund eines fehlgeschlagenen Vorgangs an einem anderen Index abgebrochen wurde. Um die Ursache des Problems zu ermitteln, empfehlen wir, alle Status meldungen in BatchJobResult zu durchlaufen – vor und nach dem Index der Ad group is invalid Fehlermeldung – und nach zusätzlichen Fehlerinformationen zu suchen.