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 oferece 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 precisa ser incluído
no job em lote.
Requisitos de CampaignOperation e CampaignAssetOperation
Quando as diretrizes da marca estão ativadas para uma campanha Performance Max
Campaign (brand_guidelines_enabled
usa true como padrão, a menos que você defina como false ou crie uma campanha de metas de turismo),
é necessário vincular os recursos de marca Asset à campanha usando
recursos CampaignAsset.
As campanhas Performance Max para Serviços Locais não são compatíveis com as diretrizes de marca e omitem os recursos de marca CampaignAsset (defina brand_guidelines_enabled como false ao criar a campanha). As campanhas Performance Max de varejo (com um feed do Merchant Center) podem omitir recursos de marca CampaignAsset no mesmo sublote atômico apenas quando você cria uma campanha sem recursos sem recursos personalizados AssetGroupAsset (exceto recursos HTML5 MEDIA_BUNDLE) ou quando brand_guidelines_enabled está definido como false.
Em um job em lote, crie esses recursos CampaignAsset
imediatamente após criar o próprio recurso Campaign (até
1.000 operações no total no sublote atômico).
A operação create Campaign (resource_name) e as operações create CampaignAsset consecutivas (campaign) precisam especificar o mesmo ID temporário negativo, e todas as operações AssetOperation create de pré-requisito precisam ser colocadas antes da criação de Campaign. Se os recursos CampaignAsset não forem criados imediatamente após o recurso Campaign (quando as diretrizes de marca estiverem ativadas; consulte a 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
Ao criar recursos AssetGroup com recursos Asset associados usando AssetGroupAsset para atender aos requisitos mínimos de recursos, os objetos MutateOperation que criam os recursos AssetGroup e AssetGroupAsset em um job em lote precisam ser sequenciais sem outras operações entre eles devido à forma como essas operações são agrupadas em sublotes atômicos (até 1.000 operações no total por sublote). Especifique o mesmo ID temporário negativo
na operação AssetGroup create (resource_name) e nas operações
AssetGroupAsset create consecutivas (asset_group) e coloque todas as
operações AssetOperation create de pré-requisito antes
da criação de AssetGroup. Caso contrário, a solicitação vai falhar com 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
Ao criar, atualizar ou remover recursos AssetGroupListingGroupFilter, adicione todas as operações AssetGroupListingGroupFilterOperation que segmentam o mesmo AssetGroup ao job em lote consecutivamente para que as operações sejam agrupadas em um sublote atômico durante a divisão de lotes. Para detalhes sobre a divisão de 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 o método 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 publicitárias no guia geral de processamento em lote
para adicionar a lista de operações de mutação.
Executar o job em lote
Comece a executar as operações enviadas chamando o método RunBatchJob. Consulte a etapa Executar o job em lote
no guia geral de processamento em lote para ver um exemplo.
Consultar o status do job e recuperar os resultados
Os jobs em lote são executados como operações de longa duração e geralmente levam tempo para serem concluídos. Depois de
iniciar o job, use o método Operations.GetOperation
no serviço google.longrunning.Operations (ou consulte
batch_job.status com GoogleAdsService) para
pesquisar o status do job até que ele seja concluído.
Quando o job em lote for concluído, chame o método ListBatchJobResults para recuperar o status e a resposta de cada operação no job. Por exemplo, consulte
Listar todos os resultados de jobs em lote.