アセットとその属性のリストを取得するには、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