GoogleAdsService に Google 広告クエリ言語（GAQL）クエリを送信することで、アセットとそれらの属性の一覧を取得できます。アセットは 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 クエリは、Google 広告アカウントのすべてのアセットについて、過去 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
アセットのソース
Asset.source は、変更可能なアセットに対してのみ正確です。
RSA アセットのソースには ad_group_ad_asset_view.source を使用します。