レポート

Google 広告クエリ言語（GAQL）クエリを GoogleAdsService に送信することで、アセットとそれらの属性の一覧を取得できます。アセットは asset エンティティで表されます。このエンティティはいくつかのアセット固有のフィールドを公開します。

アセットの属性

次の GAQL クエリは、リソースの名前とタイプとともに Google 広告アカウント内のすべてのアセットを一覧表示します。

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

このクエリにタイプ固有の属性を追加して、アセットに固有のプロパティ（例: ImageAsset、YoutubeVideoAsset）を読み取ることができます。

たとえば、次のクエリでは asset.type 値をフィルタすることによって、Google 広告アカウント内のすべての YoutubeVideoAsset オブジェクトの YouTube 動画 ID を一覧表示します。使用可能な asset.type 値のリストをご覧ください。

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_group と asset の一意の各組み合わせに対して指標を取得できます。

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 は、アプリ広告、デマンド ジェネレーション、レスポンシブ検索広告に関連するアセットの情報のみを返します。

アセットの広告単位のパフォーマンス指標は、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 か月間の Google 広告アカウントのすべてのアセットのインプレッション数、クリック数、費用、コンバージョン数を 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

アセットのソース

Asset.source は、変更可能なアセットに対してのみ正確です。

RSA アセットのソースには ad_group_ad_asset_view.source を使用します。

前へ
動画をアップロード