# تكامل Shopify

## نظرة عامة على التكامل

يتكامل Pushwoosh بسلاسة مع Shopify، وهي منصة تجارة إلكترونية رائدة تمكّن الشركات من إنشاء وإدارة وتوسيع المتاجر عبر الإنترنت. يرشدك هذا الدليل خلال عملية تثبيت وتكوين تطبيق Pushwoosh في متجر Shopify الخاص بك، وإعداد تعريف المستخدم، واستخدام الإشعارات وأدوات الأتمتة لإشراك العملاء عبر قنوات مثل الإشعارات الفورية (push)، والبريد الإلكتروني، والرسائل القصيرة (SMS)، وWhatsApp.
### نوع التكامل

- **الوجهة**: يرسل Shopify بيانات العملاء إلى Pushwoosh، حيث يتم استخدامها للاستهداف والمراسلة.

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

* [حساب Pushwoosh](https://www.pushwoosh.com/)
* الوصول إلى لوحة تحكم Shopify الخاصة بك
* [رمز الوصول لواجهة برمجة تطبيقات الجهاز (Device API Access Token)](/ar/developer/api-reference/api-access-token/#device-api-token) و**رمز التطبيق (Application Code)** من Pushwoosh
* متجر Shopify مع توفر بيانات العملاء والطلبات

### الكيانات المتزامنة

* **العملاء**: يُستخدم لتعيين وتحديد UserIDs في Pushwoosh عبر الحقول الوصفية (metafields) في Shopify

<Aside>
##### أساليب مزامنة العملاء في Pushwoosh

نظرًا للقيود التقنية، يقدم Pushwoosh عدة طرق لمزامنة العملاء، اعتمادًا على قناة الاتصال المستخدمة للإشعارات:

* **البريد الإلكتروني، الويب، الرسائل القصيرة وWhatsApp**: يتم تسجيل الأجهزة/المستخدمين تلقائيًا في تطبيق Pushwoosh.
* **تطبيقات الجوال وسطح المكتب**: يمكن مزامنة الأجهزة/المستخدمين يدويًا عبر لوحات تحكم Pushwoosh وShopify.
* **منصات الويب (Chrome, Firefox, Safari)**: تتم إدارة الأجهزة/المستخدمين بواسطة ملحق سمة Shopify نفسه.

##### كيف يعمل؟
تعمل عملية المزامنة على النحو التالي:

1. يحاول النظام استرداد جلسة المستخدم الحالية للحصول على بريد إلكتروني أو رقم هاتف (معرفات تعمل بدون تكوين إضافي).
2. إذا نجح ذلك، يتم تعيين البريد الإلكتروني أو رقم الهاتف كمعرف `userID` لكل من Pushwoosh وخاصية `pushwoosh_userid` في بيانات العميل.
3. إذا لم يكن هذا ممكنًا، يتم تعيين `userID` الافتراضي لـ Pushwoosh SDK كمعرف لكل من Pushwoosh وخاصية `pushwoosh_userid`.
4. في كلتا الحالتين، سيتم تعيين `userID` على كلا الجانبين، مما يضمن مزامنة متسقة.

</Aside>

* **شرائح العملاء**: تُستخدم للاستهداف والمراسلة القائمة على المجموعات
* **الأحداث والمشغلات** (على سبيل المثال، الطلبات المقدمة، العلامات المطبقة): تُستخدم في Shopify Flow لأتمتة المراسلة عبر القنوات
* **واجهة المتجر**: تُستخدم للحصول على موافقات إشعارات الويب الفورية (web push) من خلال البرامج النصية المضمنة

### مسرد المصطلحات (ربط أسماء الكيانات إذا كانت مختلفة)

| **Shopify**   <div style="width:150px"></div>               | **Pushwoosh**      <div style="width:150px"></div>                                         |
| -------------------------- | --------------------------------------------------------- |
| Customer                   | UserID           |

## كيف يعمل التكامل

يعمل Pushwoosh كوجهة مراسلة لـ Shopify. بمجرد التكامل، يرسل Shopify بيانات العملاء والسلوك إلى Pushwoosh، حيث تدعم الإشعارات في الوقت الفعلي، وتقسيم العملاء، والمراسلة الشخصية عبر القنوات.

### المكونات الرئيسية للتكامل

1. **تحديد العميل عبر الحقول الوصفية (metafields)**
    يتم تعيين `UserID` فريد لكل عميل في Shopify، ويتم تخزينه في حقل وصفي (`custom.pushwoosh_userid`). يسمح هذا المعرف لـ Pushwoosh بالتعرف على المستخدمين ومراسلتهم باستمرار عبر المنصات.

2. **الأتمتة القائمة على الأحداث عبر Shopify Flow**
    يوفر Pushwoosh إجراءات Flow تسمح لك بأتمتة المراسلة (push, email, SMS, WhatsApp) بناءً على أحداث Shopify، مثل:

   * تقديم طلب جديد
   * تطبيق علامة على العميل
   * التخلي عن عربة التسوق

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

4. **المراسلة اليدوية وفي الوقت الفعلي**
    من عرض العميل أو الشريحة في Shopify، يمكنك تشغيل الإشعارات يدويًا باستخدام ملحقات Pushwoosh:

   * **Notification by Customer**: للمتابعة الشخصية أو الاختبار
   * **Notification by Segment**: للرسائل القائمة على الحملات

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

#### نظرة عامة على تدفق البيانات

```
Shopify Customer & Event Data
         ↓
Pushwoosh API (via App)
         ↓
UserID → Segmentation → Triggered or Manual Notifications
```
يمكّنك هذا التكامل من تقديم رسائل ذات صلة وفي الوقت المناسب تعمل على تحسين الاحتفاظ بالمستخدمين، وزيادة التحويلات، وتعزيز تجربة العملاء — تلقائيًا أو عند الطلب.

## الجزء 1. التثبيت

### تسجيل الدخول إلى Shopify

1. اذهب إلى [Shopify Admin](https://admin.shopify.com/)
2. اختر متجرك من لوحة التحكم

<Aside>يفترض هذا الدليل أن لديك حساب Pushwoosh بالفعل. إذا لم يكن كذلك، [أنشئ واحدًا](https://www.pushwoosh.com/)</Aside>


### تثبيت تطبيق Pushwoosh

1. قم بزيارة [صفحة تطبيق Pushwoosh في متجر التطبيقات](https://apps.shopify.com/pushwoosh-notifications)
2. انقر على **Install**
![تثبيت تطبيق Pushwoosh](/integrations-shopify-integration-19.webp)
3. قم بتأكيد التثبيت في مربع حوار Shopify
![تأكيد التثبيت](/integrations-shopify-integration-1.webp)

### ربط تطبيق Pushwoosh الخاص بك

بعد التثبيت، سيتم إعادة توجيهك إلى تطبيق Pushwoosh داخل Shopify.

1. انقر على **Connect**.

![انقر على زر Connect](/integrations-shopify-integration-22.webp)

2. أدخل **Application Code** و[Device API Access Token](/ar/developer/api-reference/api-access-token/#device-api-token)، والذي يمكنك العثور عليه في **Pushwoosh Control Panel → Settings → API Access**.

![ربط تطبيق Pushwoosh الخاص بك](/integrations-shopify-integration-2.webp)

عند الاتصال، ستظهر رسالة نجاح: "Pushwoosh app connected."

![تم ربط تطبيق Pushwoosh](/integrations-shopify-integration-3.webp)

### الاشتراك في خطة

1. انقر على **Upgrade Subscription**
2. سيتم عرض خطة واحدة قائمة على الاستخدام.
3. قم بتأكيد الفوترة.

![الاشتراك في خطة](/integrations-shopify-integration-4.webp)


<Aside>الفوترة مطلوبة لاستخدام ميزات تسليم الرسائل والتقسيم.</Aside>

##  الجزء 2. الإعداد: User ID للعميل عبر الحقول الوصفية (metafields)

لتقديم الإشعارات للمستخدمين المحددين عبر القنوات (push, email, SMS, WhatsApp)، يستخدم Pushwoosh **User ID** فريدًا لكل عميل. يخزن Shopify هذه القيمة داخل **Customer metafields** في Shopify.

1. اذهب إلى **Settings → Metafields and metaobjects → Customers**

![إضافة تعريف](/integrations-shopify-integration-6.webp)

2. انقر على **Add definition** واستخدم هذه القيم:

| الحقل                   | القيمة                    |
| ----------------------- | ------------------------ |
| Namespace and key       | custom.pushwoosh_userid |
| Namespace               | custom                   |
| Type                    | Single line text         |
| Validation              | None                     |
| Customer Account Access | Read and Write           |
| Storefront API Access   | Enabled                  |


![إضافة تعريف](/integrations-shopify-integration-7.webp)
![إضافة تعريف](/integrations-shopify-integration-9.webp)


<Aside type="caution" title="لماذا هذا مهم">
هذا الحقل الوصفي هو معرف مستخدم دائم عبر أجهزة الجوال/الويب للإشعارات والتقسيم.
</Aside>


## الجزء 3. استخدام ملحقات Pushwoosh

يتضمن Pushwoosh ملحقات Shopify لاستهداف الشرائح، والأتمتة (Flow)، والإشعارات الخاصة بالعملاء.

### الملحق 1. إرسال إشعار حسب العميل

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

إرسال رسائل شخصية يدويًا أو اختبار الإشعارات لمستخدم معين.

#### الخطوات

1. افتح **Customers → Select a customer**  
2. انقر على **More actions → Notification by customer**  
![إشعار حسب العميل](/integrations-shopify-integration-10.webp)
3. اختر منصة المراسلة (على سبيل المثال، Email) و[إعداد محتوى مسبق (preset)](/ar/product/content/push-presets/).
![املأ النموذج](/integrations-shopify-integration-11.webp)
4. انقر على **Send**  


<Aside type="tip">
استخدم هذا لتذكيرات ما بعد الشراء، أو رسائل الشكر الشخصية، أو رسائل إعادة التنشيط.
</Aside>

###  الملحق 2. إشعار حسب الشريحة

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

استهداف مجموعات من العملاء — عربات التسوق المتروكة، المشترون لأول مرة، المنفقون بكثرة.

#### الخطوات

1. اذهب إلى **Customers → Segments**

2. اختر شريحة → انقر على **Use Segment**

![استخدام الشريحة](/integrations-shopify-integration-12.webp)

3. اختر **Notification by Segment**
![إشعار حسب الشريحة](/integrations-shopify-integration-13.webp)
4. اختر قناة الاتصال المطلوبة وإعداد الرسالة المسبق. انقر على **Send**.
![املأ نموذج الرسالة](/integrations-shopify-integration-14.webp)
<Aside type="tip">
يمكن إنشاء الشرائح بناءً على سجل الشراء، أو الموقع، أو النشاط، أو العلامات.
</Aside>


### الملحق 3. Pushwoosh في Shopify Flow

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

أتمتة المراسلة في رحلات العملاء باستخدام مشغلات مثل الطلبات، أو العلامات، أو السلوك.

#### الخطوات

1. أنشئ Flow جديدًا في **Shopify Flow**
2. أضف إجراء → اختر **Pushwoosh notifications**

![إجراء Pushwoosh flow](/integrations-shopify-integration-15.webp)

3. قم بتكوين الرسالة والحقول الديناميكية

![تكوين الرسالة والحقول الديناميكية](/integrations-shopify-integration-16.webp)


على سبيل المثال:

* إرسال رسالة بعد تقديم الطلب

* تذكير المستخدم عند التخلي عن عربة التسوق

* إرسال إشعار إعادة تنشيط بعد 30 يومًا من عدم النشاط

## الجزء 4. تمكين إشعارات الويب بوش (اختياري ولكن موصى به)

لدعم إشعارات الويب بوش المستندة إلى المتصفح على واجهة متجرك، قم بما يلي:

1. اذهب إلى **Online Store → Themes → Customize**  
![اذهب إلى Themes → Customize](/integrations-shopify-integration-17.webp)
2. افتح **App Embeds** من القائمة اليسرى  
3. قم بتبديل **Push Init Embed** إلى وضع التشغيل (ON)

![تبديل Push Init Embed إلى وضع التشغيل](/integrations-shopify-integration-18.webp)

<Aside type="note">
الآن يمكن لمتجرك أن يطالب المستخدمين بالاشتراك في إشعارات الويب بوش مباشرة من واجهة المتجر.
</Aside>


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

| السيناريو | الأداة المستخدمة |
| ----- | ----- |
| متابعة شخصية | Notification by Customer |
| تذكير بالتخلي عن عربة التسوق | Shopify Flow + Pushwoosh action |
| عرض ترويجي قائم على الشريحة | Notification by Segment |
| رسالة ترحيب بعد التسجيل | Flow + Metafield tracking |
| الاشتراك في الإشعارات الفورية (Push) | Theme Embed + Push Init Toggle |