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 intégrées à un groupe sont particulièrement utiles pour créer des campagnes sur le Réseau de Recherche. Consultez le guide sur les composants sur le Réseau de Recherche 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 un 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 de budget que vous avez créée à l'étape précédente pour identifier et utiliser cet objet de budget spécifique. Utilisez un CampaignOperation. Dans cet exemple, nous définissons également AiMaxSetting pour activer AI Max pour les campagnes sur le Réseau de Recherche, ainsi que 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);

Groupe d'annonces

Le groupe d'annonces doit faire référence à la campagne créée précédemment. Vous aurez donc besoin du nom exact de la ressource 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, qu'il est préférable de stocker en tant que nouvelle variable afin de pouvoir l'utiliser lors de la création de mots clés et d'annonces intégrées à un groupe. 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 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 intégrée à un groupe avec annonce

Cette étape crée une annonce intégrée à un groupe, qui associe un groupe d'annonces à une annonce. L'annonce intégrée à un groupe doit faire référence au groupe d'annonces. Vous aurez donc besoin du nom exact de la ressource 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 cela, des composants Texte pour les titres et les descriptions doivent avoir été créés, comme indiqué dans le guide sur les composants.

Pour créer l'annonce intégrée à un groupe, 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);
Précédent
Éléments
Suivant
Composants facultatifs