Componentes opcionais das campanhas Performance Max

Metas de conversão

Quando você cria uma campanha Performance Max, uma série de metas de conversão é criada automaticamente de acordo com os CustomerConversionGoals na conta. Você pode personalizar essas configurações especificamente para cada uma das suas campanhas Performance Max atualizando-as.

Para fazer isso, primeiro busque o ID da campanha das suas campanhas Performance Max e uma lista de todas as metas de conversão do cliente. Veja um exemplo de como mudar as metas de uma campanha, mas você também pode configurar seu código para percorrer várias campanhas Performance Max.

// Query for a campaign by name. Update this logic to pull the campaigns you'd
// like to edit
const campaignName = "My PMax campaign";
let campaignId = "";

const search = AdsApp.search(`SELECT campaign.id FROM campaign WHERE campaign.name = "${campaignName}"`);
if (search.hasNext()) {
  campaignId = search.next().campaign.id;
  console.log(`Updating conversion goals for ${campaignName}: ${campaignId}`);
}
else
{
  console.log(`No campaign named "${campaignName}" found`);
  // Perform further error handling here
}

// Query for a list of customer conversion goals
const searchResults = AdsApp.search(
  `SELECT
     customer_conversion_goal.category,
     customer_conversion_goal.origin
   FROM customer_conversion_goal`
);

Em seguida, você pode iterar todas as metas de conversão recebidas e criar uma operação de atualização para a campanha Performance Max atual, personalizando a segmentação de cada meta. O exemplo de código mostrado mais adiante nesta seção define todas as metas como lances, mas você precisa personalizar essa parte da lógica para corresponder ao que quer alcançar com sua campanha.

Recomendamos configurar as metas de conversão em uma transação separada do restante do processo de criação da campanha. CampaignConversionGoalOperation exige que partialFailure para a solicitação seja definido como false. Se você quiser executar esse código na mesma transação em que cria a campanha, desative a falha parcial para todo o conjunto de operações. Este exemplo de código demonstra como realizar essa operação em uma transação separada.

operations = [];
while (searchResults.hasNext()) {
  const row = searchResults.next();
  const conversionGoal = row.customerConversionGoal;

  operations.push({
    "campaignConversionGoalOperation": {
      "update": {
        "resourceName": `customers/${customerId}/campaignConversionGoals/${campaignId}~${conversionGoal.category}~${conversionGoal.origin}`,
        // Insert your logic here to determine whether you want this particular
        // campaign conversion goal to be biddable or not.
        // This code will just default everything to being biddable, but that
        // is not necessarily best for your use case.
        "biddable": true
      },
      "updateMask": "biddable"
    }
  });
}

AdsApp.mutateAll(operations, {partialFailure: false});

Segmentação da campanha

Para segmentação de campanhas Performance Max, consulte o guia da API para ver uma lista completa dos tipos de critérios permitidos.

Não é necessário usar outros critérios para criar uma campanha Performance Max, mas eles podem ser úteis para restringir a segmentação com base no seu caso de uso. O próximo exemplo de código mostra como configurar um local de segmentação por região geográfica. Consulte a documentação do CampaignCriterion para saber o formato de outros tipos de critérios.

É possível criar esses critérios junto com a própria campanha como parte da mesma chamada para mutateAll. Este exemplo de código pressupõe que você está estruturando seu código dessa forma.

operations.push({
  "campaignCriterionOperation": {
    "create": {
      "campaign": campaignOperation.campaignOperation.create.resourceName,
      "negative": false,
      "location": {
        // 1023191 represents New York City
        "geoTargetConstant": "geoTargetConstants/1023191"
      }
    }
  }
});

Indicadores do grupo de recursos

Leia sobre os indicadores de grupo de recursos na documentação da API antes de começar. Eles são configurados vinculando um grupo de recursos a um critério AudienceInfo ou SearchThemeInfo. Se você quiser usar um público-alvo, especifique o campo audience em vez do campo searchTheme com o nome do recurso do público-alvo.

operations.push({
  "assetGroupSignalOperation": {
    "create": {
      "assetGroup": assetGroupOperation.assetGroupOperation.create.resourceName,
      "searchTheme": {
        "text": "mars cruise"
      }
    }
  }
});