Componenti obbligatori della Ricerca

Per generare una nuova campagna sulla rete di ricerca da zero, devi creare almeno i seguenti elementi:

La campagna e il budget sono utili per creare tutti i tipi di campagne, mentre alcune impostazioni degli annunci dei gruppi di annunci saranno utili in particolare per creare campagne sulla rete di ricerca. Consulta la guida agli asset di ricerca per scoprire come creare asset utilizzando gli script.

Assicurati di conoscere la strategia di modifica, poiché questa guida fornisce solo gli oggetti JavaScript da utilizzare nelle modifiche.

Budget

Il budget non deve essere condiviso e deve avere un nome univoco nel tuo account. Utilizza un CampaignBudgetOperation per creare il tuo budget.

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

Campagna

La campagna deve fare riferimento a un budget, quindi avrai bisogno del nome esatto della risorsa budget che hai creato nel passaggio precedente per identificare e utilizzare l'oggetto budget specifico. Utilizza un CampaignOperation. In questo esempio impostiamo anche AiMaxSetting per attivare AI Max per la rete di ricerca e 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);

Gruppo di annunci

Il gruppo di annunci deve fare riferimento alla campagna creata in precedenza, quindi dovrai utilizzare il nome esatto della risorsa impostato nel passaggio precedente per identificare la campagna creata in precedenza in questa richiesta. Avrai anche bisogno di un ID temporaneo per il gruppo di annunci, che è meglio memorizzare come nuova variabile in modo che possa essere utilizzato durante la creazione di parole chiave e annunci del gruppo di annunci. Utilizza un 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);

Parole chiave

Le parole chiave sono necessarie per attivare i tuoi annunci nei risultati di ricerca. Vengono aggiunti come criteri a un gruppo di annunci utilizzando AdGroupCriterionOperation. Devi fare riferimento al gruppo di annunci creato nel passaggio precedente.

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

Annuncio del gruppo di annunci con annuncio

Questo passaggio crea un annuncio del gruppo di annunci, che unisce un gruppo di annunci a un annuncio. L'annuncio del gruppo di annunci deve fare riferimento al gruppo di annunci, quindi avrai bisogno del nome esatto della risorsa impostato nel passaggio precedente. Puoi creare un annuncio all'interno della stessa operazione e utilizzare asset di testo creati in precedenza o crearli anche all'interno della stessa operazione. L'esempio mostrato qui crea un annuncio adattabile della rete di ricerca utilizzando ResponsiveSearchAdInfo. Per farlo, è necessario aver creato gli asset di testo per i titoli e le descrizioni, come mostrato nella guida Asset.

Per creare l'annuncio del gruppo di annunci, utilizza 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);