أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google
searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
جلب سمات ومقاييس مواد العرض
سمات مواد العرض
يمكنك الحصول على قائمة بمواد العرض والسمات من خلال إرسال طلب بحث في لغة طلبات البحث في "إعلانات شبكة البحث 360" إلى SearchAds360Service.
يتم تمثيل مواد العرض من خلال العنصر asset
الذي يعرِض
عددًا من الحقول المتعلّقة بمواد العرض.
يسرد طلب البحث التالي جميع مواد العرض في حساب المعلِن مع
اسم المورد ونوعه.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
يُرجى العِلم أنّ هناك سمات خاصة بالنوع يمكنك إضافتها إلى query (الطلب) أعلاه لقراءة السمات الخاصة بمواد العرض، مثل
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 و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-23 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-23 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Retrieve a list of assets and their attributes, including resource name and type, using Search Ads 360 Query Language."],["Access type-specific attributes, such as mobile app IDs, by filtering the `asset.type` value in your query."],["Query asset metrics at the ad group, campaign, or customer level through respective resources like `ad_group_asset`, `campaign_asset`, and `customer_asset`."],["Segment asset metric results by fields like `ad_group.id` to analyze performance for specific combinations of assets and ad groups, campaigns, or customers."]]],["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"]]