लिक्विड टेम्प्लेट का उपयोग करना

लिक्विड टेम्प्लेट्स नियमित डायनामिक कंटेंट उपयोग के अलावा परिष्कृत लॉजिक लागू करके Pushwoosh की वैयक्तिकरण क्षमताओं को महत्वपूर्ण रूप से बढ़ाते हैं।

Pushwoosh में संदेश वैयक्तिकरण टैग्स (उपयोगकर्ता डेटा) पर आधारित है। Pushwoosh विभिन्न प्रकार के डिफ़ॉल्ट टैग्स और कस्टम टैग्स प्रदान करता है। उनका उपयोग करके, आप उपयोगकर्ता का पहला नाम, शहर, खरीद इतिहास आदि निर्दिष्ट कर सकते हैं ताकि एक अधिक व्यक्तिगत संदेश भेजा जा सके, उदाहरण के लिए: नमस्ते {First_name}, {item} ऑर्डर करने के लिए धन्यवाद।

लिक्विड टेम्प्लेट डायनामिक कंटेंट में और अधिक लॉजिक जोड़ते हैं। उदाहरण के लिए, यदि किसी उपयोगकर्ता के सब्सक्रिप्शन टैग में “फ्री” है, तो आप उन्हें एक संदेश भेज सकते हैं: “अपनी 10% छूट प्राप्त करें।”

उपयोगकर्ताओं की आईडी, व्यवहार और वरीयताओं के अनुसार संदेश की सामग्री को संशोधित करना प्रासंगिकता बढ़ाने और आपके मार्केटिंग अभियानों से अधिक प्रभावशाली परिणाम प्राप्त करने का सबसे कुशल तरीका है।

सिंटैक्स

Shopify द्वारा लिक्विड पर आधारित कंटेंट टेम्प्लेट डायनामिक कंटेंट को लोड करने के लिए टैग्स, ऑब्जेक्ट्स, और फ़िल्टर्स के संयोजन का उपयोग करते हैं। कंटेंट टेम्प्लेट आपको एक टेम्प्लेट के भीतर से कुछ वेरिएबल्स तक पहुंचने और डेटा के बारे में कुछ भी जाने बिना उनके डेटा को आउटपुट करने की अनुमति देते हैं।

ऑब्जेक्ट्स

objects उस कंटेंट को परिभाषित करते हैं जो एक उपयोगकर्ता को दिखाया जाएगा। objects को डबल कर्ली ब्रेसिज़ में संलग्न किया जाना चाहिए: {{ }}

उदाहरण के लिए, किसी संदेश को वैयक्तिकृत करते समय, संदेश की सामग्री में उपयोगकर्ताओं के नाम जोड़ने के लिए उसके बॉडी में {{Name}} भेजें। उपयोगकर्ता का नाम (नाम टैग मान) लिक्विड ऑब्जेक्ट को उस संदेश में बदल देगा जो उपयोगकर्ता देखेगा।

इनपुट
आउटपुट

नमस्ते {{Name}}! हमें खुशी है कि आप वापस आए!

टैग्स

tags टेम्प्लेट के लिए लॉजिक और कंट्रोल फ्लो बनाते हैं। कर्ली ब्रेस प्रतिशत सीमांकक {% और %} और उनके द्वारा घेरा गया टेक्स्ट कोई दृश्यमान आउटपुट नहीं देता है जब टेम्प्लेट प्रस्तुत किया जाता है। यह आपको उपयोगकर्ता को कोई भी लिक्विड लॉजिक दिखाए बिना वेरिएबल्स असाइन करने और शर्तें या लूप बनाने की सुविधा देता है।

उदाहरण के लिए, if टैग का उपयोग करके, आप उपयोगकर्ता के डिवाइस पर सेट भाषा के आधार पर संदेश की भाषा बदल सकते हैं:

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

टैग्स ऑपरेटर्स

ऑपरेटर	विवरण
`==`	बराबर है
`!=`	बराबर नहीं है
`>`	से बड़ा
`<`	से छोटा
`>=`	से बड़ा या बराबर
`<=`	से छोटा या बराबर
`or`	लॉजिकल or
`and`	लॉजिकल and
`contains`	एक स्ट्रिंग या स्ट्रिंग्स की ऐरे के अंदर एक सबस्ट्रिंग की उपस्थिति की जाँच करता है

फ़िल्टर्स

filters एक लिक्विड ऑब्जेक्ट या वेरिएबल के आउटपुट को संशोधित करते हैं। वे डबल कर्ली ब्रेसिज़ {{ }} और वेरिएबल असाइनमेंट के भीतर उपयोग किए जाते हैं, और एक पाइप वर्ण | द्वारा अलग किए जाते हैं। एक आउटपुट पर कई फ़िल्टर का उपयोग किया जा सकता है, और वे बाएं से दाएं लागू होते हैं।

इनपुट
आउटपुट

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

API के माध्यम से भेजे गए संदेशों में लिक्विड टेम्प्लेट का उपयोग करना

लिक्विड टेम्प्लेट को लागू करने के लिए अपने createMessage अनुरोधों में लिक्विड सिंटैक्स का उपयोग करें। टेम्प्लेट createMessage अनुरोध के “content” पैरामीटर के लिए उपलब्ध हैं, साथ ही डायनामिक कंटेंट का समर्थन करने वाले किसी भी अन्य पैरामीटर के लिए भी, विशेष रूप से, प्लेटफ़ॉर्म-विशिष्ट “title”, “subtitle”, और “image” पैरामीटर।

कंटेंट टेम्प्लेट का उपयोग करके, आप या तो अपने API अनुरोधों में डेटा निर्दिष्ट कर सकते हैं (“template_bindings” पैरामीटर पास करके) या उपयोगकर्ताओं के उपकरणों पर संग्रहीत टैग मानों से डेटा प्राप्त कर सकते हैं (“template_bindings” पैरामीटर का उपयोग न करके)। इस तरह, आप अत्यंत प्रासंगिक कंटेंट वाले उपयोगकर्ता-आधारित पुश अभियान बना सकते हैं।

जिन टैग्स के नामों में स्पेस है, उनके साथ टेम्प्लेट लॉजिक को परिभाषित करने के लिए, निम्नलिखित तकनीक का उपयोग करें:

उदाहरण

{% capture my_tag %}{{My Tag}}{% endcapture %}
{% if my_tag == 'value' %}
इस मामले में भेजने के लिए कंटेंट
{% else %}
अन्यथा भेजने के लिए कंटेंट
{% endif %}

लिक्विड टेम्प्लेट्स के उपयोग के मामले

यहां आपको कई उपयोग के मामले मिलेंगे जब लिक्विड टेम्प्लेट्स काम आते हैं।

बहु-भाषी पुश

लिक्विड टेम्प्लेट्स यह निश्चित रूप से निर्दिष्ट करना संभव बनाते हैं कि उपयोगकर्ताओं को आपके पुश संदेश किस भाषा में प्राप्त होने चाहिए। API अनुरोध के सरल उदाहरण और अनुरोध में उपयोग किए गए टेम्प्लेट बाइंडिंग के आधार पर प्राप्त संदेश को देखें।

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

{
  "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"
        }
      }
    ]
  }
}

सब्सक्रिप्शन अपग्रेड प्रॉम्प्ट

अपने ग्राहकों को उनके वर्तमान प्लान के आधार पर उनके सब्सक्रिप्शन को अपग्रेड करने के लिए प्रोत्साहित करें।

{% if Subscription == 'Basic' %}
    अधिक उत्पाद सुविधाएँ और 24/7 सहायता प्राप्त करने के लिए सिल्वर में अपग्रेड करें।
{% elsif Subscription == 'Silver' %}
    प्राथमिकता समर्थन और उन्नत सुविधाओं के लिए गोल्ड में अपग्रेड करें।
{% else %}
    कृपया अपनी सदस्यता नवीनीकृत करने के लिए अपने प्रबंधक से संपर्क करें।
{% endif %}

{
  "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"
        }
      }
    ]
  }
}

लिस्ट टैग्स

कंटेंट टेम्प्लेट एक लिस्ट प्रकार के टैग को संभालने के लिए काफी सहायक होते हैं।

वेरिएबल आकार

संभावित उपयोग मामलों में से एक यह है कि टैग में मानों की संख्या के आधार पर अलग-अलग कंटेंट दिया जाए। उदाहरण के लिए, आप अलग-अलग व्यवहार वाले ग्राहकों को अलग-अलग छूट प्रदान कर सकते हैं। मान लीजिए कि ग्राहक की विशलिस्ट में कुछ आइटम हैं - उन्हें खरीदने के लिए प्रोत्साहित करें, जो उनके द्वारा खरीदे जाने वाले उत्पादों की संख्या के आधार पर सबसे उपयुक्त छूट के साथ हो!

{% if WishList.size >= 3 %}
अपनी अगली खरीद पर 20% की छूट पाएं!
{% elsif WishList.size == 2 %}
अपनी अगली खरीद पर 10% की छूट पाएं!
{% else %}
अरे, नए आउटवियर पर एक नज़र डालें!
{% endif %}

{
  "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"]
        }
      }
    ]
  }
}

वेरिएबल में शामिल है

एक और मामला जिसे आपको कवर करने की आवश्यकता हो सकती है, वह है लिस्ट टैग मानों से निपटना और टैग में कौन से मान हैं, उसके आधार पर सबसे प्रासंगिक कंटेंट देना।

{% if WishList contains 'Skinny Low Ankle Jeans' %}
अपनी विशलिस्ट में उत्पादों पर 20% की छूट पाएं!
{% else %}
अरे, बिल्कुल नई स्किनी लो एंकल जींस पर एक नज़र डालें!
{% endif %}

{
  "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"]
        }
      }
    ]
  }
}

बहुवचन

कंटेंट टेम्प्लेट का उपयोग करके, आप उपयोगकर्ताओं के व्यवहार के अनुसार संदेश की सामग्री को समायोजित कर सकते हैं। उदाहरण के लिए, यदि लिस्ट टैग में एक से अधिक मान हैं, तो आप संदेश के टेक्स्ट को बहुवचन शब्दों को शामिल करने के लिए संशोधित कर सकते हैं।

    आइटम पर 20% की छूट पाएं
{% if WishList.size > 1 %}
    आपकी विशलिस्ट में!
{% else %}
    आपकी विशलिस्ट में!
{% endif %}

{
  "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"]
        }
      }
    ]
  }
}

टाइमज़ोन

टाइमज़ोन के लिए टेम्प्लेट निर्दिष्ट टाइमज़ोन के अनुसार दिनांक और समय को परिवर्तित करता है।

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

{
  "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"
        }
      }
    ]
  }
}

कनेक्टेड कंटेंट

कनेक्टेड कंटेंट लिक्विड टेम्प्लेट में एक सुविधा है जो आपको अपने ईमेल या पुश नोटिफिकेशन संदेशों के भीतर सीधे एक बाहरी स्रोत, जैसे कि एक वेब सेवा, से डेटा को गतिशील रूप से पुनः प्राप्त करने और उपयोग करने की अनुमति देती है। यह सुविधा एक निर्दिष्ट URL से JSON डेटा प्राप्त करके और इसे एक वेरिएबल में सहेजकर रीयल-टाइम वैयक्तिकरण को सक्षम करती है जिसका उपयोग आपकी सामग्री में किया जा सकता है।

मुख्य उपयोग के मामले

उत्पाद सिफारिशें: प्रत्येक उपयोगकर्ता के लिए तैयार की गई व्यक्तिगत उत्पाद सूचियाँ प्रदर्शित करें।
प्रोमो कोड: एक बैकएंड सेवा द्वारा उत्पन्न अद्वितीय प्रोमो कोड डालें।

पूर्वापेक्षाएँ

कनेक्टेड कंटेंट का उपयोग करने के लिए, आपके पास अपनी खुद की बैकएंड सेवा होनी चाहिए जो User ID, HWID, या कस्टम टैग के आधार पर आवश्यक डेटा (जैसे, प्रोमो कोड, उत्पाद सिफारिशें) उत्पन्न और प्रदान करती है। Pushwoosh फिर एक संदेश भेजने से पहले इस डेटा को प्राप्त करता है।

चरण-दर-चरण कार्यान्वयन गाइड

चरण 1. बैकएंड सेवा सेट अप करें

बैकएंड सेवा को चाहिए:

उपयोगकर्ता-विशिष्ट पैरामीटर (जैसे, userId) वाले अनुरोध को स्वीकार करें। कनेक्टेड कंटेंट UserID, HWID, या आपके प्रोजेक्ट में सेट किए गए किसी भी कस्टम टैग का समर्थन करता है।
आवश्यक डेटा के साथ एक JSON प्रतिक्रिया लौटाएं। इस कंटेंट को फिर संदेशों में गतिशील रूप से डाला जा सकता है

बैकएंड सेवा एक डेटा प्रदाता के रूप में कार्य करती है, जो उपयोगकर्ता-विशिष्ट जानकारी के साथ HTTP अनुरोधों का जवाब देती है।

Pushwoosh आपके बैकएंड को एक अनुरोध भेजता है, जिसमें उपयोगकर्ता-विशिष्ट पहचानकर्ताओं को क्वेरी पैरामीटर के रूप में पास किया जाता है।
आपका बैकएंड अनुरोध को संसाधित करता है और अनुरोधित डेटा को पुनः प्राप्त करता है।
आपका बैकएंड एक JSON प्रतिक्रिया लौटाता है।
एक संदेश भेजने से पहले, Pushwoosh बैकएंड सेवा से JSON प्रतिक्रिया प्राप्त करता है और संदेश सामग्री में लौटाए गए मानों (जैसे, code) का गतिशील रूप से उपयोग करता है।

उदाहरण प्रतिक्रिया

{ "code": "SPECIALOFFERFORUSER12345" }

चरण 2. Pushwoosh में कनेक्टेड कंटेंट के साथ एक प्रीसेट बनाएं

Push या Email content editor में, संदेश फ़ील्ड में कनेक्टेड कंटेंट सिंटैक्स डालें।

उदाहरण

{% 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`	लिक्विड टेम्प्लेट में उपयोग के लिए प्राप्त JSON प्रतिक्रिया को परिणाम वेरिएबल में संग्रहीत करता है

कनेक्टेड कंटेंट सिंटैक्स डालें

प्रमाणीकरण (वैकल्पिक)

यदि आपकी बैकएंड सेवा को प्रमाणीकरण की आवश्यकता है, तो आप सुरक्षित पहुंच सुनिश्चित करने के लिए कनेक्टेड कंटेंट अनुरोध में एक 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 %}

अगला, पुनः प्राप्त डेटा को शामिल करते हुए संदेश टेक्स्ट जोड़ें, इस तरह:

अरे, {{userid}}, अपना व्यक्तिगत प्रोमो कोड प्राप्त करें - {{result.code}}

प्राप्त डेटा के साथ संदेश टेक्स्ट जोड़ें

संदेश सामग्री को अंतिम रूप देने और प्रीसेट सेटिंग्स को कॉन्फ़िगर करने के बाद, इसे अभियानों में पुन: उपयोग के लिए सहेजें।

चरण 3. कॉन्फ़िगर किए गए प्रीसेट का उपयोग करके एक संदेश भेजें

वन-टाइम पुश या ईमेल फॉर्म या कस्टमर जर्नी का उपयोग करके इस प्रीसेट के साथ एक संदेश भेजें।