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

लिक्विड टेम्प्लेट्स नियमित डायनामिक कंटेंट उपयोग के अलावा परिष्कृत तर्क को लागू करके 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' %}अधिक उत्पाद सुविधाएँ और 24/7 सहायता प्राप्त करने के लिए सिल्वर में अपग्रेड करें।{% elsif Subscription == 'Silver' %}प्राथमिकता समर्थन और उन्नत सुविधाओं के लिए गोल्ड में अपग्रेड करें।{% else %}कृपया अपनी सदस्यता को नवीनीकृत करने के लिए अपने प्रबंधक से संपर्क करें। {% 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 %}अपनी अगली खरीद पर 20% की छूट पाएं!{% elsif WishList.size == 2 %}अपनी अगली खरीद पर 10% की छूट पाएं!{% else %}अरे, नए आउटवियर पर एक नज़र डालें!{% 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' %}अपनी अगली खरीद पर 20% की छूट पाएं!{% else %}अरे, एकदम नई स्किनी लो एंकल जीन्स पर एक नज़र डालें!{% 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": "आइटम पर 20% की छूट पाएं{% raw %}
{% if WishList.size > 1 %}आपकी विशलिस्ट में!{% else %} आपकी विशलिस्ट में!{% 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 डेटा प्राप्त करके और इसे एक वेरिएबल में सहेजकर रीयल-टाइम निजीकरण को सक्षम करती है जिसका उपयोग आपकी सामग्री में किया जा सकता है।

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

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

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

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

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

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

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

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

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

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

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

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

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

{ "code": "SPECIALOFFERFORUSER12345" }

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

1. Push या Email कंटेंट एडिटर में, संदेश फ़ील्ड में कनेक्टेड कंटेंट सिंटैक्स डालें।

उदाहरण

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

आप वैकल्पिक :headers पैरामीटर का उपयोग करके HTTP हेडर के रूप में प्रमाणीकरण (या कोई अन्य) डेटा भी भेज सकते हैं - हेडर नामों और मानों का एक JSON ऑब्जेक्ट।

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

:headers {...}	अनुरोध के साथ भेजे गए HTTP हेडर का एक JSON ऑब्जेक्ट, जैसे Authorization: Bearer <token>।

केवल स्थिर मान

${} निजीकरण वेरिएबल्स केवल URL के अंदर काम करते हैं। :headers के अंदर के मान स्थिर हैं और इंटरपोलेट नहीं किए जाते हैं।

कनेक्टेड कंटेंट में टैग का उपयोग करना

कस्टम टैग शामिल करने के लिए, उन्हें कनेक्टेड कंटेंट अनुरोध ({{ tag_name }}) में क्वेरी पैरामीटर के रूप में डालें।

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

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

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

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

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

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

महत्वपूर्ण

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