تكامل Segment

مطلوب مساعدة من المطورين

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

Segment هي منصة بيانات عملاء تبسط جمع بيانات المستخدم وتساعدك على الاستفادة منها بفعالية. إذا كنت تخزن بيانات عملائك في Segment، يمكنك إعداد التكامل مع Pushwoosh ببضع نقرات فقط.

بمجرد إعداد التكامل، سيرسل Segment البيانات التالية إلى Pushwoosh:

• سمات المستخدم: الاسم، الجهاز، التفضيلات، الموقع، السلوك، إلخ. سيحفظ Pushwoosh هذه البيانات كـ Tags وقيمها لكل مستخدم.
• الأحداث (Events): سيتم نقل كل حدث من Segment إلى Pushwoosh وحفظه كـ Pushwoosh Event بنفس الاسم. سيحصل Pushwoosh أيضًا على معلومات حول الأحداث التي قام كل مستخدم بتفعيلها.

باستخدام بيانات Segment، يمكنك متابعة جمهورك باتصالات سلسة في Pushwoosh. فيما يلي مثالان للاستفادة من قوة المنصتين:

1. إنشاء حملات موجهة بناءً على بيانات سلوك المستخدم. استخدم بيانات الأحداث (Events) من Segment لبناء شرائح مستخدمين دقيقة في Pushwoosh بناءً على سلوك مستخدم معين.

على سبيل المثال، يرسل Segment بيانات حول حدث SubscribedToOffers إلى Pushwoosh. يمكنك بناء شريحة مستخدمين في Pushwoosh تتكون من المستخدمين الذين اشتركوا في العروض الخاصة:

بعد ذلك، يمكنك إنشاء رحلات عملاء جذابة برسائل ترويجية وخصومات للمستخدمين الذين اشتركوا في عروضك:

2. تخصيص الرسائل بناءً على سمات المستخدم من Segment. يمكنك الاستفادة من سمات المستخدم التي تم الحصول عليها من Segment لتعديل محتوى إشعارات الدفع والرسائل داخل التطبيق ورسائل البريد الإلكتروني. سيسمح لك هذا بإعداد اتصالات ذات صلة وعالية التحويل.

على سبيل المثال، يرسل Segment قيم سمة searched_product إلى Pushwoosh. يمكنك إنشاء إعداد مسبق للدفع يقدم خصمًا على المنتجات من فئة بحث عنها المستخدم مسبقًا:

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

نظرة عامة على التكامل

نوع التكامل

• الوجهة (Destination): يتم إرسال البيانات من Segment إلى Pushwoosh.
• المصدر (Source): يتم إرسال البيانات من Pushwoosh إلى Segment.

المتطلبات الأساسية

حسابات مدفوعة في كل من Pushwoosh و Segment

الكيانات المتزامنة

المصدر

• إحصائيات الدفع (Push Statistics)

الوجهة

• الأجهزة (Devices)
• العلامات (Tags)

حالات الاستخدام

تتبع الإشعارات

إرسال إشعارات الدفع وتتبع حالتها، بما في ذلك ما إذا كانت قد أُرسلت وسُلّمت بنجاح.

تحليل الأحداث

تحليل الأحداث التي يفعلها المستخدم، مثل إشعارات الدفع أو تسليم البريد الإلكتروني، والتأكد من تسجيل هذه الأحداث بدقة في Segment.

إدارة المستخدمين

تسجيل وإدارة معلومات المستخدم، بما في ذلك وضع علامات للمستخدمين بسمات ذات صلة أو حذف المستخدمين عند الحاجة.

إعداد التكامل

ملاحظة

قبل إعداد التكامل مع Segment، تأكد من دمج Pushwoosh SDK.

تكوين وجهة

1. في واجهة Segment، انتقل إلى الاتصالات (Connections) ← الوجهات (Destinations) وانقر على إضافة وجهة (Add Destination).

2. ابحث عن Pushwoosh وحدده.

3. اختر المصادر (Sources) التي تريد توصيل الوجهة بها.

4. اذهب إلى إعدادات الوجهة:

5. أدخل مفتاح API الخاص بـ Pushwoosh ورمز التطبيق. تأكد من أن مفتاح تمكين الوجهة (Enable Destination) في وضع التشغيل. بعد ذلك، انقر على حفظ التغييرات (Save Changes).

أين يمكنني العثور على مفتاح API ورمز التطبيق؟

يمكنك العثور على مفتاح API في قسم الإعدادات (Settings) ← الوصول إلى API (API Access):

يمكن العثور على رمز التطبيق في الزاوية العلوية اليسرى من واجهة Pushwoosh، أسفل اسم المشروع مباشرة:

6. اذهب إلى علامة التبويب التعيينات (Mappings) وتأكد من تمكين خياري إنشاء أو تحديث ملف تعريف المستخدم (Create or Update User Profile) وتتبع الأحداث (Track Events):

من المهم التحقق من تعيين حقول الأحداث من مصدرك إلى Pushwoosh كوجهة لضمان معالجة أحداثك بشكل صحيح.

إذا لم يتضمن الحدث حقل device_platform أو كان هذا الحقل غير صحيح، فسيتم تجاهل الحدث. بالإضافة إلى ذلك، إذا لم يتضمن الحدث إما userId أو deviceId، فسيتم تجاهله أيضًا.

للتأكد من أن التعيين الخاص بك تم تكوينه بشكل صحيح، اذهب إلى Pushwoosh as Destination > Settings.

ثم، حدد علامة التبويب Mapping وانقر على Edit Mapping لطريقة Track Events.

بعد ذلك، تأكد من أن تعيين أحداثك إلى الأحداث المرسلة إلى Pushwoosh صحيح، وأن حقلي Device Platform و External User ID (أو Device ID) متطابقان بشكل صحيح.

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

إذا تم تكوين التكامل بشكل صحيح، سيبدأ Pushwoosh في تلقي الأحداث وسمات المستخدم من Segment. بناءً على هذه البيانات، يمكنك إنشاء رحلات عملاء موجهة للغاية وتخصيص إشعارات الدفع والرسائل داخل التطبيق ورسائل البريد الإلكتروني.

تكوين مصدر

1. من صفحة كتالوج المصادر في مساحة عملك، انقر على إضافة مصدر (Add Source).
2. ابحث عن “Pushwoosh” في كتالوج المصادر، حدد Pushwoosh، وانقر على إضافة مصدر (Add Source).
3. في الشاشة التالية، أعطِ المصدر اسمًا وقم بتكوين أي إعدادات أخرى.

ملاحظة

يُستخدم الاسم كتسمية في تطبيق Segment، وينشئ Segment اسم مخطط ذا صلة في مستودعك. يمكن أن يكون الاسم أي شيء، لكن Pushwoosh يوصي باستخدام شيء يعكس المصدر نفسه ويميز بين بيئاتك (على سبيل المثال: Pushwoosh_Prod، Pushwoosh_Staging، Pushwoosh_Dev).

4. انقر على إضافة مصدر (Add Source) لحفظ إعداداتك.
5. انسخ مفتاح الكتابة (Write key) من واجهة مستخدم Segment.
6. سجل الدخول إلى حساب Pushwoosh الخاص بك، وحدد التطبيق الذي تريد توصيله.
7. انتقل إلى الإعدادات > تكامل الطرف الثالث > Segment، انقر على زر تكوين، وأدخل مفتاح الكتابة (Write key) الخاص بك من مساحة عمل Segment.
8. أدرج الأحداث التي تريد تصديرها باستخدام فاصلة , في حقل الأحداث (Events)، أو اتركه فارغًا إذا كنت تريد تصدير جميع الأحداث، ثم انقر على تطبيق (Apply).

البث (Stream)

يستخدم Pushwoosh مكون مصدر البث (Stream) من Segment لإرسال بيانات أحداث Segment. يستخدم طريقة تتبع من جانب الخادم لإرسال البيانات إلى Segment. تتوفر هذه الأحداث بعد ذلك في أي وجهة تقبل الأحداث من جانب الخادم، وتتوفر في مخطط في مستودع البيانات الخاص بك.

بشكل افتراضي، يمرر Pushwoosh معرف مستخدم Pushwoosh كخاصية userId في Segment. إذا لم يكن هناك معرف مستخدم مرتبط، فسيمرر Pushwoosh HWID كـ anonymousId في Segment.

الأحداث (Events)

يسرد الجدول أدناه الأحداث التي يرسلها Pushwoosh إلى Segment. تظهر هذه الأحداث كجداول في مستودعك، وكأحداث عادية في الوجهات الأخرى.

اسم الحدث	الوصف
Email Sent	تم إرسال البريد الإلكتروني بنجاح
Push Sent	تم إرسال إشعار الدفع بنجاح
SMS Sent	تم إرسال رسالة SMS إلى المستلم
Push Opened	تم فتح إشعار الدفع
Email Opened	تم فتح إشعار البريد الإلكتروني
Email Delivered	تم تسليم البريد الإلكتروني بنجاح
Push Delivered	تم تسليم إشعار الدفع بنجاح
SMS Delivered	تم تسليم رسالة SMS بنجاح
SMS Not Delivered	فشل تسليم رسالة SMS
Email Bounced	عاد البريد الإلكتروني إلى المرسل بسبب خطأ دائم
Email Unsubscribed	تم النقر على رابط إلغاء الاشتراك في البريد الإلكتروني

خصائص الحدث

يسرد الجدول أدناه الخصائص المضمنة في الأحداث المذكورة أعلاه.

اسم الخاصية	الوصف
message_type	يحتوي على نوع الرسالة (Push، Email، In-App أو SMS)
campaign_code	المعرف الفريد لحملة الرسالة
device_type	نوع الجهاز

إضافة وجهات

الآن بعد إعداد المصدر الخاص بك، يمكنك توصيله بالوجهات.

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

إذا كانت هناك أي مشاكل في كيفية وصول الأحداث إلى Segment، اتصل بفريق الدعم لدينا.

كيف يعمل التكامل

1. بدء إشعار الدفع: يبدأ العميل العملية ببدء إشعار دفع من خلال واجهة Pushwoosh.
2. إنتاج الحدث: يعالج الواجهة الخلفية لـ Pushwoosh طلب إشعار الدفع وينشئ حدثًا. يتم بعد ذلك إرسال هذا الحدث إلى موضوع Kafka يسمى channels-tracking-log تديره Pushwoosh.
3. استهلاك الحدث: تستمع خدمة تكامل Segment باستمرار إلى موضوع Kafka channels-tracking-log وتستهلك الأحداث عند وصولها.
4. معالجة الحدث: تتم معالجة الأحداث المستهلكة بواسطة خدمة تكامل Segment، التي تحولها إلى Segment Track Events.
5. إرسال الحدث: يتم بعد ذلك إرسال Segment Track Events المعالجة إلى الواجهة الخلفية لـ Segment لمزيد من المعالجة والتحليل.

كيف تعرف أن التكامل يعمل؟

الوجهة

track-user

اذهب إلى حساب Pushwoosh الخاص بك > تطبيقك المتصل > الجمهور > مستكشف المستخدم. ابحث عن المستخدم/الجهاز الخاص بك وتحقق من العلامات (Tags) التي أرسلها Segment.

post-event

اذهب إلى حساب Pushwoosh الخاص بك > تطبيقك المتصل > الجمهور > الأحداث. حدد الحدث، انقر على قائمة النقاط الثلاث، واختر إحصائيات الحدث. تأكد من احتساب الحدث.

delete-user

اذهب إلى حساب PW الخاص بك > تطبيقك المتصل > الجمهور > مستكشف المستخدم. تأكد من أن المستخدم/الجهاز غير موجود.

المصدر

استخدم مصحح أخطاء المصدر لاكتشاف الأحداث التي تم إرسالها من Pushwoosh إلى Segment.

استكشاف الأخطاء وإصلاحها

التحقق من حالة التكامل

لاستكشاف المشكلات المتعلقة بتكامل Pushwoosh وإصلاحها، ابدأ بالتحقق مما يلي:

الوجهة

• Track-User: تحقق من معلومات المستخدم/الجهاز والعلامات في Pushwoosh تحت Audience > User Explorer.
• Post-Event: تأكد من احتساب الحدث في Pushwoosh عن طريق التحقق من إحصائيات الحدث.
• Delete-User: تأكد من أن المستخدم/الجهاز لم يعد موجودًا في Pushwoosh.

المصدر

استخدم مصحح أخطاء المصدر في Segment Debugger للتحقق مما إذا كانت الأحداث من Pushwoosh تُرسل بشكل صحيح إلى Segment.

عدم تطابق الأحداث

إذا لم تظهر الأحداث بشكل صحيح في Segment، فتأكد من أن أحداث Pushwoosh تم تعيينها بشكل صحيح إلى Segment Track Events وفقًا لقواعد التعيين المقدمة.

مشاكل المصادقة

تحقق من استخدام رموز المصادقة أو مفاتيح API الصحيحة في الطلبات إلى Pushwoosh و Segment.

مشاكل تدفق البيانات

تأكد من أن تدفق البيانات بين Pushwoosh و Segment غير منقطع وأن مواضيع Kafka تتم مراقبتها بشكل صحيح.

الأسئلة الشائعة

ما هي أنواع الأحداث التي يتم إرسالها إلى Segment من Pushwoosh؟

يتم إرسال الأحداث المحجوزة مثل Push Sent, Email Sent, SMS Sent, Push Delivered, Email Delivered, SMS Delivered, and Email Bounced إلى Segment.

كيف يمكنني التحقق من أن الأحداث يتم إرسالها بشكل صحيح إلى Segment؟

استخدم مصحح أخطاء المصدر في Segment للتحقق من الأحداث المرسلة من Pushwoosh، وراجع إحصائيات الأحداث في حساب Pushwoosh الخاص بك للتأكد من أنها تُحتسب بشكل صحيح.

ماذا يجب أن أفعل إذا واجهت مشاكل في التكامل؟

تحقق من حالة التكامل عن طريق التحقق من معلومات المستخدم/الجهاز، وعدد الأحداث، وحذف المستخدمين في Pushwoosh. بالإضافة إلى ذلك، تأكد من استخدام رموز المصادقة الصحيحة وأن تدفق البيانات غير منقطع.

كيف يتم التعامل مع معلومات المستخدم والجهاز في التكامل؟

يتم تسجيل أو تحديث معلومات المستخدم والجهاز، بما في ذلك السمات والعلامات، في Pushwoosh بناءً على الطلبات من Segment. لاحظ أن العلامات الافتراضية لا يتم إنشاؤها تلقائيًا في Pushwoosh.

أين يمكنني العثور على وثائق مفصلة للتكامل؟

تتوفر الوثائق المفصلة في أدلة تكامل Segment و Pushwoosh، وكذلك في وثائق API الخاصة بكل منهما.