Elenco dei filtri dei gruppi nei job batch

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Quando utilizzi i filtri dei gruppi di schede nel contesto di un AdGroupCriterion.listing_group o di un AssetGroupListingGroupFilter, prendi in considerazione le seguenti considerazioni durante la progettazione dell'integrazione.

Suddivisione in batch

Se in un job batch sono presenti operazioni che contengono criteri per i gruppi di annunci o filtri per i gruppi di schede dei gruppi di asset, le operazioni nel job batch vengono suddivise in più sottojob quando vengono ricevute dal server dell'API Google Ads. Tieni presente che, diversamente dalle operazioni standard in un job batch, ogni sotto-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 subbatch è determinato dai seguenti fattori:

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

Considera come vengono raggruppate le 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 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 sottolotti non atomici (comportamento di errore parziale).

Il seguente diagramma illustra questo concetto. Ogni riquadro grigio 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 sottolotti che viene creato dal server dell'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 utilizzi i filtri dei gruppi di schede nel contesto dei 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 la lunghezza di 20.000 operazioni. 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 comporta il fallimento 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 sbagliate. 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 a valle.

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. In genere, questo messaggio indica che l'operazione in questo indice è stata annullata a causa di un errore in un altro indice. Per identificare la causa principale del problema, ti consigliamo di eseguire l'iterazione di tutti i messaggi di stato in BatchJobResult, prima e dopo l'indice del messaggio di errore Ad group is invalid, alla ricerca di ulteriori informazioni sull'errore.