# AppsFlyer इंटीग्रेशन

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

## इंटीग्रेशन का अवलोकन

[AppsFlyer](https://www.appsflyer.com/) एक मोबाइल एट्रिब्यूशन और मार्केटिंग एनालिटिक्स प्लेटफॉर्म है जो आपको उपयोगकर्ता अधिग्रहण और जुड़ाव का विश्लेषण करने में मदद करता है। यह ऐप के भीतर उपयोगकर्ता के व्यवहार पर व्यापक डेटा प्रदान करता है और आपको उपयोगकर्ता अधिग्रहण स्रोतों को ट्रैक करने की अनुमति देता है। AppsFlyer से प्राप्त जानकारी का उपयोग करके, आप Pushwoosh में प्रभावी मार्केटिंग अभियान बना सकते हैं।

एक बार इंटीग्रेशन कॉन्फ़िगर हो जाने पर, AppsFlyer निम्नलिखित जानकारी Pushwoosh को भेजेगा:

* उपयोगकर्ता का इन-ऐप व्यवहार इवेंट्स और उनके एट्रिब्यूट्स के रूप में;
* उपयोगकर्ता अधिग्रहण स्रोत _Acquisition Source_ टैग मानों के रूप में।
### उपयोग के मामले

इस डेटा का उपयोग करके, आप उपयोगकर्ता सेगमेंट बना सकते हैं और Pushwoosh में सटीक रूप से लक्षित और व्यक्तिगत अभियान बना सकते हैं।
नीचे Pushwoosh में प्रभावी कस्टमर जर्नी बनाने के लिए AppsFlyer डेटा का लाभ उठाने के दो उदाहरण दिए गए हैं।

**1. AppsFlyer द्वारा ट्रैक किए गए इवेंट्स का उपयोग करके Pushwoosh में अत्यधिक लक्षित अभियान बनाएं।**

मान लीजिए आपके पास एक समाचार ऐप है। आपने _SubscribedToNews_ इवेंट को ट्रैक करने के लिए AppsFlyer को कॉन्फ़िगर किया है, जो हर बार जब कोई उपयोगकर्ता किसी समाचार चैनल की सदस्यता लेता है तो फायर होता है। इस इवेंट में श्रेणी एट्रिब्यूट है जो उपयोगकर्ता द्वारा सब्सक्राइब किए गए समाचार के प्रकार को इंगित करता है: _politics_, _business_, या _sports_।

Pushwoosh को इस इवेंट के बारे में उसके एट्रिब्यूट मानों के साथ जानकारी मिलती है। आप तीन संभावित मानों के आधार पर तीन उपयोगकर्ता सेगमेंट बना सकते हैं:

<img src="/integrations-appsflyer-integration-1.webp" alt="समाचार श्रेणी एट्रिब्यूट के आधार पर उपयोगकर्ता सेगमेंट"/>

अब आप उन उपयोगकर्ताओं पर लक्षित अभियान बना सकते हैं जो किसी विशेष प्रकार के समाचार में रुचि रखते हैं:

<img src="/integrations-appsflyer-integration-2.webp" alt="विशिष्ट समाचार श्रेणियों में रुचि रखने वाले उपयोगकर्ताओं के लिए लक्षित अभियान"/>

**2. AppsFlyer से उपयोगकर्ता व्यवहार डेटा के आधार पर मैसेजिंग को व्यक्तिगत बनाएं।**

इस उदाहरण में, हम एक ऑनलाइन शॉपिंग ऐप का उपयोग करेंगे। मान लीजिए AppsFlyer _AddToWishlist_ इवेंट को ट्रैक करता है जो तब फायर होता है जब कोई उपयोगकर्ता अपनी विशलिस्ट में कोई आइटम जोड़ता है। इस इवेंट में आइटम एट्रिब्यूट है जो विशलिस्ट में जोड़े गए आइटम का नाम इंगित करता है।

AppsFlyer _AddToWishlist_ इवेंट डेटा को Pushwoosh को भेजता है, जहाँ आप उपयोगकर्ताओं की पसंद के आधार पर संदेशों को व्यक्तिगत बना सकते हैं। उदाहरण के लिए, आप एक पुश प्रीसेट बना सकते हैं जो किसी उपयोगकर्ता द्वारा अपनी विशलिस्ट में जोड़े गए आइटम पर छूट प्रदान करता है। आइटम के नाम के बजाय, _item_ एट्रिब्यूट के साथ एक [डायनामिक कंटेंट प्लेसहोल्डर](/hi/developer/guides/personalization/dynamic-content/#personalizing-messages-sent-via-api-with-dynamic-content) जोड़ें:

<img src="/integrations-appsflyer-integration-3.webp" alt="Pushwoosh पुश प्रीसेट में डायनामिक कंटेंट प्लेसहोल्डर"/>

यदि कोई उपयोगकर्ता अपनी विशलिस्ट में कोई आइटम जोड़ता है, तो उन्हें इसके बारे में जानकारी वाला एक पुश प्राप्त होगा। उदाहरण के लिए, जो लोग iPhone 14 Pro Max चुनते हैं, उन्हें यह संदेश दिखाई देगा:

<img src="/integrations-appsflyer-integration-4.webp" alt="iPhone 14 Pro Max आइटम ऑफ़र के लिए पुश नोटिफिकेशन प्रीव्यू" width="375"/>

## इंटीग्रेशन सेट अप करना

<Aside type="note">
इंटीग्रेशन प्रक्रिया Android और iOS दोनों प्लेटफॉर्म के लिए समान है।
</Aside>

1. यदि आपने पहले से नहीं किया है तो Pushwoosh SDK को अपने ऐप में इंटीग्रेट करें। अधिक विस्तृत निर्देशों के लिए, [गाइड पढ़ें](/hi/developer/pushwoosh-sdk/pushwoosh-sdk-overview)।

<Aside type="caution">
सही संचालन के लिए, Pushwoosh iOS SDK संस्करण 6.5.7 या बाद का और Pushwoosh Android SDK संस्करण 6.6.16 या बाद का आवश्यक है।
</Aside>

2. यह सुनिश्चित करने के लिए कि AppsFlyer को सही डेटा भेजा जाए, इस कोड स्निपेट को अपने कोड में इंटीग्रेट करें। सुनिश्चित करें कि यह Pushwoosh SDK और AppsFlyer SDK दोनों के इनिशियलाइज़ होने के बाद निष्पादित हो।

<Tabs>
<TabItem label="Java">
```
String pwhwid = Pushwoosh.getInstance().getHwid();
String pwuserid = Pushwoosh.getInstance().getUserId();
Map<String, Object> customData = new HashMap<String, Object>();
customData.put("pushwoosh_hwid", pwhwid);
customData.put("pushwoosh_user_id", pwuserid);
AppsFlyerLib.getInstance().setAdditionalData(customData);
```
</TabItem>

<TabItem label="Objective-C">
```
NSString *pwhwid = [[Pushwoosh sharedInstance] getHWID];
NSString *pwuserid = [[Pushwoosh sharedInstance] getUserId];
NSDictionary *customData = [[NSDictionary alloc] initWithObjectsAndKeys:pwuserid, @"pushwoosh_user_id", pwhwid, @"pushwoosh_hwid", nil];
[[AppsFlyerLib shared] setAdditionalData:customData];
```
</TabItem>
</Tabs>

<Aside type="danger">
उपयोगकर्ताओं को पहचानने और लक्षित करने के लिए कस्टम Pushwoosh UserID मानों का उपयोग करते समय, सुनिश्चित करें कि Pushwoosh SDK में कस्टम मान के साथ **setUserId()** विधि को कॉल करने के बाद कोड चलाएं।

ट्रैक करें कि आपके मोबाइल एप्लिकेशन में लॉजिक के अनुसार Pushwoosh UserID कब बदलता है और अपडेट किए गए मानों को तुरंत AppsFlyer को भेजें। यह आपके Pushwoosh डेटाबेस में उपयोगकर्ताओं के साथ भेजे गए डेटा की सही मैपिंग के लिए महत्वपूर्ण है।
</Aside>

3. AppsFlyer में Pushwoosh इंटीग्रेशन कॉन्फ़िगर करें। इसके लिए, अपने [AppsFlyer खाते](https://hq1.appsflyer.com/auth/login) में, **Collaborate** > **Partner Marketplace** पर जाएं। पार्टनर्स सूची में, Pushwoosh का पता लगाएं और चुनें।

<img src="/integrations-appsflyer-integration-5.webp" alt="AppsFlyer में Pushwoosh का पता लगाना"/>

4. **Set up integration** पर क्लिक करें। फिर आपको इंटीग्रेशन सेटअप पेज पर निर्देशित किया जाएगा। वहां, **Activate partner** टॉगल को सक्षम करें।

<img src="/integrations-appsflyer-integration-6.webp" alt="AppsFlyer में Activate partner टॉगल को सक्षम करना"/>

<Aside type="note">
iOS ऐप्स के लिए, एडवांस्ड प्राइवेसी मोड डिफ़ॉल्ट रूप से सक्षम होता है जो AppsFlyer प्लेटफॉर्म के माध्यम से उपयोगकर्ता-स्तरीय एट्रिब्यूशन डेटा की उपलब्धता को नियंत्रित करने की अनुमति देता है। यद्यपि AppsFlyer इस प्रकार का डेटा Pushwoosh को नहीं भेजता है, एडवांस्ड प्राइवेसी टॉगल को सक्रिय रखने से डेटा ट्रांसमिशन में हस्तक्षेप हो सकता है।

यह सुनिश्चित करने के लिए कि Pushwoosh को सभी डेटा प्राप्त हो, हम **App Settings** में एडवांस्ड प्राइवेसी मोड को अक्षम करने की सलाह देते हैं। ऐसा करने से उपयोगकर्ता डेटा की गोपनीयता से कोई समझौता नहीं होगा। Pushwoosh डेटा को सुरक्षित और जिम्मेदारी से प्रबंधित करने के लिए समर्पित है, गोपनीयता की रक्षा के लिए उद्योग-मानक सुरक्षा प्रोटोकॉल का उपयोग करता है।
</Aside>

<img src="/integrations-appsflyer-integration-7.webp" alt="AppsFlyer में एडवांस्ड प्राइवेसी मोड को अक्षम करना"/>

5. **General settings** सेक्शन में, अपने Pushwoosh क्रेडेंशियल्स दर्ज करें:

* **API Access Token**। टोकन प्राप्त करने के लिए, अपने Pushwoosh खाते में **Settings > API Access** पर जाएं और कोड कॉपी करें। आप API Access Token के बारे में अधिक जानकारी [इस गाइड में](/hi/developer/api-reference/api-access-token) प्राप्त कर सकते हैं।
* **Application Code** (XXXXX-XXXXX) जो आप अपने Pushwoosh खाते में अपने एप्लिकेशन नाम के नीचे पा सकते हैं।

<img src="/integrations-appsflyer-integration-8.webp" alt="AppsFlyer सामान्य सेटिंग्स में Pushwoosh क्रेडेंशियल्स जोड़ना"/>

6. **Default postback** सेक्शन में, **All media sources, including organic** चुनें।

<img src="/integrations-appsflyer-integration-9.webp" alt="Default postback सेक्शन को कॉन्फ़िगर करना"/>

7. **In-app event settings** सेक्शन में, अपना Pushwoosh **Application Code** और **API Access Token** दर्ज करें।

<img src="/integrations-appsflyer-integration-10.webp" alt="Application Code और API टोकन के साथ इन-ऐप इवेंट सेटिंग्स सेक्शन"/>

8. **In-app event postback** टॉगल को सक्षम करें और Pushwoosh को भेजे जाने वाले पोस्टबैक में शामिल किए जाने वाले इवेंट्स और डेटा को कॉन्फ़िगर करें।

<img src="/integrations-appsflyer-integration-11.webp" alt="AppsFlyer में इन-ऐप इवेंट पोस्टबैक टॉगल कॉन्फ़िगरेशन"/>

ड्रॉप-डाउन मेनू से Pushwoosh को भेजने के लिए एक या अधिक AppsFlyer इवेंट्स चुनें, और आवश्यक पैरामीटर पूरे करें।

| पैरामीटर | विवरण |
| --- | --- |
| **the mapped to partner event** | भले ही यह फ़ील्ड अनिवार्य है, चिंता न करें कि आप क्या टाइप करते हैं क्योंकि यह इवेंट्स के नामकरण को नहीं बदलेगा। Pushwoosh को अभी भी वही नाम वाले इवेंट्स मिलेंगे जैसे वे AppsFlyer में दिखाई देते हैं। |
| **for users from** | इस फ़ील्ड में, चुनें कि क्या पोस्टबैक विशेष रूप से इस पार्टनर को एट्रिब्यूट किए गए उपयोगकर्ताओं के लिए भेजे जाते हैं या ऑर्गेनिक सहित सभी मीडिया स्रोतों के लिए। |
| **including** | <p>चुनें कि इवेंट डेटा Pushwoosh के साथ कैसे साझा किया जाता है:</p><ul><li><strong>No values & no revenue:</strong> केवल इवेंट को बिना किसी पैरामीटर (मान या राजस्व) के भेजें।</li><li><strong>Values & no revenue:</strong> राजस्व मान को छोड़कर सभी पैरामीटर भेजें।</li><li><strong>Values & revenue:</strong> राजस्व मान सहित सभी इवेंट पैरामीटर भेजें (यदि यह इवेंट में मौजूद है)।<br/>Pushwoosh को भेजे गए अतिरिक्त एट्रिब्यूट के साथ इवेंट्स प्राप्त करने के लिए, Values and Revenue चुनें।</li></ul> |

9. एक बार इंटीग्रेशन कॉन्फ़िगर हो जाने पर, **Save** पर क्लिक करें।

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

## AppsFlyer ESP 2.0 के साथ ईमेल क्लिक ट्रैकिंग

ईमेल क्लिक ट्रैकिंग का उपयोग करने और Pushwoosh के माध्यम से ईमेल भेजते समय यूनिवर्सल लिंक / ऐप लिंक को संरक्षित करने के लिए, आप [AppsFlyer ESP 2.0 ईमेल इंटीग्रेशन](/hi/product/integrations/appsflyer-esp2-email-integration) सेट अप कर सकते हैं।