تكامل Adapty

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

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

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

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

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

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

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

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

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

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

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

تكوين الأحداث (Events) والعلامات (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
});