Google Ads API は、Google 広告で直接管理する自動アセットをサポートしています。API の範囲は個々のアセットの一時停止または削除、および統計情報の取得に限定されています。自動生成アセットのオプトインとオプトアウトは、Google 広告の管理画面で行います。
作成と更新
アカウントでこの機能を有効にすると、自動生成アセットは次のように作成されます。
- アセットが作成されます。
CampaignAsset
、AdGroupAsset
、CustomerAsset
オブジェクトは、アセットをキャンペーン、広告グループ、または顧客リソースにそれぞれ関連付けるために作成されます。
Google Ads API を使って自動生成アセットの作成や更新を行うことはできません。また、Google Ads API を使って自動生成アセットの CampaignAsset
、AdGroupAsset
、CustomerAsset
を作成することはできません。
自動生成アセットを対応するリソースに関連付ける CampaignAsset
、AdGroupAsset
、CustomerAsset
のエンティティを一時停止または削除できます。
関連付けを一時停止または削除する
関連付けを一時停止すると、対応するエンティティに対してアセットが一時的に配信されなくなります。関連付けを一時停止すると、管理画面または API から再度有効化しない限り、そのリソースに対して対応するアセットが自動的に再度有効化または配信されることはありません。アセットとリソースの関連付けを完全に無効にするには、関連付けを削除します。
Google 広告では、特定のエンティティに関連付けることができる特定のタイプの自動生成アセットの数に上限を設けています(例: キャンペーンあたりの自動生成サイトリンクの数)。一時停止された関連付けはこの制限にカウントされますが、削除された関連付けはカウントされません。自動生成アセットは、手動で追加したアセットの上限にカウントされません。
自動生成アセットを取得する
自動生成アセットデータを取得するには、AssetSource = AUTOMATICALLY_CREATED
でフィルタします。広告にリンクできるアセットについては、source
を確認します。広告にリンクできるアセットタイプの一覧については、AssetType
をご覧ください。
以下は、広告のアセットに対するクエリの例です。
SELECT
ad_group.name,
ad_group_ad_asset_view.asset,
ad_group_ad_asset_view.ad_group_ad
FROM ad_group_ad_asset_view
WHERE asset.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
の各レポートから取得できます。
アカウントで自動生成アセット機能を有効にしている場合は、自動生成アセットの過去の統計情報も feed_placeholder_view
レポートで確認できます。