سجلّ التغييرات في واجهة برمجة التطبيقات لإعداد تقارير المسارات المتعدّدة القنوات في "إحصاءات Google"

نعمل بشكل دوري على تعديل واجهة برمجة التطبيقات لإعداد تقارير المسارات المتعدّدة القنوات في "إحصاءات Google" بهدف تقديم ميزات جديدة وإصلاح العيوب التي تم اكتشافها في الإصدارات السابقة. وفي معظم الحالات، ستكون هذه التغييرات واضحة لمطوّري واجهة برمجة التطبيقات. وفي بعض الأحيان، نحتاج إلى إجراء تغييرات تتطلّب من المطوّرين تعديل تطبيقاتهم الحالية.

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

الاشتراك في سجلات التغييرات ذات الصلة

جميع سجلات التغييرات في Google Analytics API
–
اشتراك rss

يتضمّن كل واجهات برمجة التطبيقات للجمع والضبط وإعداد التقارير.

جميع سجلّات التغييرات في واجهة برمجة التطبيقات Reporting API
–
اشتراك rss

يتضمّن الإصدار Core Reporting API وواجهة برمجة التطبيقات لإعداد تقارير المسارات المتعدّدة القنوات وواجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي.

سجلّ التغييرات في MCF Reporting API
–
اشتراك rss

يضيف هذا الإصدار سمة جديدة إلى واجهة برمجة التطبيقات. اطّلِع على مرجع السمات والمقاييس للحصول على القائمة الكاملة للتعريفات.

معرِّف المعاملة

  • السمة - mcf:transactionId - معرِّف المعاملة، الذي يتم توفيره من خلال طريقة تتبع التجارة الإلكترونية، لعملية الشراء في سلة التسوق.

يضيف هذا الإصدار سمات ومقاييس جديدة إلى واجهة برمجة التطبيقات. اطّلِع على مرجع المقاييس والسمات للحصول على القائمة الكاملة للتعريفات.

مسارات الإحالات الناجحة

  • السمة - mcf:dcmAd - اسم إعلان DCM لحدث DCM (الظهور أو النقرة) الذي يطابق الإحالة الناجحة في "إحصاءات Google".
  • السمة - mcf:dcmAdPath - مسار الإحالة الناجحة حيث تمثل إعلانات DCM التفاعلات التي تحدث ضمن المسار.
  • السمة - mcf:dcmAdType - اسم نوع إعلان DCM لحدث DCM (الظهور أو النقرة) الذي يطابق الإحالة الناجحة في "إحصاءات Google".
  • السمة - mcf:dcmAdvertiser - اسم معلن DCM لحدث DCM (الظهور أو النقرة) الذي يطابق الإحالة الناجحة في "إحصاءات Google".
  • السمة - mcf:dcmAdvertiserPath - مسار الإحالة الناجحة حيث يمثل المعلِنون في DCM التفاعلات التي تحدث ضمن المسار.
  • السمة - mcf:dcmCampaign - اسم حملة DCM لحدث DCM (الظهور أو النقرة) الذي يطابق الإحالة الناجحة في "إحصاءات Google".
  • السمة - mcf:dcmCampaignPath - مسار الإحالة الناجحة حيث تمثل حملات DCM التفاعلات التي تحدث ضمن المسار.
  • السمة - mcf:dcmCreative - اسم تصميم الإعلان في DCM لحدث DCM (الظهور أو النقرة) الذي يطابق الإحالة الناجحة في "إحصاءات Google".
  • السمة - mcf:dcmCreativePath - مسار الإحالة الناجحة حيث تمثل تصميمات إعلانات DCM التفاعلات التي تحدث ضمن المسار.
  • السمة - mcf:dcmCreativeVersion - إصدار تصميم الإعلان في DCM لحدث DCM (الظهور أو النقرة) الذي يطابق الإحالة الناجحة في "إحصاءات Google".
  • السمة - mcf:dcmCreativeVersionPath - مسار الإحالة الناجحة حيث تمثل إصدارات تصميمات الإعلانات في DCM التفاعلات التي تحدث ضمن المسار.
  • البُعد - mcf:dcmNetwork - الشبكة المستخدمة.
  • السمة - mcf:dcmPlacement - اسم موضع الإعلان على الموقع الإلكتروني في DCM لحدث DCM (الظهور أو النقرة) الذي يطابق الإحالة الناجحة في "إحصاءات Google".
  • السمة - mcf:dcmPlacementPath - مسار الإحالة الناجحة حيث تمثل مواضع DCM التفاعلات التي تحدث ضمن المسار.
  • السمة - mcf:dcmSite - اسم الموقع الإلكتروني في DCM حيث تم عرض تصميم إعلان DCM لحدث DCM (الظهور أو النقرة) الذي يطابق الإحالة الناجحة في "إحصاءات Google".
  • البُعد - mcf:dcmSitePath - مسار الإحالة الناجحة حيث تمثل مواقع DCM التفاعلات التي تحدث ضمن المسار.
  • المقياس - mcf:firstImpressionConversions - عدد الإحالات الناجحة التي كانت فيها مرة ظهور حملة DCM هي أول تفاعل للإحالة الناجحة في فترة معاينة إعلان مدتها 30 يومًا. يشمل هذا البُعد كلاً من الأهداف المكتملة والمعاملات.
  • المقياس - mcf:firstImpressionValue - قيمة الإحالات الناجحة التي كانت فيها مرة ظهور حملة DCM هي أول تفاعل للإحالة الناجحة في فترة معاينة إعلان مدتها 30 يومًا. يشمل هذا البُعد كلاً من الأهداف المكتملة والمعاملات.
  • المقياس - mcf:impressionAssistedConversions - عدد الإحالات الناجحة التي ظهرت لها مرة ظهور لحملة DCM على مسار الإحالة الناجحة، ولكنها لم تكن تفاعل الإحالة الناجحة النهائي. يشمل هذا البُعد كلاً من الأهداف المكتملة والمعاملات.
  • المقياس - mcf:impressionAssistedValue - قيمة الإحالات الناجحة التي ظهرت لها مرة ظهور لحملة DCM في مسار الإحالة الناجحة، ولكنها لم تكن تفاعل الإحالة الناجحة النهائي. يشمل هذا البُعد كلاً من الأهداف المكتملة والمعاملات.

يضيف هذا الإصدار سمات ومقاييس جديدة إلى واجهة برمجة التطبيقات. اطّلِع على مرجع المقاييس والسمات للحصول على القائمة الكاملة للتعريفات.

مسارات الإحالات الناجحة

  • السمة - mcf:adwordsCustomerIDPath - سلسلة الرقم التعريفي لعميل AdWords على طول مسارات الإحالات الناجحة.

التفاعلات

  • السمة - mcf:adwordsCustomerID - تتطابق مع Customer.id في AdWords API.

يضيف هذا الإصدار سمات ومقاييس جديدة إلى واجهة برمجة التطبيقات. اطّلِع على مرجع المقاييس والسمات للحصول على القائمة الكاملة للتعريفات.

مسارات الإحالات الناجحة

  • السمة - mcf:adwordsAdGroupIDPath - سلسلة رقم تعريف المجموعة الإعلانية في AdWords على طول مسارات الإحالات الناجحة.
  • السمة - mcf:adwordsCampaignIDPath - سلسلة رقم تعريف حملة AdWords على طول مسارات الإحالات الناجحة.
  • السمة - mcf:adwordsCreativeIDPath - سلسلة رقم تعريف تصميم الإعلان في "إعلانات Google" على طول مسارات الإحالات الناجحة.
  • السمة - mcf:adwordsCriteriaIDPath - سلسلة أرقام تعريف معايير AdWords على طول مسارات الإحالات الناجحة.

التفاعلات

  • السمة - mcf:adwordsAdGroupID - تتطابق مع AdGroup.id في AdWords API.
  • السمة - mcf:adwordsCampaignID - تتطابق مع Campaign.id في AdWords API.
  • السمة - mcf:adwordsCreativeID - تتطابق مع Ad.id في AdWords API.
  • السمة - mcf:adwordsCriteriaID - تتطابق مع Criterion.id في AdWords API.

الميزات الجديدة للتحكم في حجم العينة والتواريخ النسبية

التواريخ النسبية
  • تمت إضافة إمكانية استخدام التواريخ النسبية إلى واجهة برمجة التطبيقات MCF Reporting API. أصبحت today وyesterday وNdaysAgo الآن قيمًا صالحة لمعلَمات طلب البحث start-date وend-date.
  • سيؤدي استخدام هذه القيم إلى تحديد النطاق الزمني تلقائيًا بالاستناد إلى التاريخ الحالي في وقت إجراء طلب البحث، وإلى المنطقة الزمنية للملف الشخصي المحدّد في طلب البحث. يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات للحصول على تفاصيل إضافية.
مستوى أخذ العينات
  • تمّ تقديم مَعلمة جديدة، samplingLevel، تسمح لك بضبط مستوى أخذ العينات (أي عدد الزيارات المستخدَمة لحساب النتيجة) لأي طلب بحث لإعداد التقارير. القيم المسموح بها هي: DEFAULT وFASTER وHIGHER_PRECISION.
  • تمت إضافة حقلَين جديدَين إلى استجابة واجهة برمجة التطبيقات: sampleSize وsampleSpace. يمكنك استخدام هذه القيم لحساب النسبة المئوية للزيارات التي تم استخدامها كعينة لاستجابة.
  • يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات وأخذ العينات للحصول على تفاصيل إضافية.

هذا هو الإصدار الأولي من واجهة برمجة التطبيقات لإعداد التقارير للمسارات المتعددة القنوات:

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