تكامل 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.

تكوين وجهة (Destination)

1. في واجهة Segment، انتقل إلى Connections → Destinations وانقر على Add Destination.

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

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

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

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

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

يمكنك العثور على مفتاح API في قسم Settings → 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 في تلقي الأحداث (Events) وسمات المستخدم من Segment. بناءً على هذه البيانات، يمكنك إنشاء رحلات عملاء مستهدفة للغاية و تخصيص إشعارات الدفع والرسائل داخل التطبيق ورسائل البريد الإلكتروني.

تكوين مصدر (Source)

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. انتقل إلى Settings > 3rd party integration > Segment، انقر على زر Configure، وأدخل مفتاح الكتابة (Write key) من مساحة عمل Segment الخاصة بك.
8. ضع قائمة بالأحداث التي تريد تصديرها باستخدام فاصل , في حقل Events، أو اتركه فارغًا إذا كنت تريد تصدير جميع الأحداث، ثم انقر على Apply.

البث (Stream)

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

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

الأحداث (Events)

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

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

خصائص الحدث

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

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

إضافة وجهات (Destinations)

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

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

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

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

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

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

الوجهة (Destination)

track-user

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

post-event

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

delete-user

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

المصدر (Source)

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

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

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

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

الوجهة (Destination)

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

المصدر (Source)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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