# API-आधारित एंट्री का उपयोग करके कस्टमर जर्नी को ट्रिगर करें

API-आधारित एंट्री आपको एक विशिष्ट व्यावसायिक घटना होने पर कस्टमर जर्नी लॉन्च करने की अनुमति देती है। एक अभियान शुरू करने के लिए, आपको एक विशेष API अनुरोध भेजना होगा।


## सेटअप करना

1. API-आधारित एंट्री के साथ एक जर्नी बनाएं

<video src="/customer-journey-api-based-entry-1.webm" alt="कस्टमर जर्नी बिल्डर इंटरफ़ेस जो API-आधारित एंट्री तत्व के साथ एक नई जर्नी बनाने का तरीका दिखा रहा है" autoplay loop muted playsinline />

2. API-आधारित एंट्री स्टेप पर डबल-क्लिक करें। एंट्री कॉन्फ़िगरेशन विंडो खुल जाएगी।

3. आप कंटेंट प्लेसहोल्डर्स का उपयोग करके हर बार जर्नी लॉन्च होने पर पुश और ईमेल कंटेंट को संशोधित कर सकते हैं। प्रत्येक प्लेसहोल्डर का मान अनुरोध में बदला जा सकता है। यदि आपको इस विकल्प की आवश्यकता नहीं है, तो आप इस स्टेप को छोड़ सकते हैं।

> उदाहरण के लिए, आप सब्सक्राइबर्स को सूचित करने के लिए एक जर्नी बना रहे हैं जब एक नया पॉडकास्ट एपिसोड जारी होता है। एक कंटेंट प्लेसहोल्डर का उपयोग करके, आप हर बार जर्नी लॉन्च करने पर पॉडकास्ट शीर्षक बदल सकते हैं।

सबसे पहले, API-आधारित एंट्री सेटअप विंडो में प्लेसहोल्डर नाम जोड़ें। आप अपनी सुविधा के अनुसार कोई भी नाम उपयोग कर सकते हैं।

<video src="/customer-journey-api-based-entry-2.webm" alt="API-आधारित एंट्री कॉन्फ़िगरेशन विंडो जो डायनामिक कंटेंट के लिए प्लेसहोल्डर नाम जोड़ने का तरीका दिखा रही है" autoplay loop muted playsinline />

अब, एक पुश या ईमेल [प्रीसेट](/hi/product/content/presets/) बनाएं और उस टेक्स्ट के बजाय प्लेसहोल्डर डालें जिसे आप संशोधित करना चाहते हैं। प्लेसहोल्डर आपकी आवश्यकताओं के आधार पर निम्नलिखित प्रारूपों में से एक में होना चाहिए:

* `{placeholder_name|format_modifier|}` – यदि अभियान लॉन्च करते समय प्लेसहोल्डर मान निर्दिष्ट नहीं किया गया है, तो उपयोगकर्ताओं को उसकी जगह खाली जगह दिखाई देगी।
* `{placeholder_name|format_modifier}` – यदि प्लेसहोल्डर मान निर्दिष्ट नहीं किया गया है और पहले से ही किसी उपयोगकर्ता को असाइन नहीं किया गया है (यदि आपने प्लेसहोल्डर के रूप में टैग का उपयोग किया है), तो संदेश नहीं भेजा जाएगा।

<details>

<summary>प्रारूप संशोधक (Format modifiers)</summary>

* CapitalizeFirst – प्लेसहोल्डर मान में पहले अक्षर को बड़ा करता है;
* CapitalizeAllFirst – यदि मान में एक से अधिक शब्द हैं तो प्लेसहोल्डर मान में सभी शब्दों के पहले अक्षरों को बड़ा करता है;
* UPPERCASE – सभी अक्षरों को अपरकेस में बदलता है;
* lowercase – सभी अक्षरों को लोअरकेस में बदलता है;
* regular – अनुरोध में निर्दिष्ट प्लेसहोल्डर मान को बिना किसी संशोधन के ठीक वैसे ही डालता है।

</details>

<img src="/customer-journey-api-based-entry-3.webp" alt="पुश प्रीसेट एडिटर जो संदेश सामग्री में प्रारूप संशोधक के साथ प्लेसहोल्डर सिंटैक्स उदाहरण दिखा रहा है"/>

<Aside type="note">
आप प्लेसहोल्डर नाम के बजाय मौजूदा टैग नाम का भी उपयोग कर सकते हैं। इस मामले में, आपको नीचे वर्णित अनुसार अनुरोध में निर्दिष्ट मान द्वारा इस टैग मान को ओवरराइट करने के लिए कॉन्फ़िगर करना होगा।
</Aside>

अपनी जर्नी में पुश या ईमेल स्टेप को कॉन्फ़िगर करते समय, बनाए गए प्रीसेट का चयन करें और **Personalize message with event attributes** विकल्प चालू करें। जर्नी लॉन्च करते समय अनुरोध में संशोधित करने के लिए प्लेसहोल्डर्स का चयन करें। स्रोत के रूप में **API-आधारित एंट्री** और डायनामिक एट्रिब्यूट के रूप में प्लेसहोल्डर नाम चुनें:

<video src="/customer-journey-api-based-entry-4.webm" title="पुश या ईमेल स्टेप कॉन्फ़िगरेशन जो Personalize message with event attributes विकल्प और API-आधारित एंट्री स्रोत चयन दिखा रहा है" autoplay loop muted playsinline />

बदलावों को सहेजने के लिए **Apply** पर क्लिक करें।

4. एंट्री कॉन्फ़िगरेशन विंडो में, इसे संशोधित करने के लिए अनुरोध टेम्पलेट की प्रतिलिपि बनाएँ:

<img src="/customer-journey-api-based-entry-5.webp" alt="API-आधारित एंट्री कॉन्फ़िगरेशन विंडो जो प्राधिकरण हेडर प्रारूप के साथ API अनुरोध टेम्पलेट प्रदर्शित कर रही है"/>
<Aside>
API के माध्यम से एक जर्नी लॉन्च करने के लिए, आपको Authorization हेडर में एक वैध प्राधिकरण टोकन शामिल करना होगा।

**आवश्यक हेडर प्रारूप**

 ```http
 Authorization: Api <your_api_token>
 ```
 **उदाहरण**

 ```http
 Authorization: Api c8dc6435-xxxxxxxxxxxxxxx
 ```
</Aside>

5. [सेगमेंटेशन भाषा](/hi/developer/api-reference/segmentation-filters-api/segmentation-language/) का उपयोग करके "filter" पैरामीटर में ऑडियंस फ़िल्टर जोड़ें। कृपया ध्यान दें कि आपको पहले से आवश्यक [टैग](/hi/developer/guides/audience-and-segmentation/tags/) सेटअप करने होंगे।

उदाहरण के लिए, यदि आप उन उपयोगकर्ताओं पर जर्नी को लक्षित करना चाहते हैं जिन्होंने अपनी _Wishlist_ में _Socks_ आइटम जोड़ा है, तो "filter" मान इस तरह दिखना चाहिए:

```
    "filter": "A("12345-12345") * "T("Wishlist", EQ, "Socks")"
```

इस उदाहरण में, आपके ऐप में एक _Wishlist_ टैग कॉन्फ़िगर होना चाहिए।

<Aside type="note">
आपका एप्लिकेशन कोड स्वचालित रूप से `A(\"12345-12345\")` प्रारूप में "filter" पैरामीटर में जुड़ जाएगा। कृपया इसे हटाएं या संशोधित न करें।

साथ ही, कृपया ध्यान रखें कि JSON प्रश्नों में कोट्स ("") और बैकस्लैश (\\) को बैकस्लैश (\\) से एस्केप किया जाना चाहिए।
</Aside>

6. यदि आपने प्लेसहोल्डर्स सेटअप किए हैं, तो वांछित सामग्री को उनके मानों के रूप में निर्दिष्ट करें:

<img src="/customer-journey-api-based-entry-6.webp" alt="API अनुरोध टेम्पलेट जो जर्नी लॉन्च में डायनामिक सामग्री के लिए प्लेसहोल्डर मान कॉन्फ़िगरेशन दिखा रहा है"/>

7. यदि **Message Rate Limits** विकल्प सक्षम है, तो हर सेकंड एक साथ जर्नी में प्रवेश करने वाले उपयोगकर्ताओं की संख्या सीमित होगी। आप प्रति सेकंड 5000 उपयोगकर्ताओं के डिफ़ॉल्ट मान का उपयोग कर सकते हैं या कोई अन्य संख्या सेट कर सकते हैं।

<img src="/customer-journey-api-based-entry-7.webp" alt="API-आधारित एंट्री कॉन्फ़िगरेशन जो 5000 उपयोगकर्ता प्रति सेकंड के डिफ़ॉल्ट मान के साथ Message Rate Limits विकल्प दिखा रहा है"/>

<Aside type="tip">
हम प्रति सेकंड 5000 और 10000 उपयोगकर्ताओं के बीच मान रखने की सलाह देते हैं। यदि मान बहुत कम है, तो आपके दर्शकों को जर्नी में प्रवेश करने में अधिक समय लग सकता है। यदि मान बहुत अधिक है, तो आपके डेटा को संसाधित करने वाली सेवा ओवरलोड हो सकती है।
</Aside>

8. यदि आप अपने अभियान को बार-बार पुनरारंभ करने की योजना बनाते हैं और नहीं चाहते कि वही उपयोगकर्ता कई बार जर्नी में प्रवेश करें, तो [फ़्रीक्वेंसी कैपिंग](/hi/product/customer-journey/journey-settings#frequency-capping) सेट करें।

> उदाहरण के लिए, आपने उपयोगकर्ताओं को एक विशिष्ट उत्पाद के लिए मूल्य में कमी के बारे में सूचित करने के लिए एक अभियान बनाया है। आप विभिन्न ऑडियंस फ़िल्टर के साथ कई अनुरोध भेजकर जर्नी को कुछ बार फिर से लॉन्च करना चाहते हैं। इस मामले में, आप फ़्रीक्वेंसी कैपिंग जोड़ सकते हैं ताकि उन उपयोगकर्ताओं को बार-बार सूचना न भेजी जाए जो कई फ़िल्टर से मेल खाते हैं।

9. यदि आप चाहते हैं कि जब भी कोई निश्चित व्यावसायिक घटना हो तो एक जर्नी लॉन्च हो, तो वेबहुक का उपयोग करके अनुरोध को स्वचालित करें। एक बार घटना होने पर, वेबहुक को जर्नी शुरू करने के लिए स्वचालित रूप से अनुरोध भेजना चाहिए।

यदि आपको स्वचालन की आवश्यकता नहीं है तो आप अनुरोध को मैन्युअल रूप से भी भेज सकते हैं।

<Aside type="note">
* यदि आप एक नया अनुरोध भेजते समय सेगमेंटेशन शर्तों को बदलते हैं, तो यह उन उपयोगकर्ताओं को प्रभावित नहीं करेगा जो पहले ही जर्नी में प्रवेश कर चुके हैं।
* यदि आप एक नया अनुरोध भेजते समय संदेश सामग्री बदलते हैं, तो सभी उपयोगकर्ताओं को संदेश का नया संस्करण प्राप्त होगा (उन लोगों सहित जो पहले ही जर्नी में प्रवेश कर चुके हैं लेकिन अभी तक यह संदेश प्राप्त नहीं हुआ है)।
</Aside>