Solicitações de estrutura

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

Criar campanhas Performance Max

Na API Google Ads, as entidades da 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.

• Orçamento da campanha
• Campaign
• Grupos de recursos
• Recursos do grupo de recursos
• Recursos

É importante observar que as operações para criar entidades AssetGroup e AssetGroupAsset precisam ser incluídas em uma única solicitação, e os recursos de AssetGroupAsset precisam ser combinados para atender a todos os requisitos e especificações de recursos mínimos. Confira a diferença 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á opções diferentes quando se trata de 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 e Asset em solicitações separadas antes de criar os recursos AssetGroup e AssetGroupAsset.
• Inclua todos esses recursos em uma única solicitação de mutação.

Embora você possa criar os recursos CampaignBudget, Campaign e Asset em solicitações anteriores separadas, a campanha Performance Max não estará qualificada para veiculação até que os recursos AssetGroup e AssetGroupAsset também sejam criados.

Requisitos mínimos para uma campanha Performance Max de veiculação válida

É possível personalizar ainda mais suas campanhas Performance Max criando recursos adicionais, conforme mostrado no diagrama.

• Indicadores do grupo de recursos
• Metas de conversão da campanha
• Critérios da campanha

É 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 mais opções

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
• 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 do Merchant Center vinculada para criar anúncios. No entanto, recomendamos que você ofereça recursos para alcançar em todo o inventário. Para serem veiculadas, as campanhas Performance Max para varejo exigem o seguinte conjunto mínimo de recursos.

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

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 no Campaign.shopping_settings. Por fim, cada AssetGroup precisa ter uma árvore de grupo de informações do produto válida e associada composta por um ou mais recursos AssetGroupListingGroupFilter. Crie pelo menos uma única árvore de nós para contabilizar todos os produtos no seu 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 vai estar qualificada para veiculação até que todos esses recursos sejam criados corretamente.

Requisitos mínimos para uma campanha Performance Max de varejo válida para veiculação

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 da campanha. Se você optar por adicionar recursos a uma AssetGroup ao criar o recurso AssetGroup, seu AssetGroup estará sujeito aos requisitos mínimos de recursos. Em outras palavras, você pode incluir todos os recursos necessários ou nenhum recurso.

Campanha Performance Max para varejo com mais opções

Estado inválido versus 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álidas.

Estado inválido

A campanha não está qualificada para veiculação devido à configuração dela. Por exemplo, é possível criar um recurso Campaign autônomo com um advertising_channel_type de PERFORMANCE_MAX. Embora a solicitação para criar a campanha seja bem-sucedida, ela não estará qualificada para veiculação 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 será concluída 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 sem incluir os recursos mínimos necessários. É por isso que você precisa 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 para uma determinada field_type a fim de evitar que toda a solicitação falhe.

Agrupar operações com solicitações mutate

As campanhas Performance Max são compostas por vários recursos, e você pode criar esses recursos separados em solicitações únicas ou em uma única solicitação de mutação em massa. No entanto, a AssetGroups e a AssetGroupAssets associada em campanhas Performance Max padrão precisam ser criadas em uma única solicitação atômica, conforme já observado.

Sua campanha não estará qualificada para veiculação até que você crie com sucesso todos os recursos necessários mencionados ao longo deste guia. Ao emitir solicitações separadas, use os nomes reais dos recursos referenciados nas solicitações subsequentes. Ao emitir solicitações mutate em massa que contêm 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 nunca você referencie um recurso antes de criá-lo. No caso de solicitações mutate 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 recursos na mesma solicitação de mutação em massa que cria um AssetGroup e seus recursos AssetGroupAsset, todos os AssetOperations precisam vir antes de todos os AssetGroupAssetOperations, conforme demonstrado no diagrama.

O servidor 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 da API avaliará os requisitos mínimos de recursos após a primeira AssetGroupAssetOperation e retornará um erro sem continuar 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 qualquer um dos recursos AssetGroupAsset associados seriam criados.

Atualizar grupos de recursos

Depois de criar um AssetGroup válido, não será 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. Todas essas solicitações geram um erro. Por exemplo, se você criar uma AssetGroup com um único MARKETING_IMAGE (o requisito mínimo), todas as solicitações para remover o AssetGroupAsset associado a essa MARKETING_IMAGE retornarão um erro.

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