انتقل إلى المحتوى
وثائق المطورالدعم طلب عرض توضيحي تسجيل الدخول
Pushwoosh.com

قوالب Liquid

فيديو يوتيوب: تعلم كيفية استخدام قوالب المحتوى في رحلات العملاء

توسع قوالب Liquid بشكل كبير من إمكانيات التخصيص في Pushwoosh من خلال تطبيق منطق متطور بالإضافة إلى استخدام المحتوى الديناميكي العادي.

يعتمد تخصيص الرسائل في Pushwoosh على Tags (بيانات المستخدم). يقدم Pushwoosh مجموعة متنوعة من Tags الافتراضية و Tags المخصصة. باستخدامها، يمكنك تحديد الاسم الأول للمستخدم، والمدينة، وسجل الشراء، وما إلى ذلك لإرسال رسالة أكثر تخصيصًا. على سبيل المثال: مرحبًا {{First_name}}، شكرًا لطلبك {{item}}.

تضيف قوالب Liquid المزيد من المنطق إلى المحتوى الديناميكي. على سبيل المثال، إذا كان Tag اشتراك المستخدم يحتوي على “free”، يمكنك إرسال رسالة له: “احصل على خصم 10%”.

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

الصيغة

Anchor link to

تستخدم قوالب المحتوى المستندة إلى Liquid by Shopify مزيجًا من tags و objects و filters لتحميل المحتوى الديناميكي. تتيح لك قوالب المحتوى الوصول إلى متغيرات معينة من داخل القالب وإخراج بياناتها دون الحاجة إلى معرفة أي شيء عن البيانات نفسها.

Objects

Anchor link to

تحدد objects المحتوى الذي سيتم عرضه للمستخدم. يجب أن تكون objects محاطة بأقواس متعرجة مزدوجة: {{ }}

على سبيل المثال، عند تخصيص رسالة، أرسل {{Name}} في نصها لإضافة أسماء المستخدمين إلى محتوى الرسالة. سيحل اسم المستخدم (قيمة Name tag) محل كائن Liquid في الرسالة التي سيراها المستخدم.

Hi {{Name}}! We're glad you're back!

Tags

Anchor link to

تنشئ tags المنطق وتدفق التحكم للقوالب. لا تنتج المحددات المئوية للأقواس المتعرجة {% و %} والنص الذي تحيط به أي إخراج مرئي عند عرض القالب. يتيح لك هذا تعيين متغيرات وإنشاء شروط أو حلقات دون إظهار أي من منطق Liquid للمستخدم.

على سبيل المثال، باستخدام if tag، يمكنك تغيير لغة الرسالة بناءً على اللغة المحددة على جهاز المستخدم:

{% if Language == 'fr' %}
Salut!
{% else %}
Hello!
{% endif %}

عوامل تشغيل Tags

Anchor link to
عامل التشغيلالوصف
==يساوي
!=لا يساوي
>أكبر من
<أصغر من
>=أكبر من أو يساوي
<=أصغر من أو يساوي
orأو المنطقي
andو المنطقي
containsيتحقق من وجود سلسلة فرعية داخل سلسلة نصية أو مصفوفة من السلاسل النصية

Filters

Anchor link to

تعدل filters إخراج كائن أو متغير Liquid. يتم استخدامها داخل الأقواس المتعرجة المزدوجة {{ }} وتعيين المتغيرات، ويتم فصلها بحرف الأنبوب |. يمكن استخدام فلاتر متعددة على إخراج واحد، ويتم تطبيقها من اليسار إلى اليمين.

{{ Name | capitalize | prepend:"Hello " }}

استخدام قوالب Liquid

Anchor link to

تتوفر قوالب Liquid لكل من الرسائل المرسلة من Control Panel و طلبات API.

في Pushwoosh، تنطبق قوالب Liquid على جميع حقول المحتوى لأي رسالة قناة:

  • إشعارات الدفع
  • رسائل البريد الإلكتروني

لإضافة قالب Liquid إلى رسالتك، أدخله في نص الرسالة. يمكنك القيام بذلك عند العمل مع عناصر push أو email، مباشرة من واجهة Customer Journey Builder.

اذهب إلى Customer Journey Builder > Create Campaign > اسحب وأفلت العناصر التالية إلى لوحتك: Audience-based Entry، Push (أو Email)، و Exit. قم بتوصيل العناصر. ثم انقر على أيقونة Push، اختر Custom content، وأدخل نسختك.

لإضافة منطق Liquid، استخدم قيم tag بالصيغة التالية:

{% if TagName == 'value' %}
  المحتوى الذي سيتم إرساله في هذا السيناريو
{% else %}
  المحتوى الذي سيتم إرساله خلاف ذلك
{% endif %}

ثم انقر على Apply.

يجب ألا تحتوي متغيرات القالب (Pushwoosh Tags) على أي مسافات وأن تحتوي فقط على قيم أبجدية رقمية وشرطات سفلية، على سبيل المثال، my_tag أو myTag بدلاً من My Tag.

تعرف على المزيد حول قوالب Liquid في الرحلات

المحتوى المتصل

Anchor link to

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

حالات الاستخدام الرئيسية

Anchor link to

  • توصيات المنتجات: عرض قوائم منتجات مخصصة مصممة لكل مستخدم.

  • رموز الترويج: إدراج رموز ترويج فريدة تم إنشاؤها بواسطة خدمة خلفية.

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

Anchor link to
  • لاستخدام المحتوى المتصل، يجب أن يكون لديك خدمة خلفية خاصة بك تقوم بإنشاء وتوفير البيانات المطلوبة (مثل رموز الترويج، توصيات المنتجات) بناءً على User ID، HWID، أو custom tags. يقوم Pushwoosh بعد ذلك بجلب هذه البيانات قبل إرسال الرسالة.

دليل التنفيذ خطوة بخطوة

Anchor link to

الخطوة 1. إعداد الخدمة الخلفية

Anchor link to

يجب أن تقوم الخدمة الخلفية بما يلي:

  • قبول طلب يحتوي على معلمات خاصة بالمستخدم (مثل userId). يدعم المحتوى المتصل UserID، HWID، أو أي custom tags قمت بإعدادها في مشروعك.
  • إرجاع استجابة JSON بالبيانات المطلوبة. يمكن بعد ذلك إدراج هذا المحتوى ديناميكيًا في الرسائل.

الخطوة 2. إنشاء إعداد مسبق مع محتوى متصل في Pushwoosh

Anchor link to
  1. في محرر محتوى Push أو محرر محتوى البريد الإلكتروني، أدخل صيغة المحتوى المتصل في حقل الرسالة.

مثال

{% connected_content http://your-backend-url.com?userId={{ ${userid} }} :save result %}

تفصيل الصيغة

connected_contentيجلب بيانات JSON من عنوان URL الخلفي المحدد.
http://your-backend-url.comنقطة النهاية الخلفية التي تعيد البيانات المطلوبة بتنسيق JSON.
userId={{ ${userid} }}معلمة استعلام ديناميكية تمرر معرف المستخدم إلى الواجهة الخلفية.
:save resultيخزن استجابة JSON التي تم جلبها في متغير result لاستخدامه في قوالب Liquid

أدخل صيغة المحتوى المتصل

المصادقة (اختياري)

إذا كانت خدمتك الخلفية تتطلب المصادقة، يمكنك تضمين مفتاح API أو رمز مميز في طلب المحتوى المتصل لضمان الوصول الآمن.

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}&auth=YOUR_API_KEY :save result %}

استخدام tags في المحتوى المتصل

لتضمين custom tags، أدخلها كمعلمات استعلام في طلب المحتوى المتصل ({{ tag_name }}).

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}{{ Language }} :save result %}
  1. بعد ذلك، أضف نص الرسالة الذي يتضمن البيانات المستردة، مثل هذا:
Hey, {{userid}}, grab your personal promo code - {{result.code}}

أضف نص الرسالة مع البيانات المستردة

  1. بعد الانتهاء من محتوى الرسالة وتكوين إعدادات الإعداد المسبق، احفظه لإعادة استخدامه في الحملات.

الخطوة 3. إرسال رسالة باستخدام الإعداد المسبق الذي تم تكوينه

Anchor link to

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