Composants requis de la recherche

Pour générer une campagne sur le Réseau de Recherche à partir de zéro, vous devez au minimum créer les éléments suivants :

La campagne et le budget sont utiles pour créer tous les types de campagnes, tandis que certains paramètres des annonces du groupe d'annonces seront particulièrement utiles pour créer des campagnes sur le Réseau de Recherche. Consultez le guide sur la recherche de composants pour découvrir comment créer des composants à l'aide de scripts.

Assurez-vous de bien connaître la stratégie de mutation, car ce guide ne fournit que les objets JavaScript à utiliser dans les mutations.

Budget

Le budget ne doit pas être partagé et doit avoir un nom unique dans votre compte. Utilisez CampaignBudgetOperation pour créer votre budget.

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

Campagne

La campagne doit faire référence à un budget. Vous aurez donc besoin du nom exact de la ressource budgétaire que vous avez créée à l'étape précédente pour identifier et utiliser cet objet budgétaire spécifique. Utilisez un CampaignOperation. Dans cet exemple, nous définissons également AiMaxSetting pour activer AI Max pour le Réseau de Recherche et 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);

Ad group

Le groupe d'annonces doit faire référence à la campagne créée précédemment. Vous aurez donc besoin du nom de ressource exact que vous avez défini à l'étape précédente pour identifier la campagne créée précédemment dans cette requête. Vous aurez également besoin d'un ID temporaire pour le groupe d'annonces lui-même. Il est préférable de le stocker en tant que nouvelle variable afin de pouvoir l'utiliser lors de la création de mots clés et d'annonces de groupe d'annonces. Utilisez 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);

Mots clés

Les mots clés sont nécessaires pour déclencher la diffusion de vos annonces dans les résultats de recherche. Ils sont ajoutés en tant que critères à un groupe d'annonces à l'aide de AdGroupCriterionOperation. Vous devez faire référence au groupe d'annonces créé à l'étape précédente.

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

Annonce au niveau du groupe d'annonces avec annonce

Cette étape permet de créer une annonce de groupe d'annonces, qui associe un groupe d'annonces à une annonce. L'annonce du groupe d'annonces doit faire référence au groupe d'annonces. Vous aurez donc besoin du nom de ressource exact que vous avez défini à l'étape précédente. Vous pouvez créer une annonce dans la même opération et utiliser des composants Texte créés précédemment ou les créer dans la même opération. L'exemple présenté ici crée une annonce responsive sur le Réseau de Recherche à l'aide de ResponsiveSearchAdInfo. Pour ce faire, vous devez avoir créé des composants Texte pour les titres et les descriptions, comme indiqué dans le guide Composants.

Pour créer l'annonce du groupe d'annonces, utilisez 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);