ملاحظات الإصدار

الإصدار 0‏ (‎09/11/2026)

شرائح جديدة

سنضيف الشرائح التالية:

الإصدار 0 ‏(‎01/08/2026)

حقول جديدة

نحن بصدد إضافة synthetic_content_info إلى الموردَين ad وasset، بالإضافة إلى رسالة SyntheticContentInfo الداعمة والتعدادَين SyntheticContentAttestationStatus وSyntheticContentSource.

الإصدار 0‏ (‎10/03/2026)

شرائح جديدة

سنضيف الشرائح التالية:

الإصدار 0‏ (‎05/12/2025)

المقاييس الجديدة

تتوفّر الآن المقاييس التالية عند طلب المورد campaign:

سنضيف مقاييس "الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق" التالية:

شرائح جديدة

يمكن الآن تحديد تقسيم الرموز البريدية في طلب البحث. يمكنك الاطّلاع على مزيد من التفاصيل في segments.geo_target_postal_code.

الإصدار 0‏ (‎10/11/2025)

حقول عناوين URL الجديدة

نحن بصدد إضافة

مقاييس جديدة لـ UserLocationView

تتوفّر الآن المقاييس التالية عند طلب المورد user_location_view:

تصحيح اسم المورد

تم تصحيح نمط اسم المورد لموارد التصنيفات السارية التالية لاستخدام owner_customer_id لضمان احتوائه على رقم تعريف العميل الذي يملك التصنيف:

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • ‫CriterionEffectiveLabel (في AdGroupCriterionEffectiveLabel)
  • AdGroupAdEffectiveLabel

مثال: تم تغيير نمط CampaignEffectiveLabel من customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} إلى customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}.

v0 (2025-06-12)

يتضمّن هذا التحديث حقولاً جديدة لمورد العميل. يُرجى الحرص على تحديث مكتبة برامج العميل للاستفادة من كل هذه التغييرات.

حقول جديدة

نحن بصدد إضافة

للمساعدة في التنقّل في التدرّج الهرمي لحساب "إعلانات شبكة البحث 360".

الإصدار 0 (‎21/01/2025)

يتضمّن هذا التحديث مَعلمة جديدة لضبط توسيع نطاق "مركز عملائي".

توسيع نطاق "مركز عملائي"

عند الاستعلام عن bidding_strategy، يمكنك الآن ضبط قيمة منطقية (enable_mcc_expansion) في قسم PARAMETERS.

عند تفعيل هذه المَعلمة، يتم عرض البيانات من جميع الحسابات في التسلسل الهرمي للحسابات الذي يبدأ من customer_id في الاستجابة.

الإصدار 0‏ (‎08/11/2024)

يتضمّن هذا التحديث حقولاً ومراجع جديدة. احرص على تحديث مكتبة برامج العميل للاستفادة من جميع هذه التغييرات.

حقول جديدة

سنضيف ad_group_ad.effective_labels وad_group_criterion.effective_labels.

"التصنيفات السارية" هي تصنيفات مكتسَبة أو تم تعيينها مباشرةً.

موارد جديدة

طريقة عرض الموقع الجغرافي للمستخدم

وعند استخدامها مع الشرائح الجغرافية، يمكن الحصول على مقاييس ذات صلة بالمنطقة والمدينة.

اطّلِع على تفاصيل المورد user_location_view.

في ما يتعلّق بحقول effective_labels الجديدة، يتوفّر مصدران جديدان يحتفظان بالبيانات الوصفية للربط بين التصنيفات الفعّالة وad_group_ad (ad_group_ad_effective_label) أو ad_group_criterion (ad_group_criterion_effective_label).

الإصدار 0‏ (‎07/10/2024)

يتضمّن هذا التحديث مقاييس وموارد وحقولاً جديدة وبعض تعريفات الربط الجديدة. يُرجى الحرص على تحديث مكتبة برامج العميل للاستفادة من كل هذه التغييرات.

تمت إضافة المقاييس

  • cross_device_conversions_by_conversion_date: عدد الإحالات الناجحة العابرة للأجهزة حسب تاريخ الإحالة الناجحة.
  • cross_device_conversions_value_by_conversion_date: مجموع قيمة الإحالات الناجحة العابرة للأجهزة حسب تاريخ الإحالة الناجحة.
  • general_invalid_click_rate: النسبة المئوية للنقرات التي تم استبعادها من إجمالي عدد النقرات (النقرات التي تم استبعادها والنقرات التي لم يتم استبعادها) لأنّها نقرات غير صالحة عامة.
  • general_invalid_clicks: عدد النقرات غير الصالحة العامة

يتوافق cross_device_conversions_by_conversion_date وcross_device_conversions_value_by_conversion_date مع الموارد التالية: ad_group_ad وad_group_audience_view وad_group وbidding_strategy وcampaign وcustomer وcampaign_audience_view وkeyword_view وshopping_performance_view.

تمت إعادة تحديد عمليات ربط الحقول

تم تغيير عمليات ربط الحقول في dfaActions وdfaActionsCrossEnv وdfaRevenue وdfaRevenueCrossEnv وdfaTransactions وdfaTransactionsCrossEnv لبعض التقارير القديمة.

الحقل في السابق التعريف الجديد
dfaActions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaActionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date
dfaRevenue metrics.all_conversions_value - metrics.cross_device_conversions_value metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date
dfaRevenueCrossEnv metrics.all_conversions_value metrics.all_conversions_value_by_conversion_date
dfaTransactions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaTransactionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date

قائمة بالتقارير القديمة التي تم تغيير ربط الحقول فيها

حقول جديدة

سنضيف campaign.effective_labels وad_group.effective_labels.

"التصنيفات السارية" هي تصنيفات مكتسَبة أو تم تعيينها مباشرةً.

موارد جديدة

في ما يتعلّق بحقول effective_labels الجديدة، تحتفظ الموارد الجديدة بالبيانات الوصفية للربط بين التصنيفات الفعّالة و الحملة (campaign_effective_label) أو المجموعة الإعلانية (ad_group_effective_label).

الإصدار 0 (‎23/08/2024)

في هذا التحديث، تضيف البيانات الوصفية للأعمدة المخصّصة حقل renderType .

اطّلِع على تفاصيل CustomColumnRenderType.

تمت إضافة حقل owner_customer_id جديد إلى الموارد campaign_label وad_group_label وad_group_ad_label وad_group_criterion_label.

احرص على تعديل مكتبة برامج العميل للاستفادة من هذه الحقول الجديدة.

الإصدار 0 (‎01/08/2024)

يتضمّن هذا التحديث التقسيم حسب الساعة والعديد من الحقول الجديدة

التقسيم حسب الساعة

يمكن الآن تحديد التقسيم حسب الساعة في طلب البحث. يمكنك الاطّلاع على مزيد من التفاصيل في segments.hour.

يمكنك الاطّلاع على مزيد من التفاصيل في customer_manager_link.start_time

تمّت إضافة MULTIMEDIA_AD إلى ad_group_ad.ad.type

يمكن الآن اختيار المقاييس والشرائح باستخدام نوع MULTIMEDIA_AD. لا يمكن الاستعلام عن السمات الخاصة بالوسائط المتعددة في هذا الإصدار.

تمت إضافة نوع الحملة SOCIAL إلى campaign.advertising_channel_type والنوع الفرعي SOCIAL_FACEBOOK_TRACKING_ONLY إلى campaign.advertising_channel_sub_type

يمكن الآن اختيار المقاييس والشرائح مع نوع الحملة SOCIAL والنوع الفرعي SOCIAL_FACEBOOK_TRACKING_ONLY. لا يتوفّر في هذا الإصدار طلب البحث عن سمات محدّدة من SOCIAL أو SOCIAL_FACEBOOK_TRACKING_ONLY.

تمت إضافة إمكانية استخدام average_quality_score

يمكنك الاطّلاع على المزيد من التفاصيل في المقاييس.

الإصدار 0‏ (‎18/04/2024)

يتضمّن هذا التعديل مورد Accessible Bidding Strategy

استراتيجية عروض أسعار يمكن الوصول إليها

تمثّل طريقة عرض لاستراتيجيات عروض الأسعار التي يملكها العميل وتتم مشاركتها معه. على عكس BiddingStrategy، يتضمّن هذا المورد استراتيجيات يملكها مديرو العميل وتتم مشاركتها مع هذا العميل، بالإضافة إلى الاستراتيجيات التي يملكها هذا العميل. لا يوفّر هذا المورد مقاييس، ولا يعرض سوى مجموعة فرعية محدودة من سمات BiddingStrategy.

يُرجى الاطّلاع على تفاصيل مورد accessible_bidding_strategy.

الإصدار 0‏ (‎12/02/2024)

يتضمّن هذا التحديث إمكانية الوصول إلى الأعمدة المخصّصة ومتغيّرات Floodlight المخصّصة

الأعمدة المخصّصة

يمكن الآن تحديد أعمدة الإحالات الناجحة المخصّصة وأعمدة الصيغ المخصّصة في طلب بحث. يمكنك الاطّلاع على مزيد من التفاصيل في مستندات الأعمدة المخصّصة.

متغيرات Floodlight المخصصة

يمكن الآن تحديد متغيّرات Floodlight المخصّصة في طلب بحث، وذلك للإحصاءات بعد 30 يناير 2024. يمكنك الاطّلاع على مزيد من التفاصيل في مستندات متغيّرات Floodlight المخصّصة.

الإصدار 0‏ (‎09/11/2023)

يتضمّن هذا التحديث المراجع التالية. انتقِل إلى الروابط للاطّلاع على الحقول التي يمكن طلبها لهذه الموارد، والمقاييس وعمليات التقسيم التي يمكن استخدامها معها.

مجموعة مواد العرض

اطّلِع على تفاصيل مورد asset_group.

مادة عرض في مجموعة مواد العرض

اطّلِع على تفاصيل مورد asset_group_asset.

فلتر مجموعة بيانات في مجموعة مواد العرض

اطّلِع على تفاصيل المورد asset_group_listing_group_filter.

إشارة مجموعة مواد العرض

اطّلِع على تفاصيل المورد asset_group_signal.

طريقة عرض أفضل تركيبة لمجموعة مواد العرض

اطّلِع على تفاصيل مورد asset_group_top_combination_view.

طريقة عرض مبيعات بيانات سلة التسوّق

اطّلِع على تفاصيل المورد cart_data_sales_view.

الإحالة الناجحة

اطّلِع على تفاصيل مورد الإحالة الناجحة.

عرض أداء التسوّق

اطّلِع على تفاصيل المورد shopping_performance_view.

زيارة

اطّلِع على تفاصيل المورد visit.

الإصدار 0 (‎15/08/2023)

يتضمّن هذا التحديث المراجع التالية ومَعلمة جديدة لضبط تحويل العملات للمقاييس.

انتقِل إلى الروابط للاطّلاع على الحقول التي يمكن طلبها لهذه الموارد، والمقاييس وعمليات التقسيم التي يمكن استخدامها معها.

مادة عرض المجموعة الإعلانية

اطّلِع على تفاصيل مورد ad_group_asset.

مجموعة مواد عرض المجموعة الإعلانية

اطّلِع على تفاصيل مورد ad_group_asset_set.

مادة العرض

اطّلِع على تفاصيل مورد مادة العرض.

مجموعة مواد العرض

اطّلِع على تفاصيل مورد asset_set.

مادة عرض مجموعة مواد العرض

اطّلِع على تفاصيل مورد asset_set_asset.

مادة عرض الحملة

اطّلِع على تفاصيل مورد campaign_asset.

مجموعة مواد العرض للحملة

اطّلِع على تفاصيل المورد campaign_asset_set.

مادة عرض العميل

اطّلِع على تفاصيل مورد customer_asset.

مجموعة مواد عرض العميل

اطّلِع على تفاصيل المورد customer_asset_set.

تحويل أسعار العملات

يمكن تحديد العملة لحساب المقاييس باستخدام metrics_currency في قسم PARAMETERS.

عرض قائمة بالعملاء الذين يمكن الوصول إليهم

أدرِج جميع الحسابات التي يمكن الوصول إليها باستخدام طريقة ListAccessibleCustomers

الإصدار 0‏ (‎15/05/2023)

يتضمّن هذا التحديث المرجع التالي. انتقِل إلى الروابط للاطّلاع على الحقول التي يمكن طلبها لهذا المرجع، والمقاييس والتقسيمات التي يمكن استخدامها معه.

إعلان المجموعة الإعلانية

اطّلِع على تفاصيل مورد ad_group_ad.

الإصدار 0 (‎06/04/2023)

يتضمّن هذا التحديث المراجع التالية. انتقِل إلى الروابط للاطّلاع على الحقول التي يمكن طلبها لكل مورد، والمقاييس والتقسيمات التي يمكن استخدامها مع هذا المورد.

طريقة عرض الجمهور في المجموعة الإعلانية

اطّلِع على تفاصيل المورد ad_group_audience_view.

تصنيف معيار المجموعة الإعلانية

اطّلِع على تفاصيل مورد ad_group_criterion_label.

تصنيف المجموعة الإعلانية

اطّلِع على تفاصيل المورد ad_group_label.

عرض الفئة العمرية

اطّلِع على تفاصيل المورد age_range_view.

معيار الحملة

اطّلِع على تفاصيل المورد campaign_criterion.

تصنيف الحملة

اطّلِع على تفاصيل مورد campaign_label.

طريقة عرض عبارات البحث في "الإعلانات الديناميكية على شبكة البحث"

اطّلِع على تفاصيل المورد dynamic_search_ads_search_term_view.

مشاهدة صفحة ويب

اطّلِع على تفاصيل المورد webpage_view.

التصنيف

اطّلِع على تفاصيل مورد label.

الإصدار 0 (‎05/12/2022)

يتضمّن الإصدار v0 الموارد والخدمات التالية. انتقِل إلى الروابط للاطّلاع على الحقول التي يمكن طلبها لكل مورد، والمقاييس والتقسيمات التي يمكن استخدامها مع هذا المورد.

المجموعة الإعلانية

اطّلِع على تفاصيل مورد ad_group.

عروض الأسعار

اطّلِع على تفاصيل المورد bidding_strategy.

الحملات

اطّلِع على تفاصيل مورد الحملة.

إجراء الإحالة الناجحة

اطّلِع على تفاصيل المورد conversion_action.

العميل

اطّلِع على تفاصيل مورد العميل.

الكلمة الرئيسية

اطّلِع على تفاصيل مورد keyword_view.

مجموعة المنتجات

اطّلِع على تفاصيل مورد product_group_view.

SearchAds360FieldService

  • توفّر SearchAds360FieldService كتالوجًا لجميع الحقول التي يمكن طلبها. تتضمّن البيانات الوصفية في هذه الحقول الأوصاف والأنواع والتوافق مع الحقول الأخرى. مزيد من المعلومات

SearchAds360Service

  • تم تصميم SearchAds360Service لاسترداد موارد متعددة في طلب بحث واحد. تشمل الموارد التي يمكن البحث عنها ما يلي:

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • يمكن أيضًا استرداد المقاييس، مثل مرّات الظهور والنقرات، باستخدام SearchAds360Service لهذه الموارد:

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • SearchAds360Service تسمح بتقسيم البيانات حسب الحقول، مثل حقول التاريخ. مزيد من المعلومات