تكامل Qonversion

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

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

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

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

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

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

تذكيرات تجديد الاشتراك

يمكنك استخدام بيانات Qonversion حول الاشتراكات المنتهية الصلاحية لإنشاء رحلة عميل (customer journey) ترسل تلقائيًا تذكيرات مخصصة من خلال الإشعارات الفورية (push notifications) أو الرسائل داخل التطبيق (in-app messages).

العروض المخصصة

استخدم بيانات الاشتراك من Qonversion لاستهداف المستخدمين الذين ألغوا اشتراكاتهم وإنشاء رحلة عميل (customer journey) تبدأ بإشعار فوري (push notification) جذاب يقدم خصمًا حصريًا. إذا تفاعل المستخدم مع الإشعار الفوري ولكنه لم يكمل عملية الشراء، يمكن للرحلة بعد ذلك إرسال رسالة داخل التطبيق (in-app message) مع مزايا إضافية، لتشجيعهم على العودة واسترداد العرض.

تحويل الفترة التجريبية

استخدم Qonversion لتتبع المستخدمين الذين أوشكت فترة تجربتهم على الانتهاء وإنشاء رحلات عملاء (customer journeys) لتشجيعهم على التحول إلى مشتركين يدفعون.

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

إعداد حزم SDK

1. قم بتثبيت Pushwoosh SDK. تعرف على المزيد حول كيفية تثبيت Pushwoosh SDK على IOS، وAndroid، والمنصات المتعددة.
2. اتبع دليل تثبيت Qonversion SDK لإعداد Qonversion SDK.
3. لإسناد الأحداث المرسلة من Qonversion إلى مستخدم Pushwoosh معين، قم بتعيين معرف الجهاز (Hardware ID - HWID) الخاص بـ Pushwoosh:

Swift

Qonversion.shared().setUserProperty(.pushWooshHwId, value: Pushwoosh.sharedInstance().getHWID())

Objective-C

[[Qonversion sharedInstance] setUserProperty:QONUserPropertyKeyPushWooshHwId, value: [[Pushwoosh sharedInstance] getHWID]];

Java

Qonversion.getSharedInstance().setUserProperty(QUserPropertyKey.PushWooshHwId, Pushwoosh.getInstance().getHWID());

Kotlin

Qonversion.shared.setUserProperty(QUserPropertyKey.PushWooshHwId, Pushwoosh.getInstance().getHWID())

Flutter

String hwid = await Pushwoosh.getInstance.getHWID;
Qonversion.getSharedInstance().setUserProperty(QUserPropertyKey.pushWooshHwId, hwid);

React Native

Pushwoosh.getHwid( function(hwId) { Qonversion.getSharedInstance().setUserProperty(UserPropertyKey.PUSH_WOOSH_HW_ID, hwId); } );

Unity

Qonversion.GetSharedInstance().SetUserProperty(UserPropertyKey.PushWooshHwId, Pushwoosh.Instance.HWID);

Cordova

pushwoosh.getPushwooshHWID(
  function(hwId) {
    Qonversion.getSharedInstance().setUserProperty(Qonversion.UserPropertyKey.PUSH_WOOSH_HW_ID, hwId);
  }
);

4. (اختياري) لتحسين دقة الإسناد، قم بتعيين نفس معرف المستخدم (user ID) لكل من Pushwoosh و Qonversion

Swift

Pushwoosh.sharedInstance.setUserId("yourSideUserID")
Qonversion.shared().setUserProperty(.pushwooshUserId, value: "yourSideUserID")

Objective-C

[[Pushwoosh sharedInstance] setUserId:@"yourSideUserID"];
[[Qonversion sharedInstance] setUserProperty:QONUserPropertyKeyPushwooshUserId, value: @"yourSideUserID";

Java

Pushwoosh.getInstance().setUserId("yourSideUserID");
Qonversion.getSharedInstance().setUserProperty(QUserPropertyKey.PushwooshUserId, "yourSideUserID");

Kotlin

Pushwoosh.getInstance().setUserId("yourSideUserID")
Qonversion.shared.setUserProperty(QUserPropertyKey.PushwooshUserId, "yourSideUserID")

Flutter

Pushwoosh.getInstance.setUserId('yourSideUserID');
Qonversion.getSharedInstance().setUserProperty(QUserPropertyKey.pushwooshUserId, 'yourSideUserID');

React Native

Pushwoosh.setUserId('yourSideUserID');
Qonversion.getSharedInstance().setUserProperty(UserPropertyKey.PUSH_WOOSH_USER_ID, 'yourSideUserID');

Unity

Pushwoosh.Instance.SetUserId("yourSideUserID");
Qonversion.GetSharedInstance().SetUserProperty(UserPropertyKey.PushwooshUserId, "yourSideUserID");

Cordova

pushwoosh.setUserId('yourSideUserID');
Qonversion.getSharedInstance().setUserProperty(Qonversion.UserPropertyKey.PUSH_WOOSH_USER_ID, 'yourSideUserID');

تكوين تكامل Pushwoosh

1. انتقل إلى لوحة تحكم Pushwoosh للحصول على ما يلي:

• كود تطبيق Pushwoosh (XXXXX-XXXXX) والذي يقع أسفل اسم تطبيقك.

• رمز الوصول إلى Pushwoosh API. للحصول على الرمز، انتقل إلى الإعدادات > الوصول إلى API وانسخ الكود.

يمكنك معرفة المزيد حول رمز الوصول إلى API في هذا الدليل.

2. في قسم التكاملات من مشروع Qonversion الخاص بك، حدد Pushwoosh، وقدم مفتاح تطبيق Pushwoosh ورمز الوصول إلى API. انقر فوق حفظ.

3. يمكنك إما استخدام أسماء الأحداث الافتراضية التي يوفرها Qonversion أو تخصيصها لتناسب احتياجاتك.

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