Elenco dei filtri dei gruppi nei job batch

Quando utilizzi i filtri dei gruppi di schede nel contesto di una AdGroupCriterion.listing_group o di un AssetGroupListingGroupFilter, devi prendere in considerazione alcune considerazioni quando progetti la tua integrazione.

Suddivisione in batch

Punto chiave: consigliamo di aggiungere a un job batch consecutivamente le operazioni AssetGroupListingGroupFilterOperation che hanno come target le stesse operazioni AssetGroup e AdGroupCriterionOperation contenenti un listing_group che ha come target lo stesso AdGroup, in modo che l'insieme di operazioni venga trattato a livello atomico durante la suddivisione del batch.

Se in un job batch sono presenti operazioni che contengono criteri del gruppo di annunci o filtri dei gruppi di asset del gruppo di asset, le operazioni nel job batch vengono suddivise in più sottobatch quando vengono ricevute dal server API Google Ads. Tieni presente che, a differenza delle operazioni standard in un job batch, ogni sottobatch contenente le operazioni di filtro del gruppo di schede viene trattato a livello atomico.

Il modo in cui i job batch contenenti i filtri dei gruppi di schede vengono suddivisi in sottobatch è determinato dai seguenti fattori:

1. Tipo di filtro del gruppo di schede
2. AdGroupCriterion o AssetGroup scelti come target dal filtro del gruppo di schede
3. Ordine delle operazioni

Tieni presente i seguenti punti su come vengono raggruppate le operazioni:

• Tutte le operazioni AssetGroupListingGroupFilterOperation consecutive che hanno come target la stessa AssetGroup sono raggruppate in un sub-batch atomico (nessun comportamento di errore parziale).
• Tutte le operazioni AdGroupCriterionOperation consecutive che contengono un elemento listing_group che ha come target lo stesso AdGroup vengono raggruppate in un sottobatch atomico (nessun comportamento di errore parziale).
• Tutte le altre operazioni consecutive vengono raggruppate in sotto-batch non atomici (comportamento di errore parziale).

Termine chiave: il termine consecutivo si riferisce all'ordine delle operazioni nel job batch.

Il diagramma seguente illustra questo concetto. Ognuna delle caselle grigie rappresenta un job batch inviato utilizzando l'API Google Ads. All'interno delle caselle grigie, le singole operazioni sono raggruppate per colore per rappresentare i sottobatch creati dal server API Google Ads. L'ordine delle operazioni in ciascuna delle caselle grigie corrisponde all'ordine in cui le operazioni sarebbero state aggiunte al job batch.

Limitazioni

Quando lavori con i filtri dei gruppi di schede nel contesto di job batch, si applicano le seguenti limitazioni:

• Un singolo batch di operazioni AssetGroupListingGroupFilterOperation contenente un listing_group e che ha come target lo stesso AdGroup non può superare 20.000 operazioni di lunghezza. Tuttavia, è consigliabile non superare le 10.000 operazioni.
• Un singolo batch di operazioni AssetGroupListingGroupFilterOperation che hanno come target lo stesso AssetGroup non può superare le 10.000 operazioni.
• La violazione di una di queste condizioni determina l'errore dell'intero job batch.