Meta Ads इंटीग्रेशन

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

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

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

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

इस इंटीग्रेशन का उपयोग करें:

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

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

Meta Ads कनेक्ट करने से पहले, सुनिश्चित करें:

• आपके Pushwoosh खाते में एडमिन की भूमिका है। भूमिकाएँ और अनुमतियाँ कैसे काम करती हैं, इसके लिए उपयोगकर्ता पहुँच और अनुमतियाँ प्रबंधित करें देखें।
• आपके पास अपने ब्रांड के Facebook एसेट्स, जिसमें विज्ञापन खाते, पेज और ऐप्स शामिल हैं, को प्रबंधित करने के लिए एक Facebook Business Manager सेट अप है।
• आपके पास अपने Business Manager से जुड़ा एक सक्रिय Facebook Ad Account है।
• आपके Facebook Business Manager एडमिन ने आपको उन विज्ञापन खातों के लिए अभियान प्रबंधित करें या विज्ञापन खाते प्रबंधित करें की अनुमतियाँ दी हैं जिन्हें आप Pushwoosh के साथ उपयोग करने की योजना बना रहे हैं।
• आपने उन खातों के लिए विज्ञापन खाते के नियम और शर्तें स्वीकार कर ली हैं।
• आपने उन Facebook विज्ञापन खातों के लिए Facebook’s Custom Audiences Terms स्वीकार कर लिए हैं जिन्हें आप Pushwoosh के साथ उपयोग करने की योजना बना रहे हैं।

Pushwoosh में Meta Ads सेट अप करें

1. Pushwoosh में, सेटिंग्स > 3-पार्टी इंटीग्रेशन पर जाएँ।

2. Meta Ads कार्ड में, लॉगिन पेज पर क्लिक करें।

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

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

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

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

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

सेटअप के बाद, आपको Pushwoosh में Meta Ads पेज पर रीडायरेक्ट कर दिया जाएगा।

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

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

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

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

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

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

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

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

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

नोट

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

1. Meta Ads पेज पर, उपयोगकर्ता डेटा मैप करें पर क्लिक करें।

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

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

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

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

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

SDK में MADID कलेक्शन सक्षम करें

Meta Ads मोबाइल SDK के माध्यम से एकत्र किए गए डिवाइस पहचानकर्ताओं (MADID) का उपयोग करके उपयोगकर्ताओं का मिलान करता है। Pushwoosh SDK स्वचालित रूप से विज्ञापन पहचानकर्ताओं (Android पर 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"/>

सावधानी

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

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 इस पहचानकर्ता का उपयोग आपके डिवाइस रिकॉर्ड को सिंक्रनाइज़ेशन के लिए Meta Ads ऑडियंस के साथ मिलाने के लिए करता है।

Journeys में ऑडियंस सिंक करें

Journey Builder में ऑडियंस सिंक बिंदु आपकी यात्रा को एक Meta कस्टम ऑडियंस से जोड़ता है। हर बार जब कोई उपयोगकर्ता उस बिंदु पर पहुँचता है, तो Pushwoosh Meta से या तो उन्हें ऑडियंस में जोड़ने या उन्हें उससे हटाने के लिए कहता है।

उदाहरण के लिए, आप इसका उपयोग उन उपयोगकर्ताओं को वेबिनार विज्ञापन दिखाना बंद करने के लिए कर सकते हैं जो पहले ही पंजीकृत हो चुके हैं, ताकि आप उन लोगों पर विज्ञापन खर्च बर्बाद न करें जिन्हें अब इसे देखने की आवश्यकता नहीं है।

ऑडियंस सिंक को कॉन्फ़िगर करने के लिए:

1. Journey Builder खोलें।

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

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

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

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

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

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

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

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

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

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

Journey प्रोसेसिंग Meta खाते और ऑडियंस की उपलब्धता पर निर्भर करती है:

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

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

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