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 a conclusão das operações. Você pode usar o processamento em lote para criar e gerenciar campanhas Performance Max.

Este guia fornece detalhes específicos sobre as campanhas Performance Max ao trabalhar com o processamento em lote. O guia genérico de processamento em lote (em inglês) fornece informações gerais sobre o processamento em lote, e o guia de estrutura de solicitações (em inglês) 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 job de processamento em lote geral para criar um recurso BatchJob.

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

As campanhas Performance Max exigem operações para criar vários recursos relacionados, que são detalhados no guia de estrutura de solicitações. Crie uma MutateOperation para cada recurso que precisa 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 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 de marca estiverem ativadas, consulte solução de problemas), a solicitação vai falhar e retornar um CampaignError indicando recursos ausentes. A inclusão das 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 no meio devido à forma como essas operações são agrupadas quando processadas. Caso contrário, a solicitação gera uma 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 mais tarde na lista de operações.

Práticas recomendadas para AssetGroupListingGroupFilterOperation

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

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

Adicione as operações de modificação da Etapa 2 a uma lista e chame AddBatchJobOperations para adicionar a lista de modificaçõ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 sejam executados chamando RunBatchJob. Consulte a etapa Executar o job em lote no guia geral de processamento em lote para conferir um exemplo.

Extrair 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 deles seguindo a etapa listar todos os resultados de jobs em lote no guia geral de processamento em lote.