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. Este guia explica como as solicitações que modificam as campanhas Performance Max são processadas e pode ser um recurso complementar ao guia de solução de problemas e ao guia de processamento em lote da Performance Max.

Criar campanhas Performance Max

Na API Google Ads, as entidades de campanha 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 diretrizes de marca ativadas, as operações para criar Campaign e os recursos CampaignAsset necessários precisam ser incluídas 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 AssetGroup e AssetGroupAsset entidades 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. Saiba como isso é diferente para campanhas de varejo. As solicitações para criar um AssetGroup sem todas as entidades AssetGroupAsset necessárias resultam em um erro. Consulte Estado inválido x solicitações inválidas para mais contexto.

Há diferentes opções para estruturar solicitações que criam campanhas Performance Max. A decisão sobre 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 diretrizes de marca ativadas, os Campaign e os recursos CampaignAsset necessá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 não poderá ser veiculada até que os recursos AssetGroup e AssetGroupAsset também sejam criados.

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

imagem

Você pode personalizar ainda mais suas campanhas Performance Max criando recursos adicionais, conforme mostrado no diagrama.

Você pode incluir operações para criar AssetGroupSignal recursos 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 do AssetGroup.

Campanha Performance Max com opções adicionais

imagem

Campanhas Performance Max para varejo

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

  • Grupos de recursos sem recursos
  • Grupos de recursos que contêm TODOS os recursos necessários (recomendado)

Quando você opta por excluir recursos de grupos de recursos, 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 para varejo exigem o seguinte conjunto mínimo de recursos para serem veiculadas.

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

É importante observar que o campo Campaign.shopping_settings precisa ser preenchido em campanhas de varejo. Além disso, os final_urls listados em cada AssetGroup precisam corresponder aos URLs associados ao ID da conta do Merchant Center especificado em Campaign.shopping_settings. Por fim, cada AssetGroup precisa ter uma árvore de grupos de produtos anunciados associada e válida, composta por um ou mais AssetGroupListingGroupFilter recursos. No mínimo, é necessário criar uma única árvore de nós 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 não poderá ser veiculada até que todos esses recursos sejam criados corretamente.

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

imagem

As campanhas 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 de campanhas e critérios de campanhas. Se você optar por adicionar recursos de anúncio a um AssetGroup ao criar o recurso AssetGroup, seu AssetGroup estará sujeito aos requisitos mínimos de recursos de anúncio. Em outras palavras, você pode incluir nenhum recurso ou todos os recursos necessários.

Campanha Performance Max de varejo com opções adicionais

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 inválidos e solicitações inválidas.

Estado inválido
A campanha não está qualificada para veiculação devido à forma como está configurada. Por exemplo, é possível criar um recurso Campaign independente com um advertising_channel_type de PERFORMANCE_MAX. Embora a solicitação para criar a campanha seja bem-sucedida, ela não poderá ser veiculada até que você adicione pelo menos um AssetGroup à campanha. Se as solicitações forem bem-sucedidas, mas a campanha ou os 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 gera um erro se você tentar criar um AssetGroup para uma campanha que não seja de varejo sem incluir os recursos mínimos necessários. É por isso que você precisa incluir um AssetGroup e os recursos AssetGroupAsset na mesma solicitação. Isso também significa que todos os recursos AssetGroupAsset precisam atender às especificações corretas para 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 por 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, conforme já observado.

Sua campanha não poderá ser veiculada até que você crie todos os recursos necessários mencionados neste guia. Ao emitir solicitações separadas, use os nomes de recursos reais dos recursos referenciados em solicitações subsequentes. Ao emitir solicitações de mutação em massa que contenham várias operações, use nomes de recursos formados com o uso de IDs temporários.

Ordem de operações

Independente 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 forma que você nunca faça referência a um recurso antes que ele seja criado. No caso de solicitações de mutação em massa, isso significa ordenar as operações de forma que os recursos referenciados sejam listados antes dos recursos que os referenciam.

Se você optar por criar recursos de recursos na mesma solicitação de mutação em massa que cria um AssetGroup e os recursos AssetGroupAsset, todos os AssetOperations precisarão 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 sua solicitação, o servidor de API vai avaliar os requisitos mínimos de recursos após a primeira AssetGroupAssetOperation e retornar um erro sem prosseguir com o restante das operações na solicitação. Como resultado, nenhum dos recursos na solicitação seria adicionado à sua conta do Google Ads. Além disso, nem o AssetGroup nem nenhum dos recursos associados AssetGroupAsset seriam criados.

Atualizar grupos de recursos

Depois de criar um AssetGroup válido, não é possível emitir solicitações subsequentes que resultem em um estado inválido em que os requisitos mínimos de recursos não sejam mais atendidos. Qualquer solicitação desse tipo gera um erro. Por exemplo, se você criar um AssetGroup com uma única MARKETING_IMAGE (o requisito mínimo), qualquer solicitação para remover o AssetGroupAsset associado a essa MARKETING_IMAGE retornará um erro.

Isso é particularmente importante no caso de grupos de recursos em campanhas de varejo criadas sem recursos associados. As solicitações subsequentes para adicionar recursos de anúncio ao AssetGroup criando recursos AssetGroupAsset só serão bem-sucedidas se a solicitação atender a todos os requisitos de recursos de anúncio. Em outras palavras, não é possível adicionar recursos a esses grupos de recursos de forma incremental.

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