قوالب Liquid

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

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

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

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

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

الصيغة

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

ملاحظة

لمعرفة المزيد عن الصيغة، يرجى الرجوع إلى توثيق Liquid.

Objects

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

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

الإدخال

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

الإخراج

Hi Anna! We’re glad you’re back!

Tags

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

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

الإدخال

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

الإخراج (fr)

Salut!

الإخراج (es)

Hello!

عوامل Tags

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

ملاحظة

في tags التي تحتوي على أكثر من عامل and أو or، يتم فحص العوامل بالترتيب من اليمين إلى اليسار. لا يمكنك تغيير ترتيب العمليات باستخدام الأقواس — الأقواس هي أحرف غير صالحة في Liquid وستمنع tags الخاصة بك من العمل.

Filters

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

الإدخال

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

الإخراج

Hello Anna

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

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

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

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

لإضافة قالب 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 في journeys

نصيحة

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

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

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

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

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

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

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

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

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

مطلوب مساعدة المطور

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

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

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

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

كيف يعمل

تعمل الخدمة الخلفية كمزود بيانات، حيث تستجيب لطلبات HTTP بمعلومات خاصة بالمستخدم.

1. يرسل Pushwoosh طلبًا إلى خدمتك الخلفية، ويمرر معرفات خاصة بالمستخدم كمعلمات استعلام.
2. تعالج خدمتك الخلفية الطلب وتسترد البيانات المطلوبة.
3. تعيد خدمتك الخلفية استجابة JSON.
4. قبل إرسال الرسالة، يجلب Pushwoosh استجابة JSON من الخدمة الخلفية ويستخدم القيم المرجعة (مثل code) في محتوى الرسالة ديناميكيًا.

مثال على الاستجابة

{ "code": "SPECIALOFFERFORUSER12345" }

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

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 %}

يمكنك أيضًا إرسال بيانات المصادقة (أو أي بيانات أخرى) كرؤوس HTTP باستخدام المعلمة الاختيارية :headers — وهي كائن JSON لأسماء وقيم الرؤوس.

{% connected_content http://your-backend-url.com?userId={{ ${userid} }} :headers {"Authorization": "Bearer YOUR_TOKEN", "X-Api-Key": "YOUR_API_KEY"} :save result %}

:headers {...}	كائن JSON لرؤوس HTTP المرسلة مع الطلب، على سبيل المثال Authorization: Bearer <token>.

القيم الثابتة فقط

تعمل متغيرات التخصيص ${} فقط داخل عنوان URL. القيم داخل :headers ثابتة ولا يتم استيفاؤها.

أبقِ بيانات الاعتماد خارج عنوان URL

فضل استخدام :headers على معلمة استعلام URL (مثل &auth=YOUR_API_KEY) لمفاتيح API والرموز المميزة: إذا فشل الجلب، يتم كتابة عنوان URL للطلب في السجلات، مما يكشف عن أي مفتاح موضوع هناك. لا يتم تسجيل القيم داخل :headers أبدًا.

يتطلب المحتوى المتصل أيضًا تمكين قوالب محتوى Liquid لحسابك. إذا لم تكن كذلك، يتم إرسال علامة connected_content بأكملها - بما في ذلك أي مفتاح بداخلها - إلى كل مستلم كنص حرفي بدلاً من عرضها. اتصل بـدعم Pushwoosh إذا لم تكن متأكدًا مما إذا كان حسابك قد تم تمكين هذا.

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

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

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

2. بعد ذلك، أضف نص الرسالة الذي يتضمن البيانات المستردة، مثل هذا:

مرحباً، {{userid}}، احصل على رمز الترويج الشخصي الخاص بك - {{result.code}}

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

الخطوة 3. إرسال رسالة باستخدام preset المكوّن

أرسل رسالة باستخدام هذا preset باستخدام one-time push أو نموذج البريد الإلكتروني أو customer journey.

هام

إذا أعادت الخدمة حالة غير HTTP 200 OK، فلن يتم إرسال البريد الإلكتروني أو إشعار Push. هذا يضمن أن اتصالك يخرج فقط إذا تم استرداد البيانات اللازمة بنجاح.