انتقل إلى المحتوى

Liquid في In-App

اكتب Liquid في محتوى In-App لتعرض لكل مستخدم بياناته الخاصة: قيم Tags الخاصة به، وسمات الحدث الذي أطلق In-App، وUser ID الخاص به. على سبيل المثال، رحّب بالمستخدم باسمه واعرض الرمز الترويجي الذي تم تمريره في الحدث.

أين يعمل Liquid في In-App

Anchor link to

يعمل Liquid فقط في In-App الذي تعرضه Journey باستخدام عنصر In-App. يعمل كلا وضعي عرض الرسالة داخل التطبيق: عند التشغيل التالي للتطبيق وعند حدث.

اكتب Liquid في أحد هذه الأماكن:

  • نص كتلة في المحرر المدمج، مثل كتلة HTML أو كتلة Text. يعمل النص بكل لغات In-App.
  • ملف index.html ضمن أرشيف HTML مرفوع.
  • حقل نصي في In-App أصلي.

إضافة Liquid إلى In-App

Anchor link to

لإضافة Liquid، اكتبه في محرر In-App، ثم حدد In-App في Journey.

  1. افتح In-App في المحرر المدمج.

  2. أضف كتلة HTML، أو حدد كتلة موجودة.

  3. في حقل HTML، اكتب كود Liquid يدوياً.

    إعدادات كتلة HTML في محرر In-App مع كود Liquid يرحّب بالمستخدم حسب firstName، ويعرض الوسم loyalty_tier بأحرف كبيرة، وسمة الحدث promo_code، وشرط if للمستوى gold
  4. انقر على Save.

  5. في عنصر In-App في Journey الخاصة بك، حدد In-App في Media Source.

  6. إذا كان In-App يستخدم سمات الحدث، فاختر عند حدث في عرض الرسالة داخل التطبيق وحدد الحدث.

تعرض معاينة المحرر كود Liquid كما هو مكتوب. يرى كل مستخدم قيمه الخاصة.

في هذا المثال، firstName وloyalty_tier هما Tags، وpromo_code هي سمة للحدث الذي يعرض In-App:

<h2>
Hi, {{ firstName | default: "there" }}!
</h2>
<p>
Your {{ loyalty_tier | upcase }} code:
<b>{{ promo_code }}</b>
</p>
{% if loyalty_tier == "gold" %}
<p>Shipping is on us today.</p>
{% endif %}

البيانات التي يمكنك استخدامها

Anchor link to

تتوفر هذه القيم في Liquid الخاص بـ In-App:

القيمةما هيطريقة كتابتها
Tagجزء من بيانات المستخدم مخزّن في Pushwoosh، مثل اسم المستخدم. يعرض In-App القيمة التي يحملها لحظة عرضه.{{ loyalty_tier }}
سمة الحدثسمة للحدث المحدد في وضع عند حدث لعنصر In-App. إذا كان للسمة الاسم نفسه الذي يحمله Tag، تُستخدم قيمة السمة.{{ promo_code }}
User IDالمعرّف الذي يعيّنه تطبيقك للمستخدم.{{ userid }}, بأحرف صغيرة
HWIDمعرّف الجهاز (Hardware ID) الخاص بجهاز المستخدم في Pushwoosh.{{ hwid }}, بأحرف صغيرة

كتابة أسماء المتغيرات

Anchor link to

اتبع هذه القواعد عند كتابة اسم متغير:

  • اكتب الاسم تماماً كما هو في Pushwoosh، بما في ذلك الأحرف الكبيرة. الاسم غير المطابق، مثل {{ firstname }} لـ Tag firstName، يظهر كنص فارغ.
  • اكتب أسماء Tags والسمات دون مسافات: {{ LoyaltyTier }} لـ Tag باسم Loyalty Tier.
  • لعرض قيمة بديلة بدلاً من النص الفارغ، أضف المرشح default: {{ firstName | default: "there" }}.

تغيير طريقة عرض القيمة

Anchor link to

لتغيير طريقة عرض القيمة، أضف مرشح Liquid. تعمل جميع المرشحات القياسية، مثل upcase وcapitalize وdate وtruncate، وكذلك مرشح Pushwoosh timezone.

قيود Liquid في In-App

Anchor link to

في In-App، لـ Liquid القيود التالية:

  • إذا أرسلت In-App كحملة رسائل فورية داخل التطبيق (الحملات > رسائل فورية داخل التطبيق)، فلن يُطبَّق Liquid وسيرى المستخدمون الكود كما هو مكتوب. استخدم بدلاً من ذلك العناصر النائبة لـالمحتوى الديناميكي.
  • {% include %} غير مدعوم. اكتب الكود كاملاً في In-App نفسه.
  • المحتوى المتصل غير مدعوم. استخدم بدلاً منه القيم الواردة في البيانات التي يمكنك استخدامها.
  • إذا كان حجم أرشيف In-App أكبر من 1 ميغابايت، فلن يُطبَّق Liquid وسيرى المستخدم الكود كما هو مكتوب.
  • إذا كان في كود Liquid خطأ، مثل {% if %} غير مغلق، فسيرى المستخدم In-App مع الكود كما هو مكتوب. تحقق من In-App على جهازك قبل إطلاق Journey.