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

الإصدار v0 (2026-08-01)

الحقول الجديدة

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

الإصدار v0 (2026-03-10)

الشرائح الجديدة

نحن بصدد إضافة الشرائح التالية:

الإصدار v0 (2025-12-05)

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

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

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

الشرائح الجديدة

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

الإصدار v0 (2025-11-10)

حقول عناوين 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".

الإصدار v0 (2025-01-21)

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

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

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

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

الإصدار v0 (2024-11-08)

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

الحقول الجديدة

نحن بصدد إضافة 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).

الإصدار v0 (2024-10-07)

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

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

  • 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).

الإصدار v0 (2024-08-23)

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

يمكنك الاطّلاع على تفاصيل CustomColumnRenderType.

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

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

الإصدار v0 (2024-08-01)

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

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

يمكن الآن تحديد التقسيم حسب الساعة في طلب بحث. يمكنك الاطّلاع على مزيد من التفاصيل في 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

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

الإصدار v0 (2024-04-18)

يتضمّن هذا التحديث مَورد استراتيجية عروض الأسعار التي يمكن الوصول إليها.

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

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

يمكنك الاطّلاع على تفاصيل مَورد accessible_bidding_strategy.

الإصدار v0 (2024-02-12)

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

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

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

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

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

الإصدار v0 (2023-11-09)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يمكنك الاطّلاع على تفاصيل مَورد conversion.

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

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

زيارة

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

الإصدار v0 (2023-08-15)

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

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

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

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

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

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

مادة العرض

يمكنك الاطّلاع على تفاصيل مَورد asset.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الإصدار v0 (2023-05-15)

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

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

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

الإصدار v0 (2023-04-06)

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

عرض شرائح الجمهور على مستوى المجموعة الإعلانية

يمكنك الاطّلاع على تفاصيل مَورد 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.

الإصدار v0 (2022-12-05)

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

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

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

عروض الأسعار

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

الحملات

يمكنك الاطّلاع على تفاصيل مَورد campaign.

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

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

العميل

يمكنك الاطّلاع على تفاصيل مَورد customer.

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

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

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

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

SearchAds360FieldService

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

SearchAds360Service