Solicitações de estrutura

Este guia detalha muitas das complexidades da estruturação de solicitações que criam e atualizam campanhas Performance Max. Ele pode ser um recurso útil ao projetar sua integração. Neste guia, explicamos como as solicitações que modificam as campanhas Performance Max são processadas. Ele pode ser usado como um recurso complementar ao guia de solução de problemas de campanhas Performance Max e ao guia de processamento em lote de campanhas Performance Max.

Criar campanhas Performance Max

Na API Google Ads, as entidades de campanhas Performance Max são representadas como uma combinação de vários recursos exclusivos.

Campanhas Performance Max padrão

As campanhas Performance Max padrão exigem um conjunto mínimo de recursos para serem veiculadas.

Para campanhas com as diretrizes da marca ativadas, as operações para criar Campaign e os recursos CampaignAsset necessários precisam ser incluídos em uma única solicitação, e os recursos CampaignAsset precisam atender aos requisitos e especificações mínimos de recursos.

É importante observar que as operações para criar entidades AssetGroup e AssetGroupAsset precisam ser incluídas juntas em uma única solicitação, e os recursos AssetGroupAsset precisam ser combinados para atender a todos os requisitos mínimos de recursos e especificações. Veja como isso é diferente para campanhas de varejo. As solicitações para criar um AssetGroup sem todas as entidades AssetGroupAsset obrigatórias resultam em um erro. Consulte Estado inválido versus solicitações inválidas para mais contexto.

Há diferentes opções para estruturar solicitações que criam campanhas Performance Max. A decisão de como agrupar operações e estruturar solicitações depende muito dos seus objetivos e da sua infraestrutura.

  • Crie os recursos CampaignBudget, Campaign, Asset e CampaignAsset em solicitações separadas antes de criar os recursos AssetGroup e AssetGroupAsset. (Para campanhas com as diretrizes da marca ativadas, os recursos Campaign e os recursos CampaignAsset obrigatórios precisam ser incluídos juntos em uma única solicitação)
  • Inclua todos esses recursos em uma única solicitação de mutação.

Embora seja possível criar os recursos CampaignBudget, Campaign, Asset e CampaignAsset em solicitações anteriores separadas, a campanha Performance Max só vai estar qualificada para veiculação quando os recursos AssetGroup e AssetGroupAsset também forem criados.

Requisitos mínimos para uma campanha Performance Max válida

imagem

Para personalizar ainda mais suas campanhas Performance Max, crie outros recursos, conforme mostrado no diagrama.

É possível incluir operações para criar recursos AssetGroupSignal na mesma solicitação que cria os recursos AssetGroup e AssetGroupAsset. Como alternativa, é possível criar entidades AssetGroupSignal em uma solicitação separada após a criação de AssetGroup.

Campanha Performance Max com outras opções

imagem

Campanhas Performance Max para varejo

As campanhas de varejo são únicas porque há duas maneiras distintas de criar grupos de recursos que resultam em uma campanha de veiculação válida:

  • Grupos de recursos sem recursos personalizados (ou apenas com recursos HTML5 MEDIA_BUNDLE)
  • Grupos de recursos que contêm todos os recursos necessários (preferencial)

Quando você exclui recursos de grupos, o Google usa automaticamente os recursos fornecidos na sua conta vinculada do Merchant Center para criar anúncios. No entanto, recomendamos fornecer recursos para alcançar todo o inventário. As campanhas Performance Max de varejo exigem o seguinte conjunto mínimo de recursos para veiculação:

  • CampaignBudget
  • Campaign (com ShoppingSetting preenchido)
  • AssetGroup
  • AssetGroupListingGroupFilter

O campo Campaign.shopping_setting precisa ser preenchido em campanhas de varejo. Além disso, qualquer final_urls listado em um AssetGroup precisa corresponder ao domínio do site associado ao ID da conta do Merchant Center especificado em Campaign.shopping_setting. Por fim, cada AssetGroup precisa ter uma árvore de grupos de produtos anunciados válida e associada, composta por um ou mais recursos AssetGroupListingGroupFilter. No mínimo, você precisa criar uma árvore de nós única para contabilizar todos os produtos no feed especificado do Merchant Center.

Cada um desses recursos pode ser criado separadamente ou em uma única solicitação. No entanto, a campanha só poderá ser veiculada quando todos esses recursos forem criados corretamente.

Requisitos mínimos para uma campanha Performance Max de varejo válida

imagem

As campanhas Performance Max de varejo podem usar todas as opções disponíveis para campanhas Performance Max padrão, incluindo a criação de indicadores de grupos de recursos, metas de conversão e critérios de campanha. Se você optar por adicionar recursos personalizados (que não sejam recursos HTML5 MEDIA_BUNDLE) a um AssetGroup ao criar o recurso AssetGroup, sua solicitação precisará atender a todos os requisitos mínimos de recursos (incluindo propriedades da marca no nível da campanha, se as diretrizes de marca estiverem ativadas). Em outras palavras, não inclua nenhum recurso personalizado ou inclua todos os recursos necessários.

Campanha Performance Max de varejo com outras opções

imagem

Estado inválido x solicitações inválidas

Ao trabalhar com campanhas Performance Max na API Google Ads, há uma distinção importante entre estados e solicitações inválidos.

Estado inválido
A campanha não está qualificada para veiculação devido à configuração dela. Por exemplo, é possível criar um recurso Campaign independente com um advertising_channel_type de PERFORMANCE_MAX. Embora o pedido de criação da campanha seja bem-sucedido, ela não estará qualificada para veiculação até que você adicione pelo menos um AssetGroup a ela. Se as solicitações forem bem-sucedidas, mas sua campanha ou grupos de recursos não estiverem sendo veiculados, use CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus e AssetGroupPrimaryStatusReason para determinar o motivo, conforme detalhado no guia de solução de problemas.
Consulta inválida
Uma solicitação que não seria bem-sucedida porque colocaria a campanha ou o recurso em um estado inválido. Por exemplo, a API Google Ads vai gerar um erro se você tentar criar um AssetGroup para uma campanha que não seja de varejo (exceto campanhas Performance Max para Serviços Locais) sem incluir os recursos mínimos necessários. Por isso, é necessário incluir um AssetGroup e os recursos AssetGroupAsset dele na mesma solicitação. Isso também significa que todos os recursos AssetGroupAsset precisam atender às especificações corretas de um determinado field_type para evitar que toda a solicitação falhe.

Agrupar operações com solicitações de mutação

As campanhas Performance Max são compostas de vários recursos, e você tem a opção de criar esses recursos separados em solicitações exclusivas ou em uma única solicitação de mutação em massa. No entanto, AssetGroups e AssetGroupAssets associados em campanhas Performance Max padrão precisam ser criados em uma única solicitação atômica, como já observado.

Sua campanha não estará qualificada para veiculação até que você tenha criado todos os recursos necessários indicados neste guia. Ao emitir solicitações separadas, use os nomes reais dos recursos referenciados nas solicitações subsequentes. Ao emitir solicitações de mutação em massa com várias operações, use nomes de recursos formados com IDs temporários.

Ordem de operações

Independentemente de você usar uma solicitação de mutação em massa para criar uma campanha Performance Max, é necessário ordenar as solicitações e operações de modo que você nunca faça referência a um recurso antes de ele ser criado. No caso de solicitações de mutação em massa, isso significa ordenar as operações de modo que os recursos referenciados sejam listados antes dos recursos que os referenciam.

Se você optar por criar recursos de recurso na mesma solicitação de mutação em massa que cria um AssetGroup e os recursos AssetGroupAsset, todos os AssetOperations precisam vir antes de todos os AssetGroupAssetOperations, conforme demonstrado no diagrama.

imagem

O servidor de anúncios do Google Ads agrupa AssetGroupAssetOperations consecutivos e avalia se um AssetGroup atende aos requisitos mínimos de recursos após a última operação nesse grupo. Se você alternar entre AssetOperations e AssetGroupAssetOperations na solicitação, o servidor de API vai avaliar os requisitos mínimos de recursos após o primeiro AssetGroupAssetOperation e retornar um erro sem prosseguir com o restante das operações na solicitação. Como resultado, nenhum dos recursos no pedido seria adicionado à sua conta do Google Ads. Além disso, nem o AssetGroup nem os recursos AssetGroupAsset associados seriam criados.

Atualizar grupos de recursos

Depois de criar um AssetGroup válido, não é possível emitir solicitações subsequentes que deixem um grupo de recursos abaixo dos requisitos mínimos de recursos. Qualquer solicitação desse tipo gera um erro. Por exemplo, se você criar um AssetGroup com um único MARKETING_IMAGE (o requisito mínimo), uma solicitação para remover apenas esse MARKETING_IMAGE AssetGroupAsset retornará um erro. No entanto, nas campanhas Performance Max de varejo, é possível voltar a usar os recursos gerados automaticamente pelo Google Merchant Center para um AssetGroup removendo todos os links AssetGroupAsset personalizados em uma única solicitação.

Para grupos de recursos em campanhas de varejo Performance Max criadas sem recursos personalizados associados, as solicitações subsequentes para vincular recursos personalizados (exceto recursos HTML5 MEDIA_BUNDLE) precisam garantir que pelo menos um final_urls esteja definido no AssetGroup (preenchendo-o primeiro se omitido originalmente) e fornecer todos os recursos mínimos necessários (incluindo propriedades da marca no nível da campanha se as diretrizes de marca estiverem ativadas) em uma única solicitação atômica. Não vincule recursos opcionais, como YOUTUBE_VIDEO, sozinhos nem adicione recursos de anúncio de forma incremental em solicitações separadas. Vincular apenas recursos personalizados opcionais deixa o grupo de recursos em um estado não compatível que bloqueia edições na interface do Google Ads. Para mais detalhes, consulte Vincular grupos de recursos a recursos em campanhas Performance Max de varejo.

Anterior
Relatórios de critérios de campanha
Avançar
Processamento em lote