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

Se a sua campanha Performance Max não estiver apresentando os resultados esperados, talvez haja problemas específicos com os 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 as diretrizes de marca ativadas

Use as diretrizes da marca para controlar como sua marca é 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 propriedades da 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 esses recursos do CampaignAsset quando necessário, poderá receber um erro 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 as diretrizes de marca ativadas por qualquer uma das seguintes ações:

  • Criar um novo Campaign sem fornecer BUSINESS_NAME e LOGO como recursos CampaignAsset na mesma solicitação.
  • Remover um ou mais recursos de CampaignAsset que fariam com que a campanha deixasse de atender aos requisitos mínimos de propriedade da marca.
  • Vincular recursos personalizados obrigatórios no nível do grupo de recursos a uma campanha Performance Max de varejo sem recursos sem fornecer todos os recursos CampaignAsset necessários na mesma solicitação. (Vincular apenas recursos personalizados opcionais, como YOUTUBE_VIDEO, também exige os requisitos mínimos do grupo de recursos e os links de marca CampaignAsset necessários para que o grupo de recursos não entre em um estado não compatível que bloqueie as edições na interface do Google Ads.)

Tentar vincular propriedades da marca no nível errado também vai gerar erros, que podem ser corrigidos da seguinte forma:

Solução de problemas do grupo 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 está sendo veiculado ou os motivos para 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 em grupos de recursos

Se a solicitação para criar um AssetGroup ou atualizar os recursos AssetGroupAsset vinculados falhar com um NOT_ENOUGH_*_ASSET AssetGroupError (como AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET), seu AssetGroup não atende aos requisitos mínimos de recursos. Esse erro ocorre quando você cria um AssetGroup padrão sem os recursos obrigatórios, vincula recursos personalizados obrigatórios a um AssetGroup de varejo sem recursos, sem fornecer todos os recursos obrigatórios, ou remove recursos obrigatórios sem desvincular todos os recursos personalizados em uma única solicitação de varejo. (Vincular apenas recursos personalizados opcionais, como YOUTUBE_VIDEO, também exige todos os recursos mínimos necessários para que o grupo de recursos não entre em um estado incompatível que bloqueie as edições na interface do Google Ads.)

Por exemplo, um erro AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET indica que a solicitação foi enviada sem o número mínimo de recursos MARKETING_IMAGE (um, neste caso). Para corrigir esse erro, envie sua solicitação como uma solicitação de mutação em massa usando o método GoogleAdsService.Mutate que contém o asset_group_operation (ao criar um novo grupo de recursos) e todas as entradas asset_group_asset_operation necessárias, 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 até 60 caracteres.

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 únicas porque veiculam anúncios com recursos enviados pelos anunciantes e gerados automaticamente pelo Google. Como anunciante, pode ser ú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 você 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" (definir lances mais altos), o valor da vida útil de todos os novos clientes será adicionado ao valor da conversão da sua ação de conversão. O valor de vida útil de todos os novos clientes 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 valor de vida útil de todos os novos clientes 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;
  }
}
Anterior
Otimizações
Avançar
Erros comuns ao trabalhar com campanhas Performance Max