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

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

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

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

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

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

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

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

<Aside type="caution" icon="setting" title="डेवलपर सहायता की आवश्यकता है">
कनेक्टेड कंटेंट का उपयोग करने के लिए आपको अपनी डेवलपर टीम की मदद की आवश्यकता होगी। आरंभ करने के लिए इस गाइड को उनके साथ साझा करें।
</Aside>

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

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

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

<Aside type="note" title="यह कैसे काम करता है">

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

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

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

```
{ "code": "SPECIALOFFERFORUSER12345" }
```
</Aside>

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

1. [पुश](/hi/product/content/push-presets/) या [ईमेल कंटेंट एडिटर](/hi/product/content/email-content/drag-and-drop-email-editor/) में, संदेश फ़ील्ड में कनेक्टेड कंटेंट सिंटैक्स डालें।

**उदाहरण**

```
{% connected_content http://your-backend-url.com?userId={{ ${userid} }} :save result %}  
```
**सिंटैक्स का विश्लेषण**
| | |
| ----- | ----- |
| `connected_content` | निर्दिष्ट बैकएंड URL से JSON डेटा प्राप्त करता है। |
| `http://your-backend-url.com` | वह बैकएंड एंडपॉइंट जो JSON प्रारूप में आवश्यक डेटा लौटाता है। |
| `userId={{ ${userid} }}` | एक डायनामिक क्वेरी पैरामीटर जो यूज़र आईडी को बैकएंड पर भेजता है। `connected_content` के अंदर, वेरिएबल को `${}` में लपेटें। मैसेज टेक्स्ट में, इसके बिना `{{userid}}` लिखें। |
| `:save result` | लिक्विड टेम्पलेट्स में उपयोग के लिए प्राप्त JSON प्रतिक्रिया को परिणाम वेरिएबल में संग्रहीत करता है |

![कनेक्टेड कंटेंट सिंटैक्स डालें](/connectedcontent.webp)

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

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

<Aside type="caution" title="केवल स्थिर मान">
`${}` वैयक्तिकरण चर केवल URL के अंदर काम करते हैं। `:headers` के अंदर के मान स्थिर होते हैं और इंटरपोलेट नहीं किए जाते हैं।
</Aside>

<Aside type="danger" title="URL से क्रेडेंशियल्स को बाहर रखें">
API कुंजियों और टोकन के लिए URL क्वेरी पैरामीटर (जैसे `&auth=YOUR_API_KEY`) पर `:headers` को प्राथमिकता दें: यदि फ़ेच विफल हो जाता है, तो अनुरोध URL लॉग में लिखा जाता है, जिससे वहां रखी गई कुंजी उजागर हो जाती है। `:headers` के अंदर के मान कभी भी लॉग नहीं किए जाते हैं।

कनेक्टेड कंटेंट के लिए यह भी आवश्यक है कि आपके खाते के लिए लिक्विड कंटेंट टेम्पलेट्स सक्षम हों। यदि वे नहीं हैं, तो पूरा `connected_content` टैग - जिसमें कोई भी कुंजी शामिल है - प्रत्येक प्राप्तकर्ता को प्रस्तुत किए जाने के बजाय शाब्दिक पाठ के रूप में भेजा जाता है। यदि आप अनिश्चित हैं कि आपके खाते में यह सक्षम है या नहीं, तो [Pushwoosh सहायता](https://help.pushwoosh.com/hc/en-us/requests/new) से संपर्क करें।
</Aside>

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

किसी टैग का मान शामिल करने के लिए, उसे उसी `{{ ${tag_name} }}` रूप में क्वेरी पैरामीटर के तौर पर URL में जोड़ें। अगर `connected_content` टैग के अंदर इसे `{{ tag_name }}` के रूप में लिखा जाए, तो मान खाली भेजा जाता है।

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

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

```

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

![**प्राप्त डेटा** के साथ संदेश टेक्स्ट जोड़ें](/connectedcontent-1.webp)

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

<video src="/connectedcontent-2.webm" title="कनेक्टेड कंटेंट के साथ एक संदेश भेजें" autoplay loop muted playsinline />

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

इस प्रीसेट का उपयोग करके [एक-बार पुश](/hi/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#how-to-send-a-push-notification-using-the-one-time-push-form) या [ईमेल फ़ॉर्म](/hi/product/messaging-channels/emails/sending-emails/send-one-time-emails/) या [ग्राहक यात्रा](/hi/product/customer-journey/pushwoosh-journey-overview/) का उपयोग करके एक संदेश भेजें।

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