Privacy Sandbox की कुछ टेक्नोलॉजी को बंद किया जा रहा है.

Privacy Sandbox की टेक्नोलॉजी के लिए प्लान से जुड़ा हमारा अपडेट देखें.

Privacy Sandbox की सुविधा की स्थिति से, अलग-अलग एपीआई और प्लैटफ़ॉर्म की सुविधाओं की स्थिति के बारे में ज़्यादा जानकारी मिलती है.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

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

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

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

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

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

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

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

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

उदाहरण

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

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

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

Daily News Android ऐप्लिकेशन में मौजूद विज्ञापन टेक्नोलॉजी वाला एसडीके, registerSource() का इस्तेमाल करके क्लिक रजिस्टर करता है
Android पर मौजूद Attribution Reporting API, विज्ञापन से जुड़ी टेक्नोलॉजी के सर्वर को अनुरोध भेजता है registerSource() को दिया गया यूआरएल
विज्ञापन टेक्नोलॉजी सर्वर, सोर्स रजिस्ट्रेशन पूरा करने के लिए Attribution-Reporting-Register-Source हेडर के साथ जवाब देता है

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

विज्ञापन टेक्नोलॉजी, ट्रिगर रजिस्टर करती है और Attribution Reporting API में ओएस की उपलब्धता की जांच करती है
वेब एआर, यह जानकारी देता है कि कौनसे प्लैटफ़ॉर्म पर काम किया जा सकता है
OS-Trigger हेडर, वेब ARA API को ओएस ARA API के registerWebTrigger() फ़ंक्शन को कॉल करने के लिए कहता है
registerWebTrigger() को कॉल करने की प्रोसेस बैकग्राउंड में होती है. डेवलपर को ओएस के साथ सीधे तौर पर registerWebTrigger() को कॉल करने की ज़रूरत नहीं होती
ओएस एआरए, Attribution-Reporting-Register-OS-Trigger हेडर से मिले विज्ञापन टेक्नोलॉजी सर्वर के यूआरएल को ऐक्सेस करता है और उस पर अनुरोध भेजता है
विज्ञापन टेक्नोलॉजी कंपनी, ओएस एपीआई के साथ ट्रिगर रजिस्ट्रेशन पूरा करेगी
ओएस एआरए, ऐप्लिकेशन<>ऐप्लिकेशन एट्रिब्यूशन पर लागू होने वाले लॉजिक के हिसाब से एट्रिब्यूशन करेगा और वही रिपोर्ट भेजेगा

वर्कफ़्लो

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

ऐप्लिकेशन में मौजूद विज्ञापन टेक्नोलॉजी, Android के Attribution Reporting API में सोर्स रजिस्टर करती है. इसमें ये बदलाव किए जाते हैं:
- अगर आपको किसी ऐसे ऐप्लिकेशन सोर्स को रजिस्टर करना है जो वेबसाइट पर कन्वर्ज़न कर सकता है, तो Attribution-Reporting-Register-Source रिस्पॉन्स हेडर में ऐप्लिकेशन डेस्टिनेशन के बजाय वेब डेस्टिनेशन (eTLD+1) शामिल होना चाहिए.
```
Attribution-Reporting-Register-Source: {
    "web_destination": "https://advertiser.example",
    ...
}
```
ध्यान दें: जिन कैंपेन के कन्वर्ज़न, वेब या ऐप्लिकेशन में से किसी भी डेस्टिनेशन पर हो सकते हैं उनके लिए, दो डेस्टिनेशन
सेक्शन देखें
- कुछ विज्ञापन देने वाले लोग या कंपनियां, मेज़रमेंट की सेवा देने वाली एक से ज़्यादा कंपनियों का इस्तेमाल कर सकती हैं. उदाहरण के लिए, तीसरे पक्ष का मेज़रमेंट टूल या कोई ऐनलिटिक्स टूल. इसके लिए, वे 302 रीडायरेक्ट चेन का इस्तेमाल करती हैं. कुछ मामलों में, Attribution Reporting API, बैकग्राउंड में Attribution-Reporting-Redirect हेडर में दिए गए रीडायरेक्ट पाथ को फ़ॉलो करेगा. साथ ही, मौजूदा नेविगेशन अनुरोधों के लिए, फ़ोरग्राउंड में 302 रीडायरेक्ट पाथ को लागू करेगा. ये अनुरोध एक ही यूआरएल पर जाएंगे. इससे, तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी, रजिस्ट्रेशन की गिनती दो बार कर सकती है. दो बार रजिस्ट्रेशन की गिनती को रोकने के लिए, विज्ञापन से जुड़ी टेक्नोलॉजी देने वाली कंपनियां, रीडायरेक्ट करने के तरीके में बदलाव कर सकती हैं. इससे Attribution Reporting API के रजिस्ट्रेशन को किसी अन्य यूआरएल पर भेजा जा सकता है. हालांकि, यह यूआरएल पहले से तय होता है.
- इस सुविधा को चालू करने के लिए, विज्ञापन टेक्नोलॉजी कंपनियों को रजिस्ट्रेशन के अनुरोध का जवाब देते समय, एक नया एचटीटीपी हेडर शामिल करना होगा:
  - हेडर Attribution-Reporting-Redirect-Config है
  - हेडर की वैल्यू, redirect-302-to-well-known होनी चाहिए
```
Attribution-Reporting-Redirect-Config: redirect-302-to-well-known
```
  ध्यान दें: इस हेडर के बाद होने वाले सभी रीडायरेक्ट में, रीडायरेक्ट यूआरआई के पाथ की शुरुआत में .well-known जोड़ा जाएगा.
- सोर्स रजिस्टर करने की बाकी प्रोसेस, ऐप्लिकेशन-टू-ऐप्लिकेशन सोर्स रजिस्टर करने की स्टैंडर्ड प्रोसेस जैसी ही होती है.
ध्यान दें: अगर आपको या पब्लिशिंग ऐप्लिकेशन को Android ऐप्लिकेशन में विज्ञापन दिखाने के लिए वेबव्यू का इस्तेमाल करना है, तो वेबव्यू
सेक्शन देखें
विज्ञापन देने वाले व्यक्ति या कंपनी की वेबसाइट पर मौजूद विज्ञापन टेक्नोलॉजी, ट्रिगर को रजिस्टर करती है. इसके लिए, वह Chrome से रजिस्ट्रेशन को Android Attribution Reporting API को सौंपने के लिए कहती है:
- जब कोई उपयोगकर्ता किसी वेबसाइट पर कन्वर्ज़न पूरा करता है, तो विज्ञापन टेक्नोलॉजी, Chrome से ट्रिगर रजिस्टर करने का अनुरोध करेगी
  1. किसी पिक्सल या fetch() अनुरोध का इस्तेमाल करके, ट्रिगर रजिस्टर करने का अनुरोध किया जा सकता है
  2. Attribution-Reporting-Support अनुरोध हेडर, Chrome, विज्ञापन टेक्नोलॉजी कंपनी को भेजता है. अगर Chrome ब्राउज़र और Android डिवाइस, दोनों पर एपीआई चालू है, तो हेडर os, web दिखाएगा
```
Attribution-Reporting-Support: os, web
```
- इसके बाद, विज्ञापन टेक्नोलॉजी को Chrome को यह बताना चाहिए कि वह ओएस को डेलिगेट करे. इसके लिए, उसे Attribution-Reporting-Register-OS-Trigger हेडर का इस्तेमाल करना चाहिए. इस हेडर में यह जानकारी होनी चाहिए:
  1. यह कुकी, Chrome को रजिस्ट्रेशन की प्रोसेस को ओएस को सौंपने के लिए कहती है
  2. Chrome, ओएस के एपीआई फ़ंक्शन को कॉल करके, रजिस्ट्रेशन की ज़िम्मेदारी ओएस को सौंपता है registerWebTrigger()
    - registerWebTrigger() को कॉल करने की प्रोसेस बैकग्राउंड में होती है. विज्ञापन टेक्नोलॉजी को सीधे तौर पर registerWebTrigger() को कॉल करने की ज़रूरत नहीं होती
  3. ओएस एपीआई, विज्ञापन टेक्नोलॉजी से जुड़े यूआरआई को सेकंडरी एपीआई कॉल शुरू करता है. यह यूआरआई, ब्राउज़र से पास किया जाता है
```
Attribution-Reporting-Register-OS-Trigger: "https://adtech.example/register-trigger",
"https://other-adtech.example/register-trigger"
```
- कुछ मामलों में, Attribution-Reporting-Support हेडर उपलब्ध नहीं होता और इसे भेजा नहीं जा सकता. ऐसा होने पर भी, विज्ञापन टेक्नोलॉजी कंपनी, ट्रिगर रजिस्ट्रेशन को मैनेज करने के लिए पसंदीदा प्लैटफ़ॉर्म सेट कर सकती है. इसके लिए, उसे Attribution-Reporting-Info हेडर शामिल करना होगा. कुंजी preferred-platform है और इसकी मान्य वैल्यू os और web हैं. अगर पसंदीदा प्लैटफ़ॉर्म उपलब्ध है, तो ब्राउज़र उसका इस्तेमाल करेगा. अगर ओएस उपलब्ध नहीं है, तो ब्राउज़र वेब प्लैटफ़ॉर्म का इस्तेमाल करेगा.
ध्यान दें: वेब रजिस्ट्रेशन की जानकारी देने वाले Attribution-Reporting-Register-Trigger हेडर और ओएस रजिस्ट्रेशन की जानकारी देने वाले Attribution-Reporting-Register-OS-Trigger हेडर, दोनों को तब दिखाना चाहिए, जब पुष्टि के लिए पसंदीदा प्लैटफ़ॉर्म चुना जा रहा हो. इससे यह पक्का किया जा सकेगा कि सही प्लैटफ़ॉर्म पर रजिस्ट्रेशन हो. ओएस और वेब, दोनों के रजिस्ट्रेशन की जानकारी देनी होगी, ताकि अगर पसंदीदा प्लैटफ़ॉर्म उपलब्ध न हो, तो फ़ॉलबैक तरीके के लिए ज़रूरी जानकारी मौजूद हो.
```
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 को सौंप दे. ऐसा इसलिए किया जाता है, ताकि Chrome पर Attribution Reporting API का इस्तेमाल न किया जाए. उपयोगकर्ता, शॉपिंग ऐप्लिकेशन में स्वेटर खरीदता है. इसके बाद, विज्ञापन देने वाले व्यक्ति या कंपनी के ऐप्लिकेशन में मौजूद विज्ञापन टेक्नोलॉजी, Android Attribution Reporting API के साथ कन्वर्ज़न ट्रिगर रजिस्टर करती है. ओएस-लेवल का Attribution Reporting API, वेब सोर्स और ऐप्लिकेशन ट्रिगर को मैच कर सकता है. साथ ही, काम की रिपोर्ट भेज सकता है.

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

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

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

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

कपड़ों की दुकान वाले Android ऐप्लिकेशन में मौजूद विज्ञापन टेक्नोलॉजी वाला SDK, ओएस एआरए के साथ ट्रिगर रजिस्टर करता है
Android पर मौजूद Attribution Reporting API, विज्ञापन से जुड़ी टेक्नोलॉजी के सर्वर को अनुरोध भेजता है registerTrigger() को दिया गया यूआरएल
विज्ञापन टेक्नोलॉजी सर्वर, ट्रिगर रजिस्ट्रेशन पूरा करने के लिए Attribution-Reporting-Register-Trigger हेडर के साथ जवाब देता है
ओएस एआरए, ऐप्लिकेशन<>ऐप्लिकेशन एट्रिब्यूशन पर लागू होने वाले लॉजिक के हिसाब से एट्रिब्यूशन करेगा और वही रिपोर्ट भेजेगा

वर्कफ़्लो

पब्लिशर की वेबसाइट पर मौजूद विज्ञापन टेक्नोलॉजी, सोर्स को रजिस्टर करती है. इसके लिए, वह Chrome को Android Attribution Reporting API को रजिस्ट्रेशन सौंपने का निर्देश देती है:
- वेब से ऐप्लिकेशन पर स्विच करने के इस्तेमाल के उदाहरण के लिए, सोर्स रजिस्टर करते समय एट्रिब्यूशन सोर्स पैरामीटर को सीधे तौर पर तय किया जाना चाहिए. इसके लिए, attributionsrc टैग या JavaScript रजिस्ट्रेशन का इस्तेमाल किया जा सकता है
- इस उदाहरण में, attributionsrc टैग का इस्तेमाल करके सोर्स पैरामीटर की वैल्यू बताई गई है:
```
<img src="https://adtech.example/conversionpixel"
attributionsrc="https://adtech.example/register-source?purchase=12">
```
Attribution-Reporting-Support अनुरोध हेडर, Chrome, विज्ञापन टेक्नोलॉजी कंपनी को भेजता है. अगर Chrome ब्राउज़र और Android डिवाइस, दोनों पर एपीआई चालू है, तो हेडर os, web दिखाएगा.
```
Attribution-Reporting-Support: os, web
```
ध्यान दें: ऐप्लिकेशन और वेब पर मेज़रमेंट करने के लिए, Android OS पर Attribution Reporting API चालू होना चाहिए.
विज्ञापन टेक्नोलॉजी को Chrome को यह बताना चाहिए कि ओएस-लेवल के एपीआई को Attribution-Reporting-Register-OS-Source हेडर का इस्तेमाल करके डेलिगेट किया जाए. इस हेडर में यह जानकारी शामिल होनी चाहिए:
1. यह कुकी, Chrome को रजिस्ट्रेशन की प्रोसेस को ओएस को सौंपने के लिए कहती है
2. Chrome, ओएस के एपीआई फ़ंक्शन को कॉल करके, रजिस्ट्रेशन की ज़िम्मेदारी ओएस को सौंपता है registerWebSource()
3. registerWebSource() को कॉल करने की प्रोसेस बैकग्राउंड में होती है. विज्ञापन टेक्नोलॉजी को सीधे तौर पर registerWebSource() को कॉल करने की ज़रूरत नहीं होती
4. ओएस एपीआई, विज्ञापन टेक्नोलॉजी से जुड़े यूआरआई को दूसरा एपीआई कॉल शुरू करता है. यह यूआरआई, ब्राउज़र से पास किया जाता है
```
Attribution-Reporting-Register-OS-Source: "https://adtech.example/register-source"
```
- कुछ मामलों में, Attribution-Reporting-Support हेडर उपलब्ध नहीं होता है. ऐसा होने पर भी, विज्ञापन टेक्नोलॉजी कंपनी, सोर्स रजिस्ट्रेशन को मैनेज करने के लिए पसंदीदा प्लैटफ़ॉर्म सेट कर सकती है. इसके लिए, उसे Attribution-Reporting-Info हेडर शामिल करना होगा. कुंजी, preferred-platform है. साथ ही, os और web को वैल्यू के तौर पर इस्तेमाल किया जा सकता है. अगर पसंदीदा प्लैटफ़ॉर्म उपलब्ध होगा, तो ब्राउज़र उसका इस्तेमाल करेगा. अगर ओएस उपलब्ध नहीं होगा, तो ब्राउज़र वेब प्लैटफ़ॉर्म का इस्तेमाल करेगा.
ध्यान दें: वेब रजिस्ट्रेशन की जानकारी देने वाले Attribution-Reporting-Register-Source हेडर और ओएस रजिस्ट्रेशन की जानकारी देने वाले Attribution-Reporting-Register-OS-Source हेडर, दोनों को तब दिखाना चाहिए, जब पुष्टि के लिए पसंदीदा प्लैटफ़ॉर्म चुना जा रहा हो. इससे यह पक्का किया जा सकेगा कि सही प्लैटफ़ॉर्म पर रजिस्ट्रेशन हो. ओएस और वेब, दोनों के रजिस्ट्रेशन की जानकारी देनी होगी, ताकि अगर पसंदीदा प्लैटफ़ॉर्म उपलब्ध न हो, तो फ़ॉलबैक तरीके के लिए ज़रूरी जानकारी मौजूद हो.
```
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",
    ...
}
```
- सोर्स रजिस्ट्रेशन के लिए रीडायरेक्ट की सुविधा देने के लिए, Chrome रीडायरेक्ट को फ़ॉलो करेगा. साथ ही, हर रीडायरेक्ट हॉप के लिए वेब कॉन्टेक्स्ट एपीआई को कॉल करेगा.
- सोर्स रजिस्ट्रेशन की बाकी प्रक्रिया में कोई बदलाव नहीं किया गया है.
विज्ञापन देने वाले व्यक्ति या कंपनी के ऐप्लिकेशन में मौजूद विज्ञापन टेक्नोलॉजी, Android Attribution Reporting API के साथ ट्रिगर रजिस्टर करती है:
- ऐप्लिकेशन में होने वाले ट्रिगर के लिए, ऐप्लिकेशन सामान्य तौर पर Android Attribution Reporting API के साथ ट्रिगर रजिस्टर करते हैं.

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

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

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

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

ऐप्लिकेशन सोर्स और कस्टम टैब ट्रिगर रजिस्टर करें:
- ऐप्लिकेशन सोर्स और वेब ट्रिगर रजिस्टर करने के लिए दिए गए निर्देशों का पालन करें.
कस्टम टैब सोर्स और ऐप्लिकेशन ट्रिगर रजिस्टर करें:
- वेब सोर्स और ऐप्लिकेशन ट्रिगर रजिस्टर करने के लिए, दिए गए निर्देशों का पालन करें.
CCT सोर्स और CCT ट्रिगर रजिस्टर करना
- इसे Chrome में, साइट-टू-साइट वेब एट्रिब्यूशन की तरह ही माना जाता है.

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

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

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

ध्यान दें: Chrome और WebView, दोनों पर एट्रिब्यूशन करने के लिए, Chrome में सोर्स और ट्रिगर रजिस्ट्रेशन को ओएस को सौंपना होगा. ऐसा इसलिए, क्योंकि WebView के लिए सिर्फ़ ओएस पर आधारित एट्रिब्यूशन काम करता है.

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

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

Android Attribution Reporting API को कॉल करते समय, WebView डिफ़ॉल्ट रूप से registerSource और registerWebTrigger का इस्तेमाल करेगा. इससे सोर्स को ऐप्लिकेशन से और ट्रिगर को WebView में यूआरएल के टॉप-लेवल ऑरिजिन से जोड़ा जाता है. ऐसा तब होता है, जब ट्रिगर चालू होता है.

अगर किसी ऐप्लिकेशन को अलग तरीके से काम करना है, तो उसे androidx.webkit.WebViewSettingsCompat क्लास में, setAttributionRegistrationBehavior नाम के नए तरीके का इस्तेमाल करना होगा. इस तरीके से यह तय किया जाएगा कि WebView को registerSource() या registerTrigger() के बजाय registerWebSource() या registerWebTrigger() को कॉल करना चाहिए.
यह सेटिंग, शुरू किए गए हर WebView के लिए सेट करनी होगी.
अगर विज्ञापन टेक्नोलॉजी से जुड़ा SDK टूल, WebView शुरू कर रहा है, तो SDK टूल को यह डिफ़ॉल्ट व्यवहार सेट करना होगा.
अगर किसी ऐप्लिकेशन को registerWebSource() का इस्तेमाल करके, सोर्स रजिस्ट्रेशन को ऐप्लिकेशन के बजाय वेबव्यू में वेबसाइट से जोड़ना है, तो उसे वेब ऐप्लिकेशन की अनुमति वाली सूची में शामिल होना होगा. अनुमति वाली सूची में शामिल होने के लिए, यह फ़ॉर्म भरें. अनुमति वाली सूची का मकसद, वेब कॉन्टेक्स्ट के लिए भरोसा कायम करने से जुड़ी निजता की समस्याओं को कम करना है.

वैल्यू	ब्यौरा	इस्तेमाल का उदाहरण
APP_SOURCE_AND_WEB_TRIGGER (डिफ़ॉल्ट)	इस अनुमति से ऐप्लिकेशन, वेबव्यू से ऐप्लिकेशन सोर्स (ऐप्लिकेशन पैकेज के नाम से जुड़े सोर्स) और वेब ट्रिगर (eTLD+1 से जुड़े ट्रिगर) रजिस्टर कर सकते हैं.	ऐसे ऐप्लिकेशन जो वेब ब्राउज़िंग की सुविधा देने के बजाय, विज्ञापन दिखाने के लिए WebView का इस्तेमाल करते हैं
WEB_SOURCE_AND_WEB_TRIGGER	इससे ऐप्लिकेशन, वेबव्यू से वेब सोर्स और वेब ट्रिगर रजिस्टर कर पाते हैं.	वेबव्यू पर आधारित ब्राउज़र ऐप्लिकेशन, जहां विज्ञापन इंप्रेशन और कन्वर्ज़न, दोनों वेबव्यू में वेबसाइटों पर हो सकते हैं.
APP_SOURCE_AND_APP_TRIGGER	इससे ऐप्लिकेशन, WebView से ऐप्लिकेशन के सोर्स और ऐप्लिकेशन के ट्रिगर रजिस्टर कर पाते हैं.	वेबव्यू पर आधारित ऐप्लिकेशन, जहां विज्ञापन इंप्रेशन और कन्वर्ज़न को हमेशा ऐप्लिकेशन से जोड़ा जाना चाहिए, न कि वेबव्यू के eTLD+1 से.
बंद है	यह कुकी, WebView से सोर्स और ट्रिगर रजिस्ट्रेशन की सुविधा बंद करती है.

वेबव्यू से सोर्स और ट्रिगर रजिस्ट्रेशन
विज्ञापन टेक्नोलॉजी को Attribution-Reporting-Register-OS-Source हेडर का इस्तेमाल करके, सोर्स रजिस्ट्रेशन का जवाब देना चाहिए. वेबव्यू के लिए सेट किए गए व्यवहार के आधार पर, यह ओएस के साथ registerSource() या registerWebSource() को कॉल करेगा. साथ ही, विज्ञापन टेक्नोलॉजी यूआरआई को Android Attribution Reporting API से दूसरा एपीआई कॉल शुरू करेगा.
- सोर्स रजिस्ट्रेशन पूरा करने के लिए, विज्ञापन टेक्नोलॉजी के एंडपॉइंट को Android Attribution Reporting API के अनुरोध का जवाब, रिस्पॉन्स हेडर के साथ देना चाहिए.
```
 Attribution-Reporting-Register-OS-Source: {
  "source_event_id":"123001",
  "destination":"android-app://com.example.advertiser",
  ...
}
```
सोर्स रजिस्ट्रेशन की बाकी प्रक्रिया में कोई बदलाव नहीं किया गया है.
विज्ञापन टेक्नोलॉजी कंपनियों को, Attribution-Reporting-Register-OS-Trigger हेडर का इस्तेमाल करके ट्रिगर रजिस्ट्रेशन का जवाब देना चाहिए. WebView के लिए सेट किए गए व्यवहार के आधार पर, यह ओएस के साथ 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"]}
    ],
    ...
}

ट्रिगर रजिस्टर करने की बाकी प्रोसेस में कोई बदलाव नहीं होता.

डीबग

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

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