Converter campanhas inteligentes em campanhas PMax

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

Como funciona a conversão

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

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

• status está definido como PAUSED.
• A qualificação de veiculação é mostrada 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 tiver propaganda política na UE.

Isso permite inspecionar, modificar e melhorar a campanha, 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 que a nova campanha seja ativada. 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 upload de novas imagens seguindo o exemplo de upload de recurso de imagem.
3. Vincule os novos recursos ao grupo de recursos da campanha de rascunho e remova os links AssetGroupAsset das 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 continuem sendo atendidos) seguindo o guia para vincular grupos de recursos a recursos.

Parâmetros de solicitação

Atenção: os parâmetros gbp_enabled e image_enabled não são compatíveis e causam erros se forem definidos como true em uma solicitação. Deixe os dois campos sem definição ou defina-os como false.

A mensagem GeneratePMaxDraftCampaignRequest aceita os seguintes campos:

• resource_name (obrigatório): o nome do recurso do SmartCampaignSetting a ser gerado novamente 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 são retornados no campo validated_info da resposta sem criar entidades de rascunho.

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

• image_enabled (não compatível): opcional. Se as imagens necessárias para a campanha Performance Max devem ser geradas (como imagens horizontais, quadradas e de logotipo). Deixe esse campo sem definição ou false. Não é possível definir como true, e isso retorna um erro SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

Detalhes da resposta

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

• 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 ao lado dos nomes de recursos de entidade gerados quando validate_only é false).

Fluxo de trabalho recomendado

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

1. Gere o rascunho da campanha: chame SmartCampaignSettingService.GeneratePMaxDraftCampaign com apenas o resource_name obrigatório definido (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 o rascunho da campanha Performance Max é criado com status = PAUSED e creation_status = INCOMPLETE, inspecione e configure o orçamento, o grupo de recursos e os recursos.
3. Ative a campanha e pause a original: quando estiver tudo pronto para veicular anúncios, atualize o status da campanha Performance Max para ENABLED e o status da campanha inteligente original para PAUSED. Isso evita a veiculação duplicada.

Observação: quando gbp_enabled e image_enabled forem ativados em uma versão futura, você também poderá migrar automaticamente os locais do Perfil da Empresa no Google e os recursos de imagem.