Componentes obrigatórios da Pesquisa

Para gerar uma nova campanha de pesquisa do zero, é necessário criar pelo menos o seguinte:

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. Consulte o guia de recursos de pesquisa para saber como os recursos podem ser criados usando scripts.

Confira se você conhece a estratégia de mutação, já que este guia só vai fornecer 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 a 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 referenciar um orçamento. Portanto, você vai precisar do nome exato do recurso de orçamento criado na etapa anterior para identificar e usar esse objeto de orçamento específico. Use a CampaignOperation. Neste exemplo, também definimos o AiMaxSetting 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 referenciar a 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 que possa ser usado ao criar palavras-chave e anúncios do grupo de anúncios. Use an 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. Elas são adicionadas como critérios a um grupo de anúncios usando AdGroupCriterionOperation. Você precisa referenciar o 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 referenciar o grupo de anúncios. 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 criá-los na mesma operação. O exemplo mostrado aqui cria um anúncio responsivo de pesquisa usando ResponsiveSearchAdInfo. Isso exige que os recursos de texto para títulos e descrições tenham sido criados, conforme mostrado no guia de 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);
Anterior
Recursos
Avançar
Componentes opcionais