アセットとその属性のリストを取得するには、Google 広告クエリ言語(GAQL)クエリを GoogleAdsService に送信します。アセットは asset
エンティティで表されます。このエンティティは多くのアセット固有のフィールドを公開します。
アセットの属性
次の GAQL クエリは、リソースの名前とタイプとともに広告主のアカウント内のすべてのアセットを一覧表示します。
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
前述のクエリに追加して、アセットに固有のプロパティ(例: ImageAsset
、YoutubeVideoAsset
)を読み取るようにできるタイプ固有の属性があります。
たとえば、次のクエリは YoutubeVideoAsset
の asset.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_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