É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 et ajouter des composants plus tard, mais vous avez besoin d'un ensemble de composants pour commencer.

Consultez les composants et les exigences concernant les 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 requis, ce guide vous explique comment importer chacun d'eux. Ces principes peuvent également s'appliquer à d'autres types d'assets. Quel que soit le type d'élément 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 le fait 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 forcément nécessaire de les créer au cours 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 la ressource renvoyée à utiliser dans une future opération lorsque vous devrez référencer le 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);

Compléments Image

Les composants Image sont importés au format encodé en 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 connaître son ID, qui est le meilleur moyen de l'identifier de manière unique. Pour obtenir l'ID, vous pouvez copier le lien partageable depuis l'UI Google Drive et l'extraire. Vous pouvez également extraire 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())
      }
    }
  }
}

Vous pouvez également extraire une image hébergée sur un serveur Web à l'aide de 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.