Attribution Reporting API क्रॉस वेब और ऐप्लिकेशन लागू करने की गाइड

Attribution Reporting API की मदद से, सोर्स के लिए क्रॉस ऐप्लिकेशन और वेब एट्रिब्यूशन की सुविधा चालू होती है और एक ही डिवाइस पर होने वाले ट्रिगर होते हैं. ब्राउज़र, जैसे कि Chrome, एट्रिब्यूशन रिपोर्टिंग को सोर्स और रजिस्ट्रेशन, दोनों को सौंप सकता है एपीआई का इस्तेमाल करना चाहिए, न कि ब्राउज़र में उन रजिस्ट्रेशन को मैनेज करने का. इससे Android, साइटों और ऐप्लिकेशन, दोनों में सोर्स और ट्रिगर का मिलान कर पाता है.

इस गाइड में आपको क्रॉस ऐप्लिकेशन और वेब एट्रिब्यूशन सेट अप करने का तरीका पता चलेगा.

क्रॉस ऐप्लिकेशन और वेब एट्रिब्यूशन सेट अप करते समय, हमारा सुझाव है कि आप डीबग करने के तरीकों के बारे में जानें, ताकि यह पक्का किया जा सके कि सेटअप सही तरीके से काम कर रहा है.

Android OS के साथ सोर्स और ट्रिगर रजिस्टर करें

क्रॉस ऐप्लिकेशन और वेब एट्रिब्यूशन सिर्फ़ तब उपलब्ध होगा, जब एट्रिब्यूशन Reporting API को ब्राउज़र और Android OS, दोनों में चालू किया गया है डिवाइस. Android Attribution Reporting API की उपलब्धता की जानकारी भेज दी गई है एट्रिब्यूशन-रिपोर्टिंग-सहायता हेडर के ज़रिए. इस हेडर से os, वेब या दोनों में से कुछ भी तय कर सकें. अगर दोनों उपलब्ध होने पर, विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनियों के पास वेब सोर्स और वेब ट्रिगर करती है.

विज्ञापन टेक्नोलॉजी को यह तय करना होता है कि वेब सोर्स को रजिस्टर करना है या वेब ट्रिगर को ब्राउज़र या ओएस से कनेक्ट होता है.

  • सिर्फ़ वेब पर चलने वाले कैंपेन के लिए, विज्ञापन टेक्नोलॉजी, अब भी सोर्स और ट्रिगर, दोनों को रजिस्टर कर सकती हैं के साथ काम करना चाहिए या दोनों को ओएस को सौंपने का विकल्प चुना जा सकता है. केवल वेब वाले उन अभियानों के लिए जहां स्रोत या ट्रिगर किसी वेबव्यू, विज्ञापन टेक्नोलॉजी को सोर्स, दोनों को सौंपना होगा और रजिस्ट्रेशन को ट्रिगर करना होगा किया है. ज़्यादा जानकारी के लिए, वेबव्यू से जुड़ा सेक्शन देखें.
  • विज्ञापन टेक्नोलॉजी को, Chrome दोनों के साथ सोर्स और ट्रिगर को रजिस्टर करने से बचना चाहिए और Android API को एक साथ इस्तेमाल करें, ताकि डुप्लीकेट एट्रिब्यूशन न बने रिपोर्ट.
  • ब्राउज़र और ओएस के लिए एट्रिब्यूशन अलग-अलग होता है. अगर कोई सोर्स ब्राउज़र के साथ पंजीकृत है, लेकिन ट्रिगर OS के साथ पंजीकृत है, तो मेल नहीं खाया जा सकता है या नहीं.
  • ऐप्लिकेशन या वेब ट्रिगर करने वाले सोर्स के लिए, यह बहुत ज़्यादा होता है इसका सुझाव दिया जाता है कि विज्ञापन टेक्नोलॉजी, वेब सोर्स को ऐक्सेस करने और रजिस्ट्रेशन को ट्रिगर करने के लिए Android Attribution Reporting API.
  • ऐप्लिकेशन पर आधारित सोर्स से ट्रिगर होने वाले ट्रिगर के लिए, विज्ञापन टेक्नोलॉजी वेब ट्रिगर रजिस्ट्रेशन को Android एट्रिब्यूशन रिपोर्टिंग के लिए सौंपने का विकल्प चुना जा सकता है एपीआई.
  • ऐसे कैंपेन के लिए जहां सोर्स और ट्रिगर, दोनों किसी ऐप्लिकेशन में होते हैं, वहां दोनों यह ओएस ऐट्रिब्यूशन रिपोर्टिंग एपीआई के साथ रजिस्टर होना चाहिए.

ऐप्लिकेशन सोर्स और वेब ट्रिगर रजिस्टर करें

कुछ कैंपेन के लिए, ट्रिगर होने के दौरान ऐप्लिकेशन में सोर्स हो सकता है उसी डिवाइस में किसी मोबाइल ब्राउज़र में.

उदाहरण

एक व्यक्ति, अपने पसंदीदा समाचार ऐप्लिकेशन में लेख पढ़ रहा है. वे सस्ते में विज्ञापन देखते हैं दिल्ली के लिए फ़्लाइट और बुक करने के लिए जोशीले अंदाज़ में क्लिक करें. इसमें विज्ञापन दिखाने वाली विज्ञापन टेक्नोलॉजी समाचार ऐप्लिकेशन, क्लिक सोर्स को Android Attribution Reporting API के साथ रजिस्टर करता है. उपयोगकर्ता को Chrome में विज्ञापन देने वाले के वेब पेज पर ले जाया जाता है, जहां वे ये काम कर सकते हैं बदलें. विज्ञापन देने वाले व्यक्ति या कंपनी की साइट पर मौजूद विज्ञापन टेक्नोलॉजी, यह जांच करती है कि ओएस लेवल एपीआई उपलब्ध है और है. AdTech, कन्वर्ज़न ट्रिगर को इस तरह रजिस्टर करती है: Chrome को रजिस्टर करने के बजाय, ओएस को रजिस्ट्रेशन का ऐक्सेस देने के लिए निर्देश देना इसे सीधे Chrome के Attribution Reporting API से जोड़ सकते हैं. ओएस-लेवल एट्रिब्यूशन इसके बाद, Reporting API, ऐप्लिकेशन के सोर्स और वेब ट्रिगर को मैच कर पाएगा और Google को भेज पाएगा से जुड़ी रिपोर्ट शामिल हैं.

ऐप्लिकेशन टू वेब एट्रिब्यूशन फ़्लो
ऐप्लिकेशन टू वेब एट्रिब्यूशन फ़्लो

ऐप्लिकेशन सोर्स रजिस्ट्रेशन:

  1. डेली न्यूज़ के Android ऐप्लिकेशन में मौजूद विज्ञापन टेक्नोलॉजी का SDK टूल, क्लिक को रजिस्टर करने के लिए registerSource() अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

  2. Android पर Attribution Reporting API, विज्ञापन टेक्नोलॉजी के सर्वर को एक अनुरोध भेजता है registerSource() को दिया गया यूआरएल

  3. विज्ञापन टेक्नोलॉजी से जुड़ा सर्वर, एट्रिब्यूशन-रिपोर्टिंग-रजिस्टर-सोर्स के साथ जवाब देता है सोर्स रजिस्ट्रेशन पूरा करने के लिए हेडर

वेब ट्रिगर रजिस्ट्रेशन:

  1. विज्ञापन टेक्नोलॉजी, एक ट्रिगर रजिस्टर करती है. साथ ही, Attribution Reporting API

  2. वेब ARA से यह जानकारी मिलती है कि Gemini का इस्तेमाल किस प्लैटफ़ॉर्म पर किया जा सकता है

  3. OS-Trigger हेडर, वेब ARA API को OS ARA API को कॉल करने के लिए कहता है registerWebTrigger() फ़ंक्शन

  4. registerWebTrigger() को कॉल, हुड और डेवलपर के तहत होता है registerWebTrigger() को सीधे ओएस से कॉल करने की ज़रूरत नहीं है

  5. ओएस ARA, AdTech सर्वर के दिए गए यूआरएल को एक अनुरोध भेजता है Attribution-Reporting-Register-OS-Trigger हेडर

  6. विज्ञापन टेक्नोलॉजी, ओएस एपीआई की मदद से, ट्रिगर रजिस्ट्रेशन को पूरा करेगी

  7. OS ARA, app<>ऐप्लिकेशन एट्रिब्यूशन को सेट करने और वही रिपोर्ट भेजने की अनुमति देता है

वर्कफ़्लो

यहां दिए गए चरणों में, टास्क पूरा करने के बारे में ज़्यादा जानकारी दी गई है:

  1. ऐप्लिकेशन की विज्ञापन टेक्नोलॉजी, Android के एट्रिब्यूशन के साथ सोर्स को रजिस्टर करती है Reporting API में ये बदलाव किए गए हैं:

    • जिस ऐप्लिकेशन सोर्स को वेबसाइट पर कन्वर्ट करने की उम्मीद है उसे रजिस्टर करने के लिए, Attribution-Reporting-Register-Source रिस्पॉन्स हेडर में वेब शामिल होना चाहिए गंतव्य (eTLD+1).
    Attribution-Reporting-Register-Source: {
        "web_destination": "https://advertiser.example",
        ...
    }
    
    सेक्शन देखें
    • विज्ञापन देने वाले कुछ लोग या कंपनियां, मेज़रमेंट की सुविधा देने वाली कई कंपनियों का इस्तेमाल कर सकती हैं. उदाहरण के लिए, तीसरे पक्ष का मेज़रमेंट टूल या ऐनलिटिक्स टूल) जो 302 रीडायरेक्ट चेन का इस्तेमाल करता है. कुछ मामलों में, Attribution Reporting API, रीडायरेक्ट पाथ को फ़ॉलो करेगा एट्रिब्यूशन-रिपोर्टिंग-रीडायरेक्ट हेडर में बैकग्राउंड में और उसी समय मौजूदा 302 रीडायरेक्ट पाथ, फ़ोरग्राउंड में एक्ज़ीक्यूट होता है नेविगेशन के अनुरोध शामिल हैं. ये अनुरोध एक ही यूआरएल पर किए जाएंगे. इनका नतीजा यह हो सकता है के मामले में, रजिस्ट्रेशन की दो बार गिनती की जा सकती है. यहां की यात्रा पर हूं रजिस्ट्रेशन की दो बार गिनती होने से रोकता है, विज्ञापन टेक्नोलॉजी, रीडायरेक्शन के तरीके में बदलाव कर सकती हैं एट्रिब्यूशन रिपोर्टिंग एपीआई रजिस्ट्रेशन को किसी अन्य विकल्प पर भेजने के लिए सारणिक URL.
    • इस व्यवहार को चालू करने के लिए, विज्ञापन टेक्नोलॉजी को खास तौर पर तब नया एचटीटीपी हेडर शामिल करना होगा, जब अगर रजिस्ट्रेशन के अनुरोध का जवाब दिया जा रहा है, तो:

      • हेडर Attribution-Reporting-Redirect-Config है
      • हेडर की वैल्यू रीडायरेक्शन-302-टू-वेल-मेन होनी चाहिए
      Attribution-Reporting-Redirect-Config: redirect-302-to-well-known
      
    • सोर्स रजिस्ट्रेशन की बाकी प्रोसेस, स्टैंडर्ड तौर पर ली जाती है ऐप्लिकेशन-से-ऐप्लिकेशन का सोर्स रजिस्ट्रेशन.

  2. विज्ञापन देने वाली कंपनी की वेबसाइट पर मौजूद विज्ञापन टेक्नोलॉजी, गड़बड़ी की वजह से ट्रिगर को रजिस्टर करने के लिए कहती है Chrome, Android Attribution Reporting API को रजिस्ट्रेशन का ऐक्सेस देने के लिए:

    • जब कोई उपयोगकर्ता किसी वेबसाइट पर कन्वर्ज़न पूरा करता है, तो विज्ञापन टेक्नोलॉजी Chrome के साथ ट्रिगर को रजिस्टर करने का अनुरोध करें

      1. Pixel या fetch() के अनुरोध का इस्तेमाल करके, ट्रिगर

      2. Chrome, Attribution-Reporting-Support अनुरोध का हेडर दिखाता है के बारे में बात करते हैं. अगर Chrome ब्राउज़र और Android डिवाइस, हेडर के साथ os, web दिखेगा

      Attribution-Reporting-Support: os, web
      
    • इसके बाद, विज्ञापन टेक्नोलॉजी को Chrome को इस निर्देश का इस्तेमाल करके, ओएस का ऐक्सेस देने के लिए कहना चाहिए Attribution-Reporting-Register-OS-Trigger हेडर जो:

      1. यह नीति, Chrome को रजिस्ट्रेशन का ऐक्सेस ओएस को देने के लिए कहती है

      2. Chrome, OS API फ़ंक्शन को कॉल करके ओएस को रजिस्ट्रेशन असाइन करता है registerWebTrigger() अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

        • registerWebTrigger() पर कॉल, विज्ञापन टेक्नोलॉजी के तहत की जाती है registerWebTrigger() को सीधे कॉल करने की ज़रूरत नहीं है
      3. OS API, उस विज्ञापन टेक्नोलॉजी के यूआरआई को दूसरा एपीआई कॉल शुरू करता है जो पास की गई है ब्राउज़र से

      Attribution-Reporting-Register-OS-Trigger: "https://adtech.example/register-trigger",
      "https://other-adtech.example/register-trigger"
      
    • कुछ मामलों में Attribution-Reporting-Support हेडर उपलब्ध नहीं होता है और भेजा नहीं जा सकता. ऐसा होने पर, विज्ञापन टेक्नोलॉजी, यह शामिल करके, ट्रिगर रजिस्ट्रेशन को मैनेज करने का प्लैटफ़ॉर्म Attribution-Reporting-Info हेडर. सबसे अहम है,: पसंदीदा प्लैटफ़ॉर्म और os और web इस्तेमाल किए जा सकते हैं. ब्राउज़र आपके पसंदीदा प्लैटफ़ॉर्म का इस्तेमाल करेगा उपलब्ध होने पर डाउनलोड करें और ओएस के उपलब्ध होने पर, वेब प्लैटफ़ॉर्म पर वापस आ जाएगा उपलब्ध नहीं हैं.

    Attribution-Reporting-Info: preferred-platform=os
    
    • ट्रिगर रजिस्ट्रेशन पूरा करने के लिए, विज्ञापन टेक्नोलॉजी के एंडपॉइंट को जवाब देना चाहिए रिस्पॉन्स हेडर का इस्तेमाल करके, Android Attribution Reporting API अनुरोध जोड़ना होगा.
    Attribution-Reporting-Register-Trigger: {
        "event_trigger_data": [{"trigger_data":"1"}],
        "aggregatable_trigger_data": [
            {"key_piece":"0x400","source_keys":["campaignCounts"]},
            {"key_piece":"0xA80","source_keys":["geoValue"]}
        ],
        ...
    }
    

वेब सोर्स और ऐप्लिकेशन ट्रिगर को रजिस्टर करना

कुछ कैंपेन के लिए, मोबाइल ब्राउज़र वाली साइट पर सोर्स मौजूद हो सकता है, जबकि उसी डिवाइस पर किसी ऐप्लिकेशन में ट्रिगर होता है.

उदाहरण

एक व्यक्ति अपने Android फ़ोन पर, Chrome ब्राउज़र में किसी साइट को ब्राउज़ कर रहा है. उन्हें अपने किसी पसंदीदा स्टोर के स्वेटर का विज्ञापन दिखता है. वे और उन्हें उस ऐप्लिकेशन पर ले जाया जाता है जिसे उन्होंने पहले से डाउनलोड किया है. तकनीकी सहायता जिस वेबसाइट पर विज्ञापन दिखाया गया था वह Chrome को निर्देश देकर क्लिक सोर्स को रजिस्टर करती है के बजाय Android Attribution Reporting API को रजिस्ट्रेशन का ऐक्सेस देने के लिए एट्रिब्यूशन रिपोर्टिंग एपीआई का इस्तेमाल करके. जब उपयोगकर्ता स्वेटर खरीदता है शॉपिंग ऐप्लिकेशन. इसके बाद, विज्ञापन देने वाले के ऐप्लिकेशन में मौजूद विज्ञापन टेक्नोलॉजी, Android Attribution Reporting API की मदद से कन्वर्ज़न ट्रिगर जोड़ना होता है. ओएस-लेवल Attribution Reporting API, वेब सोर्स और ऐप्लिकेशन के ट्रिगर से मैच कर सकता है और संबंधित रिपोर्ट भेजें.

वेब से ऐप्लिकेशन का एट्रिब्यूशन फ़्लो
वेब से ऐप्लिकेशन का एट्रिब्यूशन फ़्लो

वेब सोर्स रजिस्ट्रेशन:

  1. AdTech, सोर्स को रजिस्टर करती है और Attribution Reporting API

  2. वेब ARA से यह जानकारी मिलती है कि Gemini का इस्तेमाल किस प्लैटफ़ॉर्म पर किया जा सकता है

  3. OS-Source हेडर, वेब ARA API को OS ARA API को कॉल करने के लिए कहता है registerWebSource() फ़ंक्शन

  4. registerWebSource() को कॉल, हुड के तहत होता है और डेवलपर यह करता है registerWebSource() को सीधे ओएस से कॉल करने की ज़रूरत नहीं है

  5. ओएस ARA, विज्ञापन टेक्नोलॉजी से जुड़े सर्वर के दिए गए यूआरएल को अनुरोध भेजता है Attribution-Reporting-Register-OS-Source हेडर के मुताबिक

  6. विज्ञापन टेक्नोलॉजी, ओएस एपीआई की मदद से सोर्स रजिस्ट्रेशन को पूरा करेगी

ऐप्लिकेशन ट्रिगर रजिस्ट्रेशन:

  1. कपड़ों के स्टोर के Android ऐप्लिकेशन में, विज्ञापन टेक्नोलॉजी से जुड़ा SDK टूल, ट्रिगर को इसके साथ रजिस्टर करता है: ओएस ARA

  2. Android पर Attribution Reporting API, विज्ञापन टेक्नोलॉजी के सर्वर को एक अनुरोध भेजता है registerTrigger() को दिया गया यूआरएल

  3. AdTech सर्वर, Attribution-Reporting-Register-Trigger की मदद से जवाब देता है ट्रिगर रजिस्ट्रेशन पूरा करने के लिए हेडर

  4. OS ARA, app<>ऐप्लिकेशन एट्रिब्यूशन को सेट करने और वही रिपोर्ट भेजने की अनुमति देता है

वर्कफ़्लो

यहां दिए गए चरणों में, टास्क पूरा करने के बारे में ज़्यादा जानकारी दी गई है:

  1. पब्लिशर की वेबसाइट पर मौजूद विज्ञापन टेक्नोलॉजी, निर्देश देकर सोर्स को रजिस्टर करती है Chrome, Android Attribution Reporting API को रजिस्ट्रेशन का ऐक्सेस देने के लिए:

    • वेब से ऐप्लिकेशन में इस्तेमाल के उदाहरण के लिए, सोर्स रजिस्टर करते समय, एट्रिब्यूशन स्रोत पैरामीटर को सीधे तौर पर या तो attributionsrc टैग या JavaScript रजिस्ट्रेशन का इस्तेमाल करके
    • नीचे दिए गए उदाहरण में, यह बताने के लिए attributionsrc टैग का इस्तेमाल किया गया है कि सोर्स पैरामीटर:
    <img src="https://adtech.example/conversionpixel"
    attributionsrc="https://adtech.example/register-source?purchase=12">
    
  2. Chrome, Attribution-Reporting-Support अनुरोध के हेडर को विज्ञापन तकनीक. अगर Chrome ब्राउज़र और Android डिवाइस, दोनों पर एपीआई चालू है, तो हेडर के तौर पर os, web दिखेगा.

    Attribution-Reporting-Support: os, web
    
  3. विज्ञापन टेक्नोलॉजी को यह बताना चाहिए कि Chrome को Attribution-Reporting-Register-OS-Source हेडर जो:

    1. यह नीति, Chrome को रजिस्ट्रेशन का ऐक्सेस ओएस को देने के लिए कहती है
    2. Chrome, OS API फ़ंक्शन को कॉल करके ओएस को रजिस्ट्रेशन असाइन करता है registerWebSource() अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
    3. registerWebSource() पर कॉल हुड के तहत होता है, जबकि विज्ञापन टेक्नोलॉजी registerWebSource() को सीधे कॉल करने की ज़रूरत नहीं है
    4. OS API, विज्ञापन टेक्नोलॉजी से जुड़ी सेवा के उस यूआरआई को दूसरा एपीआई कॉल शुरू करता है जिसे इससे भेजा जाता है ब्राउज़र
    Attribution-Reporting-Register-OS-Source: "https://adtech.example/register-source"
    
    • कुछ मामलों में, Attribution-Reporting-Support हेडर उपलब्ध नहीं होता है. ऐसा होने पर भी, विज्ञापन टेक्नोलॉजी, हैंडल करने के लिए पसंदीदा प्लैटफ़ॉर्म सेट कर सकती है Attribution-Reporting-Info हेडर शामिल करके सोर्स रजिस्ट्रेशन के लिए. कुंजी पसंदीदा प्लैटफ़ॉर्म है और os और web को वैल्यू के तौर पर इस्तेमाल किया जा सकता है. कॉन्टेंट बनाने ब्राउज़र, पसंदीदा प्लैटफ़ॉर्म उपलब्ध होने पर उसका इस्तेमाल करेगा. साथ ही, उस प्लैटफ़ॉर्म पर वापस आ जाएगा ओएस उपलब्ध न होने पर, वेब प्लैटफ़ॉर्म पर दिखेगी.
    Attribution-Reporting-Info: preferred-platform=os
    
    • सोर्स रजिस्ट्रेशन पूरा करने के लिए, विज्ञापन टेक्नोलॉजी के एंडपॉइंट को जवाब देना चाहिए रिस्पॉन्स हेडर के साथ Android Attribution Reporting API अनुरोध को कॉपी करना Attribution-Reporting-Register-Source. जवाब में यह भी बताया जाना चाहिए के गंतव्य फ़ील्ड में.
    Attribution-Reporting-Register-Source: {
        "source_event_id":"123001",
        "destination":"android-app://com.example.advertiser",
        ...
    }
    
  4. विज्ञापन देने वाले व्यक्ति या कंपनी के ऐप्लिकेशन में मौजूद विज्ञापन टेक्नोलॉजी, Android के साथ एक ट्रिगर रजिस्टर करती है Attribution Reporting API:

    • ऐप्लिकेशन में होने वाले ट्रिगर के लिए, ऐप्लिकेशन सामान्य रूप से Android Attribution Reporting API.

ऐसे कैंपेन जिनमें ऐप्लिकेशन और वेब, दोनों तरह के डेस्टिनेशन मौजूद हैं

  1. ड्यूअल डेस्टिनेशन सेट अप करना

    • कुछ कैंपेन, विज्ञापन देने वाले के ऐप्लिकेशन में बदलने के लिए सेट अप किए जा सकते हैं या विज्ञापन देने वाले के वेब पेज पर कई बातों पर निर्भर करता है. जैसे, अगर उपयोगकर्ता ऐप्लिकेशन को इंस्टॉल किया हो.
    • इन मामलों में, यह सुझाव दिया जाता है कि सोर्स रजिस्ट्रेशन को ओएस, जहां उपलब्ध हो, ताकि सोर्स को सही तरीके से एट्रिब्यूट किया जा सके ट्रिगर होता है. सोर्स को ओएस के साथ रजिस्टर करते समय, दोनों ऐप्लिकेशन और वेब डेस्टिनेशन को उनसे जुड़े पैरामीटर में तय किया जा सकता है.
    • ऐप्लिकेशन का डेस्टिनेशन, destination फ़ील्ड में होना चाहिए
    • वेब डेस्टिनेशन, web_destination फ़ील्ड में होना चाहिए
    • Chrome डेवलपर को ध्यान रखना चाहिए कि ओएस के लिए destination फ़ील्ड Attribution Reporting API, यूआरएल नहीं, बल्कि ऐप्लिकेशन पैकेज होना चाहिए.
    Attribution-Reporting-Register-Source: {
        "source_event_id":"123001",
        "destination":"android-app://com.example.advertiser",
        "web_destination": "https://example.advertiser"
        ...
    }
    
    • अनुमानित रिपोर्टिंग पर अगले सेक्शन में बताया जाएगा कि ड्यूअल डेस्टिनेशन का इस्तेमाल कैसे किया जाता है आपकी रिपोर्ट में मौजूद ग़ैर-ज़रूरी आवाज़ों पर असर डाल सकती है.
  2. ड्यूअल रिपोर्ट के लिए इवेंट-लेवल रिपोर्ट में ग़ैर-ज़रूरी आवाज़ें कम करने के लिए, ज़्यादा जानकारी वाली रिपोर्टिंग की सुविधा का इस्तेमाल करें गंतव्य स्रोत:

    • अगर सोर्स में ओएस (ऐप्लिकेशन) और वेब डेस्टिनेशन, दोनों के बारे में बताया गया था रजिस्ट्रेशन के बाद, इवेंट-लेवल की रिपोर्ट में यह बताया जाएगा कि ट्रिगर हुआ या नहीं डिफ़ॉल्ट रूप से, वेब डेस्टिनेशन या ऐप्लिकेशन डेस्टिनेशन में दिखते हैं. हालांकि, निजता की सीमा तय की गई है, तो इन रिपोर्ट में अतिरिक्त ग़ैर-ज़रूरी आवाज़ें जोड़ दी जाएंगी.
    • विज्ञापन टेक्नोलॉजी, कन्वर्ज़न टाइप के तौर पर coarse_event_report_destinations फ़ील्ड का इस्तेमाल कर सकती हैं अनुमानित जानकारी की सुविधा चालू करने के लिए Attribution-Reporting-Register-Source हेडर और शोर को कम करें. अगर coarse_event_report_destinations वाला कोई सोर्स फ़ील्ड में दी गई जानकारी एट्रिब्यूशन जीतती है, नतीजे में मिलने वाली रिपोर्ट में दोनों ऐप्लिकेशन शामिल होते हैं और वेब डेस्टिनेशन में यह पता न करें कि असल में ऐप्लिकेशन या वेब डेस्टिनेशन वाले पेज पर मौजूद रिपोर्ट से कम शोर के साथ आया बताया गया है.
    • एग्रीगेट रिपोर्ट में कोई बदलाव नहीं होता.

Chrome के कस्टम टैब इस्तेमाल करने वाले ऐप्लिकेशन के लिए

कुछ ऐप्लिकेशन, वेब कॉन्टेंट रेंडर करने के लिए कस्टम टैब का इस्तेमाल कर सकते हैं. कस्टम टैब काम करते हैं यह टूल, ऐप्लिकेशन और मोबाइल वेबसाइटों पर मेज़र करने के लिए किसी सामान्य वेब पेज की तरह ही काम करता है.

  1. ऐप्लिकेशन सोर्स और कस्टम टैब ट्रिगर रजिस्टर करें:
  2. कस्टम टैब सोर्स और ऐप्लिकेशन ट्रिगर रजिस्टर करें:
  3. CCT सोर्स और CCT ट्रिगर रजिस्टर करें

वेबव्यू का इस्तेमाल करने वाले ऐप्लिकेशन के लिए

कुछ ऐप्लिकेशन, कॉन्टेंट दिखाने के लिए वेबव्यू का इस्तेमाल कर सकते हैं. अलग-अलग तरीकों से वेबव्यू के लिए इस्तेमाल किए जा सकते हैं, जैसे कि विज्ञापन रेंडर करना, वेब कॉन्टेंट होस्ट करना या कस्टम ऐप्लिकेशन सुविधाएं वेब फ़ॉर्मैट के लिए ज़्यादा सही हैं.

  1. वेबव्यू में सिर्फ़ ओएस-लेवल एट्रिब्यूशन उपलब्ध है. कॉन्टेंट बनाने Attribution-Reporting-Support हेडर सिर्फ़ os दिखाएगा. ऐसा सिर्फ़ तब होगा, जब Android Attribution Reporting API उपलब्ध है.

  2. ओएस को सौंपते समय, वेबव्यू registerSource या registerWebSource और registerTrigger या registerWebTrigger. पेमेंट के कौनसे तरीके का इस्तेमाल, वेबव्यू को रेंडर करने वाले ऐप्लिकेशन से किया जाता है. साथ ही, इसे इस पर तय किया जाता है हर वेबव्यू के आधार पर.

    • registerSource और registerWebSource के बीच का अंतर यह है कि स्रोत को प्रकाशक के रूप में लॉग कर लिया जाता है. registerSource के साथ ऐप्लिकेशन का डेटा लॉग किया जाता है प्रकाशक के तौर पर; registerSource के इस्तेमाल का उदाहरण पब्लिशर ऐप्लिकेशन, जो वेबव्यू का इस्तेमाल करके रेंडर किया गया विज्ञापन दिखाता है. के साथ registerWebSource, वेबव्यू में होस्ट की गई वेबसाइट को प्रकाशक; registerWebSource को कब इस्तेमाल करना है, इसका एक उदाहरण ऐसा ऐप्लिकेशन होगा वेबव्यू होस्ट करता है और वेबव्यू से रेंडर की जा रही वेबसाइट विज्ञापन दिखाने हैं. registerTrigger और registerWebTrigger इसी तरह के काम करते हैं. कॉन्टेंट बनाने आइटम #3 के चार्ट में, अलग-अलग स्थितियों की जानकारी दी गई है. इससे पता चलता है कि कब कोई ऐप्लिकेशन या SDK टूल डेवलपर registerSource या registerWebSource का इस्तेमाल करने के लिए एपीआई को कॉन्फ़िगर करना चाहेगा, और registerTrigger या registerWebTrigger.
  3. डिफ़ॉल्ट रूप से, वेबव्यू registerSource और registerWebTrigger का इस्तेमाल तब करेगा, जब हम Android Attribution Reporting API को कॉल कर रहे हैं. यह सोर्स को ऐप्लिकेशन से जुड़ जाता है और वेबव्यू में यूआरएल के टॉप-लेवल ऑरिजिन के साथ ट्रिगर होता है, जब ट्रिगर होता है.

    • अगर किसी ऐप्लिकेशन को अलग तरीके से काम करने की ज़रूरत है, तो उसे नया तरीका इस्तेमाल करना होगा androidx.webkit.WebViewSettingsCompat पर setAttributionRegistrationBehavior क्लास. इस तरीके से यह तय होगा कि वेबव्यू, registerWebSource() को कॉल करे या नहीं या registerSource() या registerTrigger() के बजाय registerWebTrigger().
      • शुरू किए गए हर वेबव्यू के लिए, यह व्यवहार सेट करना होगा.
      • अगर AdTech SDK टूल, वेबव्यू की शुरुआत कर रहा है, तो SDK टूल को डिफ़ॉल्ट रूप से ऐसा नहीं होता.
      • उन ऐप्लिकेशन के लिए जो सोर्स को जोड़ने के लिए registerWebSource() का इस्तेमाल करना चाहते हैं ऐप्लिकेशन के बजाय वेबव्यू में वेबसाइट के रजिस्ट्रेशन के लिए, उन्हें WebApp की अनुमति वाली सूची में शामिल हों. अनुमति वाली सूची में शामिल होने के लिए, यह फ़ॉर्म भरें. कॉन्टेंट बनाने अनुमति वाली सूची का मकसद, निजता से जुड़ी ज़रूरी बातों को कम करना है वेब कॉन्टेक्स्ट के लिए भरोसा सेट करना.
    • setAttributionRegistrationBehavior के लिए विकल्प
    वैल्यू जानकारी इस्तेमाल के उदाहरण का उदाहरण
    APP_SOURCE_AND_WEB_trigger (डिफ़ॉल्ट) ऐप्लिकेशन को वेबव्यू से, ऐप्लिकेशन के सोर्स (ऐप्लिकेशन के पैकेज के नाम से जुड़े स्रोत) और वेब ट्रिगर (eTLD+1 से जुड़े ट्रिगर) को रजिस्टर करने की अनुमति देता है. ऐसे ऐप्लिकेशन जो वेब ब्राउज़िंग को चालू करने के बजाय, विज्ञापन दिखाने के लिए वेबव्यू का इस्तेमाल करते हैं
    WEB_SOURCE_AND_WEB_TRIGGER ऐप्लिकेशन को वेबव्यू से वेब सोर्स और वेब ट्रिगर रजिस्टर करने की अनुमति देता है. वेबव्यू पर आधारित ब्राउज़र ऐप्लिकेशन का इस्तेमाल करें, जिसमें वेबव्यू में वेबसाइटों पर विज्ञापन इंप्रेशन और कन्वर्ज़न, दोनों हो सकते हैं.
    APP_SOURCE_AND_APP_TRIGGER ऐप्लिकेशन को वेबव्यू से, ऐप्लिकेशन सोर्स और ऐप्लिकेशन ट्रिगर को रजिस्टर करने की अनुमति देता है. वेबव्यू पर आधारित ऐप्लिकेशन जहां विज्ञापन इंप्रेशन और कन्वर्ज़न हमेशा वेबव्यू के eTLD+1 के बजाय ऐप्लिकेशन से जुड़े होने चाहिए.
    बंद है वेबव्यू से सोर्स बंद करता है और रजिस्ट्रेशन ट्रिगर करता है.
  4. वेबव्यू से सोर्स करें और रजिस्ट्रेशन ट्रिगर करें

    • विज्ञापन टेक्नोलॉजी को सोर्स रजिस्ट्रेशन का जवाब देना चाहिए. इसके लिए, Attribution-Reporting-Register-OS-Source हेडर. सेट किए गए व्यवहार के आधार पर वेबव्यू के लिए, registerSource() या registerWebSource() को कॉल करेगा ओएस के साथ काम करें और Android एट्रिब्यूशन से दूसरा एपीआई कॉल शुरू करें विज्ञापन तकनीक के यूआरआई को रिपोर्टिंग एपीआई.

      • सोर्स रजिस्ट्रेशन को पूरा करने के लिए, विज्ञापन टेक्नोलॉजी के एंडपॉइंट को Android Attribution Reporting API अनुरोध का जवाब रिस्पॉन्स हेडर.
      Attribution-Reporting-Register-OS-Source: {
          "source_event_id":"123001",
          "destination":"android-app://com.example.advertiser",
          ...
      }
      
    • बाकी सोर्स रजिस्ट्रेशन में कोई बदलाव नहीं होगा.

  5. विज्ञापन टेक्नोलॉजी को, Attribution-Reporting-Register-OS-Trigger हेडर. सेट किए गए व्यवहार के आधार पर वेबव्यू के लिए, registerTrigger() या registerWebTrigger() को कॉल करेगा साथ ही, Rb से विज्ञापन टेक्नोलॉजी के यूआरआई पर दूसरा एपीआई कॉल शुरू करें.

    • ट्रिगर रजिस्ट्रेशन को पूरा करने के लिए, विज्ञापन टेक्नोलॉजी के एंडपॉइंट को Android Attribution Reporting API अनुरोध का जवाब देना हेडर.
    Attribution-Reporting-Register-OS-Trigger: {
        "event_trigger_data": [{"trigger_data":"1"}],
        "aggregatable_trigger_data": [
            {"key_piece":"0x400","source_keys":["campaignCounts"]},
            {"key_piece":"0xA80","source_keys":["geoValue"]}
        ],
        ...
    }
    

डीबग

हमारा सुझाव है कि ऐप्लिकेशन को वेब पर लागू करते समय, डीबग सेट अप करें रिपोर्ट कर सकता है, ताकि यह पुष्टि की जा सके कि सोर्स और ट्रिगर सही तरीके से रजिस्टर किए जा रहे हैं या नहीं. रजिस्टर नहीं की गई हैं, तो इसकी वजह जानने के लिए.

एट्रिब्यूशन रिपोर्टिंग को डीबग करने के सामान्य चरणों के बारे में जानने के लिए, डीबगिंग कुकबुक पर जाएं.