Filtros de grupos de fichas em jobs em lote

Ao trabalhar com filtros de grupos de produtos anunciados no contexto de uma AdGroupCriterion.listing_group ou AssetGroupListingGroupFilter, é preciso considerar algumas considerações ao criar sua integração.

Divisão em lote

Importante :recomendamos adicionar operações AssetGroupListingGroupFilterOperation que segmentam os mesmos AssetGroup e AdGroupCriterionOperation operações contendo um listing_group que segmenta o mesmo AdGroup, a um job em lote consecutivamente, para que o conjunto de operações seja tratado atomicamente durante a divisão em lote.

Se houver operações em uma tarefa em lote que contenha critérios do grupo de anúncios ou filtros do grupo de produtos anunciados, as operações na tarefa em lote serão divididas em vários sublotes quando recebidas pelo servidor da API Google Ads. Ao contrário das operações padrão em uma tarefa em lote, cada sublote que contém as operações de filtro do grupo de fichas é tratado atomicamente.

A maneira como os jobs em lote que contêm filtros do grupo de fichas são divididos em sublotes é determinado pelos seguintes fatores:

1. Tipo de filtro do grupo de fichas
2. A AdGroupCriterion ou AssetGroup que o filtro do grupo de fichas segmenta
3. Ordem de operações

Lembre-se destes pontos sobre como as operações são agrupadas:

• Todas as operações AssetGroupListingGroupFilterOperation consecutivas direcionadas ao mesmo AssetGroup são agrupadas em um sublote atômico (sem comportamento de falha parcial).
• Todas as operações AdGroupCriterionOperation consecutivas que contêm um listing_group destinado ao mesmo AdGroup são agrupadas em um sublote atômico (nenhum comportamento de falha parcial).
• Todas as outras operações consecutivas são agrupadas em sublotes não atômicos (comportamento de falha parcial).

Termo-chave :consecutivo refere-se à ordem das operações no job em lote.

O diagrama abaixo ilustra esse conceito. Cada uma das caixas cinza representa uma tarefa em lote conforme enviada usando a Google Ads API. Dentro das caixas cinza, as operações individuais são agrupadas por cor para representar os sublotes criados pelo servidor da Google Ads API. A ordem das operações em cada uma das caixas cinza corresponde à ordem em que as operações teriam sido adicionadas à tarefa em lote.

Limitações

Ao trabalhar com filtros de grupos de fichas no contexto de jobs em lote, as seguintes limitações se aplicam:

• Um único lote de operações AssetGroupListingGroupFilterOperation contendo um listing_group e direcionadas ao mesmo AdGroup não pode exceder 20.000 operações de duração. No entanto, é recomendável não exceder 10.000 operações.
• Um único lote de operações AssetGroupListingGroupFilterOperation direcionadas ao mesmo AssetGroup não pode exceder 10.000 operações.
• A violação de qualquer uma dessas condições resulta na falha de todo o job em lote.