Solução de problemas das campanhas Performance Max

Assim como nos relatórios das campanhas Performance Max, use GoogleAdsService.SearchStream para recuperar metadados de campanhas e grupos de recursos e resolver problemas comuns.

Solução de problemas da campanha

Quando sua campanha Performance Max não apresenta os resultados esperados, é possível que haja problemas específicos com anúncios, lances, segmentação, acompanhamento de conversões ou configurações da campanha. Consulte os guias a seguir para ver as etapas de solução de problemas:

Campanhas com diretrizes de marca ativadas

Use as diretrizes da marca para controlar como ela é representada nas campanhas Performance Max. Use Campaign.brand_guidelines_enabled para verificar se as diretrizes de marca foram ativadas em uma campanha.

As campanhas Performance Max com Campaign.brand_guidelines_enabled definido como true usam recursos de marca no nível da campanha (BUSINESS_NAME, LOGO e LANDSCAPE_LOGO) e precisam ter

  • Exatamente um recurso BUSINESS_NAME
  • Pelo menos um recurso de LOGO

Se você não vincular corretamente esses recursos CampaignAsset, vai receber um erro de CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED ou CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED, dependendo do tipo de recurso ausente. Esses erros podem ser acionados em campanhas com diretrizes de marca ativadas por qualquer uma das seguintes ações:

A tentativa de vincular recursos da marca no nível errado também vai gerar erros, que podem ser corrigidos da seguinte maneira:

Solução de problemas com grupos de recursos

Use os campos asset_group.primary_status e asset_group.primary_status_reasons para fornecer insights sobre a performance de um grupo de recursos.

SELECT
  asset_group.resource_name,
  asset_group.primary_status,
  asset_group.primary_status_reasons
FROM asset_group
WHERE asset_group.resource_name = "customers/CUSTOMER_ID/assetGroups/ASSET_GROUP_ID"

Da mesma forma, use os campos asset_group_asset.primary_status, asset_group_asset.primary_status_details, e asset_group_asset.primary_status_reasons para mostrar se um recurso do grupo de recursos está sendo veiculado ou os motivos de não estar.

SELECT
  asset_group_asset.resource_name,
  asset_group_asset.primary_status,
  asset_group_asset.primary_status_reasons,
  asset_group_asset.primary_status_details
FROM asset_group_asset
WHERE asset_group_asset.resource_name = "customers/CUSTOMER/assetGroupAssets/ASSET_GROUP_ID~ASSET_ID~FIELD_TYPE"

Erros comuns de grupo de recursos

Se a solicitação para criar um AssetGroup falhar com um AssetGroupError e um valor de enumeração que começa com NOT_ENOUGH, como AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET, isso significa que o AssetGroup não atendeu aos requisitos mínimos de recursos e não foi criado.

Por exemplo, um erro AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET sugere que a solicitação para criar um AssetGroup foi enviada sem o número mínimo de MARKETING_IMAGES, que é um neste caso. Para corrigir esse erro, reenvie sua solicitação para criar um AssetGroup como uma solicitação de mutação em massa usando o método GoogleAdsService.mutate que contenha um asset_group_operation e qualquer asset_group_asset_operations ausente, conforme demonstrado em Vincular grupos de recursos a recursos.

Neste exemplo, a lista de operações de mutação na solicitação de mutação em massa precisa incluir pelo menos um AssetGroupAsset com um field_type de MARKETING_IMAGE. O recurso referenciado pelo AssetGroupAsset também precisa atender às especificações de um MARKETING_IMAGE.

Da mesma forma, se a solicitação para criar um AssetGroup falhar com um AssetGroupError.SHORT_DESCRIPTION_REQUIRED, isso significa que o AssetGroup não tinha um recurso TEXT com 60 caracteres ou menos e um field_type de DESCRIPTION. As etapas para corrigir esse problema são as mesmas mostradas no exemplo NOT_ENOUGH_MARKETING_IMAGE_ASSET. No entanto, a solicitação precisa incluir pelo menos um AssetGroupAsset com um field_type de DESCRIPTION, e o recurso referenciado pelo AssetGroupAsset precisa ter 60 caracteres ou menos.

Consulte Erros comuns para ver uma lista de erros comuns e como corrigi-los.

Encontrar a origem do recurso para resolver problemas

As campanhas Performance Max são exclusivas porque veiculam anúncios com recursos enviados pelos anunciantes e gerados automaticamente pelo Google. Como anunciante, é útil saber a origem do recurso para resolver problemas ou avaliar a performance. Nesse caso, use o campo asset_group_asset.source da seguinte forma:

SELECT
  asset.id,
  asset.name,
  asset_group.id,
  asset_group_asset.source
FROM asset_group_asset
WHERE campaign.id = CAMPAIGN_ID

Valores de conversão da meta de aquisição de novos clientes

Os valores de conversão informados podem ser maiores do que os que você envia manualmente se tiver configurado a aquisição de novos clientes nas suas campanhas Performance Max ou de pesquisa. Se você selecionou o modo "Valor do novo cliente" (lance mais alto), o valor da vida útil de todos os novos clientes será adicionado ao valor da conversão da ação de conversão. O novo valor de vida útil do cliente está disponível apenas na interface da Web do Google Ads.

Se você precisar calcular os valores de conversão omitindo o valor de vida útil de todos os novos clientes, consulte o pseudocódigo a seguir. O novo valor de vida útil do cliente pode ser baixado na interface da Web do Google Ads.

nonNewCustomerAcquisitionConversionValueTotal = 0;
// For each campaign that has that conversion...
for (campaign in campaigns) {
  // If the new customer acquisition value is 'Bid higher', then subtract.
  if (bidHigher == true) {
    nonNewCustomerAcquisitionConversionValueTotal +=
        campaign.allConversionsValue - campaign.allNewCustomerLifetimeValue;
  }
  // If the new customer acquisition value is 'Only bid' or not set, then don't subtract.
  else {
    nonNewCustomerAcquisitionConversionValueTotal += campaign.allConversionsValue;
  }
}