アセットの属性と指標の取得

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

アセット属性

アセットとその属性の一覧を取得するには、Google 広告サービスに Google 広告クエリ言語(GAQL)クエリを送信します。アセットは、asset エンティティによって表され、アセット固有のフィールドをいくつか公開します。

次の GAQL クエリは、広告主のアカウントのすべてのアセットをリソース名と種類とともにリストします。

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.type
FROM asset

ImageAssetYoutubeVideoAsset などのアセットに固有のプロパティを読み取るために、上記のクエリに追加できるタイプ固有の属性があります。

たとえば、次のクエリは、asset.typeasset.type 値(使用可能な型値のリストに関するドキュメントを参照)をフィルタすることで、アカウント内のすべての YoutubeVideoAsset オブジェクトの YouTube 動画 ID を一覧表示します。

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'

アセットの指標

アセット指標はいくつかのリソースで利用できます。

これらのリソースを使用して、それぞれのレベルでアセット指標をクエリできます。たとえば、ad_group_asset リソースをクエリする場合は、ad_group.id フィールドを使用して結果をセグメント化し、ad_groupasset の一意の組み合わせごとに指標を取得できます。

SELECT
  ad_group.id,
  asset.id,
  metrics.clicks,
  metrics.impressions
FROM ad_group_asset
WHERE segments.date DURING LAST_MONTH
ORDER BY metrics.impressions DESC

広告レベルの指標

アセットに関する広告レベルのパフォーマンス指標は、ad_group_ad_asset_view に集約されます。このビューでは、個々の広告についてアセットの指標が収集されます。このビューに対してクエリを実行すると、広告グループと広告ごとに 1 行が返されます。

ad_group_ad_asset_view でビュー固有の属性 performance_label が公開され、この特定のアセットと広告の組み合わせのパフォーマンス特性がわかります。次の表に、performance_label フィールドに指定できる値を示します。

performance_label説明
BEST成果の高いアセット
GOODパフォーマンスの高いアセット
LOWパフォーマンスの低いアセット。
LEARNINGアセットはインプレッションを獲得し始めていますが、アセットのパフォーマンス ラベルを取得するのに十分な統計的有意性がありません。
PENDINGこのアセットにはパフォーマンス情報がまだありません。審査中である可能性もあります。
UNKNOWNこのバージョンで不明な値を表します。
UNSPECIFIED指定されていません。

次の GAQL クエリは、アカウント内のすべてのアセットの過去 1 か月間のインプレッション数、クリック数、費用、コンバージョン数を performance_label で並べ替えて返します。

SELECT
  ad_group_ad_asset_view.ad_group_ad,
  ad_group_ad_asset_view.asset,
  ad_group_ad_asset_view.field_type,
  ad_group_ad_asset_view.performance_label,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions
FROM ad_group_ad_asset_view
WHERE segments.date DURING LAST_MONTH
ORDER BY ad_group_ad_asset_view.performance_label