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
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:
- Tipo di filtro del gruppo di schede
AdGroupCriterion
oAssetGroup
scelti come target dal filtro del gruppo di schede- Ordine delle operazioni
Tieni presente i seguenti punti su come vengono raggruppate le operazioni:
- Tutte le operazioni
AssetGroupListingGroupFilterOperation
consecutive che hanno come target la stessaAssetGroup
sono raggruppate in un sub-batch atomico (nessun comportamento di errore parziale). - Tutte le operazioni
AdGroupCriterionOperation
consecutive che contengono un elementolisting_group
che ha come target lo stessoAdGroup
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).
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 unlisting_group
e che ha come target lo stessoAdGroup
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 stessoAssetGroup
non può superare le 10.000 operazioni. - La violazione di una di queste condizioni determina l'errore dell'intero job batch.