É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.

Renseignez-vous sur les composants et les exigences en matière de composants pour les campagnes Performance Max lorsque vous planifiez votre campagne.

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

Les composants peuvent être créés à l'aide de AdsApp sans utiliser de mutation, mais par souci de cohérence, ce guide procède de la même manière que toutes les autres opérations. Notez que vous pouvez et devez réutiliser les composants existants si vous en avez déjà. Par conséquent, bien que vous deviez disposer de composants pour créer une campagne Performance Max, il n'est pas strictement obligatoire de les créer dans le cadre du processus de création de la campagne.

Composants Texte

Les composants Texte fonctionnent comme n'importe quelle autre opération. Si vous importez des composants dans le cadre du processus de création de la campagne, utilisez un ID temporaire. Sinon, notez le nom de ressource renvoyé à utiliser dans une opération ultérieure 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 encodé en base64. Comme 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 à partir de Google Drive, vous devez d'abord disposer de 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 à partir de l'interface utilisateur Google Drive et extraire l'ID. Vous pouvez également récupérer une série de fichiers par programmation 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())
      }
    }
  }
}
operations.push(imageAsset);

Vous pouvez également récupérer une image hébergée sur un serveur Web par son URL à l'aide de 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.