Elenco dei filtri dei gruppi nei job batch

Quando utilizzi i filtri dei gruppi di schede nel contesto di un AdGroupCriterion.listing_group o di un AssetGroupListingGroupFilter, tieni presente quanto segue quando progetti l'integrazione.

Divisione in batch

Se in un batch job sono presenti operazioni che contengono criteri del gruppo di annunci o filtri del gruppo di schede del gruppo di asset, le operazioni nel batch job 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 batch secondario contenente operazioni di filtro del gruppo di schede viene trattato in modo atomico.

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

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

Considera come sono raggruppate le operazioni:

• Tutte le operazioni AssetGroupListingGroupFilterOperation consecutive che hanno come target lo stesso AssetGroup sono raggruppate in un batch secondario atomico (nessun comportamento di errore parziale).
• Tutte le operazioni AdGroupCriterionOperation consecutive che contengono un 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 batch secondari non atomici (comportamento di errore parziale).

Il seguente diagramma illustra questo concetto. Ciascuna delle caselle grigie rappresenta un job batch inviato tramite l'API Google Ads. All'interno delle caselle grigie, le singole operazioni sono raggruppate per colore per rappresentare i sottogruppi che il server dell'API Google Ads crea. L'ordine delle operazioni in ciascuna delle caselle grigie corrisponde all'ordine in cui le operazioni sarebbero state aggiunte al job batch.

Limitazioni

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

• Un singolo batch di AssetGroupListingGroupFilterOperation operazioni contenente un listing_group e che ha come target lo stesso AdGroup non può superare le 20.000 operazioni di lunghezza. Tuttavia, è consigliabile 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 riescono 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 apparire in un indice prima o dopo gli errori downstream.

Ad esempio, durante l'elaborazione di una risposta da ListBatchJobResults, potresti notare che diverse operazioni non sono riuscite con un messaggio di stato, Ad group is invalid due to the listing groups it contains. Questo messaggio indica in genere 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 esaminare tutti i messaggi di stato nel BatchJobResult, prima e dopo l'indice del messaggio di errore Ad group is invalid, alla ricerca di ulteriori informazioni sugli errori.