# কানেক্টেড কন্টেন্ট

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

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

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

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

## পূর্বশর্ত

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

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

<Aside type="caution" icon="setting" title="ডেভেলপারের সহায়তা প্রয়োজন">
কানেক্টেড কন্টেন্ট ব্যবহার করার জন্য আপনার ডেভেলপার টিমের সাহায্যের প্রয়োজন হবে। শুরু করার জন্য তাদের সাথে এই গাইডটি শেয়ার করুন।
</Aside>

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

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

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

<Aside type="note" title="এটি কিভাবে কাজ করে"> 

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

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

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

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



### ধাপ ২. Pushwoosh-এ কানেক্টেড কন্টেন্ট সহ একটি প্রিসেট তৈরি করুন
 
1. [পুশ](/bn/product/content/push-presets/) বা [ইমেল কন্টেন্ট এডিটর](/bn/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 প্রতিক্রিয়াটি result ভেরিয়েবলে সংরক্ষণ করে |

![কানেক্টেড কন্টেন্ট সিনট্যাক্স প্রবেশ করান](/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 />

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

[এককালীন পুশ](/bn/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#how-to-send-a-push-notification-using-the-one-time-push-form) বা [ইমেল ফর্ম](/bn/product/messaging-channels/emails/sending-emails/send-one-time-emails/) বা [কাস্টমার জার্নি](/bn/product/customer-journey/pushwoosh-journey-overview/) ব্যবহার করে এই প্রিসেট সহ একটি মেসেজ পাঠান।

<Aside type="caution" title="গুরুত্বপূর্ণ">
যদি পরিষেবাটি HTTP 200 OK ছাড়া অন্য কোনো স্ট্যাটাস ফেরত দেয়, তাহলে ইমেল বা পুশ নোটিফিকেশন পাঠানো হবে না। এটি নিশ্চিত করে যে আপনার যোগাযোগ শুধুমাত্র তখনই পাঠানো হবে যদি প্রয়োজনীয় ডেটা সফলভাবে পুনরুদ্ধার করা হয়।
</Aside>