Filtros de grupos de fichas em jobs em lote

Ao trabalhar com filtros de grupo de fichas no contexto de um AdGroupCriterion.listing_group ou um AssetGroupListingGroupFilter, você precisa considerar algumas considerações ao criar sua integração.

Divisão em lote

Importante: recomendamos adicionar operações AssetGroupListingGroupFilterOperation que segmentam as mesmas operações AssetGroup e AdGroupCriterionOperation com um listing_group que tem como destino 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 contenham critérios ou filtros do grupo de anúncios do grupo de recursos, as operações na tarefa em lote serão divididas em vários sublotes quando forem recebidas pelo servidor da API Google Ads. Observe que, ao contrário das operações padrão em uma tarefa em lote, cada sublote que contém operações de filtro do grupo de listagem é tratado atomicamente.

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

1. Tipo de filtro do grupo de fichas da empresa
2. O AdGroupCriterion ou AssetGroup que o filtro do grupo de fichas está segmentando
3. Ordem de operações

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

• Todas as operações AssetGroupListingGroupFilterOperation consecutivas que segmentam o 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 segmentando o mesmo AdGroup são agrupadas em um sublote atômico (sem 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 se refere à 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 listagens no contexto de jobs em lote, as seguintes limitações se aplicam:

• Um único lote de operações AssetGroupListingGroupFilterOperation contendo um listing_group e segmentando o 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 que segmentam a mesma AssetGroup não pode exceder 10.000 operações.
• A violação de uma dessas condições resulta na falha de todo o job em lote.