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

الإصدار 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}.

الإصدار 0 (2025-06-12)

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

حقول جديدة

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

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

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

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

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

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

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

الإصدار 0 (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).

الإصدار 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 (2024-08-23)

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

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

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

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

الإصدار 0 (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

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

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

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

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

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

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

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

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

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

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

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

يمكن الآن تحديد متغيّرات Floodlight المخصّصة في طلب بحث للحصول على إحصاءات بعد 30/01/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.

زيارة

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

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

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

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

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

اطّلِع على تفاصيل مورد 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 (2023-05-15)

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

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

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

الإصدار 0 (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.

التصنيف

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

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

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

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

اطّلِع على تفاصيل مورد 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 تقسيم البيانات حسب الحقول، مثل حقول التاريخ. مزيد من المعلومات