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

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

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

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

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

सिंटैक्स

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

नोट

सिंटैक्स के बारे में अधिक जानने के लिए, कृपया लिक्विड दस्तावेज़ीकरण देखें।

ऑब्जेक्ट्स

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

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

इनपुट

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

आउटपुट

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

टैग्स

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

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

इनपुट

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

आउटपुट (fr)

Salut!

आउटपुट (es)

Hello!

टैग्स ऑपरेटर

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

नोट

एक से अधिक and या or ऑपरेटर वाले टैग्स में, ऑपरेटरों की जाँच दाएं से बाएं क्रम में की जाती है। आप कोष्ठक का उपयोग करके संचालन के क्रम को नहीं बदल सकते हैं - कोष्ठक लिक्विड में अमान्य वर्ण हैं और आपके टैग्स को काम करने से रोकेंगे।

फ़िल्टर्स

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

इनपुट

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

आउटपुट

Hello Anna

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

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

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

नोट

कृपया ध्यान दें कि डायनामिक कंटेंट के विपरीत, टेम्प्लेट्स में वेरिएबल्स को डबल कर्ली ब्रेसिज़ में इस प्रकार संलग्न किया जाना चाहिए: {{myVariable}}।

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

उदाहरण

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

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

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

बहु-भाषी पुश

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

लिक्विड इनपुट

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

API अनुरोध

{
  "request": {
    "application": "XXXXX-XXXXX", // Pushwoosh ऐप कोड
    "auth": "yxoPUlw.....IyEX4H", // Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन
    "notifications" : [ // पुश संदेश पैरामीटर
      {
       "content": "{% raw %}
{% if language == 'es' %}¡Hola!{% else %}hello!{% endif %}
{% endraw %}",
        "template_bindings": { // वैकल्पिक। जब अनुरोध में कोई template_bindings पास नहीं किए जाते हैं, तो डिवाइस से टैग मानों का उपयोग किया जाता है।
         "language" : "es"
        }
      }
    ]
  }
}

आउटपुट

भाषा ‘es’ है: ¡Hola!

भाषा ‘en’ है: Hello!

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

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

लिक्विड इनपुट

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

API अनुरोध

{
  "request": {
    "application": "XXXXX-XXXXX", // Pushwoosh ऐप कोड
    "auth": "yxoPUlw.....IyEX4H", // Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन
    "notifications" : [ // पुश संदेश पैरामीटर
      {
       "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": { // वैकल्पिक। जब अनुरोध में कोई template_bindings पास नहीं किए जाते हैं, तो डिवाइस से टैग मानों का उपयोग किया जाता है।
         "language" : "es"
        }
      }
    ]
  }
}

आउटपुट

बेसिक सब्सक्रिप्शन प्लान वाले उपयोगकर्ताओं के लिए: अधिक उत्पाद सुविधाएँ और 24/7 सहायता प्राप्त करने के लिए सिल्वर में अपग्रेड करें।

सिल्वर सब्सक्रिप्शन प्लान वाले उपयोगकर्ताओं के लिए: प्राथमिकता सहायता और उन्नत सुविधाओं के लिए गोल्ड में अपग्रेड करें।

अन्य प्लान वाले उपयोगकर्ताओं के लिए: कृपया अपने सब्सक्रिप्शन को नवीनीकृत करने के लिए अपने प्रबंधक से संपर्क करें।

लिस्ट टैग्स

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

वेरिएबल आकार

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

लिक्विड इनपुट

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

API अनुरोध

{
  "request": {
    "application": "XXXXX-XXXXX", // Pushwoosh ऐप कोड
    "auth": "yxoPUlw.....IyEX4H", // Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन
    "notifications" : [ // पुश संदेश पैरामीटर
      {
       "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"]
        }
      }
    ]
  }
}

विशलिस्ट आकार ≥ 3

विशलिस्ट आकार = 2

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

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

लिक्विड इनपुट

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

API अनुरोध

{
  "request": {
    "application": "C90C0-0E786",
    "auth": "yxoPUlw.....IyEX4H", // Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन
    "notifications" : [ // पुश संदेश पैरामीटर
      {
       "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 %}

API अनुरोध

{
  "request": {
    "application": "C90C0-0E786",
    "auth": "yxoPUlw.....IyEX4H", // Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन
    "notifications" : [ // पुश संदेश पैरामीटर
      {
       "content": "Get 20% off item{% raw %}
{% if WishList.size > 1 %}s in your WishList!{% else %} in your Wishlist!{% endif %}
{% endraw %}",
        "template_bindings": { // वैकल्पिक। जब अनुरोध में कोई template_bindings पास नहीं किए जाते हैं, तो डिवाइस से टैग मानों का उपयोग किया जाता है।
         "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"]
        }
      }
    ]
  }
}

बहुवचन

एकवचन

टाइमज़ोन

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

लिक्विड इनपुट

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

API अनुरोध

उदाहरण

{
  "request" : {
    "auth" : "3H9bk8w3.....Acge2RbupTB", // Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन
    "application" : "XXXXX-XXXXX", // Pushwoosh ऐप कोड
    "notifications" : [ // पुश संदेश पैरामीटर
      {
        "content": "Current Date: {{ MyDate | timezone: MyTimezone | date: \"%Y-%m-%d %H:%M\" }}",
        "template_bindings": { // वैकल्पिक। जब अनुरोध में कोई template_bindings पास नहीं किए जाते हैं, तो डिवाइस से टैग मानों का उपयोग किया जाता है।
         "MyDate" : "2019-07-23 15:00",
         "MyTimezone" : "Asia/Dubai"
        }
      }
    ]
  }
}

आउटपुट

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

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

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

• उत्पाद सिफारिशें: प्रत्येक उपयोगकर्ता के लिए तैयार की गई व्यक्तिगत उत्पाद सूचियों को प्रदर्शित करें।

• प्रोमो कोड: एक बैकएंड सेवा द्वारा उत्पन्न अद्वितीय प्रोमो कोड डालें।

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

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

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

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

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

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

यह कैसे काम करता है

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

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

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

{ "code": "SPECIALOFFERFORUSER12345" }

चरण 2. 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	लिक्विड टेम्प्लेट्स में उपयोग के लिए प्राप्त 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 %}

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

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

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

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

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

महत्वपूर्ण

यदि सेवा HTTP 200 OK के अलावा कोई अन्य स्थिति लौटाती है, तो ईमेल या पुश नोटिफिकेशन नहीं भेजा जाएगा। यह सुनिश्चित करता है कि आपका संचार केवल तभी बाहर जाता है जब आवश्यक डेटा सफलतापूर्वक प्राप्त हो जाता है।