تتبُّع البريد الإلكتروني - Measurement Protocol

يوضّح هذا المستند كيفية قياس تفاعلات المستخدمين مع البريد الإلكتروني باستخدام بروتوكول Measurement Protocol.

نظرة عامة

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

تنبيه: لا يجوز تحميل أي بيانات تسمح لمحرّك بحث Google بتحديد هوية أي شخص بشكل شخصي (مثل الأسماء وعناوين البريد الإلكتروني)، حتى في شكل مجزّأ. اطّلِع على سياسة Measurement Protocol لمزيد من التفاصيل.

Measurement Protocol للرسائل الإلكترونية

تتطلب جميع نتائج Measurement Protocol حقولاً معينة. وسيوضّح هذا المستند كيفية اختيارها وبعض الحقول المقترَحة.

يجب وضع علامة صورة في الرسالة الإلكترونية. ننصحك بوضع الصورة في أسفل الرسالة الإلكترونية كي لا يؤخّر تحميل المحتوى الرئيسي لها.

<img src="https://www.google-analytics.com/collect?v=1&..."/>

رقم تعريف التتبّع (&tid)

استخدِم رقم تعريف التتبّع نفسه الذي يستخدمه موقعك الإلكتروني. سيسمح هذا الإجراء لمعرّفات العميل ومعرّفات المستخدمين بالعمل على جميع الأجهزة وأنواع الوسائط.

معرِّف العميل (&cid)

ويجب أن يكون معرّف العميل عددًا صحيحًا عشوائيًا 64 بت. في السابق، كانت خدمة "إحصاءات Google" تقسّم ClientID إلى جزأين أساسيَّين 32 بت وغير موقَّعَين، هما: 123456789.123456789. يتيح Measurement Protocol استخدام معرّفات فريدة عالمية (UUID) أكبر، بما في ذلك الأحرف الأبجدية الرقمية.

ملاحظة: إذا كنت ترسل رسالة إلكترونية حول الخدمة، يمكنك استخدام معرِّف العميل من analytics.js باستخدام طريقة الحصول.

رقم تعريف المستخدم (&uid)

في حال كنت تستخدم userID لقياس المستخدمين على جميع الأجهزة، يمكنك استخدامه للرسائل الإلكترونية بالإضافة إلى Client-ID.

فعاليات

يجب تتبُّع مرّات فتح الرسائل الإلكترونية كأحداث. استخدِم فئة (&ec) للنوع email وإجراء (&ea) من أجل open.

t=event&ec=email&ea=open

يمكن الإبلاغ عن الأحداث بطريقة فريدة، وهو أمر مهم عند فتح الرسائل الإلكترونية، لأنّه يمكنك فتح رسالة إلكترونية عدة مرات.

مسار المستند

يمكن أن تحتوي جميع الأحداث على مسار مستند (&dp) أو موقع مستند (&dl). استخدِم مسار المستند، لأنّ الرسائل الإلكترونية لا تتوافق مع عناوين URL العادية. يجب أن تبدأ بشرطة مائلة للأمام (/) وأن تكون فريدة لكل رسالة إلكترونية.

ملاحظة: احرِص على أن تكون المسارات فريدة من نوعها عن مضيف الويب. وتم إضافة /email/ في بداية كل مسار لتسهيل إعداد التقارير عن الرسائل الإلكترونية المفتوحة فقط مقارنةً ببقية الموقع الإلكتروني.

عنوان المستند

يجب أن يكون عنوان المستند (&dt) هو سطر موضوع رسالة البريد الإلكتروني.

حقول معلومات النظام

إذا كانت حقول معلومات النظام معروفة (مثل اللغة)، أضِفها إلى النتيجة.

حقول الحملة

بدون حقول الحملة، سيتم تتبُّع الرسالة الإلكترونية المفتوحة على أنّها (مباشرة) أو الحملة الأخيرة. استنادًا إلى الرسالة الإلكترونية، قد يكون هذا هو السلوك المطلوب. وإذا لم يكن الأمر كذلك، اضبط معلَمات الحملة على النحو الوارد في مصادر الزيارات.

تتطلب الحملات حقلاً لاسم (&cn) أو رقم تعريف (&ci). استخدِم email كوسيط (&cm).

النقرات على رابط التتبُّع

يجب أن تتضمّن الرسالة الإلكترونية روابط تؤدي إلى موقعك الإلكتروني أو تطبيقك. ننصحك بوضع علامات على الروابط باستخدام مَعلمات الحملة. استخدِم أداة إنشاء عناوين URL لإنشاء الروابط.

ملاحظة: استخدِم مَعلمة الحملة نفسها المستخدَمة في النتيجة المفتوحة.

المُحيلون في "الرسائل الإلكترونية"

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

الخادم الوكيل للصور في Gmail

نظرًا لأن خدمة الخادم الوكيل للصور في Gmail لا تعيد توجيه ملفات تعريف الارتباط للمستخدمين، لا يمكنك استخدام بروتوكول القياس لتتبُّع مستخدمي Gmail. وتمنع خدمة الخادم الوكيل للصور في Gmail ذلك من خلال تمرير طلبات Measurement Protocol من خلال خادم وسيط.