Converter campanhas inteligentes em campanhas PMax

A partir da versão v25_2, a API Google Ads apresenta o método SmartCampaignSettingService.GeneratePMaxDraftCampaign para ajudar você a converter uma campanha inteligente em uma campanha Performance Max.

Como a conversão funciona

Quando você chama SmartCampaignSettingService.GeneratePMaxDraftCampaign, a API gera uma campanha Performance Max de rascunho com base na configuração de uma campanha inteligente atual.

A campanha de rascunho Performance Max gerada é inicializada com os seguintes valores de status:

Assim, você pode inspecionar, modificar e melhorar a campanha Performance Max, o orçamento, o grupo de recursos e os recursos gerados antes de ativar a campanha para veicular anúncios.

Parâmetros de solicitação

A mensagem GeneratePMaxDraftCampaignRequest aceita os seguintes campos:

  • resource_name (obrigatório): o nome do recurso da SmartCampaignSetting associada à campanha inteligente que você quer converter, no seguinte formato:

    customers/customer_id/smartCampaignSettings/campaign_id

  • validate_only (opcional): se true, a solicitação será validada, mas não executada. Somente erros de validação, avisos ou possíveis problemas de conversão são retornados no campo validated_info da resposta.

  • gbp_enabled (não disponível no momento): se o local do Perfil da Empresa no Google (GBP) associado à campanha inteligente será convertido e vinculado à campanha Performance Max gerada. Definir esse campo como true não está implementado no momento e vai retornar um erro GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

  • image_enabled (atualmente não disponível): se as imagens necessárias para a campanha Performance Max (como recursos de imagem horizontais, quadrados e de logotipo) serão geradas automaticamente. Definir esse campo como true não está implementado no momento e vai retornar um erro IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

Detalhes da resposta

A mensagem GeneratePMaxDraftCampaignResponse retorna os nomes de recursos da campanha de rascunho Performance Max recém-gerada e das entidades associadas:

  • pmax_campaign: o nome do recurso Campaign da campanha Performance Max gerada.
  • campaign_budget: o nome do recurso CampaignBudget vinculado à campanha Performance Max gerada.
  • asset_group: o nome do recurso AssetGroup vinculado à campanha Performance Max gerada.
  • assets: uma lista de nomes de recursos Asset vinculados à campanha Performance Max gerada.
  • validated_info: informações de validação adicionais ou possíveis problemas de conversão retornados quando validate_only é definido como true.

Para converter uma campanha inteligente, use o seguinte fluxo de trabalho:

  1. Gere a campanha de rascunho: chame SmartCampaignSettingService.GeneratePMaxDraftCampaign com apenas o conjunto resource_name obrigatório. Deixe gbp_enabled e image_enabled sem definição ou defina como false. Salve os nomes de recursos pmax_campaign, campaign_budget, asset_group e assets retornados.
  2. Analise e personalize a campanha: como a campanha Performance Max de rascunho é criada com status = PAUSED e creation_status = INCOMPLETE, inspecione e configure o orçamento, o grupo de recursos e os recursos dela.
  3. Ative a campanha: quando estiver tudo pronto para veicular anúncios, atualize o status da campanha para ENABLED e o creation_status para COMPLETE.