# تكامل mParticle

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

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

[mParticle](https://www.mparticle.com/) هي منصة لإدارة بيانات العملاء التي يتم جمعها من تطبيقات الجوال والويب ومصادر أخرى.

إذا كنت تستخدم mParticle لتخزين بيانات العملاء، يمكنك بسهولة إعداد التكامل مع Pushwoosh. سيسمح لك هذا بإنشاء حملات مستهدفة وشخصية وفعالة في Pushwoosh باستخدام البيانات من mParticle.

يمكنك إرسال البيانات التالية من mParticle إلى Pushwoosh:

*   **سمات المستخدم (User attributes)**: الاسم، الموقع، الجهاز، التفضيلات، السلوك، إلخ. سيتم حفظ هذه البيانات في Pushwoosh كـ [Tags](/ar/product/audience-data-and-segmentation/user-data-tags/tags/) وقيمها لكل مستخدم. يتم تحديد نوع البيانات لكل Tag تلقائيًا.
*   **الأحداث (Events)**: سيتم نقل كل Event تم تكوينه في mParticle إلى Pushwoosh وحفظه كـ [Event](/ar/product/audience-data-and-segmentation/events/default-events/) بنفس الاسم والعلامات إذا وجدت. سيحصل Pushwoosh أيضًا على معلومات حول الأحداث التي قام كل مستخدم بتشغيلها.
*   **الشرائح (Segments)**: يمكن نقل جميع جماهير mParticle (Audiences) المستندة إلى سمات المستخدم والأحداث التي تم تشغيلها إلى Pushwoosh كشرائح (Segments). يمكنك استخدامها لإنشاء حملات عالية الاستهداف. إذا تم تحديث شريحة جمهور في mParticle، فسيتم تحديث تلك الشريحة أيضًا في Pushwoosh. يتم تكوين تردد تحديث شرائح mParticle من جانب mParticle.

<Aside type="note">
يرجى ملاحظة أنه لا ينبغي تسمية Tags و Events في mParticle بنفس أسماء Tags و Events الافتراضية في Pushwoosh. إذا تطابقت الأسماء، فقد لا يتم نقل البيانات.
</Aside>

لا يتم نقل البيانات مرة أخرى من Pushwoosh إلى mParticle، لكننا نخطط لإضافة هذا الخيار في المستقبل، لذا ترقبوا.

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

<Aside type="note">
لإعداد تكامل mParticle و Pushwoosh، لا تحتاج إلى دمج Pushwoosh SDK في تطبيقك. هذا مطلوب فقط إذا قمت بإنشاء حملات تتضمن رسائل داخل التطبيق (in-app messages).
</Aside>

1.  [في واجهة mParticle](https://app.mparticle.com/login)، انتقل إلى قسم **Directory** وابحث عن **Pushwoosh** في القائمة. مرر مؤشر الماوس فوق الرمز وانقر على **Setup**.

<img src="/integrations-mparticle-integration-1.webp" alt="العثور على Pushwoosh في دليل mParticle"/>

2.  حدد كلاً من **Event** و **Audience** كمخرجات (Outputs) وانقر على **Configure**:

<img src="/integrations-mparticle-integration-2.webp" alt="تحديد مخرجات Event و Audience في mParticle" width="375"/>

3.  في الصفحة التي تفتح (**Setup** → **Outputs**)، انقر على أيقونة علامة الجمع في صف **Pushwoosh Default Group**:

<img src="/integrations-mparticle-integration-3.webp" alt="مجموعة Pushwoosh الافتراضية في مخرجات mParticle"/>

أدخل أي اسم للتكوين (على سبيل المثال، _Pushwoosh integration_)، ورمز تطبيق Pushwoosh، ومفتاح API. انقر على **Save**.

<details>

<summary>أين يمكنني العثور على رمز التطبيق ومفتاح API؟</summary>

يمكنك العثور على رمز التطبيق في الزاوية العلوية اليسرى من واجهة Pushwoosh، أسفل اسم المشروع مباشرة:

<img src="/integrations-mparticle-integration-4.webp" alt="العثور على رمز التطبيق في واجهة Pushwoosh" data-size="original"/>

للعثور على مفتاح API، انتقل إلى **Settings** → **API Access**:

<img src="/integrations-mparticle-integration-5.webp" alt="قسم الوصول إلى API في إعدادات Pushwoosh" data-size="original"/>

</details>

<img src="/integrations-mparticle-integration-6.webp" alt="إعدادات التكوين لتكامل Pushwoosh" width="375"/>

الآن انتقل إلى علامة التبويب **Audience** وكرر هذه الخطوات لصف **Pushwoosh Default**:

<img src="/integrations-mparticle-integration-7.webp" alt="تكوين علامة تبويب Audience في mParticle"/>

4.  انتقل إلى **Connections** → **Connect** وانقر على المدخل (Input) الذي تريد دمجه مع Pushwoosh.

<img src="/integrations-mparticle-integration-8.webp" alt="قسم الاتصالات في واجهة mParticle"/>

انقر على **Connect Output**، وحدد **Pushwoosh**، وقم بتنشيط الاتصال.

<img src="/integrations-mparticle-integration-9.webp" alt="توصيل مخرج Pushwoosh في mParticle"/>

كرر هذه الخطوات لكل مدخل (Input) تريد دمجه مع Pushwoosh.

إذا تم تكوين كل شيء بشكل صحيح، سيبدأ Pushwoosh في تلقي البيانات من mParticle، وستتمكن من إنشاء [رحلات العملاء (customer journeys)](/ar/product/customer-journey/pushwoosh-journey-overview) وإرسال [إشعارات الدفع (push notifications)](/ar/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/) باستخدام بيانات العملاء من mParticle.