Converter campanhas inteligentes em campanhas PMax

Em v25 e versões mais recentes, você pode usar o SmartCampaignSettingService.GeneratePMaxDraftCampaign método para converter uma campanha inteligente em uma campanha Performance Max. Esse método não está disponível na v24 e versões anteriores.

Como a conversão funciona

Ao chamar SmartCampaignSettingService.GeneratePMaxDraftCampaign, a API gera uma campanha Performance Max de rascunho, um orçamento, um grupo de recursos e recursos, com base na configuração da campanha inteligente fornecida na solicitação. Depois de gerados, inspecione, modifique e melhore os novos recursos antes de ativar a campanha para veicular anúncios.

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

  • status é definido como PAUSED.
  • A qualificação para veiculação é refletida em primary_status.
  • contains_eu_political_advertising é definido como DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING por padrão (se ainda não tiver sido especificado na campanha inteligente). Verifique e atualize esse campo se a campanha contiver propaganda política da UE.

Isso permite 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.

Recursos de rascunho

A nova campanha é acompanhada por um grupo de imagens marcadoras de posição que precisam ser substituídas antes da ativação. Quando o campo image_enabled é compatível e definido como true na solicitação, a API gera imagens automaticamente em vez de usar imagens marcadoras de posição. Você pode inspecionar os novos recursos no campo assets da resposta e substituí-los seguindo estas etapas:

  1. Consulte o guia de requisitos de recursos.
  2. Faça o upload de novas imagens seguindo o exemplo de recurso de imagem de upload.
  3. Vincule os novos recursos ao grupo de recursos da campanha de rascunho e remova os AssetGroupAsset links para as imagens marcadoras de posição (na mesma solicitação de mutação atômica ou depois de vincular os novos recursos para que os requisitos mínimos de recursos permaneçam atendidos) seguindo o guia de grupos de recursos de link para recursos.

Parâmetros de solicitação

A mensagem GeneratePMaxDraftCampaignRequest aceita os seguintes campos:

  • resource_name (obrigatório): o nome do recurso do SmartCampaignSetting a ser regenerado para a campanha inteligente que você quer converter, no seguinte formato:

    customers/customer_id/smartCampaignSettings/campaign_id

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

  • gbp_enabled (não compatível): opcional. Se o local do Perfil da Empresa no Google (GBP) vinculado à campanha Performance Max será convertido. Deixe esse campo não definido ou false. A definição como true não é compatível e retorna um SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED erro.

  • image_enabled (não compatível): opcional. Se as imagens necessárias da campanha Performance Max serão geradas (como tipos de imagem horizontal, quadrada e de logotipo). Deixe esse campo não definido ou false. A definição como true não é compatível e retorna um SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED erro.

Detalhes da resposta

A mensagem GeneratePMaxDraftCampaignResponse retorna os nomes de recursos da campanha Performance Max de rascunho gerada e das entidades associadas a ela:

  • pmax_campaign: o nome do recurso Campaign da campanha Performance Max de rascunho 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 ou possíveis problemas de conversão retornados pela verificação de conversão (preenchidos quando validate_only é definido como true e junto com os nomes de recursos de entidade gerados quando validate_only é false).

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

  1. Gerar a campanha de rascunho: chame SmartCampaignSettingService.GeneratePMaxDraftCampaign com apenas o resource_name obrigatório definido (deixe gbp_enabled e image_enabled não definidos ou definidos como false). Salve os nomes de recursos pmax_campaign, campaign_budget, asset_group e assets retornados.
  2. Analisar e personalizar 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.
  3. Ativar a campanha e pausar a original: quando estiver tudo pronto para veicular anúncios, atualize o status da campanha Performance Max para ENABLED e, em seguida, atualize o status da campanha inteligente original para PAUSED para evitar a veiculação duplicada.