Componentes obligatorios de la Búsqueda

Para generar una campaña de Búsqueda nueva desde cero, debes crear, como mínimo, los siguientes elementos:

• Un presupuesto
• La campaña en sí
• Un grupo de anuncios
• Palabras clave
• Un anuncio del grupo de anuncios que contiene un anuncio

La campaña y el presupuesto son útiles para crear todo tipo de campañas, mientras que algunos parámetros de configuración dentro de los anuncios del grupo de anuncios serán especialmente útiles para crear campañas de Búsqueda. Visita la guía de recursos de búsqueda para ver cómo se pueden crear recursos con secuencias de comandos.

Asegúrate de conocer la estrategia de mutación, ya que esta guía solo proporcionará los objetos de JavaScript que se usarán en las mutaciones.

Presupuesto

El presupuesto no debe ser compartido y debe tener un nombre único en tu cuenta. Usa un CampaignBudgetOperation para crear tu presupuesto.

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

Campaña

La campaña debe hacer referencia a un presupuesto, por lo que necesitarás el nombre exacto del recurso de presupuesto que creaste en el paso anterior para identificar y usar ese objeto de presupuesto específico. Usa un CampaignOperation. En este ejemplo, también configuramos AiMaxSetting para habilitar IA Max para campañas de Búsqueda y 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 anuncios

El grupo de anuncios debe hacer referencia a la campaña creada anteriormente, por lo que necesitarás el nombre exacto del recurso que estableciste en el paso anterior para identificar la campaña creada anteriormente en esta solicitud. También necesitarás un ID temporal para el grupo de anuncios, que es mejor almacenar como una variable nueva para que se pueda usar cuando crees palabras clave y anuncios del grupo de anuncios. Usa un objeto 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);

Palabras clave

Se requieren palabras clave para activar tus anuncios en los resultados de la búsqueda. Se agregan como criterios a un grupo de anuncios con AdGroupCriterionOperation. Debes hacer referencia al grupo de anuncios creado en el paso anterior.

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

Anuncio del grupo de anuncios con anuncio

En este paso, se crea un anuncio del grupo de anuncios, que une un grupo de anuncios con un anuncio. El anuncio del grupo de anuncios debe hacer referencia al grupo de anuncios, por lo que necesitarás el nombre del recurso exacto que estableciste en el paso anterior. Puedes crear un anuncio en la misma operación y usar recursos de texto creados anteriormente o crearlos en la misma operación. En el ejemplo que se muestra aquí, se crea un anuncio de búsqueda responsivo con ResponsiveSearchAdInfo. Para ello, es necesario que se hayan creado recursos de texto para los títulos y las descripciones, como se muestra en la guía de Recursos.

Para crear el anuncio del grupo de anuncios, usa un 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);