تكامل Amplitude

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

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

Amplitude، وهي منصة قوية لتحليلات المنتجات، تمكّن الشركات من فهم سلوك المستخدم في الوقت الفعلي، وتتبع التفاعلات داخل المنتج، واكتساب رؤى قيمة حول تفاعل المستخدمين والاحتفاظ بهم والإيرادات.

يتيح لك دمج Amplitude مع Pushwoosh تخصيص حملات Pushwoosh ببيانات Amplitude، وتشغيل حملات آلية بناءً على إجراءات المستخدم، وتحليل الأداء للتحسين المستمر، وفي النهاية زيادة التفاعل، وتقليل معدل التوقف عن استخدام الخدمة، وزيادة الإيرادات.

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

نوع التكامل

الوجهة: يتم إرسال البيانات من Amplitude إلى Pushwoosh.

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

لإعداد تكامل بث الأحداث ومزامنة المجموعات (Event Streaming and Cohort Sync) من Amplitude إلى Pushwoosh، تأكد من استيفاء المتطلبات الأساسية التالية:

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

مسرد المصطلحات (مطابقة أسماء الكيانات إذا كانت مختلفة)

المجموعات (Cohorts) في Amplitude = الشرائح (Segments) في Pushwoosh

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

• الأحداث (Events)
• العلامات (Tags)
• الشرائح (Segments)

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

يعمل تكامل Amplitude مع Pushwoosh عن طريق مزامنة البيانات بين المنصتين لتعزيز تفاعل المستخدمين وتقسيمهم. إليك تفصيل لكيفية عمله:

نقل البيانات

• الأحداث (Events): يرسل Amplitude بيانات الأحداث إلى Pushwoosh. يحتوي كل حدث على معرف مستخدم (external_id)، ورمز تطبيق (app_id)، وطابع زمني (created_at)، وسمات إضافية (attributes).

• العلامات (Tags): يتلقى Pushwoosh علامات مرتبطة بملفات تعريف المستخدمين. يتم إرسال هذه العلامات مع معرف مستخدم (external_id)، ورمز تطبيق (app_id)، وخصائص العلامة (properties).

• الشرائح (Segments): يتم استيراد الشرائح بشكل مشابه لكيفية تعامل Pushwoosh مع استيراد ملفات CSV. تتم إضافة المستخدمين إلى الشرائح أو إزالتهم منها عبر الطلبات.

تدفق البيانات

• الأحداث والعلامات: يتم إرسال البيانات من Amplitude إلى Pushwoosh بناءً على تفاعلات المستخدم أو السمات التي يتم تتبعها في Amplitude. يتم إنشاء الأحداث والعلامات أو تحديثها في Pushwoosh وفقًا للتكوين والتعيينات التي تم إعدادها في Amplitude.

• الشرائح: يتم إنشاء الشرائح في Pushwoosh عندما يقوم Amplitude بتقديم طلب. يقوم Pushwoosh بإنشاء معرف فريد لكل شريحة، والذي يستخدمه Amplitude للتحكم في الشريحة عن طريق إضافة أو إزالة المستخدمين.

الطلبات

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

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

تتبع الأحداث

تتبع إجراءات المستخدم وتفاعلاته من Amplitude وأرسل هذه الأحداث إلى Pushwoosh لتشغيل الإشعارات أو التحديثات.

وضع علامات للمستخدمين

قم بتعيين علامات للمستخدمين بناءً على سلوكهم أو سماتهم في Amplitude. يمكن استخدام هذه العلامات في Pushwoosh للمراسلة المستهدفة أو التقسيم.

إدارة الشرائح

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

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

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

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

مزامنة المجموعات (Cohort sync)

إعداد Pushwoosh

1. في Pushwoosh، انتقل إلى الإعدادات > التكاملات (Settings > Integrations).

2. انقر على إضافة تكامل (Add Integration)، ثم ابحث عن Amplitude وأضفه.

   

3. انسخ مفتاح API ورمز التطبيق من Pushwoosh إلى الحافظة الخاصة بك.

إعداد Amplitude

لتكوين Amplitude للتكامل، اتبع الخطوات التالية:

1. في بيانات (Data) Amplitude، انتقل إلى الكتالوج (Catalog) وحدد الوجهات (Destinations).
2. تحت قسم المجموعات (Cohort)، حدد موقع Pushwoosh وانقر عليه.

3. انقر على إضافة وجهة أخرى (Add another destination).

4. أدخل اسمًا والصق مفتاح API الذي نسخته من Pushwoosh.

5. قم بتعيين حقل معرف مستخدم Amplitude إلى حقل معرف مستخدم Pushwoosh.
6. احفظ إعداداتك عند الانتهاء.

إرسال مجموعة (cohort)

لمزامنة مجموعتك الأولى، أكمل الخطوات التالية:

1. في Amplitude، افتح المجموعة التي ترغب في مزامنتها، ثم انقر على مزامنة (Sync).

2. اختر Pushwoosh وحدد الحساب الذي تريد المزامنة معه. ثم، انقر على التالي (Next).

3. حدد إيقاع المزامنة واحفظ تكويناتك.

بث الأحداث (Event streaming)

إعداد Pushwoosh

1. احصل على مفتاح API الخاص بـ Pushwoosh.

2. حدد موقع رمز التطبيق في حساب Pushwoosh الخاص بك.

إعداد Amplitude

1. في Amplitude، انتقل إلى وجهات البيانات (Data Destinations) وابحث عن Pushwoosh - Event Stream.

2. أدخل اسمًا للمزامنة ثم انقر على إنشاء مزامنة (Create Sync).

3. غير الحالة من معطل (Disabled) إلى ممكّن (Enabled) والصق رمز وصول API ورمز التطبيق الخاصين بـ Pushwoosh.

4. من القائمة المنسدلة اليسرى، حدد خاصية مستخدم Amplitude التي تتوافق مع معرف المستخدم (UserID) في Pushwoosh.
5. (اختياري) قم بتمكين مفتاح إنشاء وتحديث المستخدمين (Create & Update users) إذا كنت ترغب في إرسال المستخدمين وخصائصهم في الوقت الفعلي كلما قام Amplitude بإنشاء أو تحديث خاصية مستخدم.

6. قم بتمكين إرسال الأحداث (Send Events) (“يتم إرسال الأحداث إلى Pushwoosh”) إذا كنت ترغب في بث الأحداث إلى Pushwoosh. سيؤدي هذا إلى إعادة توجيه الأحداث تلقائيًا إلى Pushwoosh فور استيعابها في Amplitude. لا يتم إرسال الأحداث وفقًا لجدول زمني أو عند الطلب باستخدام هذا التكامل.

8. بعد ذلك، اختر الأحداث التي تريد إرسالها في قسم تحديد وتصفية الأحداث (Select and Filter Events). حدد فقط الأحداث التي تحتاجها في Pushwoosh؛ الأحداث المحولة غير مدعومة.
9. بمجرد الانتهاء، قم بتمكين الوجهة وانقر على حفظ (Save).

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

للتحقق من أن تكامل Amplitude و Pushwoosh يعمل بشكل صحيح، يمكنك استخدام الطرق التالية:

مراقبة لوحة تحكم Pushwoosh

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

التحقق من استجابات API

• الاستجابات الناجحة: تأكد من أنك تتلقى استجابات 200 OK من نقاط نهاية API الخاصة بـ Pushwoosh. على الرغم من أنه قد لا يكون هناك دائمًا نص استجابة، إلا أن حالة 200 OK تشير إلى أن الطلب قد تم استلامه بنجاح.
• استجابات الخطأ: راجع أي استجابات خطأ أو رموز حالة أخرى غير 200 OK للحصول على أدلة إذا كان هناك شيء لا يعمل. قد تشمل الأخطاء الشائعة 400 Bad Request، 401 Unauthorized، أو 500 Internal Server Error.

تسجيل الطلبات والاستجابات

• سجلات الطلبات: احتفظ بسجلات للطلبات الصادرة من Amplitude والاستجابات الواردة من Pushwoosh. تحقق من هذه السجلات للتأكد من أن الطلبات منسقة بشكل صحيح وأن الاستجابات كما هو متوقع.
• تسجيل الأخطاء: قم بتنفيذ تسجيل الأخطاء لالتقاط أي مشاكل أثناء عمليات نقل البيانات أو التكامل.

الاختبار ببيانات عينة

• إرسال أحداث/علامات اختبار: قم بإنشاء وإرسال أحداث وعلامات اختبار من Amplitude إلى Pushwoosh. تحقق من ظهور هذه الإدخالات الاختبارية بشكل صحيح في Pushwoosh وتؤدي إلى السلوكيات المتوقعة.
• محاكاة إجراءات المستخدم: قم بتنفيذ إجراءات في Amplitude يجب أن تؤدي إلى أحداث أو تحديثات محددة في Pushwoosh. تحقق مما إذا كانت هذه الإجراءات تؤدي إلى التغييرات المتوقعة في Pushwoosh.

استخدام أدوات المراقبة

• مراقبة التكامل: استخدم أدوات أو خدمات المراقبة التي يمكنها تتبع صحة وأداء التكامل. يمكن لهذه الأدوات تنبيهك بالمشاكل أو الإخفاقات في الوقت الفعلي.
• التحليلات والتقارير: استخدم ميزات التحليلات في كل من Amplitude و Pushwoosh لمراجعة تدفق البيانات وأداء التكامل.

مراجعة وثائق التكامل

• مراجعة التكوين: تحقق مرة أخرى من تكوين التكامل في كل من Amplitude و Pushwoosh للتأكد من تطبيق جميع الإعدادات والتعيينات بشكل صحيح.
• تحديثات الوثائق: ابق على اطلاع بأي تغييرات أو تحديثات في وثائق التكامل قد تؤثر على الوظائف.

الاتصال بالدعم

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

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

مشاكل التكامل

• الحدث لا يظهر في Pushwoosh: تأكد من تعيين الحدث بشكل صحيح، وتحقق من أن رمز تطبيق Pushwoosh ورمز API تم تكوينهما بشكل صحيح.

• العلامات لا تتم مزامنتها: تأكد من أن العلامات منسقة بشكل صحيح وأن جميع تفاصيل المصادقة اللازمة مدرجة في الطلب.

مشاكل الشرائح (Segments)

• الشريحة لم يتم إنشاؤها: تحقق من أن طلب إنشاء الشريحة منسق بشكل صحيح وأن رمز API الخاص بـ Pushwoosh صالح.

• المستخدمون لم تتم إضافتهم/إزالتهم: تحقق من تحديد معرفات المستخدمين بشكل صحيح وأن معرف الشريحة صالح. تأكد من أن حمولة الطلب منسقة بشكل صحيح.

مشاكل الاستجابة

• لا يوجد نص استجابة: إذا تلقيت استجابة 200 OK ولكن لا يوجد نص استجابة، تحقق من أن الطلب كان منسقًا بشكل صحيح وأن البيانات قد تم إرسالها بشكل صحيح.

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

ماذا أفعل إذا تلقيت خطأ 400 Bad Request؟

راجع حمولة الطلب بحثًا عن أخطاء في التنسيق أو حقول مفقودة. تأكد من تضمين جميع الحقول المطلوبة وتنسيقها بشكل صحيح.

كيف يمكنني التحقق مما إذا كان التكامل يعمل؟

تحقق من لوحة تحكم Pushwoosh للأحداث والعلامات وتحديثات الشرائح الواردة. يمكنك أيضًا مراقبة السجلات أو الاستجابات من نقاط نهاية API لعمليات نقل البيانات الناجحة.

هل يمكنني تخصيص الأحداث أو العلامات المرسلة إلى Pushwoosh؟

نعم، يمكنك تخصيص الأحداث والعلامات ضمن تكوين Amplitude. تأكد من أن البيانات تلتزم بالتنسيق المتوقع لـ Pushwoosh.

كم مرة تتم مزامنة البيانات بين Amplitude و Pushwoosh؟

تتم مزامنة البيانات في الوقت الفعلي أو شبه الفعلي بناءً على الطلبات المقدمة من Amplitude. تأكد من أن تكوينك يدعم تردد التحديث المطلوب.

أين يمكنني العثور على مزيد من المعلومات أو الدعم لهذا التكامل؟

ارجع إلى الوثائق الرسمية من Amplitude و Pushwoosh. لمزيد من المساعدة، اتصل بفرق الدعم المعنية.