Processamento em lote para campanhas Performance Max

O processamento em lote oferece uma maneira de 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 sobre campanhas Performance Max ao trabalhar com processamento em lote. O guia genérico de processamento em lote oferece informações gerais sobre o assunto, e o guia de estrutura de solicitações 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 geral de criação de jobs do processamento em lote 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

Quando as diretrizes de marca estão ativadas para uma campanha (consulte diretrizes de marca), é necessário vincular os recursos de 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 recurso Campaign. Se os recursos CampaignAsset não forem criados imediatamente após o recurso Campaign (quando as diretrizes de marca estão ativadas. Consulte solução de problemas), a solicitação vai falhar e retornar um CampaignError indicando que há recursos ausentes. Incluir as operações de criação de CampaignAsset mais tarde na mesma lista de operações não impede esse erro.

Requisitos de AssetGroupOperation e AssetGroupAssetOperation

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 faltando, mesmo que as operações necessárias para atender aos requisitos mínimos de recursos sejam incluídas mais tarde na lista de operações.

Práticas recomendadas de AssetGroupListingGroupFilterOperation

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

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.