Search Ads 360 Reporting API החדש זמין עכשיו. כדי להתעדכן לגבי השיפורים והגרסאות שצפויים בקרוב, הצטרפו לקבוצת Google
searchads-api-announcements.
אחזור מאפיינים ומדדים של נכסים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מאפייני נכסים
כדי לקבל רשימה של נכסים והמאפיינים שלהם, שולחים שאילתה בשפת השאילתות של Search Ads 360 אל SearchAds360Service.
הנכסים מיוצגים על ידי הישות asset
, שמציגה מספר שדות ספציפיים לנכס.
השאילתה הבאה מציגה את כל הנכסים בחשבון של המפרסם, יחד עם שם המשאב והסוג שלו.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
שימו לב שיש מאפיינים ספציפיים לסוג שאפשר להוסיף לשאילתה שלמעלה כדי לקרוא מאפיינים ספציפיים לנכסים, כמו SitelinkAsset
או MobileAppAsset
.
לדוגמה, השאילתה הבאה מפרטת את מזהי האפליקציות לנייד של כל האובייקטים MobileAppAsset
בחשבון, על ידי סינון הערך asset.type
של MobileAppAsset
.
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
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-29 (שעון UTC).
[null,null,["עדכון אחרון: 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"]]