Converter campanhas inteligentes em campanhas PMax

Em v25 (a partir de v25.2), você pode 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 uma campanha Performance Max de rascunho com base na configuração de uma campanha inteligente.

A campanha de rascunho Performance Max gerada é inicializada com o status definido como PAUSED (e a qualificação para veiculação refletida em primary_status). Se todos os conversores de recursos falharem na validação da campanha inteligente, a solicitação vai falhar com um erro SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL.

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. A geração da campanha Performance Max em rascunho não modifica nem pausa a campanha inteligente original, que permanece ativa até que você a pause manualmente.

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 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 (indisponível): opcional. Se é necessário converter o local do Perfil da Empresa no Google (GBP) vinculado à campanha Performance Max. Deixe esse campo sem definição ou false. Definir como true não é implementado em v25 e retorna um erro SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

• image_enabled (indisponível): opcional. Se as imagens obrigatórias da campanha Performance Max devem ser geradas (como tipos de imagem horizontal, quadrada e de logotipo). Deixe esse campo sem definição ou false. Definir como true não é implementado em v25 e 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 do Performance Max 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).

Fluxo de trabalho recomendado

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

1. Gere 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. Analise e personalize a campanha: como a campanha Performance Max de rascunho é criada com status = PAUSED, inspecione e configure o orçamento, o grupo de recursos e os recursos dela.
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 para evitar a veiculação duplicada.