Este guia detalha muitas das complexidades da estruturação de solicitações para criar e atualizar campanhas Performance Max. Ele pode ser um recurso útil na hora de projetar sua integração. Este guia explica como as solicitações que mudam as campanhas Performance Max são processadas e pode ser um recurso complementar do guia de solução de problemas das campanhas Performance Max e do guia de processamento em lote 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.
É importante observar que as operações para criar entidades AssetGroup
e
AssetGroupAsset
precisam ser incluídas 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.
Confira 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 versus solicitações inválidas
para mais contexto.
Há diferentes opções quando se trata de estruturar solicitações para criar campanhas Performance Max. A decisão de como agrupar operações e estruturar solicitações depende muito dos objetivos e da infraestrutura.
- Crie os recursos
CampaignBudget
,Campaign
eAsset
em solicitações separadas antes de criar os recursosAssetGroup
eAssetGroupAsset
. - Inclua todos esses recursos em uma única solicitação de mutação.
Embora você consiga 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 válida em veiculação
É possível personalizar ainda mais suas campanhas Performance Max criando 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 do 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ê opta por excluir recursos dos grupos, o Google usa automaticamente os recursos fornecidos na sua conta do Merchant Center vinculada para criar anúncios. No entanto, recomendamos fornecer recursos para alcançar em todo o inventário. As campanhas Performance Max para varejo exigem o seguinte conjunto mínimo de recursos para serem veiculadas.
CampaignBudget
Campaign
(comShoppingSettings
preenchidas)AssetGroup
AssetGroupListingGroupFilter
É importante observar que o campo Campaign.shopping_settings
precisa ser preenchido em campanhas de varejo. Além disso, o final_urls
listado em cada
AssetGroup
precisa 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 associada e válida composta por um ou mais recursos AssetGroupListingGroupFilter
. No mínimo, você precisa criar 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 estará qualificada para veiculação até que todos esses recursos sejam criados corretamente.
Requisitos mínimos para uma campanha Performance Max válida para varejo
As campanhas de varejo podem usar todas as opções disponíveis para as campanhas Performance Max padrão, incluindo a criação de indicadores do grupo de recursos, metas de conversão da campanha e critérios da campanha. Se você optar por adicionar recursos a um
AssetGroup
ao criar o recurso AssetGroup
, seu AssetGroup
vai
estar sujeito aos requisitos mínimos de recursos. Em outras palavras, é possível
não incluir recursos ou incluir todos os recursos necessários.
Campanha Performance Max para varejo com mais opções
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 à configuração dela. Por
exemplo, é possível criar um recurso
Campaign
autônomo com umadvertising_channel_type
dePERFORMANCE_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 umAssetGroup
à campanha. Se as solicitações forem bem-sucedidas, mas a campanha ou os grupos de recursos não estiverem sendo veiculados, useCampaignPrimaryStatus
,CampaignPrimaryStatusReason
,AssetGroupPrimaryStatus
eAssetGroupPrimaryStatusReason
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ê tenta criar um
AssetGroup
para uma campanha que não é de varejo sem incluir os recursos mínimos necessários. É por isso que você precisa incluir umAssetGroup
e os recursosAssetGroupAsset
dele na mesma solicitação. Isso também significa que todos os seus recursos deAssetGroupAsset
precisam atender às especificações corretas para um determinadofield_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ê pode criar esses recursos separados em solicitações únicas 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á mencionado.
Sua campanha só estará qualificada para veiculação depois que você criar todos os recursos necessários mencionados neste 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
Mesmo que você use ou não uma solicitação de modificação em massa para criar uma campanha Performance Max, é necessário ordenar suas solicitações e operações para que nunca se refiram a um recurso antes da criação dele. 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 se referem a eles.
Se você optar por criar recursos de recurso na mesma solicitação de mutação em massa que
cria um AssetGroup
e os recursos de AssetGroupAsset
, todos os
AssetOperations
precisarão vir antes de todos os AssetGroupAssetOperations
, como
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 de API 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 da solicitação seria adicionado à sua conta do Google Ads. Além disso, o AssetGroup
nem qualquer um dos recursos
AssetGroupAsset
associados serão criados.
Atualizar grupos de recursos
Depois de criar um AssetGroup
válido, não é possível emitir solicitações subsequentes
que resultariam em um estado inválido, em que os requisitos mínimos de recursos
não são mais atendidos. Essas solicitações geram um erro. Por exemplo, se você
criar um AssetGroup
com um único MARKETING_IMAGE
(o requisito mínimo), qualquer solicitação para remover o AssetGroupAsset
associado a esse MARKETING_IMAGE
retornaria 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 do recurso. Em outras palavras, não é possível adicionar
recursos a esses grupos de modo incremental.