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

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

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

حقول جديدة

نحن بصدد إضافة ad_group_ad.effective_labels وad_group_criterion.effective_labels.

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

موارد جديدة

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

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

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

في ما يتعلّق بالحقول المحسّنة للتصنيفات الفعّالة، هناك موردان جديدان يحافظان على البيانات الوصفية للارتباط بين التصنيفات الفعّالة والسمة 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. لا يمكن تنفيذ طلبات بحث عن السمات المتعلّقة بالوسائط المتعددة في هذا الإصدار.

تمت إضافة نوع الحملة "الشبكات الاجتماعية" إلى campaign.advertising_channel_type والنوع الفرعي SOCIAL_FACEBOOK_TRACKING_ONLY إلى campaign.advertising_channel_sub_type.

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

إتاحة استخدام average_quality_score

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

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

تتضمّن هذه التعديلات مرجع "استراتيجية عروض الأسعار السهلة الاستخدام".

استراتيجية عروض الأسعار السهلة الاستخدام

تمثّل عرضًا لـ "استراتيجيات عروض الأسعار" التي يملكها العميل ويشاركها معه. في مقابل 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.

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

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

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

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

انتقال

يُرجى الانتقال إلى تفاصيل المرجع.

الإصدار 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‏ نيسان/أبريل 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.

التصنيف

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

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