Google Ads API は、Google 広告によって直接管理される自動アセットをサポートしています。API のスコープは、個々のアセットの一時停止または削除、統計情報の取得に限定されています。自動生成アセットの有効化と無効化は、Google 広告のウェブ インターフェースで行います。
作成と更新
アカウントでこの機能を有効にすると、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
レポートで確認できます。