Componentes obrigatórios da Pesquisa

Para gerar uma campanha de pesquisa do zero, é preciso criar pelo menos o seguinte:

• Um orçamento
• A campanha em si
• Um grupo de anúncios
• Palavras-chave
• Um anúncio do grupo de anúncios que contém um anúncio

A campanha e o orçamento são úteis para criar todos os tipos de campanha, enquanto algumas configurações nos anúncios do grupo de anúncios são especificamente úteis para criar campanhas de pesquisa. Acesse o guia de pesquisa de recursos para saber como eles podem ser criados usando scripts.

Confira se você conhece a estratégia de mutação, já que este guia vai fornecer apenas os objetos JavaScript a serem usados nas mutações.

Orçamento

O orçamento não pode ser compartilhado e precisa ter um nome exclusivo na sua conta. Use um CampaignBudgetOperation para criar seu orçamento.

const budgetOperation = {
  "campaignBudgetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/campaignBudgets/${getNextTempId()}`,
      "name": "Search campaign budget",
      "amountMicros": "10000000",
      "deliveryMethod": "STANDARD",
      "explicitlyShared": false
    }
  }
}
operations.push(budgetOperation);

Campanha

A campanha precisa fazer referência a um orçamento. Por isso, você vai precisar do nome exato do recurso de orçamento criado na etapa anterior para identificar e usar esse objeto específico. Use um CampaignOperation. Neste exemplo, também definimos o AiMaxSetting como true para ativar a IA Max para pesquisa e o NetworkSettings.

const campaignOperation = {
  "campaignOperation": {
    "create": {
      "resourceName": `customers/${customerId}/campaigns/${getNextTempId()}`,
      "name": "Search campaign",
      "status": "PAUSED",
      "advertisingChannelType": "SEARCH",
      "campaignBudget": budgetOperation.campaignBudgetOperation.create.resourceName,
      "biddingStrategyType": "MANUAL_CPC",
      "startDate": "20240314",
      "endDate": "20250313",
      "manualCpc": {
        "enhancedCpcEnabled": true
      },
      "aiMaxSetting": {
        "enableAiMax": true
      },
      "networkSettings": {
        "targetGoogleSearch": true,
        "targetSearchNetwork": true
      },
      "containsEuPoliticalAdvertising": "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
    }
  }
}
operations.push(campaignOperation);

Grupo de anúncios

O grupo de anúncios precisa fazer referência à campanha criada anteriormente. Portanto, você vai precisar do nome exato do recurso definido na etapa anterior para identificar a campanha criada anteriormente nesta solicitação. Você também vai precisar de um ID temporário para o grupo de anúncios, que é melhor armazenado como uma nova variável para ser usado ao criar palavras-chave e anúncios do grupo. Use um AdGroupOperation.

const adGroupId = getNextTempId();
const adGroupOperation = {
  "adGroupOperation": {
    "create": {
      "resourceName": `customers/${customerId}/adGroups/${adGroupId}`,
      "name": "Search ad group",
      "status": "PAUSED",
      "campaign": campaignOperation.campaignOperation.create.resourceName,
      "type": "SEARCH_STANDARD"
    }
  }
}
operations.push(adGroupOperation);

Palavras-chave

As palavras-chave são necessárias para acionar seus anúncios nos resultados da pesquisa. Eles são adicionados como critérios a um grupo de anúncios usando AdGroupCriterionOperation. É necessário fazer referência ao grupo de anúncios criado na etapa anterior.

const keywordOperation = {
  "adGroupCriterionOperation": {
    "create": {
      "adGroup": adGroupOperation.adGroupOperation.create.resourceName,
      "status": "ENABLED",
      "keyword": {
        "text": "flowers",
        "matchType": "BROAD"
      }
    }
  }
}
operations.push(keywordOperation);

Anúncio do grupo de anúncios com anúncio

Esta etapa cria um anúncio do grupo de anúncios, que une um grupo de anúncios a um anúncio. O anúncio do grupo de anúncios precisa fazer referência ao grupo. Portanto, você vai precisar do nome exato do recurso definido na etapa anterior. Você pode criar um anúncio na mesma operação e usar recursos de texto criados anteriormente ou criar recursos na mesma operação. O exemplo mostrado aqui cria um anúncio responsivo de pesquisa usando ResponsiveSearchAdInfo. Para isso, é necessário criar recursos de texto para títulos e descrições, conforme mostrado no guia Recursos.

Para criar o anúncio do grupo de anúncios, use um AdGroupAdOperation.

const adGroupAdOperation = {
  "adGroupAdOperation": {
    "create": {
      "resourceName": `customers/${customerId}/adGroupAds/${adGroupId}~${getNextTempId()}`,
      "adGroup": adGroupOperation.adGroupOperation.create.resourceName,
      "status": "PAUSED",
      "ad": {
        "name": "Search RSA ad",
        "finalUrls": [
          "http://www.example.com"
        ],
        "responsiveSearchAd": {
          "headlines": [
            {
              "text": textAsset.assetOperation.create.resourceName
            },
            {
              "text": "Headline 2"
            },
            {
              "text": "Headline 3"
            }
          ],
          "descriptions": [
            {
              "text": "Description 1"
            },
            {
              "text": "Description 2"
            }
          ]
        }
      }
    }
  }
}
operations.push(adGroupAdOperation);