É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 lors de la planification de 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.

Vous pouvez 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 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, même si vous devez 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é pour l'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 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 à 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 à 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.