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

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

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

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

عند طلب 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. لا يمكن استخدام هذا الإصدار لطلب السمات المتعلّقة بالوسائط المتعددة.

تمت إضافة نوع الحملة "الشبكات الاجتماعية" إلى 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 المخصّصة".

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

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

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