Gruppenfilter in Batchjobs auflisten

Wenn Sie mit Filtern für Listengruppen im Kontext von AdGroupCriterion.listing_group oder AssetGroupListingGroupFilter arbeiten, beachten Sie die folgenden Hinweise beim Entwerfen Ihrer Integration.

Batchaufteilung

Wichtiger Hinweis :Wir empfehlen, AssetGroupListingGroupFilterOperation-Vorgänge, die auf dasselbe AssetGroup ausgerichtet sind, und AdGroupCriterionOperation-Vorgänge mit einem listing_group, das auf dasselbe AdGroup ausgerichtet ist, nacheinander einem Batchjob hinzuzufügen, damit die Gruppe von Vorgängen beim Aufteilen des Batches atomar behandelt wird.

Wenn ein Batch-Job Vorgänge mit Anzeigengruppenkriterien oder Filtern für die Listengruppe von Asset-Gruppen enthält, werden die Vorgänge im Batch-Job beim Empfang durch den Google Ads API-Server in mehrere Unter-Batches aufgeteilt. Im Gegensatz zu Standardvorgängen in einem Batchjob wird jeder Unterbatch, der Filtervorgänge für die Eintragsgruppe enthält, als atomar behandelt.

Die Art und Weise, wie Batch-Jobs mit Filtern für die Einträgegruppe in Sub-Batches aufgeteilt werden, hängt von den folgenden Faktoren ab:

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

So werden Vorgänge gruppiert:

• Alle aufeinanderfolgenden AssetGroupListingGroupFilterOperation-Vorgänge, die auf dasselbe AssetGroup ausgerichtet sind, werden in einem atomaren Sub-Batch gruppiert (kein teilweises Fehlerverhalten).
• Alle aufeinanderfolgenden AdGroupCriterionOperation-Vorgänge, die ein listing_group für dasselbe AdGroup enthalten, werden in einem atomaren Sub-Batch gruppiert (kein Verhalten bei Teilausfall).
• Alle anderen aufeinanderfolgenden Vorgänge werden in nicht atomaren Sub-Batches zusammengefasst (Verhalten bei Teilausfall).

Schlüsselbegriff: Aufeinanderfolgend bezieht sich auf die Reihenfolge der Vorgänge im Batchjob.

Das folgende Diagramm veranschaulicht dieses Konzept. Jedes der grauen Kästchen steht für einen Batch-Job, der über die Google Ads API eingereicht wurde. In den grauen Feldern sind die einzelnen Vorgänge farblich nach den Unterbatches gruppiert, die vom Google Ads API-Server erstellt werden. Die Reihenfolge der Vorgänge in den einzelnen grauen Kästen entspricht der Reihenfolge, in der die Vorgänge dem Batchjob hinzugefügt worden wären.

Beschränkungen

Wenn Sie im Zusammenhang mit Batch-Jobs mit Filtern für Listengruppen arbeiten, gelten die folgenden Einschränkungen:

• Ein einzelner Batch mit AssetGroupListingGroupFilterOperation-Vorgängen, der ein listing_group enthält und auf dasselbe AdGroup ausgerichtet ist, darf nicht länger als 20.000 Vorgänge sein. Es wird jedoch empfohlen, 10.000 Vorgänge nicht zu überschreiten.
• Ein einzelner Batch mit 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 Batch-Job fehl.

Fehlerbehebung

Filtervorgänge für Listengruppen in einem Batchjob werden als eine Transaktion verarbeitet. Das kann dazu führen, dass viele Vorgänge aufgrund einer kleinen Anzahl fehlerhafter Vorgänge fehlschlagen. Außerdem kann die Ursache der Fehler aufgrund der Art und Weise, wie BatchJob-Vorgänge verarbeitet werden, an einem Index vor oder nach den Downstream-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 weist in der Regel darauf hin, 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 Statusmeldungen in BatchJobResult – vor und nach dem Index der Ad group is invalid-Fehlermeldung – nach zusätzlichen Fehlerinformationen zu durchsuchen.