تكامل Adapty

نظرة عامة على التكامل وحالات الاستخدام

Adapty هي منصة لإدارة اشتراكات تطبيقات الجوال وتحقيق الدخل منها.

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

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

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

ابدأ في حساب Adapty الخاص بك

انتقل إلى قسم التكاملات (Integrations)، اختر Pushwoosh، وقم بتفعيله عن طريق تحويل المفتاح من إيقاف إلى تشغيل، ثم أكمل الحقول المطلوبة.

اذهب إلى Pushwoosh لإعداد بيانات الاعتماد الأساسية

أنشئ اتصالاً بين حسابي Pushwoosh و Adapty الخاصين بك عن طريق إعداد بيانات الاعتماد. يتطلب هذا معرف تطبيق Pushwoosh (Pushwoosh App ID) ورمز المصادقة (authentication token).

حدد موقع بيانات اعتماد Pushwoosh الخاصة بك

معرف التطبيق (App ID): يوجد في لوحة تحكم Pushwoosh.
رمز المصادقة (Auth Token): يوجد في قسم الوصول إلى API (API Access) في إعدادات Pushwoosh.

تكوين الأحداث والعلامات (Events and Tags)

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

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

تمكين العلامات المخصصة (custom tags)

عزز تكامل Pushwoosh مع Adapty باستخدام العلامات المخصصة. يمكن تخصيص هذه العلامات لتلبية متطلباتك المحددة، كما هو موضح أدناه:

adapty_customer_user_id: معرف مستخدم فريد من Pushwoosh.
adapty_profile_id: معرف ملف مستخدم Adapty فريد، يظهر في لوحة تحكم Adapty.
environment: يحدد بيئة المستخدم، إما ‘Sandbox’ أو ‘Production’.
store: يشير إلى متجر الشراء (‘app_store’ أو ‘play_store’).
vendor_product_id: معرف المنتج في متجر Apple/Google.
subscription_expires_at: تاريخ انتهاء صلاحية أحدث اشتراك، بتنسيق محدد.
last_event_type: نوع أحدث حدث من Adapty.
purchase_date: تاريخ آخر معاملة، بتنسيق محدد.
original_purchase_date: تاريخ أول عملية شراء، بتنسيق محدد.
active_subscription: يشير إلى حالة الاشتراك.
period_type: أحدث نوع فترة للشراء أو التجديد.

بالإضافة إلى ذلك، يمكنك دمج السمات المخصصة لمرونة أكبر في التتبع. في صفحة التكامل من جانب Adapty، حدد مربع الاختيار ‘إرسال سمات المستخدم المخصصة’ (Send user custom attributes) للإرسال التلقائي إلى Pushwoosh.

مطلوب: تكوين SDK

لإكمال التكامل، أرسل قيمة HWID من Pushwoosh إلى Adapty:

let params = AdaptyProfileParameters.Builder()
    .with(pushwooshHWID: Pushwoosh.sharedInstance().getHWID())
    .build()

Adapty.updateProfile(params: params) { error in
    // handle the error
}

val params = AdaptyProfileParameters.Builder()
    .withPushwooshHwid(Pushwoosh.getInstance().hwid)
    .build()

Adapty.updateProfile(params) { error ->
    if (error != null) {
        // handle the error
    }
}

AdaptyProfileParameters params = new AdaptyProfileParameters.Builder()
    .withPushwooshHwid(Pushwoosh.getInstance().getHwid())
    .build();

Adapty.updateProfile(params, error -> {
    if (error != null) {
        // handle the error
    }
})

import 'package:pushwoosh/pushwoosh.dart';

final builder = AdaptyProfileParametersBuilder()
        ..setPushwooshHWID(
          await Pushwoosh.getInstance.getHWID,
        );
try {
    await adapty.updateProfile(builder.build());
} on AdaptyError catch (adaptyError) {
    // handle error
} catch (e) {}

import { adapty } from 'react-native-adapty';
import Pushwoosh from 'pushwoosh-react-native-plugin';

// ...
try {
  await adapty.updateProfile({
    pushwooshHWID: hwid,
  });
} catch (error) {
  // handle `AdaptyError`
}

var builder = new Adapty.ProfileParameters.Builder();
builder.SetPushwooshHWID(Pushwoosh.Instance.HWID);

Adapty.UpdateProfile(builder.Build(), (error) => {
    // handle error
});