アセットの属性と指標の取得

アセットの属性

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

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

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

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

たとえば、次のクエリでは MobileAppAsset で asset.type 値をフィルタすることによって、アカウント内のすべての MobileAppAsset オブジェクトのモバイルアプリ ID を一覧表示します。

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.mobile_app_asset.app_store
FROM asset
WHERE asset.type = 'MOBILE_APP'

アセットの指標

アセットの指標はいくつかのリソースによって利用可能になります。

これらのリソースによって、各レベルでアセットの指標をクエリできます。たとえば、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