アセット

アセットとは、画像、動画、広告見出し、説明文などの共有可能なデータの単位で、ディスプレイ広告、YouTube、アプリストアなど、複数のフォーマットでさまざまな種類の広告を作成するために使用されます。

オブジェクト

API の最も基本的なオブジェクトは次のとおりです。

  • Asset: 共有可能な広告データの単位
    • AssetType: アセットに含まれるコンテンツの種類(例: テキスト、画像)
    • AssetFieldType: アセットの使用方法(例: テキスト アセット タイプは、広告見出しや説明文のアセットのフィールド タイプとして使用できます)
  • AssetSet: テーマを中心とする、またはキャンペーンごとに分類されるアセットのコレクション
    • AssetSetType: アセットセットのクラス

アセット、アセットセット、広告グループ、キャンペーン、顧客間のリンクを表す次のオブジェクトが存在します。

  • アセットへのリンク設定

    • CustomerAsset: 顧客とアセット間のリンク
    • CampaignAsset: キャンペーンとアセット間のリンク
    • AdGroupAsset: 広告グループとアセット間のリンク
    • AssetSetAsset: アセットセットとアセット間のリンク
  • アセットセットへのリンク設定

    • CustomerAssetSet: 顧客とアセットセット間のリンク
    • CampaignAssetSet: キャンペーンとアセットセット間のリンク
    • AdGroupAssetSet: 広告グループとアセットセット間のリンク

キャンペーン アセットの例

オブジェクトの一部をリンクする方法を視覚的に表したものを以下に示します。この例は最上部のキャンペーンから開始していますが、同じ階層が顧客と広告グループにも適用されています。

CampaignAssetSet を作成する前に、Campaign と、1 つ以上のアセットを含む AssetSet を作成する必要があります。アセットを組み合わせて、キャンペーンに適用可能なすべての広告フォーマットの広告枠を作成することも、広告が配信されるチャネル(YouTube、Gmail、検索など)に基づいて利用可能なアセットを組み合わせることもできます。

広告にリンクされているアセットタイプ

一部のアセットタイプは広告に直接リンクできます。

アセットタイプ AssetFieldType 広告タイプ
動画 YOUTUBE_VIDEO
MASTHEAD_COMPANION_VIDEO
アプリ広告
アプリ エンゲージメント広告
ローカル広告
レスポンシブ ディスプレイ広告
メディア バンドル メディア バンドル
カスタム レイアウト
アプリ広告
ディスプレイ アップロード広告
画像 MARKETING_IMAGE
SQUARE_MARKETING_IMAGE
LOGO
LANDSCAPE_LOGO
PORTRAIT_MARKETING_IMAGE
アプリ広告
アプリ エンゲージメント広告
ローカル広告
レスポンシブ ディスプレイ広告
テキスト HEADLINE
LONG_HEADLINE
DESCRIPTION
MANDATORY_AD_TEXT
CALL_TO_ACTION_SELECTION
BUSINESS_NAME
アプリ広告
アプリ エンゲージメント広告
ローカル広告
レスポンシブ ディスプレイ広告
レスポンシブ検索広告
スマート アシスト キャンペーン広告
行動を促すフレーズ CALL_TO_ACTION ローカル広告
レスポンシブ ディスプレイ広告

顧客、キャンペーン、広告グループにリンクされるアセットタイプ

一部のタイプのアセットは、リンケージ オブジェクトを介して顧客、キャンペーン、広告グループにリンクできます。

アセットタイプ AssetFieldType リンク 変更可
テキスト BUSINESS_NAME CampaignAsset ×
画像 AD_IMAGE キャンペーン アセット
広告グループ アセット
×
画像 BUSINESS_LOGO CampaignAsset ×
リードフォーム LEAD_FORM CampaignAsset
プロモーション プロモーション CustomerAsset
CampaignAsset
AdGroupAsset
コールアウト CALLOUT CustomerAsset
CampaignAsset
AdGroupAsset
構造化スニペット STRUCTURED_SNIPPET CustomerAsset
CampaignAsset
AdGroupAsset
サイトリンク SITELINK CustomerAsset
CampaignAsset
AdGroupAsset
モバイルアプリ MOBILE_APP CustomerAsset
CampaignAsset
AdGroupAsset
ホテルのコールアウト HOTEL_CALLOUT CustomerAsset
CampaignAsset
AdGroupAsset
電話 CALL CustomerAsset
CampaignAsset
AdGroupAsset
Price PRICE CustomerAsset
CampaignAsset
AdGroupAsset

住所アセット

住所アセットは、他のアセットタイプとは異なる方法で処理されます。詳しくは、住所アセットをご覧ください。

自動作成アセット

自動作成アセットは変更できません。AssetSource は、アセットがユーザーによって作成されたものか、システムによって自動的に生成されたものかを示します。サイトリンクなどの変更可能なタイプは、自動作成アセットにリンクできません。

アセットセットにリンクされるアセットタイプ

一部のアセットタイプは、特定のタイプのアセットセットにリンクできます。

AssetType AssetSetType リンク 変更可
PAGE_FEED PAGE_FEED CampaignAssetSet
DYNAMIC_EDUCATION DYNAMIC_EDUCATION CampaignAssetSet
DYNAMIC_CUSTOM DYNAMIC_CUSTOM CampaignAssetSet
DYNAMIC_HOTELS_AND_RENTALS DYNAMIC_HOTELS_AND_RENTALS CampaignAssetSet
DYNAMIC_REAL_ESTATE DYNAMIC_REAL_ESTATE CampaignAssetSet
DYNAMIC_LOCAL DYNAMIC_LOCAL CampaignAssetSet
DYNAMIC_FLIGHTS DYNAMIC_FLIGHTS CampaignAssetSet
DYNAMIC_JOBS DYNAMIC_JOBS CampaignAssetSet
DYNAMIC_TRAVEL DYNAMIC_TRAVEL CampaignAssetSet
LOCATION LOCATION_SYNC CustomerAssetSet
CampaignAssetSet
AdGroupAssetSet
いいえ(システム生成)
GMB_DYNAMIC_LOCATION_GROUP CampaignAssetSet
AdGroupAssetSet
CHAIN_DYNAMIC_LOCATION_GROUP CampaignAssetSet
AdGroupAssetSet
STATIC_LOCATION_GROUP CampaignAssetSet
AdGroupAssetSet