自動生成アセット

Google Ads API は、Google 広告で直接管理される自動アセットをサポートしています。API のスコープは、個々のアセットの一時停止または削除と、統計情報の取得に限定されています。自動生成アセットの有効化と無効化は、Google 広告のウェブ インターフェースで行います。

作成と更新

この機能が有効になっているアカウントでは、Google 広告によって次のように自動生成アセットが作成されます。

  1. アセットが作成されます。
  2. CampaignAsset、AdGroupAsset、CustomerAsset オブジェクトが作成され、アセットがそれぞれキャンペーン、広告グループ、顧客リソースに関連付けられます。

Google Ads API を使用して自動生成アセットを作成または更新することはできません。また、Google Ads API を使用して自動生成アセットの CampaignAsset、AdGroupAsset、CustomerAsset を作成することもできません。

自動生成アセットを対応するリソースに関連付ける CampaignAsset、AdGroupAsset、CustomerAsset エンティティを一時停止または削除できます。

関連付けを一時停止または削除する

関連付けを一時停止すると、対応するエンティティに対してアセットが一時的に配信されなくなります。関連付けを一時停止すると、ウェブ インターフェースまたは API で再度有効にするまで、Google 広告がそのリソースに対して対応するアセットを自動的に再度有効にしたり、配信したりすることはありません。アセットとリソースの関連付けを完全に無効にするには、関連付けを削除します。

Google 広告では、特定のエンティティ(キャンペーンあたりの自動生成アセットの数など)に関連付けることができる特定のタイプの自動生成アセットの数に上限が適用されます。一時停止中の関連付けはこの上限にカウントされますが、削除された関連付けはカウントされません。自動生成アセットは、手動で追加されたアセットの上限にはカウントされません。

自動生成アセットを取得する

自動生成アセットのデータを取得するには、AssetSource = AUTOMATICALLY_CREATED でフィルタします。広告にリンクできるアセットについては、アセットの source を確認します。広告にリンクできるアセットタイプの一覧については、AssetType をご覧ください。

広告内のアセットを対象としたクエリの例を次に示します。

SELECT
  ad_group.name,
  ad_group_ad_asset_view.asset,
  ad_group_ad_asset_view.ad_group_ad,
  ad_group_ad_asset_view.source
FROM ad_group_ad_asset_view
WHERE ad_group_ad_asset_view.source = 'AUTOMATICALLY_CREATED'

他のタイプのアセットの場合は、Asset リソースを直接クエリします。

SELECT
  asset.id,
  asset.name
FROM asset
WHERE asset.source = 'AUTOMATICALLY_CREATED'

レポート

アセットのパフォーマンス統計情報は、asset_field_type_view レポートからリクエストできます。このレポートには、自動的に追加された広告アセットと手動で追加された広告アセットの両方の集計データが含まれます。

個々のアセットのパフォーマンス統計情報は、campaign_asset、customer_asset、ad_group_asset の各レポートから取得できます。