Yeni Search Ads 360 Reporting API kullanıma sunuldu. Yaklaşan geliştirmeler ve sürümlerden haberdar olmak için
searchads-api-announcements Google grubuna katılın.
Öğe Özellikleri ve Metrikleri getiriliyor
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Öğe özellikleri
SearchAds360Service'e bir Search Ads 360 Sorgu Dili sorgusu göndererek öğelerin ve özelliklerinin listesini alabilirsiniz.
Öğeler, öğeye özgü bir dizi alanı gösteren asset
öğesiyle temsil edilir.
Aşağıdaki sorgu, bir reklamverenin hesabındaki tüm öğeleri, kaynak adları ve türleriyle birlikte listeler.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
SitelinkAsset
veya MobileAppAsset
gibi öğelere özgü özellikleri okumak için yukarıdaki sorguya ekleyebileceğiniz türe özgü özellikler olduğunu unutmayın.
Örneğin, aşağıdaki sorgu, MobileAppAsset
için asset.type
değerini filtreleyerek bir hesaptaki tüm MobileAppAsset
nesnelerinin mobil uygulama kimliklerini listeler.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.mobile_app_asset.app_store
FROM asset
WHERE asset.type = 'MOBILE_APP'
Öğe metrikleri
Öğe metrikleri birkaç kaynak üzerinden sunulur:
Bu kaynaklar sayesinde öğe metrikleri ilgili her düzeyde sorgulanabilir.
Örneğin, ad_group_asset
kaynağı sorgulanırken ad_group.id
alanı, sonuçları segmentlere ayırmak için kullanılabilir. Böylece, her bir benzersiz ad_group
ve asset
kombinasyonu için metrikler alınır:
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
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-29 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-29 UTC."],[[["\u003cp\u003eRetrieve a list of assets and their attributes, including resource name and type, using Search Ads 360 Query Language.\u003c/p\u003e\n"],["\u003cp\u003eAccess type-specific attributes, such as mobile app IDs, by filtering the \u003ccode\u003easset.type\u003c/code\u003e value in your query.\u003c/p\u003e\n"],["\u003cp\u003eQuery asset metrics at the ad group, campaign, or customer level through respective resources like \u003ccode\u003ead_group_asset\u003c/code\u003e, \u003ccode\u003ecampaign_asset\u003c/code\u003e, and \u003ccode\u003ecustomer_asset\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSegment asset metric results by fields like \u003ccode\u003ead_group.id\u003c/code\u003e to analyze performance for specific combinations of assets and ad groups, campaigns, or customers.\u003c/p\u003e\n"]]],["Assets and their attributes can be retrieved by sending a Search Ads 360 Query Language query to the SearchAds360Service, using the `asset` entity. Type-specific attributes can be added to queries. Asset metrics are available through `ad_group_asset`, `campaign_asset`, and `customer_asset` resources, enabling queries at various levels. For example, metrics can be retrieved for each unique combination of `ad_group` and `asset` using `ad_group_asset` resource.\n"],null,["# Fetching Asset Attributes and Metrics\n\nAsset attributes\n----------------\n\nYou can get a list of assets and their attributes by sending a [Search Ads 360\nQuery Language query](/search-ads/reporting/query/query-language) to the SearchAds360Service.\nAssets are represented by the [`asset`](/search-ads/reporting/api/reference/fields/v0/asset) entity, which exposes a\nnumber of asset-specific fields.\n\nThe following query lists all assets in an advertiser's account along with\ntheir resource name and type. \n\n SELECT\n asset.id,\n asset.name,\n asset.resource_name,\n asset.type\n FROM asset\n\nNote that there are type-specific attributes that you could add to the above\nquery to read properties specific to assets such as\n[`SitelinkAsset`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.common#unifiedsitelinkasset) or\n[`MobileAppAsset`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.common#mobileappasset).\n\nFor example, the following query lists the mobile app IDs for all\n[`MobileAppAsset`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.common#mobileappasset) objects in an account by\nfiltering the [`asset.type`](/search-ads/reporting/api/reference/fields/v0/asset#asset.type) value for\n[`MobileAppAsset`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.common#mobileappasset). \n\n SELECT\n asset.id,\n asset.name,\n asset.resource_name,\n asset.mobile_app_asset.app_store\n FROM asset\n WHERE asset.type = 'MOBILE_APP'\n\nAsset metrics\n-------------\n\nAsset metrics are made available through a few resources:\n\n- [`ad_group_asset`](/search-ads/reporting/api/reference/fields/v0/ad_group_asset)\n- [`campaign_asset`](/search-ads/reporting/api/reference/fields/v0/campaign_asset)\n- [`customer_asset`](/search-ads/reporting/api/reference/fields/v0/customer_asset)\n\nWith these resources, asset metrics can be queried at each respective level.\nFor instance, when querying the `ad_group_asset` resource, the `ad_group.id`\nfield can be used to segment the results, thereby retrieving metrics for each\nunique combination of `ad_group` and `asset`: \n\n SELECT\n ad_group.id,\n asset.id,\n metrics.clicks,\n metrics.impressions\n FROM ad_group_asset\n WHERE segments.date DURING LAST_MONTH\n ORDER BY metrics.impressions DESC"]]