アセット

P-MAX キャンペーンを作成する前に、キャンペーンで使用する予定のアセットをすべてインポートすることが重要です。アセットは後でいつでも追加できますが、始めるにはアセットのセットが必要です。

キャンペーンの計画時に、P-MAX キャンペーンのアセットとアセットの要件についてご確認ください。

テキスト アセットと画像アセットは、主な必須アセットタイプであるため、このガイドでは、それぞれをアップロードする方法について説明します。これらの原則は、他のアセットタイプにも適用できます。作成するアセットの種類に関係なく、AssetOperation を使用して作成します。

アセットは mutate を使用せずに AdsApp を使用して作成できますが、一貫性を保つため、このガイドでは他のすべてのオペレーションと同じ方法で作成します。既存のアセットが利用可能な場合は、再利用できます。そのため、P-MAX キャンペーンを作成するにはアセットが必要ですが、キャンペーンの作成プロセスの一環としてアセットを作成する必要があるとは限りません。

テキスト アセット

テキスト アセットは、他のオペレーションと同じように機能します。キャンペーン作成プロセスの一環としてアセットをアップロードする場合は、一時 ID を使用します。それ以外の場合は、返されたリソース名をメモしておきます。これは、アセットをアセット グループに追加するために参照する必要がある場合に、将来のオペレーションで使用します。

const textAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "textAsset": {
        "text": "Travel the World"
      }
    }
  }
}
operations.push(textAsset);

画像アセット

画像アセットは base-64 エンコード形式でアップロードされます。Google 広告スクリプトに画像を直接アップロードすることはできないため、画像データを取得してアップロード用にエンコードする方法は 2 つあります。

Google ドライブから画像を取得するには、まず画像の ID が必要です。これは、画像を一意に識別する最良の方法です。ID を取得する方法の 1 つは、Google ドライブの UI から共有可能なリンクをコピーして ID を抽出することです。一連のファイルをプログラムで取得し、アップロードするファイルを選択することもできます。このコードは、既知の ID を持つ単一の画像をアップロードする方法を示しています。

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())
      }
    }
  }
}

または、UrlFetchApp を使用して、ウェブサーバーでホストされている画像を URL で取得することもできます。

const file = UrlFetchApp.fetch(imageUrl);

このファイルに対して、Google ドライブ ファイルと同じように getBlob を呼び出すことができます。そのため、オペレーションの構築は Google ドライブ ファイルの手順と同じになります。