# تسجيل الأجهزة في Pushwoosh ومزامنة البيانات مع المنصة

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

## Pushwoosh SDK

### الجوال

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

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

بالإضافة إلى ذلك، يسمح Pushwoosh SDK بتسجيل أرقام الهواتف لإشعارات الرسائل القصيرة SMS وWhatsApp. يمكنك استخدام الطرق التالية:

#### تسجيل رقم SMS

##### iOS

```
- (void)registerSmsNumber:(NSString * _Nonnull)number;
```

**مثال**

```
Pushwoosh.sharedInstance().registerSmsNumber(@"+0000000000");
```

استبدل `+0000000000` برقم الهاتف الفعلي **بتنسيق E.164** (بما في ذلك علامة "+" ورمز البلد).

##### Android

```
Pushwoosh.getInstance().registerSmsNumber(String number);
```

**مثال**

```
Pushwoosh.getInstance().registerSmsNumber("+0000000000");
```

استبدل `+0000000000` برقم هاتف المستخدم الفعلي بتنسيق E.164، بما في ذلك علامة "+" ورمز البلد.

#### تسجيل رقم WhatsApp

##### iOS

```
- (void)registerWhatsappNumber:(NSString * _Nonnull)number;
```

**مثال**

```
Pushwoosh.sharedInstance().registerWhatsappNumber(@"+0000000000");
```

استبدل `+0000000000` برقم الهاتف الفعلي **بتنسيق E.164** (بما في ذلك علامة "+" ورمز البلد).

##### Android

لتسجيل رقم هاتف مستخدم لـ WhatsApp على Android، استخدم الطريقة التالية:

```
Pushwoosh.getInstance().registerWhatsappNumber(String number);
```

**مثال**

```
Pushwoosh.getInstance().registerWhatsappNumber("+0000000000");
```

استبدل `+0000000000` برقم هاتف المستخدم الفعلي بتنسيق E.164، بما في ذلك علامة "+" ورمز البلد.

### الويب

لتسجيل الأجهزة لإشعارات الويب، استخدم [Web Push SDK](/ar/developer/pushwoosh-sdk/web-push-notifications/web-push-sdk-30/).

<Aside type="tip">
للسماح لزوار موقعك بالاشتراك في إشعارات الدفع، قم بإعداد [موجه اشتراك](/ar/developer/guides/messaging-channels/subscription-prompt/) مخصص أو افتراضي على موقعك. يؤدي هذا الموجه إلى تشغيل طلب الاشتراك الأصلي للمتصفح، حيث يمكن للمستخدمين اختيار تمكين أو حظر إشعارات الدفع عبر الويب لموقعك.
</Aside>
<video src="/start-with-your-project-subscribe-users-1.webm" title="مثال على موجه اشتراك إشعارات الويب يوضح طلب إذن الإشعارات من المتصفح" autoplay loop muted playsinline />

[تعرف على المزيد حول Pushwoosh SDK](/ar/developer/pushwoosh-sdk/pushwoosh-sdk-overview)

## Pushwoosh API

أيضًا، يمكنك استخدام **Pushwoosh API** لتسجيل الأجهزة ومزامنة البيانات. يوفر API مرونة كاملة لسيناريوهات أكثر تقدمًا.

### الجوال

لتسجيل أجهزة الجوال، استخدم طريقة [`registerDevice`](/ar/developer/api-reference/device-api/#registerdevice) API.

### البريد الإلكتروني

يوفر Pushwoosh نماذج اشتراك مدمجة يمكنك تضمينها في موقع الويب الخاص بك لجمع اشتراكات البريد الإلكتروني. تعلم كيفية [إنشاء وتضمين نموذج](/ar/product/audience-data-and-segmentation/subscription-forms/create-subscription-forms/#how-to-build-a-form) و[تخصيص الويدجت](/ar/product/audience-data-and-segmentation/subscription-forms/customize-widget/#customize-colors).

بعد جمع رسائل البريد الإلكتروني، استخدم طريقة [`registerEmail`](/ar/developer/api-reference/email-api#registeremail) API لتسجيل أجهزة البريد الإلكتروني. بدلاً من ذلك، يمكنك استخدام [`registerDevice`](/ar/developer/api-reference/device-api#registerdevice).

<Aside type="note">
يرجى ملاحظة أن طلب [`registerEmailUser`](/ar/developer/api-reference/email-api#registeremailuser) لا يسجل عنوان بريد إلكتروني في قاعدة المستخدمين الخاصة بك؛ يجب استخدامه فقط لتعيين User IDs لرسائل البريد الإلكتروني المسجلة بالفعل بواسطة استدعاء registerEmail.
</Aside>

لربط مستخدمي تطبيقك أو زوار موقعك بعناوين بريدهم الإلكتروني، استخدم [User IDs](/ar/developer/pushwoosh-knowledge-hub/users-userids/users-userids). يتيح لك ذلك بناء Customer Journeys عبر القنوات وإرسال رسائل بريد إلكتروني بناءً على إجراءات المستخدم في تطبيقك أو على موقع الويب. سيسمح لك User ID أيضًا بعرض سجل رسائل وأحداث المستخدم في User Explorer.

**1. احصل على User ID.**

كل جهاز مسجل لمشروع Pushwoosh الخاص بك له User ID خاص به؛ افتراضيًا، يكون مساويًا لمعرف جهاز الجهاز (HWID) ويتم استرداده بواسطة طلب [`registerDevice`](/ar/developer/api-reference/device-api#registerdevice) API.

لتعيين User ID مخصص، استدعِ طريقة [`registerUser`](/ar/developer/api-reference/user-centric-api#registeruser).

**2. قم بتعيين User ID إلى عنوان بريد إلكتروني.**

استخدم طريقة [`registerEmail`](/ar/developer/api-reference/email-api#registeremail) أو [`registerEmailUser`](/ar/developer/api-reference/email-api#registeremailuser) API لربط User ID بعنوان بريد إلكتروني.

[تعرف على المزيد حول User IDs](/ar/developer/pushwoosh-knowledge-hub/users-userids/users-userids)

### الرسائل القصيرة SMS

لتسجيل أجهزة SMS في Pushwoosh، يمكنك استخدام إما طريقة [`registerDevice`](/ar/developer/api-reference/device-api#registerdevice) API أو طريقة [`createSMSMessage`](/ar/developer/api-reference/sms#createsmsmessage) API. عند استخدام الأخيرة، تأكد من تعيين المعلمة `use_auto_registration` إلى `true` لتسجيل رقم الهاتف تلقائيًا كجهاز SMS. [تعرف على المزيد](/ar/developer/api-reference/sms#createsmsmessage)

### WhatsApp

لتسجيل أجهزة WhatsApp في Pushwoosh، يمكنك استخدام إما طريقة [`registerDevice`](/ar/developer/api-reference/device-api#registerdevice) API أو طريقة [`createWhatsAppMessage`](/ar/developer/api-reference/whatsapp) API. عند استخدام الأخيرة، تأكد من تعيين المعلمة `use_auto_registration` إلى `true` لتسجيل رقم الهاتف تلقائيًا كجهاز WhatsApp.

## استيراد قاعدة المستخدمين الحالية الخاصة بك

إذا كنت تعمل مع مجموعات كبيرة من البيانات الموجودة مسبقًا، يمكنك استيراد هذه البيانات إلى Pushwoosh.

### الجوال

لترحيل قاعدة مشتركي إشعارات الدفع عبر الجوال، يرجى الاتصال بنا عبر [نموذج اتصل بنا](https://help.pushwoosh.com/hc/en-us/requests/new) وتقديم عينة من قاعدة المستخدمين الخاصة بك. سيقوم فريقنا بمراجعة تنسيق البيانات وتقييم ما إذا كان الترحيل ممكنًا.

### الويب

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

ومع ذلك، يمكن إعادة اشتراك مستخدمي الويب الذين منحوا بالفعل إذنًا لتلقي إشعارات الدفع لموقعك على الويب. [تعرف على المزيد](https://help.pushwoosh.com/hc/en-us/articles/360018326111-Migrate-your-userbase-to-Pushwoosh/?utm_content=docs&utm_term=post&utm_campaign=migrate-your-userbase-to-pushwoosh)

### البريد الإلكتروني

لـ [استيراد قاعدة بيانات مشتركي البريد الإلكتروني الخاصة بك](/ar/product/messaging-channels/emails/get-email-subscribers/#import-email-list)، قم بتحميل ملف **.csv** يحتوي على عناوين البريد الإلكتروني. سيتم تسجيل رسائل البريد الإلكتروني المستوردة كمشتركين على منصة البريد الإلكتروني. يمكنك أيضًا إرسال بيانات إضافية لكل عنوان بريد إلكتروني، مثل اسم المستلم أو جنسه أو موقعه، لتحسين تقسيم وتخصيص اتصالات البريد الإلكتروني الخاصة بك.

[استيراد رسائل البريد الإلكتروني](https://app.pushwoosh.com/applications/AEE06-2F522/import-csv/import-emails)

### الرسائل القصيرة SMS

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

[استيراد جهات اتصال SMS](https://app.pushwoosh.com/applications/AEE06-2F522/import-csv/import-sms)

### WhatsApp

لاستيراد جهات اتصال WhatsApp الخاصة بك، قم بتحميل ملف .csv يحتوي على جهات اتصال WhatsApp. يمكنك أيضًا تقديم تفاصيل إضافية، مثل اسم المستلم أو جنسه أو موقعه، لتخصيص رسائل WhatsApp الخاصة بك.

[استيراد جهات اتصال WhatsApp](https://app.pushwoosh.com/applications/AEE06-2F522/import-csv/import-whatsapp)

### Viber

لاستيراد جهات اتصال Viber الخاصة بك، قم بتحميل ملف .csv يحتوي على جهات اتصال Viber. يمكنك أيضًا تقديم تفاصيل إضافية، مثل اسم المستلم أو جنسه أو موقعه، لتخصيص رسائل Viber الخاصة بك.

[استيراد جهات اتصال Viber](https://app.pushwoosh.com/applications/AEE06-2F522/import-csv/import-viber)

## استخدام تكاملات الطرف الثالث لنقل البيانات

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

[استكشف جميع التكاملات المتاحة](/ar/product/integrations/)