Éléments

Avant de créer une campagne de génération de la demande, 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.

Consultez le guide des spécifications et bonnes pratiques pour les composants de génération de la demande lorsque vous planifiez votre campagne.

Les composants Image et Vidéo sont les principaux types de composants. Ce guide vous explique comment les importer. Ces principes peuvent également être étendus à d'autres types de composants. Quel que soit le type d'élément 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 pour toutes les autres opérations. Notez que vous pouvez et devez réutiliser les composants existants si vous en avez déjà. Vous devez disposer de composants pour créer une campagne de génération de la demande, mais vous n'êtes pas forcément obligé de les créer lors de la création de la campagne.

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'interface utilisateur 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 à partir 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.

Composants Vidéo

Le moyen le plus simple d'utiliser des composants vidéo est de passer par une vidéo YouTube. Si vous importez des composants lors de la création d'une 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);