Elenco dei filtri dei gruppi nei job batch

Quando lavori con i filtri di gruppo di elenchi nel contesto di una AdGroupCriterion.listing_group o di una AssetGroupListingGroupFilter, ci sono alcune considerazioni da tenere presenti quando progetta la tua integrazione.

Suddivisione in batch

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

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

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

Tieni presente questi punti relativi al raggruppamento delle operazioni:

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

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 filtri di gruppi di elenchi nel contesto di job batch, si applicano le seguenti limitazioni:

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