Reporting

アセットとその属性のリストを取得するには、Google 広告クエリ Language（GAQL）クエリを GoogleAdsService に渡します。アセット asset エンティティで表現され、 確認しましょう

アセットの属性

次の GAQL クエリは、広告主様のアカウントのすべてのアセットと リソースの名前とタイプを指定します。

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

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

たとえば、次のクエリでは、すべての動画の YouTube 動画 ID が YoutubeVideoAsset 個のオブジェクトが含まれる asset.type 値をフィルタする（ 使用可能な型の値の一覧については、ドキュメントをご覧ください）。 YoutubeVideoAsset。

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。このビューは収集します 広告ごとのアセットの指標を確認できますしたがって、このビューにクエリを実行すると、1 行あたり 広告グループと広告です

ad_group_ad_asset_view は、 ビュー固有の属性 そのperformance_label 特定のアセット広告のパフォーマンス特性に関する分析情報が得られる ペア設定できます。performance_label フィールドの有効な値が列挙されています。 表します。

performance_label説明
BESTパフォーマンスが特に高いアセット。
GOODパフォーマンスの高いアセットです。
LOW最もパフォーマンスが低いアセット。
LEARNINGアセットの取得が開始されました 統計的に有意なデータが少ないため アセットのパフォーマンスラベル
PENDINGこのアセットにはまだ何も設定されていません パフォーマンス情報が含まれます。原因としては、まだ審査中であることが考えられます。
UNKNOWNこのバージョンで不明な値を表します。
UNSPECIFIED指定されていません。

次の GAQL クエリは、次のコンバージョンの数のインプレッション数、クリック数、費用、コンバージョン数を返します。 先月のアカウントのすべてのアセットを 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
前へ
自動生成アセット
次へ
アセット