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 das campanhas Performance Max ao trabalhar com o processamento em lote. O guia genérico de processamento em lote oferece informações gerais sobre o processamento em lote, e o guia Estruturar 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 novo job em lote
Siga a etapa geral de processamento em lote
de criação de jobs 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, detalhados no
guia Estruturar solicitações. 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), você precisa vincular
propriedades da marca à campanha usando CampaignAsset
recursos. Além disso, em um job em lote, a criação desses CampaignAsset
recursos precisa acontecer imediatamente após a criação do próprio Campaign
recurso. 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 que faltam recursos.
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 AssetGroup e
AssetGroupAsset recursos 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 grupos de produtos anunciados no contexto de um
AssetGroupListingGroupFilter, recomendamos adicionar
AssetGroupListingGroupFilterOperation
operações segmentando 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 lote 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 publicitárias
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 consultar 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.