# تكامل Solitics

<Aside type="caution" icon="setting" title="مطلوب مساعدة من المطورين">
 ستحتاج إلى مساعدة من فريق التطوير لديك لإعداد التكامل. يرجى مشاركة هذا الدليل معهم.
</Aside>

[Solitics](https://solitics.com/) هي منصة متقدمة لإدارة البيانات وأتمتة التسويق في الوقت الفعلي تمكّن العلامات التجارية التي تتعامل مباشرة مع المستهلكين (B2C) من تقديم تجارب شخصية للغاية لعملائها. من خلال الاستفادة من بيانات العملاء، يمكن للشركات زيادة الإيرادات من خلال تحسين معدلات التحويل والاحتفاظ بالعملاء، كل ذلك مع تقليل نفقات التطوير وتكنولوجيا المعلومات بشكل كبير.

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

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

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

فيما يلي بعض حالات الاستخدام العملية التي توضح كيف يمكن استخدام تكامل Solitics و Pushwoosh لتحسين تجربة العملاء وتحقيق نتائج أعمال أفضل:

### العروض الترويجية والعروض المخصصة

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

### تعزيز المشاركة

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

### التنبيهات الأمنية

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

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

تتضمن عملية التكامل خطوتين أساسيتين:

1. دمج Pushwoosh SDK في موقع الويب الخاص بك أو تطبيق الهاتف المحمول.
2. إنشاء معرف مستخدم (user ID) يعمل كمعرف فريد لكل من Solitics و Pushwoosh.

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

1. حساب Pushwoosh
2. [رمز الوصول إلى واجهة برمجة تطبيقات Pushwoosh](/ar/developer/api-reference/api-access-token): لتمكين نقل البيانات إلى Pushwoosh، تحتاج إلى إنشاء رمز وصول إلى واجهة برمجة تطبيقات Pushwoosh. للحصول عليه، انتقل إلى **الإعدادات > الوصول إلى واجهة برمجة التطبيقات** وانسخه من هناك.
3. رمز تطبيق Pushwoosh: بالمثل، ستحتاج إلى تحديد موقع رمز تطبيق Pushwoosh الخاص بك لتسهيل نقل البيانات إلى Pushwoosh. للقيام بذلك، ابحث عن اسم المشروع في الزاوية العلوية اليسرى وانسخ الرمز المعروض أسفله.
4. [حساب Solitics](https://dashboard.solitics.com/#/pages/signin)

<Aside type="note">
لتمكين التكامل، قم بتسجيل كل مستخدم في كل من Solitics و Pushwoosh باستخدام نفس معرف العضو. هذا هو الشرط الأساسي لكي يعمل التكامل بفعالية.
</Aside>

### تكوين Pushwoosh للتكامل

1. قم بإعداد حساب Pushwoosh إذا لم يكن لديك حساب.
2. قم بتكوين مشاريعك. [اعرف المزيد عن كيفية القيام بذلك.](/ar/product/first-steps/start-with-your-project/configure-platforms)
3. بعد ذلك، قم بإنشاء تطبيق داخل Pushwoosh وحدد قنوات الاتصال المفضلة. يمكنك اختيار استخدام تطبيق موجود إذا كان لديك واحد بالفعل.

### تكوين Solitics للتكامل

1. اتصل بـ Solitics ([support@solitics.com](mailto:support@solitics.com)) واطلب دمج علامتك التجارية مع Pushwoosh.

حدد التفاصيل التالية:

* مفتاح واجهة برمجة تطبيقات Pushwoosh (Pushwoosh API Key)
* رمز تطبيق Pushwoosh (Pushwoosh Application Code)

2. سيوفر لك فريق Solitics رمز وصول للتفاعلات المستقبلية مع واجهة برمجة تطبيقات Solitics.

## تسجيل المستخدم

كما تم التأكيد عليه سابقًا، من المهم تسجيل المستخدمين بمعرفات مستخدم متطابقة في كل من Solitics و Pushwoosh.

<Aside type="note">
استخدم نفس معرف العضو الفريد الذي تستخدمه علامتك التجارية لتكامل الأعضاء عند التسجيل في إشعارات الدفع. لن يضمن هذا الاتساق أن يكون معرف العضو الخاص بك فريدًا فحسب، بل سيبسط أيضًا التتبع ويسهل تصحيح الأخطاء في حالة حدوث أي مشكلات.
</Aside>

### التسجيل مع Pushwoosh

يقدم Pushwoosh طريقتين لربط معرف مستخدم بجهاز معين. إذا لم تستخدم هذه الطرق، فسيستخدم Pushwoosh تلقائيًا معرف الجهاز (hardware ID) كمعرف للمستخدم.

لربط معرف مستخدم بجهاز في Pushwoosh، يمكنك اختيار إحدى الطرق التالية:

#### `setUserId`

هذه وظيفة SDK تمكنك من تعيين قيمة سلسلة كمعرف Pushwoosh، والتي ستتم مطابقتها تلقائيًا مع معرف الجهاز (HWID) الذي يستخدمه Pushwoosh لتحديد الأجهزة.

**Android**

<LinkCard title="setUserId – Android" href="https://github.com/Pushwoosh/pushwoosh-android-sdk/blob/master/Documentation/inapp/PushwooshInApp.md#1a69cdb1592ad7640a49ba8bac8a14d54d" />

**iOS**
<LinkCard title="setUserId – iOS" href="https://github.com/Pushwoosh/pushwoosh-ios-sdk/blob/master/Documentation/PushNotificationManager.md#1ad51b323a64cbedb408442f9b52cc39fd" />


#### طريقة واجهة برمجة التطبيقات `registerUser`

تتيح لك هذه الطريقة تعيين معرف مستخدم (User ID) عن بعد إلى معرف جهاز (HWID) معين من الواجهة الخلفية الخاصة بك.

يمكن العثور على معلومات مفصلة حول استخدام استدعاء واجهة برمجة التطبيقات هذا [هنا](/ar/developer/api-reference/user-centric-api#registeruser).

### التسجيل مع Solitics

عندما يتم تسجيل مستخدم لتلقي رسائل الدفع، يجب أيضًا إبلاغ Solitics. لهذا، قم بإجراء طلب HTTP التالي:

**طريقة HTTP:** POST

**نقطة النهاية:** `https://api.solitics.com/rest/subscribers/register/app`

**جسم الطلب**

```json
{
 "memberId": "1234567",
 "email": "abcd@solitics.com",
 "token": "GH2TKoXXXXXXXEj1111",
 "key": "1234567”
}
```

**معلمات الجسم**

| المعلمة | الوصف |
| ---------- | ------------------------------------------------------------------------------------------------- |
| memberID | يمثل هذا المعرف الفريد للمستخدم في Solitics (مثل معرف CRM) |
| email | البريد الإلكتروني للعضو الذي يستخدم للمصادقة الثنائية |
| token | الرمز الذي يوفره Solitics للوصول إلى واجهة برمجة تطبيقات الدفع. |
| key | يجب أن يتطابق مفتاح تسجيل الدفع للعضو مع معرف المستخدم المستخدم للتسجيل مع Pushwoosh. |

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

## اختبار التكامل

بمجرد إكمال عملية الإعداد، من الضروري إجراء اختبار للتأكد من أن التكامل يعمل كما هو متوقع. اتبع هذه الخطوات للاختبار:

1. قم بإنشاء ترويج دفع (Push Promotion) في Solitics واحفظه.

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

إذا لم تكن متأكدًا من حالة التسجيل، فلا تتردد في الاتصال بـ Solitics على [support@solitics.com](mailto:support@solitics.com) للتأكيد، بما في ذلك تفاصيل حول حالة تسجيل المستخدم ومعرف المستخدم المرتبط به.

3. ابدأ الاختبار. في ترويج Solitics، انقر فوق زر الاختبار (Test). أدخل البريد الإلكتروني أو رقم الهاتف أو معرف العضو للمشترك (المستلم المقصود لرسالة الدفع). انقر فوق إرسال (Send).

إذا كانت جميع التكوينات صحيحة، فيجب أن تظهر رسالة الدفع.