Elenco dei filtri dei gruppi nei job batch

Quando lavori con i filtri dei gruppi di schede nel contesto di un AdGroupCriterion.listing_group o di un AssetGroupListingGroupFilter, tieni presente le seguenti considerazioni quando progetti l'integrazione.

Suddivisione in batch

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

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

1. Tipo di filtro dei gruppi di schede
2. Il AdGroupCriterion o AssetGroup a cui è destinato il filtro dei gruppi di schede
3. Ordine delle operazioni

Considera come vengono raggruppate le operazioni:

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

Il diagramma seguente illustra questo concetto. Ogni riquadro grigio rappresenta un job batch inviato utilizzando l'API Google Ads. All'interno dei riquadri grigi, le singole operazioni sono raggruppate per colore per rappresentare i sub-batch creati dal server dell'API Google Ads. L'ordine delle operazioni in ciascuno dei riquadri grigi 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 dei job batch, si applicano le seguenti limitazioni:

• Un singolo batch di AdGroupCriterionOperation operazioni 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 AssetGroupListingGroupFilterOperation operazioni che hanno come target lo stesso AssetGroup non può superare le 10.000 operazioni.
• La violazione di una di queste condizioni comporta l'esito negativo dell'intero job batch.

Risoluzione dei problemi

Le operazioni di filtro dei gruppi di schede in un job batch vengono elaborate come una singola transazione, il che può portare a scenari in cui molte operazioni non vanno a buon fine a causa di un numero ridotto di operazioni errate. Inoltre, a causa del modo in cui vengono elaborate le operazioni BatchJob, la causa principale degli errori potrebbe essere visualizzata in un indice prima o dopo gli errori downstream.

Ad esempio, durante l'elaborazione di una risposta da ListBatchJobResults, potresti scoprire che diverse operazioni non sono andate a buon fine con un messaggio di stato: Ad group is invalid due to the listing groups it contains. Questo messaggio in genere indica che l'operazione in questo indice è stata annullata a causa di un'operazione non riuscita in un indice diverso. Per identificare la causa principale del problema, ti consigliamo di scorrere tutti i mess101}aggi di stato in BatchJobResult, prima e dopo l'indice del messaggio di errore Ad group is invalid, alla ricerca di informazioni aggiuntive sugli errori.