Éléments

Avant de créer une campagne Demand Gen, 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 ultérieurement, mais vous avez besoin d'un ensemble de composants pour commencer.

Consultez le guide sur les spécifications et les bonnes pratiques concernant les composants Demand Gen asset lorsque vous planifiez votre campagne.

Les composants Image et Vidéo sont les principaux types de composants. 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.

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à. Ainsi, bien que vous deviez disposer de composants pour créer une campagne Demand Gen, il n'est pas strictement nécessaire de les créer dans le cadre du processus de création de la campagne.

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 avez d'abord besoin 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 depuis 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())
      }
    }
  }
}

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.

Composants Vidéo

Les composants Vidéo sont gérés via des vidéos YouTube. 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 videoAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing video",
      "type": "YOUTUBE_VIDEO",
      "youtube_video_asset": {
        "youtube_video_title": "Demand Gen video",
        "youtube_video_id": "123456789"
      }
    }
  }
}
operations.push(videoAsset);