# إرسال البيانات إلى التطبيق

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

يسمح لك عنصر **Data to app** في Journey بإرسال بيانات مخصصة أو [إشعارات دفع صامتة](/ar/product/messaging-channels/push-notifications/advanced-push-features/silent-push-notifications) وتقديم بيانات يمكن لتطبيقك تفسيرها والتصرف بناءً عليها، مما يعزز تفاعل المستخدم ووظائف التطبيق.

## ما هي البيانات المخصصة؟

البيانات المخصصة هي معلومات إضافية تُرسل مع إشعار الدفع. تكون هذه البيانات عادةً بتنسيق JSON ويمكن أن تتضمن معلمات مختلفة توجه التطبيق لأداء إجراءات محددة عند استلام الإشعار.

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

## كيفية إرسال بيانات مخصصة باستخدام عنصر إرسال البيانات إلى التطبيق

1. أضف عنصر إرسال البيانات إلى التطبيق إلى لوحة Journey.

<img src="/journey-elements-README-20.webp" alt="إضافة عنصر إرسال البيانات إلى التطبيق على لوحة Journey"/>

2. الصق كود JSON الخاص بك في الحقل المخصص.

<img src="/journey-elements-README-21.webp" alt="إدخال حمولة JSON في عنصر إرسال البيانات إلى التطبيق"/>

3. بعد إدخال بيانات JSON الخاصة بك، انقر على **حفظ** لتطبيق الإعدادات.
### استخدام القسائم

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

لإعداد القسائم:

1. قم بتضمين العنصر النائب `{{voucher}}` في حمولة JSON الخاصة بك.
   
   **مثال:**

   ```json
   {
     "message": "تهانينا! لقد تلقيت خصمًا خاصًا: {{voucher}}"
   }
   ```

2. في إعدادات عنصر إرسال البيانات إلى التطبيق، قم بتبديل **القسائم** إلى وضع التشغيل ON.

3. اختر **مجمع القسائم** المناسب الذي يحتوي على الأكواد المتاحة (تأكد من إنشائه مسبقًا).

4. (اختياري) استخدم **تعيين Tag** لتصنيف المستخدمين الذين يتلقون قسائم للتتبع أو التقسيم.

[تعرف على المزيد حول القسائم](/ar/product/content/vouchers/)

## أمثلة على استخدام إرسال البيانات إلى التطبيق

#### إرسال إشعارات دفع صامتة

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

#### تتبع إلغاء التثبيت

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

#### تحديث تطبيقك بشكل استباقي

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

##### مثال JSON

```
{
  "Action": "UpdateApp"
}
```

#### اختبار قسم أو وحدة جديدة في تطبيقك

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

##### مثال JSON

```
{
"EnableNewFeatureSection" : "Yes"
}
```

#### تحديث أيقونة التطبيق

غيّر أيقونة التطبيق ديناميكيًا.
##### مثال JSON

```
{
  "UpdateAppIcon": "https://example.com/new-icon.png"
}

```

#### تسليم أكواد ترويجية وخصومات

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

##### مثال JSON

```
{
  "ApplyPromoCode": "DISCOUNT2024"
}
```

#### منح نقاط إضافية للمستخدمين

أرسل إشعارات دفع مع بيانات مخصصة لمنح نقاط إضافية. عندما ينقر المستخدم على الإشعار، يتم إضافة النقاط الإضافية إلى حسابه تلقائيًا.

##### مثال JSON

```
{
"AddPromo" : "+1000"
}
```

[تعرف على المزيد حول كيفية تخصيص رسائلك بالبيانات المخصصة](/ar/product/messaging-channels/push-notifications/advanced-push-features/using-custom-data)