# मेटा विज्ञापन एकीकरण
[मेटा विज्ञापन](https://www.facebook.com/business/ads) एकीकरण आपको Pushwoosh ऑडियंस को अपने मेटा विज्ञापन खातों में सिंक करने की सुविधा देता है। इसका उपयोग विज्ञापन अभियानों में उपयोगकर्ताओं को लक्षित करने या बाहर करने और अपनी ग्राहक यात्रा में एक और चैनल के रूप में भुगतान किए गए विज्ञापनों को जोड़ने के लिए करें।
## उपयोग के मामले
इस एकीकरण का उपयोग करें:
* खरीद या जुड़ाव बढ़ाने के लिए कई चैनलों में उच्च-मूल्य वाले उपयोगकर्ताओं को लक्षित करना
* उन उपयोगकर्ताओं को पुनः लक्षित करना जो अन्य चैनलों में कम प्रतिक्रियाशील हैं
* सप्रेशन ऑडियंस बनाना ताकि वफादार ग्राहकों को अनावश्यक विज्ञापन न मिलें
## पूर्वापेक्षाएँ
मेटा विज्ञापन कनेक्ट करने से पहले, सुनिश्चित करें:
* आपके Pushwoosh खाते में **एडमिन** भूमिका है। भूमिकाएँ और अनुमतियाँ कैसे काम करती हैं, इसके लिए [उपयोगकर्ता पहुँच और अनुमतियाँ प्रबंधित करें](/hi/product/account-management-and-security/multi-login-accounts/#creating-and-managing-roles-also-known-as-groups) देखें।
* आपके पास अपने ब्रांड की फेसबुक संपत्तियों, जिसमें विज्ञापन खाते, पेज और ऐप शामिल हैं, को प्रबंधित करने के लिए एक [**फेसबुक बिजनेस मैनेजर**](https://www.facebook.com/business/tools/business-manager) स्थापित है।
* आपके पास अपने बिजनेस मैनेजर से जुड़ा एक सक्रिय [**फेसबुक विज्ञापन खाता**](https://www.facebook.com/business/tools/ads-manager) है।
* आपके फेसबुक बिजनेस मैनेजर एडमिन ने आपको उन विज्ञापन खातों के लिए **अभियान प्रबंधित करें** या **विज्ञापन खाते प्रबंधित करें** की अनुमतियाँ दी हैं जिन्हें आप Pushwoosh के साथ उपयोग करने की योजना बना रहे हैं।
* आपने उन खातों के लिए विज्ञापन खाते के नियम और शर्तें स्वीकार कर ली हैं।
* आपने उन फेसबुक विज्ञापन खातों के लिए [**फेसबुक की कस्टम ऑडियंस शर्तें**](https://business.facebook.com/legal/terms/customaudience) स्वीकार कर ली हैं जिन्हें आप Pushwoosh के साथ उपयोग करने की योजना बना रहे हैं।
## Pushwoosh में मेटा विज्ञापन सेट अप करें
1. Pushwoosh में, **सेटिंग्स** > **तृतीय-पक्ष एकीकरण** पर जाएँ।
2. मेटा विज्ञापन कार्ड में, **लॉगिन पेज** पर क्लिक करें।
3. अपने मेटा खाते में साइन इन करें, फिर **जारी रखें** पर क्लिक करें।
4. उन विज्ञापन खातों का चयन करें जिन्हें आप कनेक्ट करना चाहते हैं।
5. विज्ञापन खाते और व्यावसायिक पहुँच के लिए अनुरोधित अनुमतियों की समीक्षा करें।
6. **सहेजें** पर क्लिक करें। मेटा फिर एक पुष्टि दिखाता है कि आपका खाता कनेक्ट हो गया है।
### कनेक्शन स्थिति की समीक्षा करें
सेटअप के बाद, आपको Pushwoosh में **मेटा विज्ञापन** पृष्ठ पर पुनः निर्देशित किया जाएगा।
विज्ञापन खातों की तालिका प्रत्येक कनेक्टेड खाते को सूचीबद्ध करती है:
* **विज्ञापन खाता नाम**
* **व्यावसायिक खाता**
* **आईडी**
एक पंक्ति के अंत में तीन बिंदुओं को खोलें और Pushwoosh में सूची से उस विज्ञापन खाते को हटाने के लिए **विज्ञापन खाता हटाएं** चुनें।
### कनेक्टेड विज्ञापन खातों का प्रबंधन करें
**मेटा विज्ञापन** पृष्ठ पर, संवाद खोलने के लिए **खातों का प्रबंधन करें** पर क्लिक करें। एकीकरण से उस विज्ञापन खाते को शामिल करने या बाहर करने के लिए प्रत्येक पंक्ति पर टॉगल का उपयोग करें।
परिवर्तनों को सहेजने के लिए **लागू करें** पर क्लिक करें या बिना सहेजे बंद करने के लिए **रद्द करें** पर क्लिक करें।
सूची दृश्य को समायोजित करने के लिए:
* कौन सी पंक्तियाँ दिखाई देती हैं, इसे सीमित करने के लिए **केवल कनेक्टेड दिखाएं** को चालू या बंद करें।
* सूची में खातों को खोजने के लिए **नाम या आईडी से खोजें...** में टाइप करें।
### प्रोजेक्ट टैग को मेटा फ़ील्ड्स पर मैप करें
उपयोगकर्ता गुणों को मैप करने से आप Pushwoosh को बता सकते हैं कि कौन से मेटा उपयोगकर्ता विशेषताएँ आपके प्रोजेक्ट में कौन से **टैग नाम** फ़ील्ड्स को अपडेट करनी चाहिए। इस तरह, जब मेटा से डेटा आता है, तो यह वहाँ सहेजा जाता है जहाँ आप उम्मीद करते हैं।
1. **मेटा विज्ञापन** पृष्ठ पर, **उपयोगकर्ता डेटा मैप करें** पर क्लिक करें।
2. बाएँ कॉलम में प्रत्येक **फेसबुक फ़ील्ड** के लिए, दाएँ नियंत्रण से अपने प्रोजेक्ट में एक **टैग नाम** चुनें।
केवल उन पंक्तियों को मैप करें जिनकी आपको आवश्यकता है।
3. मैपिंग लागू करने के लिए **सहेजें** पर क्लिक करें या बिना सहेजे बंद करने के लिए **रद्द करें** पर क्लिक करें।
## SDK में MADID संग्रह सक्षम करें
मेटा विज्ञापन मोबाइल SDK के माध्यम से एकत्र किए गए डिवाइस पहचानकर्ताओं (MADID) का उपयोग करके उपयोगकर्ताओं का मिलान करता है।
Pushwoosh SDK स्वचालित रूप से विज्ञापन पहचानकर्ताओं (एंड्रॉइड पर GAID, iOS पर IDFA) को एकत्र नहीं करता है।
दोनों प्लेटफॉर्म पहचानकर्ता को पढ़ने से पहले स्पष्ट उपयोगकर्ता सहमति की आवश्यकता होती है।
अपने एप्लिकेशन में, उपयोगकर्ता की सहमति का अनुरोध करें, अनुमति मिलने पर पहचानकर्ता पढ़ें, और
मान को SDK को पास करें।
**1. निर्भरता जोड़ें**
```groovy
implementation 'com.google.android.gms:play-services-ads-identifier:...'
```
**2. AD_ID अनुमति घोषित करें (targetSdk ≥ 33 के लिए आवश्यक)**
इसे अपने `AndroidManifest.xml` में जोड़ें:
```xml
```
**3. GAID प्राप्त करें और इसे SDK को पास करें**
`getAdvertisingIdInfo` को एक पृष्ठभूमि थ्रेड पर कॉल किया जाना चाहिए:
```java
String gaid = AdvertisingIdClient.getAdvertisingIdInfo(context).getId();
Pushwoosh.getInstance().setAdvertisingId(gaid);
```
बैकएंड पर संग्रहीत मान को साफ़ करने के लिए, `null` या एक खाली स्ट्रिंग पास करें:
```java
Pushwoosh.getInstance().setAdvertisingId(null);
```
**व्यवहार नोट्स:**
- यदि अंतिम सफल कॉल के बाद से मान नहीं बदला है, तो कोई नेटवर्क अनुरोध नहीं किया जाता है।
- यदि नेटवर्क अनुरोध विफल हो जाता है, तो अगले ऐप लॉन्च पर पुनः प्रयास करें।
- जब `Pushwoosh.stopCommunication()` सक्रिय होता है तो कॉल को अनदेखा कर दिया जाता है।
- शून्य UUID (`00000000-0000-0000-0000-000000000000`) को `null` के समान माना जाता है — संग्रहीत MADID को बैकएंड पर साफ़ कर दिया जाता है।
**1. `Info.plist` में उपयोग विवरण जोड़ें**
ATT अनुमति संवाद दिखाने से पहले Apple को इस कुंजी की आवश्यकता होती है:
```xml
NSUserTrackingUsageDescriptionWe use your advertising identifier to show you relevant ads.
```
**2. अपनी गोपनीयता मैनिफेस्ट में ट्रैकिंग डोमेन घोषित करें**
यदि आपका ऐप ट्रैकिंग के लिए IDFA का उपयोग करता है, तो Apple को आपके [गोपनीयता मैनिफेस्ट](https://developer.apple.com/documentation/bundleresources/privacy-manifest-files) (`PrivacyInfo.xcprivacy`) में ट्रैकिंग डेटा प्राप्त करने वाले डोमेन को सूचीबद्ध करने की आवश्यकता होती है। पूरी आवश्यकताओं के लिए [TN3182](https://developer.apple.com/documentation/technotes/tn3182-adding-privacy-tracking-keys-to-your-privacy-manifest) देखें।
`NSPrivacyTracking` को `true` पर सेट करें और Pushwoosh ट्रैकिंग डोमेन को `NSPrivacyTrackingDomains` में जोड़ें:
```xml
NSPrivacyTrackingNSPrivacyTrackingDomainstracking.svc-nue.pushwoosh.com
```
**3. ट्रैकिंग प्राधिकरण का अनुरोध करें और IDFA को SDK को पास करें**
`ATTrackingManager` को iOS 14 या बाद के संस्करण की आवश्यकता होती है। यदि आपका परिनियोजन लक्ष्य iOS 14 से नीचे है, तो कॉल को उपलब्धता जांच में लपेटें।
Pushwoosh SDK `ATTrackingManager` को कॉल नहीं करता है। अपने एप्लिकेशन में ट्रैकिंग प्राधिकरण का अनुरोध करें, फिर परिणाम को SDK को पास करें:
```swift
import AppTrackingTransparency
import AdSupport
if #available(iOS 14, *) {
ATTrackingManager.requestTrackingAuthorization { status in
let idfa = status == .authorized
? ASIdentifierManager.shared().advertisingIdentifier.uuidString
: nil
Pushwoosh.configure.setAdvertisingId(idfa)
}
}
```
बैकएंड पर संग्रहीत मान को साफ़ करने के लिए, `nil` या एक खाली स्ट्रिंग पास करें:
```swift
Pushwoosh.configure.setAdvertisingId(nil)
```
**व्यवहार नोट्स:**
- यदि अंतिम सफल कॉल के बाद से मान नहीं बदला है, तो कोई नेटवर्क अनुरोध नहीं किया जाता है।
- यदि नेटवर्क अनुरोध विफल हो जाता है, तो अगले ऐप लॉन्च पर `setAdvertisingId` को फिर से कॉल करें।
- जब `Pushwoosh_ALLOW_SERVER_COMMUNICATION` अक्षम होता है तो कॉल को अनदेखा कर दिया जाता है।
- शून्य UUID (`00000000-0000-0000-0000-000000000000`) को `nil` या एक खाली स्ट्रिंग के समान माना जाता है — संग्रहीत MADID को बैकएंड पर साफ़ कर दिया जाता है।
> अपने ऐप के मुख्य UI प्रवाह से `requestTrackingAuthorization` को कॉल करें। Apple लॉन्च पर तुरंत नहीं, बल्कि अपनी स्वयं की व्याख्यात्मक स्क्रीन दिखाने के बाद ऐसा करने की सलाह देता है।
### यह कैसे काम करता है
एक बार जब आप `setAdvertisingId` को कॉल करते हैं, तो SDK मान को Pushwoosh ट्रैकिंग एंडपॉइंट पर `madid` फ़ील्ड के रूप में ऐप कोड और डिवाइस हार्डवेयर आईडी के साथ भेजता है। Pushwoosh इस पहचानकर्ता का उपयोग आपके डिवाइस रिकॉर्ड को सिंक्रनाइज़ेशन के लिए मेटा विज्ञापन ऑडियंस के साथ मिलान करने के लिए करता है।
## यात्राओं में ऑडियंस सिंक करें
**Journey Builder** में **ऑडियंस सिंक** बिंदु आपकी यात्रा को एक मेटा कस्टम ऑडियंस से जोड़ता है। हर बार जब कोई उपयोगकर्ता उस बिंदु पर पहुँचता है, तो Pushwoosh मेटा से या तो उन्हें ऑडियंस में जोड़ने या उन्हें इससे हटाने के लिए कहता है।
उदाहरण के लिए, आप इसका उपयोग उन उपयोगकर्ताओं को वेबिनार विज्ञापन दिखाना बंद करने के लिए कर सकते हैं जो पहले ही पंजीकरण कर चुके हैं, ताकि आप उन लोगों पर विज्ञापन खर्च बर्बाद न करें जिन्हें अब इसे देखने की आवश्यकता नहीं है।
ऑडियंस सिंक को कॉन्फ़िगर करने के लिए:
1. [**Journey Builder**](/hi/product/customer-journey/pushwoosh-journey-overview/) खोलें।
2. एक [**ऑडियंस-आधारित प्रविष्टि**](/hi/product/customer-journey/journey-elements/entry-elements/audience-based-entry/) जोड़ें। **ऑडियंस स्रोत** में, एक Pushwoosh सेगमेंट या सूची चुनें जो परिभाषित करती है कि इस यात्रा में कौन प्रवेश करेगा। उदाहरण के लिए, एक सेगमेंट **`webinar_registered` टैग वाले उपयोगकर्ता `true` पर सेट हैं**। केवल वे उपयोगकर्ता यात्रा के माध्यम से आगे बढ़ेंगे और **ऑडियंस सिंक** तक पहुँचेंगे।
3. **ऑडियंस सिंक** बिंदु जोड़ें।
4. **उपयोगकर्ताओं की जानकारी को मेटा ऑडियंस में कैसे सिंक करें** के तहत, एक विकल्प चुनें:
* **उपयोगकर्ताओं को ऑडियंस में जोड़ें**। इस चरण पर पहुँचने वाले प्रत्येक उपयोगकर्ता को आपके द्वारा चुने गए मेटा ऑडियंस में जोड़ता है। उदाहरण के लिए, इसका उपयोग उन उपयोगकर्ताओं को विज्ञापन दिखाना शुरू करने के लिए करें जिन्होंने साइन अप किया है लेकिन अभी तक भाग नहीं लिया है।
* **उपयोगकर्ताओं को ऑडियंस से हटाएं**। इस चरण पर पहुँचने वाले प्रत्येक उपयोगकर्ता को उस मेटा ऑडियंस से हटा देता है। इस उदाहरण में, उन उपयोगकर्ताओं को वेबिनार विज्ञापन दिखाना बंद करने के लिए इस विकल्प का चयन करें जो पहले ही पंजीकरण कर चुके हैं।
5. **मेटा विज्ञापन खाते** में, कनेक्टेड विज्ञापन खाते का चयन करें।
6. **ऑडियंस** में, मेटा ऑडियंस का चयन करें, उदाहरण के लिए **वेबिनार**।
7. बिंदु को सहेजने के लिए **लागू करें** पर क्लिक करें या बिना सहेजे बंद करने के लिए **रद्द करें** पर क्लिक करें।
8. यात्रा को कॉन्फ़िगर करना समाप्त करें, फिर इसे लॉन्च करें।
जब वे उपयोगकर्ता **ऑडियंस सिंक** पर पहुँचते हैं, तो उन्हें मेटा में **वेबिनार** ऑडियंस से हटा दिया जाता है, इसलिए वे अब वहाँ वेबिनार विज्ञापन नहीं देखते हैं।
## व्यवहार और त्रुटि प्रबंधन
यात्रा प्रसंस्करण मेटा खाते और ऑडियंस की उपलब्धता पर निर्भर करता है:
* मेटा ऑडियंस को तभी अपडेट करता है जब वह Pushwoosh द्वारा प्रदान किए गए डेटा से उपयोगकर्ता का मिलान कर सकता है। यदि मेटा उपयोगकर्ता का मिलान नहीं कर सकता है, तो उस उपयोगकर्ता के लिए ऑडियंस नहीं बदलती है, और वे यात्रा में जारी रहते हैं।
* यदि कोई प्रोफ़ाइल **ऑडियंस सिंक** बिंदु पर पहुँचती है, जबकि कनेक्टेड विज्ञापन खाता डिस्कनेक्ट हो गया है, तो उस प्रोफ़ाइल के लिए यात्रा रुक जाती है और Pushwoosh सिस्टम और ईमेल सूचनाएं भेजता है।
* यदि कोई चयनित ऑडियंस मेटा में नहीं मिलती है और API एक त्रुटि देता है, तो उस प्रोफ़ाइल के लिए यात्रा रुक जाती है और Pushwoosh सिस्टम और ईमेल सूचनाएं भेजता है।
## ऑडियंस सिंक आँकड़े
लॉन्च के बाद, **ऑडियंस सिंक** चरण के लिए आँकड़े खोलें ताकि प्रवेश मात्रा, जोड़ और निष्कासन, और छोड़ी गई प्रोफ़ाइल देख सकें। मीट्रिक विवरण के लिए, **ग्राहक यात्रा आँकड़े** में [**ऑडियंस सिंक**](/hi/product/statistics-and-analytics/journey-statistics/journey-element-statistics/#audience-sync) देखें।
3. अपने मेटा खाते में साइन इन करें, फिर **जारी रखें** पर क्लिक करें।
4. उन विज्ञापन खातों का चयन करें जिन्हें आप कनेक्ट करना चाहते हैं।
5. विज्ञापन खाते और व्यावसायिक पहुँच के लिए अनुरोधित अनुमतियों की समीक्षा करें।
6. **सहेजें** पर क्लिक करें। मेटा फिर एक पुष्टि दिखाता है कि आपका खाता कनेक्ट हो गया है।
### कनेक्शन स्थिति की समीक्षा करें
सेटअप के बाद, आपको Pushwoosh में **मेटा विज्ञापन** पृष्ठ पर पुनः निर्देशित किया जाएगा।
विज्ञापन खातों की तालिका प्रत्येक कनेक्टेड खाते को सूचीबद्ध करती है:
* **विज्ञापन खाता नाम**
* **व्यावसायिक खाता**
* **आईडी**
एक पंक्ति के अंत में तीन बिंदुओं को खोलें और Pushwoosh में सूची से उस विज्ञापन खाते को हटाने के लिए **विज्ञापन खाता हटाएं** चुनें।
### कनेक्टेड विज्ञापन खातों का प्रबंधन करें
**मेटा विज्ञापन** पृष्ठ पर, संवाद खोलने के लिए **खातों का प्रबंधन करें** पर क्लिक करें। एकीकरण से उस विज्ञापन खाते को शामिल करने या बाहर करने के लिए प्रत्येक पंक्ति पर टॉगल का उपयोग करें।
परिवर्तनों को सहेजने के लिए **लागू करें** पर क्लिक करें या बिना सहेजे बंद करने के लिए **रद्द करें** पर क्लिक करें।
सूची दृश्य को समायोजित करने के लिए:
* कौन सी पंक्तियाँ दिखाई देती हैं, इसे सीमित करने के लिए **केवल कनेक्टेड दिखाएं** को चालू या बंद करें।
* सूची में खातों को खोजने के लिए **नाम या आईडी से खोजें...** में टाइप करें।
### प्रोजेक्ट टैग को मेटा फ़ील्ड्स पर मैप करें
उपयोगकर्ता गुणों को मैप करने से आप Pushwoosh को बता सकते हैं कि कौन से मेटा उपयोगकर्ता विशेषताएँ आपके प्रोजेक्ट में कौन से **टैग नाम** फ़ील्ड्स को अपडेट करनी चाहिए। इस तरह, जब मेटा से डेटा आता है, तो यह वहाँ सहेजा जाता है जहाँ आप उम्मीद करते हैं।
1. **मेटा विज्ञापन** पृष्ठ पर, **उपयोगकर्ता डेटा मैप करें** पर क्लिक करें।
2. बाएँ कॉलम में प्रत्येक **फेसबुक फ़ील्ड** के लिए, दाएँ नियंत्रण से अपने प्रोजेक्ट में एक **टैग नाम** चुनें।
केवल उन पंक्तियों को मैप करें जिनकी आपको आवश्यकता है।
3. मैपिंग लागू करने के लिए **सहेजें** पर क्लिक करें या बिना सहेजे बंद करने के लिए **रद्द करें** पर क्लिक करें।
## SDK में MADID संग्रह सक्षम करें
मेटा विज्ञापन मोबाइल SDK के माध्यम से एकत्र किए गए डिवाइस पहचानकर्ताओं (MADID) का उपयोग करके उपयोगकर्ताओं का मिलान करता है।
Pushwoosh SDK स्वचालित रूप से विज्ञापन पहचानकर्ताओं (एंड्रॉइड पर GAID, iOS पर IDFA) को एकत्र नहीं करता है।
दोनों प्लेटफॉर्म पहचानकर्ता को पढ़ने से पहले स्पष्ट उपयोगकर्ता सहमति की आवश्यकता होती है।
अपने एप्लिकेशन में, उपयोगकर्ता की सहमति का अनुरोध करें, अनुमति मिलने पर पहचानकर्ता पढ़ें, और
मान को SDK को पास करें।
7. बिंदु को सहेजने के लिए **लागू करें** पर क्लिक करें या बिना सहेजे बंद करने के लिए **रद्द करें** पर क्लिक करें।
8. यात्रा को कॉन्फ़िगर करना समाप्त करें, फिर इसे लॉन्च करें।
जब वे उपयोगकर्ता **ऑडियंस सिंक** पर पहुँचते हैं, तो उन्हें मेटा में **वेबिनार** ऑडियंस से हटा दिया जाता है, इसलिए वे अब वहाँ वेबिनार विज्ञापन नहीं देखते हैं।
## व्यवहार और त्रुटि प्रबंधन
यात्रा प्रसंस्करण मेटा खाते और ऑडियंस की उपलब्धता पर निर्भर करता है:
* मेटा ऑडियंस को तभी अपडेट करता है जब वह Pushwoosh द्वारा प्रदान किए गए डेटा से उपयोगकर्ता का मिलान कर सकता है। यदि मेटा उपयोगकर्ता का मिलान नहीं कर सकता है, तो उस उपयोगकर्ता के लिए ऑडियंस नहीं बदलती है, और वे यात्रा में जारी रहते हैं।
* यदि कोई प्रोफ़ाइल **ऑडियंस सिंक** बिंदु पर पहुँचती है, जबकि कनेक्टेड विज्ञापन खाता डिस्कनेक्ट हो गया है, तो उस प्रोफ़ाइल के लिए यात्रा रुक जाती है और Pushwoosh सिस्टम और ईमेल सूचनाएं भेजता है।
* यदि कोई चयनित ऑडियंस मेटा में नहीं मिलती है और API एक त्रुटि देता है, तो उस प्रोफ़ाइल के लिए यात्रा रुक जाती है और Pushwoosh सिस्टम और ईमेल सूचनाएं भेजता है।
## ऑडियंस सिंक आँकड़े
लॉन्च के बाद, **ऑडियंस सिंक** चरण के लिए आँकड़े खोलें ताकि प्रवेश मात्रा, जोड़ और निष्कासन, और छोड़ी गई प्रोफ़ाइल देख सकें। मीट्रिक विवरण के लिए, **ग्राहक यात्रा आँकड़े** में [**ऑडियंस सिंक**](/hi/product/statistics-and-analytics/journey-statistics/journey-element-statistics/#audience-sync) देखें।
