Liquid টেমপ্লেট ব্যবহার করা

Liquid টেমপ্লেটগুলি নিয়মিত ডাইনামিক কন্টেন্ট ব্যবহারের পাশাপাশি অত্যাধুনিক যুক্তি প্রয়োগ করে Pushwoosh-এর ব্যক্তিগতকরণ ক্ষমতাকে উল্লেখযোগ্যভাবে প্রসারিত করে।

Pushwoosh-এ মেসেজ ব্যক্তিগতকরণ ট্যাগ (ব্যবহারকারীর ডেটা) এর উপর ভিত্তি করে করা হয়। Pushwoosh বিভিন্ন ধরনের ডিফল্ট ট্যাগ এবং কাস্টম ট্যাগ অফার করে। এগুলি ব্যবহার করে, আপনি আরও ব্যক্তিগতকৃত মেসেজ পাঠানোর জন্য ব্যবহারকারীর প্রথম নাম, শহর, ক্রয়ের ইতিহাস ইত্যাদি নির্দিষ্ট করতে পারেন, উদাহরণস্বরূপ: হাই {First_name}, {item} অর্ডার করার জন্য ধন্যবাদ।

Liquid টেমপ্লেট ডাইনামিক কন্টেন্টে আরও যুক্তি যোগ করে। উদাহরণস্বরূপ, যদি কোনও ব্যবহারকারীর সাবস্ক্রিপশন ট্যাগে “free” থাকে, আপনি তাদের একটি মেসেজ পাঠাতে পারেন: “আপনার ১০% ছাড় নিন।”

ব্যবহারকারীদের আইডি, আচরণ এবং পছন্দের উপর ভিত্তি করে মেসেজের কন্টেন্ট পরিবর্তন করা হল প্রাসঙ্গিকতা বাড়ানোর এবং আপনার মার্কেটিং ক্যাম্পেইন থেকে আরও চিত্তাকর্ষক ফলাফল পাওয়ার সবচেয়ে কার্যকর উপায়।

সিনট্যাক্স

Shopify-এর Liquid এর উপর ভিত্তি করে কন্টেন্ট টেমপ্লেটগুলি ডাইনামিক কন্টেন্ট লোড করার জন্য ট্যাগ, অবজেক্ট, এবং ফিল্টার এর সংমিশ্রণ ব্যবহার করে। কন্টেন্ট টেমপ্লেটগুলি আপনাকে একটি টেমপ্লেটের মধ্যে থেকে নির্দিষ্ট ভেরিয়েবল অ্যাক্সেস করতে এবং ডেটা সম্পর্কে কিছু না জেনেই তাদের ডেটা আউটপুট করতে দেয়।

নোট

সিনট্যাক্স সম্পর্কে আরও জানতে, অনুগ্রহ করে Liquid ডকুমেন্টেশন দেখুন।

অবজেক্ট

অবজেক্ট গুলি সেই কন্টেন্টকে সংজ্ঞায়িত করে যা একজন ব্যবহারকারীকে দেখানো হবে। অবজেক্ট গুলি ডাবল কার্লি ব্রেসের মধ্যে থাকা উচিত: {{ }}

উদাহরণস্বরূপ, একটি মেসেজ ব্যক্তিগতকরণ করার সময়, ব্যবহারকারীদের নাম মেসেজের কন্টেন্টে যোগ করতে এর বডিতে {{Name}} পাঠান। ব্যবহারকারীর নাম (Name ট্যাগের মান) ব্যবহারকারী যে মেসেজটি দেখবেন তাতে Liquid অবজেক্টটিকে প্রতিস্থাপন করবে।

ইনপুট

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

আউটপুট

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

ট্যাগ

ট্যাগ টেমপ্লেটগুলির জন্য যুক্তি এবং নিয়ন্ত্রণ প্রবাহ তৈরি করে। কার্লি ব্রেস শতাংশ ডিলিমিটার {% এবং %} এবং তাদের ঘিরে থাকা টেক্সট টেমপ্লেট রেন্ডার করার সময় কোনও দৃশ্যমান আউটপুট তৈরি করে না। এটি আপনাকে কোনও Liquid যুক্তি ব্যবহারকারীকে না দেখিয়ে ভেরিয়েবল অ্যাসাইন করতে এবং শর্ত বা লুপ তৈরি করতে দেয়।

উদাহরণস্বরূপ, if ট্যাগ ব্যবহার করে, আপনি ব্যবহারকারীর ডিভাইসে কোন ভাষা সেট করা আছে তার উপর ভিত্তি করে মেসেজের ভাষা পরিবর্তন করতে পারেন:

ইনপুট

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

আউটপুট (fr)

Salut!

আউটপুট (es)

Hello!

ট্যাগ অপারেটর

অপারেটর	বর্ণনা
==	সমান
!=	সমান নয়
>	বড়
<	ছোট
>=	বড় বা সমান
<=	ছোট বা সমান
or	লজিক্যাল or
and	লজিক্যাল and
contains	একটি স্ট্রিং বা স্ট্রিং এর অ্যারের মধ্যে একটি সাবস্ট্রিং এর উপস্থিতি পরীক্ষা করে

নোট

একাধিক and বা or অপারেটর সহ ট্যাগগুলিতে, অপারেটরগুলি ডান থেকে বামে ক্রমানুসারে পরীক্ষা করা হয়। আপনি বন্ধনী ব্যবহার করে অপারেশনের ক্রম পরিবর্তন করতে পারবেন না — বন্ধনী Liquid-এ অবৈধ অক্ষর এবং আপনার ট্যাগগুলিকে কাজ করতে বাধা দেবে।

ফিল্টার

ফিল্টার একটি Liquid অবজেক্ট বা ভেরিয়েবলের আউটপুট পরিবর্তন করে। এগুলি ডাবল কার্লি ব্রেস {{ }} এবং ভেরিয়েবল অ্যাসাইনমেন্টের মধ্যে ব্যবহৃত হয় এবং একটি পাইপ অক্ষর | দ্বারা পৃথক করা হয়। একটি আউটপুটে একাধিক ফিল্টার ব্যবহার করা যেতে পারে, এবং বাম থেকে ডানে প্রয়োগ করা হয়।

ইনপুট

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

আউটপুট

Hello Anna

API এর মাধ্যমে পাঠানো মেসেজে Liquid টেমপ্লেট ব্যবহার করা

Liquid টেমপ্লেট প্রয়োগ করতে আপনার createMessage অনুরোধে Liquid সিনট্যাক্স ব্যবহার করুন। টেমপ্লেটগুলি createMessage অনুরোধের “content” প্যারামিটারের জন্য উপলব্ধ, সেইসাথে ডাইনামিক কন্টেন্ট সমর্থনকারী অন্য কোনও প্যারামিটারের জন্য, বিশেষ করে, প্ল্যাটফর্ম-নির্দিষ্ট “title”, “subtitle”, এবং “image” প্যারামিটারগুলির জন্য।

কন্টেন্ট টেমপ্লেট ব্যবহার করে, আপনি আপনার API অনুরোধে ডেটা নির্দিষ্ট করতে পারেন (“template_bindings” প্যারামিটার পাস করে) অথবা ব্যবহারকারীদের ডিভাইসে সংরক্ষিত ট্যাগ মান থেকে ডেটা পেতে পারেন (“template_bindings” প্যারামিটার ব্যবহার না করে)। এইভাবে, আপনি অত্যন্ত প্রাসঙ্গিক কন্টেন্ট সহ ব্যবহারকারী-ভিত্তিক পুশ ক্যাম্পেইন তৈরি করতে সক্ষম।

নোট

অনুগ্রহ করে মনে রাখবেন, ডাইনামিক কন্টেন্টের মতো নয়, টেমপ্লেটের ভেরিয়েবলগুলি ডাবল কার্লি ব্রেসের মধ্যে আবদ্ধ করা উচিত: {{myVariable}}।

নামে স্পেস সহ ট্যাগ ব্যবহার করে টেমপ্লেট লজিক সংজ্ঞায়িত করতে, নিম্নলিখিত কৌশলটি ব্যবহার করুন:

উদাহরণ

{% capture my_tag %}{{My Tag}}{% endcapture %}
{% if my_tag == 'value' %}
Content to send in this case
{% else %}
Content to send otherwise
{% endif %}

Liquid টেমপ্লেট ব্যবহারের ক্ষেত্র

এখানে আপনি বেশ কয়েকটি ব্যবহারের ক্ষেত্র পাবেন যেখানে Liquid টেমপ্লেটগুলি কাজে আসে।

বহু-ভাষার পুশ

Liquid টেমপ্লেটগুলি ব্যবহারকারীদের কোন ভাষায় আপনার পুশ মেসেজগুলি গ্রহণ করা উচিত তা নির্দিষ্টভাবে নির্ধারণ করা সম্ভব করে তোলে। API অনুরোধের সহজ উদাহরণ এবং অনুরোধে ব্যবহৃত টেমপ্লেট বাইন্ডিংয়ের উপর নির্ভর করে প্রাপ্ত মেসেজটি দেখুন।

Liquid ইনপুট

{% if Language == 'es' %}
¡Hola!
{% else %}
Hello!
{% endif %}

API অনুরোধ

{
  "request": {
    "application": "XXXXX-XXXXX", // Pushwoosh app code
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "{% raw %}
{% if language == 'es' %}¡Hola!{% else %}hello!{% endif %}
{% endraw %}",
        "template_bindings": { // optional. When no template_bindings are passed in a request, Tag values from the device are used.
         "language" : "es"
        }
      }
    ]
  }
}

আউটপুট

ভাষা ‘es’ হলে: ¡Hola!

ভাষা ‘en’ হলে: Hello!

সাবস্ক্রিপশন আপগ্রেড প্রম্পট

আপনার গ্রাহকদের তাদের বর্তমান প্ল্যানের উপর ভিত্তি করে তাদের সাবস্ক্রিপশন আপগ্রেড করতে উৎসাহিত করুন।

Liquid ইনপুট

{% if Subscription == 'Basic' %}
    Upgrade to Silver for getting more product features and 24/7 support.
{% elsif Subscription == 'Silver' %}
    Upgrade to Gold for priority support and advanced features.
{% else %}
    Please contact your manager to renew your subscription.
{% endif %}

API অনুরোধ

{
  "request": {
    "application": "XXXXX-XXXXX", // Pushwoosh app code
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "{% raw %}
{% if Subscription == 'Basic' %}Upgrade to Silver for getting more product features and 24/7 support.{% elsif Subscription == 'Silver' %}Upgrade to Gold for priority support and advanced features.{% else %}Please contact your manager to renew your subscription. {% endif %}
{% endraw %}",
        "template_bindings": { // optional. When no template_bindings are passed in a request, Tag values from the device are used.
         "language" : "es"
        }
      }
    ]
  }
}

আউটপুট

বেসিক সাবস্ক্রিপশন প্ল্যান সহ ব্যবহারকারীদের জন্য: Upgrade to Silver for getting more product features and 24/7 support.

সিলভার সাবস্ক্রিপশন প্ল্যান সহ ব্যবহারকারীদের জন্য: Upgrade to Gold for priority support and advanced features.

অন্যান্য প্ল্যান সহ ব্যবহারকারীদের জন্য: Please contact your manager to renew your subscription.

তালিকা ট্যাগ

কন্টেন্ট টেমপ্লেটগুলি তালিকা ধরনের ট্যাগগুলি পরিচালনা করার জন্য বেশ সহায়ক।

ভেরিয়েবল সাইজ

একটি সম্ভাব্য ব্যবহারের ক্ষেত্র হল ট্যাগে থাকা মানের সংখ্যার উপর নির্ভর করে বিভিন্ন কন্টেন্ট সরবরাহ করা। উদাহরণস্বরূপ, আপনি বিভিন্ন আচরণের গ্রাহকদের বিভিন্ন ছাড় প্রদান করতে পারেন। ধরা যাক গ্রাহকের তাদের WishList-এ কিছু আইটেম আছে—তারা কতগুলি পণ্য কিনতে যাচ্ছে তার উপর ভিত্তি করে সবচেয়ে উপযুক্ত ছাড় দিয়ে তাদের কেনাকাটা করতে উৎসাহিত করুন!

Liquid ইনপুট

{% if WishList.size >= 3 %}
Get 20% off your next purchase!
{% elsif WishList.size == 2 %}
Get a 10% discount on your next purchase!
{% else %}
Hey, take a look at new outwears!
{% endif %}

API অনুরোধ

{
  "request": {
    "application": "XXXXX-XXXXX", // Pushwoosh app code
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "{% raw %}
{% if WishList.size >= 3 %}Get 20% off your next purchase!{% elsif WishList.size == 2 %}Get a 10% discount on your next purchase!{% else %}Hey, take a look at new outwears!{% endif %}
{% endraw %}",
        "template_bindings": {
         "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"]
        }
      }
    ]
  }
}

WishList সাইজ ≥ 3

WishList সাইজ = 2

ভেরিয়েবলে আছে

আরেকটি ক্ষেত্র যা আপনার কভার করার প্রয়োজন হতে পারে তা হল তালিকা ট্যাগের মানগুলির সাথে ডিল করা এবং ট্যাগে কোন মানগুলি রয়েছে তার উপর ভিত্তি করে সবচেয়ে প্রাসঙ্গিক কন্টেন্ট সরবরাহ করা।

Liquid ইনপুট

{% if WishList contains 'Skinny Low Ankle Jeans' %}
Get 20% off products in your wishlist!
{% else %}
Hey, take a look at the brand new Skinny Low Ankle Jeans!
{% endif %}

API অনুরোধ

{
  "request": {
    "application": "C90C0-0E786",
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "{% raw %}
{% if WishList contains 'Skinny Low Ankle Jeans' %}Get 20% off your next purchase!{% else %}Hey, take a look at the brand new Skinny Low Ankle Jeans!{% endif %}
{% endraw %}",
        "template_bindings": {
         "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"]
        }
      }
    ]
  }
}

ভেরিয়েবলে ডেটা আছে

ভেরিয়েবলে ডেটা নেই

বহুবচন

কন্টেন্ট টেমপ্লেট ব্যবহার করে, আপনি ব্যবহারকারীদের আচরণের উপর ভিত্তি করে মেসেজের কন্টেন্ট সামঞ্জস্য করতে সক্ষম। উদাহরণস্বরূপ, তালিকা ট্যাগে একাধিক মান থাকলে আপনি মেসেজের টেক্সট পরিবর্তন করে বহুবচন শব্দ অন্তর্ভুক্ত করতে পারেন।

Liquid ইনপুট

    Get 20% off item
{% if WishList.size > 1 %}
    s in your WishList!
{% else %}
    in your Wishlist!
{% endif %}

API অনুরোধ

{
  "request": {
    "application": "C90C0-0E786",
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "Get 20% off item{% raw %}
{% if WishList.size > 1 %}s in your WishList!{% else %} in your Wishlist!{% endif %}
{% endraw %}",
        "template_bindings": { // optional. When no template_bindings are passed in a request, Tag values from the device are used.
         "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"]
        }
      }
    ]
  }
}

বহুবচন

একবচন

টাইমজোন

টাইমজোনের জন্য টেমপ্লেট নির্দিষ্ট টাইমজোন অনুযায়ী তারিখ এবং সময় রূপান্তর করে।

Liquid ইনপুট

{{ MyDate | timezone: MyTimezone | date: \"%Y-%m-%d %H:%M\" }}

API অনুরোধ

উদাহরণ

{
  "request" : {
    "auth" : "3H9bk8w3.....Acge2RbupTB", // API access token from Pushwoosh Control Panel
    "application" : "XXXXX-XXXXX", // Pushwoosh app code
    "notifications" : [ // push message parameters
      {
        "content": "Current Date: {{ MyDate | timezone: MyTimezone | date: \"%Y-%m-%d %H:%M\" }}",
        "template_bindings": { // optional. When no template_bindings are passed in a request, Tag values from the device are used.
         "MyDate" : "2019-07-23 15:00",
         "MyTimezone" : "Asia/Dubai"
        }
      }
    ]
  }
}

আউটপুট

সংযুক্ত কন্টেন্ট

সংযুক্ত কন্টেন্ট হল Liquid টেমপ্লেটের একটি বৈশিষ্ট্য যা আপনাকে একটি বাহ্যিক উৎস, যেমন একটি ওয়েব পরিষেবা, থেকে সরাসরি আপনার ইমেল বা পুশ নোটিফিকেশন মেসেজের মধ্যে ডেটা গতিশীলভাবে পুনরুদ্ধার এবং ব্যবহার করতে দেয়। এই বৈশিষ্ট্যটি একটি নির্দিষ্ট URL থেকে JSON ডেটা এনে এবং এটি একটি ভেরিয়েবলে সংরক্ষণ করে রিয়েল-টাইম ব্যক্তিগতকরণ সক্ষম করে যা আপনার কন্টেন্টে ব্যবহার করা যেতে পারে।

মূল ব্যবহারের ক্ষেত্র

• পণ্যের সুপারিশ: প্রতিটি ব্যবহারকারীর জন্য তৈরি করা ব্যক্তিগতকৃত পণ্যের তালিকা প্রদর্শন করুন।

• প্রোমো কোড: একটি ব্যাকএন্ড পরিষেবা দ্বারা তৈরি করা অনন্য প্রোমো কোড সন্নিবেশ করান।

পূর্বশর্ত

• সংযুক্ত কন্টেন্ট ব্যবহার করার জন্য, আপনার অবশ্যই নিজস্ব ব্যাকএন্ড পরিষেবা থাকতে হবে যা ইউজার আইডি, HWID, বা কাস্টম ট্যাগ এর উপর ভিত্তি করে প্রয়োজনীয় ডেটা (যেমন, প্রোমো কোড, পণ্যের সুপারিশ) তৈরি এবং সরবরাহ করে। Pushwoosh তারপর একটি মেসেজ পাঠানোর আগে এই ডেটা নিয়ে আসে।

ধাপে ধাপে বাস্তবায়ন নির্দেশিকা

ধাপ ১. ব্যাকএন্ড পরিষেবা সেট আপ করুন

ব্যাকএন্ড পরিষেবাটি করা উচিত:

• ব্যবহারকারী-নির্দিষ্ট প্যারামিটার (যেমন, userId) সহ একটি অনুরোধ গ্রহণ করুন। সংযুক্ত কন্টেন্ট UserID, HWID, বা আপনার প্রকল্পে সেট আপ করা যেকোনো কাস্টম ট্যাগ সমর্থন করে।
• প্রয়োজনীয় ডেটা সহ একটি JSON প্রতিক্রিয়া ফেরত দিন। এই কন্টেন্টটি তারপর গতিশীলভাবে মেসেজে সন্নিবেশ করা যেতে পারে।

এটি কীভাবে কাজ করে

ব্যাকএন্ড পরিষেবাটি একটি ডেটা সরবরাহকারী হিসাবে কাজ করে, ব্যবহারকারী-নির্দিষ্ট তথ্য সহ HTTP অনুরোধের প্রতিক্রিয়া জানায়।

1. Pushwoosh আপনার ব্যাকএন্ডে একটি অনুরোধ পাঠায়, ব্যবহারকারী-নির্দিষ্ট শনাক্তকারীগুলিকে কোয়েরি প্যারামিটার হিসাবে পাস করে।
2. আপনার ব্যাকএন্ড অনুরোধটি প্রক্রিয়া করে এবং অনুরোধ করা ডেটা পুনরুদ্ধার করে।
3. আপনার ব্যাকএন্ড একটি JSON প্রতিক্রিয়া ফেরত দেয়।
4. একটি মেসেজ পাঠানোর আগে, Pushwoosh ব্যাকএন্ড পরিষেবা থেকে JSON প্রতিক্রিয়া নিয়ে আসে এবং ফেরত দেওয়া মানগুলি (যেমন, code) মেসেজের কন্টেন্টে গতিশীলভাবে ব্যবহার করে।

উদাহরণ প্রতিক্রিয়া

{ "code": "SPECIALOFFERFORUSER12345" }

ধাপ ২. Pushwoosh-এ সংযুক্ত কন্টেন্ট সহ একটি প্রিসেট তৈরি করুন

1. পুশ বা ইমেল কন্টেন্ট এডিটর-এ, মেসেজ ফিল্ডে সংযুক্ত কন্টেন্ট সিনট্যাক্স সন্নিবেশ করান।

উদাহরণ

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

সিনট্যাক্স ব্রেকডাউন

connected_content	নির্দিষ্ট ব্যাকএন্ড URL থেকে JSON ডেটা নিয়ে আসে।
http://your-backend-url.com	ব্যাকএন্ড এন্ডপয়েন্ট যা JSON ফরম্যাটে প্রয়োজনীয় ডেটা ফেরত দেয়।
userId={{ ${userid} }}	একটি গতিশীল কোয়েরি প্যারামিটার যা ব্যবহারকারী আইডি ব্যাকএন্ডে পাস করে।
:save result	Liquid টেমপ্লেটে ব্যবহারের জন্য আনা JSON প্রতিক্রিয়াটি result ভেরিয়েবলে সংরক্ষণ করে।

প্রমাণীকরণ (ঐচ্ছিক)

যদি আপনার ব্যাকএন্ড পরিষেবার জন্য প্রমাণীকরণের প্রয়োজন হয়, আপনি নিরাপদ অ্যাক্সেস নিশ্চিত করতে সংযুক্ত কন্টেন্ট অনুরোধে একটি API কী বা টোকেন অন্তর্ভুক্ত করতে পারেন।

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

সংযুক্ত কন্টেন্টে ট্যাগ ব্যবহার করা

কাস্টম ট্যাগ অন্তর্ভুক্ত করতে, সেগুলিকে সংযুক্ত কন্টেন্ট অনুরোধে কোয়েরি প্যারামিটার হিসাবে সন্নিবেশ করান ({{ tag_name }})।

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

2. এরপর, পুনরুদ্ধার করা ডেটা অন্তর্ভুক্ত করে মেসেজের টেক্সট যোগ করুন, এইভাবে:

Hey, {{userid}}, grab your personal promo code - {{result.code}}

3. মেসেজের কন্টেন্ট চূড়ান্ত করার এবং প্রিসেট সেটিংস কনফিগার করার পরে, এটি প্রচারাভিযানে পুনরায় ব্যবহারের জন্য সংরক্ষণ করুন।

ধাপ ৩. কনফিগার করা প্রিসেট ব্যবহার করে একটি মেসেজ পাঠান

এককালীন পুশ বা ইমেল ফর্ম বা কাস্টমার জার্নি ব্যবহার করে এই প্রিসেট সহ একটি মেসেজ পাঠান।

গুরুত্বপূর্ণ

যদি পরিষেবাটি HTTP 200 OK ছাড়া অন্য কোনো স্ট্যাটাস ফেরত দেয়, তাহলে ইমেল বা পুশ নোটিফিকেশন পাঠানো হবে না। এটি নিশ্চিত করে যে আপনার যোগাযোগ শুধুমাত্র তখনই পাঠানো হবে যদি প্রয়োজনীয় ডেটা সফলভাবে পুনরুদ্ধার করা হয়।