Éléments

Avant de créer une campagne Performance Max, il est important d'importer tous les composants que vous prévoyez d'utiliser dans la campagne. Vous pourrez toujours revenir en arrière et ajouter des composants plus tard, mais vous avez besoin d'un ensemble de composants pour commencer.

Lorsque vous planifiez votre campagne, lisez les articles sur les composants et les exigences liées aux composants pour les campagnes Performance Max.

Étant donné que les composants Texte et Image sont les principaux types de composants requis, ce guide vous montrera comment importer chacun d'eux. Ces principes peuvent également être étendus à d'autres types d'assets. Quel que soit le type de composant que vous créez, utilisez AssetOperation.

Il est possible de créer des composants à l'aide de AdsApp sans utiliser mutate, mais par souci de cohérence, ce guide procède de la même manière que pour toutes les autres opérations. Notez que vous pouvez et devez réutiliser les composants existants si vous en avez déjà. Ainsi, même si vous devez disposer de composants pour créer une campagne Performance Max, vous n'êtes pas forcément obligé de les créer lors de la création de la campagne.

Composants Texte

Les composants Texte fonctionnent comme n'importe quelle autre opération. Si vous importez des composants lors de la création d'une campagne, utilisez un ID temporaire. Sinon, notez le nom de la ressource renvoyée pour l'utiliser dans une future opération lorsque vous devrez faire référence au composant pour l'ajouter à un groupe de composants.

const textAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "textAsset": {
        "text": "Travel the World"
      }
    }
  }
}
operations.push(textAsset);

Composants Image

Les composants Image sont importés au format base64. Étant donné que vous ne pouvez pas importer d'images directement dans les scripts Google Ads, vous avez le choix entre deux approches différentes pour obtenir les données d'image et les encoder pour l'importation.

Pour récupérer une image depuis Google Drive, vous devez d'abord obtenir son ID, qui est le meilleur moyen d'identifier l'image de manière unique. Pour obtenir l'ID, vous pouvez copier le lien partageable depuis l'UI Google Drive et extraire l'ID. Vous pouvez également récupérer une série de fichiers de manière programmatique et sélectionner ceux que vous souhaitez importer. Ce code montre comment importer une seule image avec un ID connu :

const file = DriveApp.getFileById(fileId);
const imageAsset =  {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing Logo",
      "type": "IMAGE",
      "imageAsset": {
        "data": Utilities.base64Encode(file.getBlob().getBytes())
      }
    }
  }
}

Vous pouvez également récupérer une image hébergée sur un serveur Web à l'aide de son URL en utilisant UrlFetchApp :

const file = UrlFetchApp.fetch(imageUrl);

Vous pouvez ensuite appeler getBlob sur ce fichier comme vous le feriez avec un fichier Drive. La construction de l'opération est donc identique à celle d'un fichier Google Drive.