Solicitações de estrutura

Este guia detalha muitas das complexidades da estruturação de solicitações que criam e atualizar as campanhas Performance Max. Pode ser um recurso útil à medida que você projeta sua integração. Este guia explica como as solicitações que modificam as campanhas Performance Max campanhas são processadas e podem ser um recurso complementar à campanha Performance Max guia de solução de problemas e o 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 para veiculação.

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

É importante observar que as operações para criar AssetGroup e As entidades AssetGroupAsset precisam ser incluídas em uma única solicitação, e os recursos de AssetGroupAsset devem ser combinados para atender a todos os recursos mínimos requisitos e especificações. ver como isso é diferente para Campanhas de varejo. Solicitações para criar um AssetGroup sem todas as entidades AssetGroupAsset necessárias resulta em uma erro. ver Estado inválido x solicitações inválidas para mais contexto.

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

• Criar os recursos CampaignBudget, Campaign e Asset em partes separadas antes de criar os recursos AssetGroup e AssetGroupAsset.
• Inclua todos esses recursos em uma única solicitação de mutação.

Embora seja possível criar CampaignBudget, Campaign e Asset em solicitações anteriores separadas, a campanha Performance Max qualificado para veiculação até que os recursos AssetGroup e AssetGroupAsset sejam que você criou.

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

Para personalizar ainda mais suas campanhas Performance Max, crie os recursos da nuvem, 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 no mesmo 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 duas maneiras distintas de criar grupos de recursos que resultam em uma veiculação válida campanha:

• 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 de forma automática os recursos fornecidos conta vinculada do Merchant Center 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 servir.

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

É importante observar que o campo Campaign.shopping_settings precisa ser preenchidos nas campanhas de varejo. Além disso, os final_urls listados 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 associada e válida do grupo de informações do produto composta por um ou mais AssetGroupListingGroupFilter recursos. No mínimo, é preciso criar um único á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 estará qualificada para veiculação até que todos esses recursos foram criadas corretamente.

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

As campanhas de varejo podem utilizar todas as opções disponíveis para campanhas Performance Max, incluindo a criação de indicadores do grupo de recursos, metas de conversão e critérios da campanha. Se você optar por adicionar recursos a uma AssetGroup ao criar o recurso AssetGroup, o AssetGroup será sujeitos aos requisitos mínimos dos recursos. Em outras palavras, você pode não inclua recursos ou 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. Para exemplo, é possível criar um recurso Campaign independente com uma advertising_channel_type de PERFORMANCE_MAX. Embora a solicitação para criar a campanha for bem-sucedida, ela só estará qualificada para veiculação depois que você adicionar pelo menos um AssetGroup à campanha. Se suas solicitações forem bem-sucedidas, mas sua campanha ou grupos de recursos não estão sendo veiculados, use CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus e AssetGroupPrimaryStatusReason para determinar o motivo, conforme detalhado nos solução de problemas guia.

Consulta inválida

Uma solicitação que não seria bem-sucedida porque colocaria a campanha ou para um estado inválido. Por exemplo, a API Google Ads gera um erro se você tente criar um AssetGroup para uma campanha que não seja de varejo sem incluir o recursos mínimos necessários. Isso é por que você precisa incluir uma AssetGroup e os recursos AssetGroupAsset dela no mesma solicitação. Isso também significa que todos os seus recursos AssetGroupAsset precisam atendam às especificações corretas para um determinado field_type para evitar que toda falha.

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

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

Sua campanha só estará qualificada para veiculação depois que você criar todas as os recursos necessários observados neste guia. Ao emitir solicitações, use os nomes de recursos reais dos recursos referenciados nas solicitações. Ao emitir solicitações mutate em massa que contêm várias operações, use nomes de recursos formados com o uso de IDs temporários.

Ordem de operações

Não importa se você usa uma solicitação de mutação em massa para criar uma campanha Performance Max campanha, você deve ordenar suas solicitações e operações de forma que nunca referenciar um recurso antes da criação. No caso de mutate em massa isso significa ordenar as operações para referenciar recursos são 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 dele, todos os A AssetOperations precisa vir antes de todo o AssetGroupAssetOperations, assim como são demonstradas no diagrama.

O servidor do Google Ads agrupa AssetGroupAssetOperations consecutivos e avalia se um AssetGroup atende aos requisitos mínimos de recursos a seguir a última operação nesse grupo. Se você alternar entre AssetOperations e AssetGroupAssetOperations na solicitação, o servidor da API avaliará requisitos mínimos de recursos após os primeiros 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 ao seu na sua conta do Google Ads. Além disso, nem a AssetGroup nem qualquer um dos AssetGroupAsset recursos serão criados.

Atualizar grupos de recursos

Depois de criar um AssetGroup válido, não é possível emitir solicitações subsequentes que resultaria 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), as solicitações para remover o AssetGroupAsset associados a esse MARKETING_IMAGE retornaria um erro.

Isso é importante principalmente no caso de grupos de recursos em campanhas de varejo. criados sem recursos associados. As próximas solicitações para adicionar recursos à AssetGroup criando recursos AssetGroupAsset só teria sucesso se o solicitação atendeu a todos os requisitos de recursos. Em outras palavras, não é possível adicionar recursos esses grupos de recursos de forma incremental.