Processamento em lote para campanhas Performance Max

O processamento em lote permite enviar um conjunto de operações, que podem ser interdependentes, para vários serviços sem esperar de forma síncrona que as operações sejam concluídas. Você pode usar o processamento em lote para criar e gerenciar campanhas Performance Max.

Este guia fornece detalhes específicos para campanhas Performance Max ao trabalhar com processamento em lote. O guia genérico de processamento em lote fornece informações gerais sobre o processamento em lote, e o guia de solicitações de estrutura contém informações detalhadas sobre como criar solicitações para criar ou gerenciar campanhas Performance Max.

Para criar uma campanha Performance Max usando o processamento em lote, siga estas etapas:

Criar um job em lote

Siga a etapa de criação de jobs de processamento em lote geral para criar um recurso BatchJob.

Preparar uma lista de operações de mutação

As campanhas Performance Max exigem operações para criar vários recursos relacionados, que são detalhados no guia de solicitações de estrutura. Crie um MutateOperation para cada recurso que deve ser incluído no job em lote.

Requisitos de CampaignOperation e CampaignAssetOperation

Observação: esse requisito se aplica apenas a recursos Campaign com recursos Asset associados que usam CampaignAsset para atender aos requisitos de propriedade da marca.

Quando as diretrizes de marca estão ativadas para uma campanha (consulte diretrizes de marca), é necessário vincular propriedades da marca à campanha usando recursos CampaignAsset. Além disso, em um job em lote, a criação desses recursos CampaignAsset precisa acontecer imediatamente após a criação do próprio recurso Campaign. Se os recursos CampaignAsset não forem criados imediatamente após o recurso Campaign (quando as diretrizes da marca estiverem ativadas, consulte solução de problemas), a solicitação vai falhar e retornar um CampaignError indicando recursos ausentes. Incluir as operações de criação de CampaignAsset posteriormente na mesma lista de operações não impede esse erro.

Requisitos de AssetGroupOperation e AssetGroupAssetOperation

Observação: esse requisito se aplica apenas a recursos AssetGroup com recursos Asset associados usando AssetGroupAsset para aderir aos requisitos mínimos de recursos.

As operações do tipo MutateOperation que criam recursos AssetGroup e AssetGroupAsset em um job em lote precisam ser sequenciais sem outras operações entre elas devido à forma como essas operações são agrupadas quando processadas. Caso contrário, a solicitação vai gerar um AssetGroupError indicando que alguns recursos estão ausentes, mesmo que as operações necessárias para atender aos requisitos mínimos de recursos sejam incluídas posteriormente na lista de operações.

Práticas recomendadas do AssetGroupListingGroupFilterOperation

Observação: os recursos AssetGroupListingGroupFilter só podem ser usados com campanhas Performance Max para vendas on-line com um feed de produtos. Os recursos AssetGroup nessas campanhas precisam ter uma árvore de grupos de produtos válida composta por um ou mais recursos AssetGroupListingGroupFilter associados. Para segmentar todos os produtos, use uma árvore de nó único.

Ao trabalhar com filtros de grupos de produtos anunciados no contexto de um AssetGroupListingGroupFilter, recomendamos adicionar operações AssetGroupListingGroupFilterOperation que segmentam o mesmo AssetGroup a um job em lote consecutivamente, para que o conjunto de operações seja tratado de forma atômica durante a divisão em lote. Para saber mais sobre a divisão em lotes e outros fatores que afetam os grupos de produtos anunciados, consulte o guia de processamento em lote de grupos de produtos anunciados.

Adicionar as operações de mutação ao job

Adicione as operações de mutação da Etapa 2 a uma lista e chame AddBatchJobOperations para adicionar a lista de mutações ao job em lote criado na Etapa 1. Siga a etapa de adição de operações no guia geral de processamento em lote para adicionar a lista de operações de mutação.

Executar o job em lote

Permita que os jobs enviados comecem a ser executados chamando RunBatchJob. Consulte a etapa Executar o job em lote no guia geral de processamento em lote para ver um exemplo.

Recuperar o status do job

Os jobs em lote começam como operações de longa duração e geralmente levam tempo para serem concluídos. Depois de iniciar o job, use o método GetOperation da operação de longa duração para pesquisar o status do job até que ele seja concluído.

Quando todos os jobs em lote forem concluídos, chame ListBatchJobResults para imprimir os status e as respostas seguindo a etapa listar todos os resultados de jobs em lote no guia geral de processamento em lote.