मेटा विज्ञापन एकीकरण

डेवलपर सहायता की आवश्यकता है

आपको एकीकरण स्थापित करने के लिए अपनी विकास टीम से सहायता की आवश्यकता होगी। कृपया इस गाइड को उनके साथ साझा करें।

मेटा विज्ञापन एकीकरण आपको Pushwoosh ऑडियंस को अपने मेटा विज्ञापन खातों में सिंक करने की सुविधा देता है। इसका उपयोग विज्ञापन अभियानों में उपयोगकर्ताओं को लक्षित करने या बाहर करने और अपनी ग्राहक यात्रा में एक और चैनल के रूप में भुगतान किए गए विज्ञापनों को जोड़ने के लिए करें।

उपयोग के मामले

इस एकीकरण का उपयोग करें:

• खरीद या जुड़ाव बढ़ाने के लिए कई चैनलों में उच्च-मूल्य वाले उपयोगकर्ताओं को लक्षित करना
• उन उपयोगकर्ताओं को पुनः लक्षित करना जो अन्य चैनलों में कम प्रतिक्रियाशील हैं
• सप्रेशन ऑडियंस बनाना ताकि वफादार ग्राहकों को अनावश्यक विज्ञापन न मिलें

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

मेटा विज्ञापन कनेक्ट करने से पहले, सुनिश्चित करें:

• आपके Pushwoosh खाते में एडमिन भूमिका है। भूमिकाएँ और अनुमतियाँ कैसे काम करती हैं, इसके लिए उपयोगकर्ता पहुँच और अनुमतियाँ प्रबंधित करें देखें।
• आपके पास अपने ब्रांड की फेसबुक संपत्तियों, जिसमें विज्ञापन खाते, पेज और ऐप शामिल हैं, को प्रबंधित करने के लिए एक फेसबुक बिजनेस मैनेजर स्थापित है।
• आपके पास अपने बिजनेस मैनेजर से जुड़ा एक सक्रिय फेसबुक विज्ञापन खाता है।
• आपके फेसबुक बिजनेस मैनेजर एडमिन ने आपको उन विज्ञापन खातों के लिए अभियान प्रबंधित करें या विज्ञापन खाते प्रबंधित करें की अनुमतियाँ दी हैं जिन्हें आप Pushwoosh के साथ उपयोग करने की योजना बना रहे हैं।
• आपने उन खातों के लिए विज्ञापन खाते के नियम और शर्तें स्वीकार कर ली हैं।
• आपने उन फेसबुक विज्ञापन खातों के लिए फेसबुक की कस्टम ऑडियंस शर्तें स्वीकार कर ली हैं जिन्हें आप Pushwoosh के साथ उपयोग करने की योजना बना रहे हैं।

Pushwoosh में मेटा विज्ञापन सेट अप करें

1. Pushwoosh में, सेटिंग्स > तृतीय-पक्ष एकीकरण पर जाएँ।

2. मेटा विज्ञापन कार्ड में, लॉगिन पेज पर क्लिक करें।

3. अपने मेटा खाते में साइन इन करें, फिर जारी रखें पर क्लिक करें।

4. उन विज्ञापन खातों का चयन करें जिन्हें आप कनेक्ट करना चाहते हैं।

5. विज्ञापन खाते और व्यावसायिक पहुँच के लिए अनुरोधित अनुमतियों की समीक्षा करें।

6. सहेजें पर क्लिक करें। मेटा फिर एक पुष्टि दिखाता है कि आपका खाता कनेक्ट हो गया है।

कनेक्शन स्थिति की समीक्षा करें

सेटअप के बाद, आपको Pushwoosh में मेटा विज्ञापन पृष्ठ पर पुनः निर्देशित किया जाएगा।

विज्ञापन खातों की तालिका प्रत्येक कनेक्टेड खाते को सूचीबद्ध करती है:

• विज्ञापन खाता नाम
• व्यावसायिक खाता
• आईडी

एक पंक्ति के अंत में तीन बिंदुओं को खोलें और Pushwoosh में सूची से उस विज्ञापन खाते को हटाने के लिए विज्ञापन खाता हटाएं चुनें।

कनेक्टेड विज्ञापन खातों का प्रबंधन करें

मेटा विज्ञापन पृष्ठ पर, संवाद खोलने के लिए खातों का प्रबंधन करें पर क्लिक करें। एकीकरण से उस विज्ञापन खाते को शामिल करने या बाहर करने के लिए प्रत्येक पंक्ति पर टॉगल का उपयोग करें। परिवर्तनों को सहेजने के लिए लागू करें पर क्लिक करें या बिना सहेजे बंद करने के लिए रद्द करें पर क्लिक करें।

सूची दृश्य को समायोजित करने के लिए:

• कौन सी पंक्तियाँ दिखाई देती हैं, इसे सीमित करने के लिए केवल कनेक्टेड दिखाएं को चालू या बंद करें।
• सूची में खातों को खोजने के लिए नाम या आईडी से खोजें… में टाइप करें।

प्रोजेक्ट टैग को मेटा फ़ील्ड्स पर मैप करें

उपयोगकर्ता गुणों को मैप करने से आप Pushwoosh को बता सकते हैं कि कौन से मेटा उपयोगकर्ता विशेषताएँ आपके प्रोजेक्ट में कौन से टैग नाम फ़ील्ड्स को अपडेट करनी चाहिए। इस तरह, जब मेटा से डेटा आता है, तो यह वहाँ सहेजा जाता है जहाँ आप उम्मीद करते हैं।

नोट

ऑडियंस सिंक के लिए, Pushwoosh हमेशा ईमेल, फ़ोन नंबर, या MADID से प्रति उपयोगकर्ता एक पहचानकर्ता भेजता है, जो प्रोफ़ाइल पर मौजूद है, उसके आधार पर। मैपिंग को तब कॉन्फ़िगर करें जब आप चाहते हैं कि मेटा उपरोक्त पहचानकर्ताओं के अलावा अतिरिक्त उपयोगकर्ता विशेषताएँ प्राप्त करे।

1. मेटा विज्ञापन पृष्ठ पर, उपयोगकर्ता डेटा मैप करें पर क्लिक करें।

2. बाएँ कॉलम में प्रत्येक फेसबुक फ़ील्ड के लिए, दाएँ नियंत्रण से अपने प्रोजेक्ट में एक टैग नाम चुनें। केवल उन पंक्तियों को मैप करें जिनकी आपको आवश्यकता है।

स्वचालित रूप से मैप किए गए फ़ील्ड

Pushwoosh इन फ़ील्ड्स को स्वचालित रूप से मैप करता है। आप उन्हें प्रोजेक्ट टैग को मेटा फ़ील्ड्स पर मैप करें में सेट नहीं करते हैं:

• ईमेल
• फ़ोन नंबर
• MADID

3. मैपिंग लागू करने के लिए सहेजें पर क्लिक करें या बिना सहेजे बंद करने के लिए रद्द करें पर क्लिक करें।

SDK में MADID संग्रह सक्षम करें

मेटा विज्ञापन मोबाइल SDK के माध्यम से एकत्र किए गए डिवाइस पहचानकर्ताओं (MADID) का उपयोग करके उपयोगकर्ताओं का मिलान करता है। Pushwoosh SDK स्वचालित रूप से विज्ञापन पहचानकर्ताओं (एंड्रॉइड पर GAID, iOS पर IDFA) को एकत्र नहीं करता है। दोनों प्लेटफॉर्म पहचानकर्ता को पढ़ने से पहले स्पष्ट उपयोगकर्ता सहमति की आवश्यकता होती है। अपने एप्लिकेशन में, उपयोगकर्ता की सहमति का अनुरोध करें, अनुमति मिलने पर पहचानकर्ता पढ़ें, और मान को SDK को पास करें।

Android

1. निर्भरता जोड़ें

implementation 'com.google.android.gms:play-services-ads-identifier:...'

2. AD_ID अनुमति घोषित करें (targetSdk ≥ 33 के लिए आवश्यक)

इसे अपने AndroidManifest.xml में जोड़ें:

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

सावधानी

एंड्रॉइड 13+ पर इस अनुमति के बिना, AdvertisingIdClient.getAdvertisingIdInfo() चुपचाप एक शून्य UUID (00000000-0000-0000-0000-000000000000) लौटाता है। Pushwoosh SDK इसे null में सामान्य कर देता है, इसलिए सर्वर पर कोई MADID नहीं भेजा जाता है और मेटा ऑडियंस मिलान काम नहीं करेगा।

3. GAID प्राप्त करें और इसे SDK को पास करें

getAdvertisingIdInfo को एक पृष्ठभूमि थ्रेड पर कॉल किया जाना चाहिए:

String gaid = AdvertisingIdClient.getAdvertisingIdInfo(context).getId();

Pushwoosh.getInstance().setAdvertisingId(gaid);

बैकएंड पर संग्रहीत मान को साफ़ करने के लिए, null या एक खाली स्ट्रिंग पास करें:

Pushwoosh.getInstance().setAdvertisingId(null);

व्यवहार नोट्स:

• यदि अंतिम सफल कॉल के बाद से मान नहीं बदला है, तो कोई नेटवर्क अनुरोध नहीं किया जाता है।
• यदि नेटवर्क अनुरोध विफल हो जाता है, तो अगले ऐप लॉन्च पर पुनः प्रयास करें।
• जब Pushwoosh.stopCommunication() सक्रिय होता है तो कॉल को अनदेखा कर दिया जाता है।
• शून्य UUID (00000000-0000-0000-0000-000000000000) को null के समान माना जाता है — संग्रहीत MADID को बैकएंड पर साफ़ कर दिया जाता है।

iOS

1. Info.plist में उपयोग विवरण जोड़ें

ATT अनुमति संवाद दिखाने से पहले Apple को इस कुंजी की आवश्यकता होती है:

<key>NSUserTrackingUsageDescription</key>
<string>We use your advertising identifier to show you relevant ads.</string>

2. अपनी गोपनीयता मैनिफेस्ट में ट्रैकिंग डोमेन घोषित करें

यदि आपका ऐप ट्रैकिंग के लिए IDFA का उपयोग करता है, तो Apple को आपके गोपनीयता मैनिफेस्ट (PrivacyInfo.xcprivacy) में ट्रैकिंग डेटा प्राप्त करने वाले डोमेन को सूचीबद्ध करने की आवश्यकता होती है। पूरी आवश्यकताओं के लिए TN3182 देखें।

NSPrivacyTracking को true पर सेट करें और Pushwoosh ट्रैकिंग डोमेन को NSPrivacyTrackingDomains में जोड़ें:

<key>NSPrivacyTracking</key>
<true/>
<key>NSPrivacyTrackingDomains</key>
<array>
    <string>tracking.svc-nue.pushwoosh.com</string>
</array>

नोट

यदि उपयोगकर्ता ने ATT अनुमति नहीं दी है, तो iOS NSPrivacyTrackingDomains में सूचीबद्ध सभी डोमेन के लिए नेटवर्क अनुरोधों को ब्लॉक कर देता है। MADID नहीं भेजा जाएगा, भले ही आपका कोड कुछ भी करे।

3. ट्रैकिंग प्राधिकरण का अनुरोध करें और IDFA को SDK को पास करें

ATTrackingManager को iOS 14 या बाद के संस्करण की आवश्यकता होती है। यदि आपका परिनियोजन लक्ष्य iOS 14 से नीचे है, तो कॉल को उपलब्धता जांच में लपेटें।

Pushwoosh SDK ATTrackingManager को कॉल नहीं करता है। अपने एप्लिकेशन में ट्रैकिंग प्राधिकरण का अनुरोध करें, फिर परिणाम को SDK को पास करें:

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 या एक खाली स्ट्रिंग पास करें:

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 खोलें।

2. एक ऑडियंस-आधारित प्रविष्टि जोड़ें। ऑडियंस स्रोत में, एक Pushwoosh सेगमेंट या सूची चुनें जो परिभाषित करती है कि इस यात्रा में कौन प्रवेश करेगा। उदाहरण के लिए, एक सेगमेंट webinar_registered टैग वाले उपयोगकर्ता true पर सेट हैं। केवल वे उपयोगकर्ता यात्रा के माध्यम से आगे बढ़ेंगे और ऑडियंस सिंक तक पहुँचेंगे।

3. ऑडियंस सिंक बिंदु जोड़ें।

4. उपयोगकर्ताओं की जानकारी को मेटा ऑडियंस में कैसे सिंक करें के तहत, एक विकल्प चुनें:

   • उपयोगकर्ताओं को ऑडियंस में जोड़ें। इस चरण पर पहुँचने वाले प्रत्येक उपयोगकर्ता को आपके द्वारा चुने गए मेटा ऑडियंस में जोड़ता है। उदाहरण के लिए, इसका उपयोग उन उपयोगकर्ताओं को विज्ञापन दिखाना शुरू करने के लिए करें जिन्होंने साइन अप किया है लेकिन अभी तक भाग नहीं लिया है।
   • उपयोगकर्ताओं को ऑडियंस से हटाएं। इस चरण पर पहुँचने वाले प्रत्येक उपयोगकर्ता को उस मेटा ऑडियंस से हटा देता है। इस उदाहरण में, उन उपयोगकर्ताओं को वेबिनार विज्ञापन दिखाना बंद करने के लिए इस विकल्प का चयन करें जो पहले ही पंजीकरण कर चुके हैं।

5. मेटा विज्ञापन खाते में, कनेक्टेड विज्ञापन खाते का चयन करें।

6. ऑडियंस में, मेटा ऑडियंस का चयन करें, उदाहरण के लिए वेबिनार।

7. बिंदु को सहेजने के लिए लागू करें पर क्लिक करें या बिना सहेजे बंद करने के लिए रद्द करें पर क्लिक करें।

8. यात्रा को कॉन्फ़िगर करना समाप्त करें, फिर इसे लॉन्च करें।

जब वे उपयोगकर्ता ऑडियंस सिंक पर पहुँचते हैं, तो उन्हें मेटा में वेबिनार ऑडियंस से हटा दिया जाता है, इसलिए वे अब वहाँ वेबिनार विज्ञापन नहीं देखते हैं।

व्यवहार और त्रुटि प्रबंधन

यात्रा प्रसंस्करण मेटा खाते और ऑडियंस की उपलब्धता पर निर्भर करता है:

• मेटा ऑडियंस को तभी अपडेट करता है जब वह Pushwoosh द्वारा प्रदान किए गए डेटा से उपयोगकर्ता का मिलान कर सकता है। यदि मेटा उपयोगकर्ता का मिलान नहीं कर सकता है, तो उस उपयोगकर्ता के लिए ऑडियंस नहीं बदलती है, और वे यात्रा में जारी रहते हैं।
• यदि कोई प्रोफ़ाइल ऑडियंस सिंक बिंदु पर पहुँचती है, जबकि कनेक्टेड विज्ञापन खाता डिस्कनेक्ट हो गया है, तो उस प्रोफ़ाइल के लिए यात्रा रुक जाती है और Pushwoosh सिस्टम और ईमेल सूचनाएं भेजता है।
• यदि कोई चयनित ऑडियंस मेटा में नहीं मिलती है और API एक त्रुटि देता है, तो उस प्रोफ़ाइल के लिए यात्रा रुक जाती है और Pushwoosh सिस्टम और ईमेल सूचनाएं भेजता है।

ऑडियंस सिंक आँकड़े

लॉन्च के बाद, ऑडियंस सिंक चरण के लिए आँकड़े खोलें ताकि प्रवेश मात्रा, जोड़ और निष्कासन, और छोड़ी गई प्रोफ़ाइल देख सकें। मीट्रिक विवरण के लिए, ग्राहक यात्रा आँकड़े में ऑडियंस सिंक देखें।