कन्वर्ज़न एट्रिब्यूशन मेज़रमेंट में कई पक्ष शामिल हो सकते हैं. जैसे, पब्लिशर, विज्ञापन देने वाला व्यक्ति या कंपनी, विज्ञापन दिखाने वाली विज्ञापन टेक्नोलॉजी (विज्ञापन दिखाने वाली इकाई), मेज़रमेंट की सुविधा देने वाली कंपनी वगैरह. इस दस्तावेज़ में, कन्वर्ज़न मेज़रमेंट के सामान्य उदाहरण दिए गए हैं. हालांकि, सामान्य तौर पर, Attribution Reporting API (ARA) से एट्रिब्यूशन रिपोर्ट पाने वाली किसी भी पार्टी को यह पक्का करना होगा कि इस दस्तावेज़ में बताए गए इंटिग्रेशन के चरणों का पालन किया गया हो.
उदाहरण के लिए, किसी पब्लिशर के पास विज्ञापन दिखाने के लिए, एक या उससे ज़्यादा विज्ञापन टेक्नोलॉजी कंपनियां हो सकती हैं. इनमें क्रिएटिव के लिए मार्कअप उपलब्ध कराने वाली कंपनियां, क्रिएटिव पर इंप्रेशन या ट्रैकिंग पिक्सल उपलब्ध कराने वाली कंपनियां, और पब्लिशर पेज पर विज्ञापन स्लॉट के लिए एसडीके या टैग उपलब्ध कराने वाली कंपनियां शामिल हो सकती हैं. विज्ञापन टेक्नोलॉजी से जुड़ी ये कंपनियां, ARA से एट्रिब्यूशन रिपोर्ट पाना चाहें या न चाहें. हालांकि, ये इस बात की पुष्टि करती हैं कि विज्ञापन टेक्नोलॉजी से जुड़ी अन्य कंपनियां, एट्रिब्यूशन रिपोर्ट पा सकती हैं.
इसके अलावा, विज्ञापन देने वाला व्यक्ति या कंपनी, क्रॉस-नेटवर्क एट्रिब्यूशन के साथ-साथ रिपोर्टिंग की अन्य सुविधाओं के लिए, तीसरे पक्ष की कन्वर्ज़न मेज़रमेंट सेवा देने वाली कंपनी का इस्तेमाल कर सकती है. विज्ञापन देने वाले लोग या कंपनियां, इस डेटा का इस्तेमाल करके यह समझती हैं कि अलग-अलग पब्लिशर और चैनलों पर विज्ञापन दिखाने से उन्हें कितना रिटर्न मिला. इसलिए, यह ज़रूरी है कि डीएसपी या विज्ञापन सर्वर को यह पता हो कि इन मामलों में Attribution Reporting API को कैसे चालू किया जाए. विज्ञापन देने वाले जो लोग या कंपनियां तीसरे पक्ष की सेवा का इस्तेमाल करना चाहती हैं वे ऐसा कर सकती हैं. इसके लिए, वे तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी का इस्तेमाल कर सकती हैं या एपीआई से रिपोर्ट पाने और उन्हें रजिस्टर करने के लिए, इन-हाउस सर्वर सेट अप कर सकती हैं.
Attribution Reporting API की मदद से, विज्ञापन से जुड़ी कई टेक्नोलॉजी, एक ही इंप्रेशन या कन्वर्ज़न के लिए एट्रिब्यूशन सोर्स और ट्रिगर रजिस्टर कर सकती हैं. साथ ही, एपीआई से अलग-अलग रिपोर्ट पा सकती हैं. उदाहरण के लिए, कोई डीएसपी, Attribution Reporting API से अपनी एट्रिब्यूशन रिपोर्ट पा सकता है. साथ ही, विज्ञापन देने वाले व्यक्ति या कंपनी के तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी के लिए अलग रिपोर्टिंग की अनुमति दे सकता है. विज्ञापन टेक्नोलॉजी को एपीआई से रिपोर्ट पाने के लिए, एट्रिब्यूशन सोर्स और ट्रिगर, दोनों को रजिस्टर करना होगा. साथ ही, एट्रिब्यूशन उन एट्रिब्यूशन सोर्स और ट्रिगर के बीच किया जाता है जिन्हें विज्ञापन टेक्नोलॉजी ने एपीआई के साथ अलग-अलग रजिस्टर किया है.
कन्वर्ज़न मेज़रमेंट से जुड़े सामान्य उदाहरण
इस सेक्शन में, हम कन्वर्ज़न मेज़रमेंट के दो सामान्य उदाहरणों के बारे में जानेंगे.
पहला उदाहरण: विज्ञापन दिखाने वाली टेक्नोलॉजी और मेज़रमेंट की सेवा देने वाली तीसरे पक्ष की कंपनी, दोनों को Attribution Reporting API से रिपोर्ट मिलनी चाहिए
विज्ञापन देने वाला कोई व्यक्ति या कंपनी, तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी का इस्तेमाल करके, विज्ञापन इन्वेंट्री पर कन्वर्ज़न को एट्रिब्यूट करना चाहती है. साथ ही, क्रिएटिव को होस्ट करने वाली विज्ञापन टेक्नोलॉजी कंपनी, विज्ञापन इन्वेंट्री पर कन्वर्ज़न को एट्रिब्यूट करना चाहती है. यह आम तौर पर डीएसपी या विज्ञापन देने वाले व्यक्ति या कंपनी के विज्ञापन सर्वर (तीसरे पक्ष का विज्ञापन सर्वर — 3PAS) के लिए होता है. ये कंपनियां, विज्ञापन क्रिएटिव के लिए मार्कअप उपलब्ध कराती हैं, एट्रिब्यूशन रिपोर्टिंग करती हैं, और विज्ञापन देने वाले उन लोगों या कंपनियों के साथ काम करती हैं जो मेज़रमेंट या ऐनलिटिक्स की सेवा देने वाली तीसरे पक्ष की कंपनियों के साथ इंटिग्रेट करती हैं.
इस मामले में, विज्ञापन दिखाने वाली टेक्नोलॉजी भी वह पार्टी है जो मौजूदा सेटअप में क्लिक और इंप्रेशन इवेंट को ट्रिगर करने के लिए ज़िम्मेदार है. विज्ञापन दिखाने वाली टेक्नोलॉजी को नई attributionsrc को सही जगहों पर सेट करना चाहिए. साथ ही, यह पुष्टि करनी चाहिए कि रीडायरेक्ट सही तरीके से कॉन्फ़िगर किए गए हैं. साथ ही, विज्ञापन दिखाने वाली विज्ञापन टेक्नोलॉजी और तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी, दोनों को यह पुष्टि करनी चाहिए कि उन्होंने रजिस्टर किया है और उनके सर्वर, Attribution Reporting API के अनुरोधों को स्वीकार करने और उनका जवाब देने के लिए तैयार हैं.
कैंपेन का सामान्य सेटअप इस तरह दिख सकता है:
विज्ञापन देने वाला व्यक्ति या कंपनी, विज्ञापन सर्वर (3PAS) के ज़रिए डीएसपी को विज्ञापन क्रिएटिव के लिए मार्कअप उपलब्ध कराती है. इसमें तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी के इंप्रेशन और क्लिक ट्रैकिंग पिक्सल शामिल होते हैं. विज्ञापन सर्वर को यह पक्का करना चाहिए कि विज्ञापन क्रिएटिव मार्कअप में
attributionsrcशामिल हो.डीएसपी, मेज़रमेंट के लिए इंप्रेशन और क्लिक ट्रैकिंग पिक्सल जोड़ने की सुविधाएं देता है. साथ ही, उसे यह पक्का करना चाहिए कि
attributionsrcको उस फ़ाइनल विज्ञापन क्रिएटिव मार्कअप में शामिल किया गया हो जिसके लिए वे बिड कर रहे हैं.
दूसरा उदाहरण: सिर्फ़ तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी को Attribution Reporting API से रिपोर्ट मिलनी चाहिए
विज्ञापन देने वाला कोई व्यक्ति या कंपनी, तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी का इस्तेमाल करके, विज्ञापन इन्वेंट्री पर कन्वर्ज़न एट्रिब्यूट करना चाहती है. हालांकि, क्रिएटिव को होस्ट करने वाली विज्ञापन टेक्नोलॉजी में एट्रिब्यूशन मेज़रमेंट से जुड़ी कोई ज़रूरी शर्तें नहीं हैं. यह आम तौर पर उन पब्लिशर, एसएसपी या पब्लिशर विज्ञापन सर्वर के लिए होता है जो क्रिएटिव होस्ट करते हैं और खुद एट्रिब्यूशन रिपोर्टिंग का इस्तेमाल नहीं करना चाहते. हालांकि, वे अपने डीएसपी पार्टनर या मेज़रमेंट टैगिंग कंपनियों के लिए, Attribution Reporting API को चालू करना चाहते हैं. जैसे, तीसरे पक्ष के विज्ञापन सर्वर, मेज़रमेंट या आंकड़ों की सेवा देने वाली कंपनियां.
इस मामले में, मौजूदा सेटअप में क्लिक और इंप्रेशन इवेंट ट्रिगर करने के लिए ज़िम्मेदार पार्टी को क्रिएटिव में नया attributionsrc एट्रिब्यूट जोड़ना होगा. साथ ही, यह पुष्टि करनी होगी कि रीडायरेक्ट सही तरीके से काम कर रहे हैं. यह हर पब्लिशर के इंटिग्रेशन पर निर्भर करता है. हालांकि, क्लिक इवेंट के लिए यह एसएसपी, विज्ञापन दिखाने वाली टेक्नोलॉजी या पब्लिशर खुद हो सकता है. इंप्रेशन इवेंट के लिए, तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी का इस्तेमाल ज़्यादा किया जाता है.
पहले उदाहरण में, कैंपेन सेटअप के सामान्य उदाहरण में, पब्लिशर के विज्ञापन सर्वर, एसएसपी या पब्लिशर को सिर्फ़ यह पुष्टि करनी पड़ सकती है कि डीएसपी ने जो attributionsrc एट्रिब्यूट दिया है वह पब्लिशर पेज पर मौजूद है.
क्रियान्वयन विवरण
यहां दी गई टेबल में, Attribution Reporting API को लागू करने के चरणों के बारे में खास जानकारी दी गई है:
| चरण | काम की ज़िम्मेदारी | उदाहरण |
|---|---|---|
| पहला चरण: मौजूदा क्रिएटिव और मेज़रमेंट कोड के लिए एट्रिब्यूशन सोर्स चालू करना | इंप्रेशन इवेंट ट्रिगर करने या क्लिक इवेंट मैनेज करने के लिए ज़िम्मेदार इकाई, attributionsrc एट्रिब्यूट जोड़ती है. |
क्लिक इवेंट के लिए, आम तौर पर खरीदार (डीएसपी/विज्ञापन देने वाले व्यक्ति या कंपनी का विज्ञापन सर्वर) जो क्रिएटिव रेंडर करता है, वह एट्रिब्यूट जोड़ता है.
इंप्रेशन इवेंट के लिए, डिमांड-साइड प्लैटफ़ॉर्म (डीएसपी), सप्लाई-साइड प्लैटफ़ॉर्म (एसएसपी), पब्लिशर, विज्ञापन सर्वर या मेज़रमेंट सेवा देने वाली कंपनी एट्रिब्यूट जोड़ती है. यह पब्लिशर के सेटअप पर निर्भर करता है. वीएएसटी फ़ॉर्मैट का इस्तेमाल करने वाले वीडियो विज्ञापनों के लिए, पब्लिशर और वीडियो एसडीके, एट्रिब्यूट जोड़ते हैं. |
| दूसरा चरण: तीसरे पक्ष के ऑरिजिन के लिए एट्रिब्यूशन रिपोर्टिंग चालू करना | अगर 302 रीडायरेक्ट के साथ किसी मौजूदा रीडायरेक्ट पाथ का इस्तेमाल किया जा रहा है, तो यह सुविधा तुरंत काम करने लगती है. अगर 302 रीडायरेक्ट का इस्तेमाल नहीं किया जा सकता, तो |
आम तौर पर, जब तक क्रिएटिव में attributionsrc एट्रिब्यूट जोड़ा जाता है, तब तक तीसरे पक्ष के रीडायरेक्ट को Attribution Reporting API कॉल मिलते रहने चाहिए. |
| तीसरा चरण: Attribution Reporting API के अनुरोधों के लिए जवाब सेट अप करना | कोई भी ऐसी इकाई जिसे Attribution Reporting API से रिपोर्ट चाहिए | विज्ञापन देने वाले व्यक्ति या कंपनी की ओर से इस्तेमाल किया गया डीएसपी और तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी |
ध्यान दें कि हर चरण की खास जानकारी इस बात पर निर्भर करती है कि पब्लिशर पेज पर क्रिएटिव कैसे रेंडर और दिखाए जाते हैं. साथ ही, विज्ञापन से जुड़ी टेक्नोलॉजी की किन इकाइयों को Attribution Reporting API से भेजी गई रिपोर्ट मिलती हैं.
पहला चरण: मौजूदा क्रिएटिव और मेज़रमेंट कोड के लिए एट्रिब्यूशन सोर्स चालू करना
पहले चरण में, एट्रिब्यूशन सोर्स चालू किए जाते हैं.
attributionsrc एट्रिब्यूट कैसे काम करता है
नए attributionsrc एट्रिब्यूट से यह तय होता है कि Attribution Reporting API के अनुरोध कहां भेजे जाएंगे. इंप्रेशन और क्लिक इवेंट को ट्रिगर करने वाली इकाई को, क्रिएटिव में attributionsrc एट्रिब्यूट की वैल्यू अपडेट करनी होगी. attributionsrc को मौजूदा क्लिक और इंप्रेशन इवेंट में जोड़ा जाना चाहिए. यह खाली या भरा हुआ हो सकता है.
रीडायरेक्ट का इस्तेमाल करने वाले क्लिक इवेंट के लिए, नेविगेशन में attributionsrc एट्रिब्यूट जोड़ा जाना चाहिए. नेविगेशन के बाद होने वाले किसी भी 302 रीडायरेक्ट के लिए, attributionsrc एट्रिब्यूट जोड़ने की ज़रूरत नहीं है. साथ ही, ये एआरए के लिए तब तक ज़रूरी शर्तें पूरी करते रहेंगे, जब तक शुरुआती नेविगेशन में attributionsrc एट्रिब्यूट जोड़ा गया हो.
attributionsrc खाली होने पर, एआरए के अनुरोध, ऐंकर टैग (क्लिकथ्रू यूआरएल) के href एट्रिब्यूट में तय किए गए यूआरएल पर भेजे जाएंगे. attributionsrc एट्रिब्यूट तय किए जाने पर, एआरए के अनुरोध attributionsrc एट्रिब्यूट में तय किए गए यूआरएल पर भेजे जाएंगे. क्लिकथ्रू यूआरएल भी सोर्स रजिस्टर करने की ज़रूरी शर्तें पूरी करता है.
आम तौर पर, अगर क्लिकथ्रू यूआरएल को होस्ट करने वाला सर्वर, Attribution Reporting API के अनुरोधों को पा सकता है और उनका जवाब दे सकता है, तो खाली attributionsrc एट्रिब्यूट का इस्तेमाल करें. अगर आपको Attribution Reporting API के अनुरोध किसी दूसरे सर्वर पर भेजने हैं, तो अपना attributionsrc यूआरएल तय करें.
खाली attributionsrc एट्रिब्यूट का उदाहरण:
| आपका मौजूदा सेटअप | एआरए इंटिग्रेशन के साथ |
|---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
|
जब attributionsrc एट्रिब्यूट की वैल्यू खाली होती है, तब Attribution Reporting API के अनुरोध, ऐंकर टैग के href एट्रिब्यूट से तय किए गए यूआरएल पर भेजे जाएंगे.
attributionsrc एट्रिब्यूट की ऐसी वैल्यू का उदाहरण जिसमें कोई न कोई वैल्यू मौजूद है:
| आपका मौजूदा सेटअप | एआरए इंटिग्रेशन के साथ |
|---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>
|
attributionsrc टैग में वैल्यू मौजूद होने पर, Attribution Reporting API के अनुरोध, attributionsrc टैग में तय किए गए यूआरएल पर भेजे जाएंगे. क्लिकथ्रू यूआरएल भी सोर्स रजिस्टर करने की ज़रूरी शर्तें पूरी करता है.
क्लिक और इंप्रेशन इवेंट के लिए attributionsrc जोड़ना
- क्लिक इवेंट:
- आम तौर पर, विज्ञापन दिखाने वाली विज्ञापन टेक्नोलॉजी कंपनी
attributionsrcजोड़ती है. - क्लिक इवेंट वाले ऐंकर टैग में
attributionsrcएट्रिब्यूट जोड़ा जाना चाहिए. window.openका इस्तेमाल करके किए गए क्लिक के लिए, एट्रिब्यूशन सोर्स तय करने के लिएwindow.openकॉल केwindowFeaturesआर्ग्युमेंट का इस्तेमाल किया जाना चाहिए.
- आम तौर पर, विज्ञापन दिखाने वाली विज्ञापन टेक्नोलॉजी कंपनी
- इंप्रेशन इवेंट:
attributionsrcको जोड़ने के लिए आम तौर पर, विज्ञापन दिखाने वाली टेक्नोलॉजी और मेज़रमेंट की सेवा देने वाली कंपनियां ज़िम्मेदार होती हैं.<img>टैग या<script>टैग से ट्रिगर किए गए इंप्रेशन इवेंट मेंattributionsrcएट्रिब्यूट शामिल होना चाहिए.- Fetch API का इस्तेमाल करके भेजे गए इंप्रेशन इवेंट में,
attributionReportingऑब्जेक्ट शामिल होना चाहिए. यह ऑब्जेक्ट, फ़ेच एपीआई कॉल को पास किए गए options आर्ग्युमेंट में शामिल होना चाहिए.
क्लिक और इंप्रेशन इवेंट के लिए ज़रूरी बदलावों की खास जानकारी के लिए, यहां दी गई टेबल देखें:
| इवेंट | टैग | आपका मौजूदा सेटअप | एआरए इंटिग्रेशन के बाद |
|---|---|---|---|
| क्लिक | एचटीएमएल |
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
|
| JavaScript | window.open("[CLICKTHROUGH_URL]", "_blank"); |
window.open("[CLICKTHROUGH_URL]", "_blank", "attributionsrc"); |
|
| इंप्रेशन | एचटीएमएल <img> टैग |
<img src="[IMPRESSION_URL]">
|
<img src="[IMPRESSION_URL]" attributionsrc>
|
एचटीएमएल <script> टैग |
<script src="[IMPRESSION_URL]"></script>
|
<script src="[IMPRESSION_URL]" attributionsrc></script>
|
|
| JavaScript |
const options = {...} |
const options = { |
Protected Audience API से जुड़ी नीलामी में एट्रिब्यूशन सोर्स रजिस्ट्रेशन की सुविधा चालू करना
Protected Audience ऑक्शन में कन्वर्ज़न मेज़र करने के लिए, attributionsrc का इस्तेमाल करने के बजाय, एट्रिब्यूशन सोर्स रजिस्टर करने के लिए registerAdBeacon/registerAdMacro और setReportEventDataForAutomaticBeacons/reportEvent का इस्तेमाल किया जा सकता है.
Protected Audience सिग्नल की रिपोर्टिंग के लिए, registerAdBeacon फ़ंक्शन, रिपोर्टिंग वर्कलेट में उपलब्ध होता है. साथ ही, registerAdMacro फ़ंक्शन, खरीदार के विन रिपोर्टिंग वर्कलेट में उपलब्ध होता है. इसके बाद, विज्ञापन फ़्रेम में मौजूद इवेंट डेटा को रजिस्टर किए गए बीकन और मैक्रो में जोड़ा जा सकता है. इसके लिए, Fenced Frame Ads Reporting API के reportEvent और setReportEventDataForAutomaticBeacons फ़ंक्शन का इस्तेमाल किया जा सकता है. इससे, सुरक्षित ऑडियंस की रिपोर्टिंग के वर्कलेट के सिग्नल और विज्ञापन क्रिएटिव फ़्रेम के इवेंट पेलोड को एक-दूसरे से जोड़ा जा सकता है.
Attribution-Reporting-Eligible एचटीटीपी हेडर को अनुरोध में तब जोड़ा जाता है, जब बीकन और मैक्रो, फ़्रेम से reportEvent कॉल से ट्रिगर होते हैं या ऑटोमैटिक बीकन, ब्राउज़र से ट्रिगर होते हैं. एट्रिब्यूशन सोर्स रजिस्टर करने के लिए, बीकन के रिस्पॉन्स का इस्तेमाल किया जा सकता है. तीसरे पक्ष के मेज़रमेंट की अनुमति देने के लिए, बीकन के अनुरोधों को रीडायरेक्ट किया जा सकता है.
ज़्यादा जानकारी के लिए, Fenced Frame Ad Reporting API के बारे में बताने वाले लेख में Attribution Reporting API के साथ काम करने की सुविधा वाला सेक्शन देखें.
VAST फ़ॉर्मैट के लिए एट्रिब्यूशन रिपोर्टिंग की सुविधा चालू करना
VAST, वीडियो विज्ञापन इन्वेंट्री को दिखाने और मेज़र करने का एक सामान्य फ़ॉर्मैट है. इस स्टैंडर्ड में तय किए गए कई इवेंट को संभावित सोर्स इवेंट माना जाना चाहिए. ये इवेंट, Attribution Reporting API के साथ रजिस्टर किए जा सकते हैं. Attribution Reporting API के साथ काम करने के लिए VAST ऐडेंडम में इस बारे में ज़्यादा जानकारी दी गई है. हालांकि, कम शब्दों में कहें, तो <Tracking>, <Impression>, <*ClickThrough>, और <*ClickTracking> इवेंट, एट्रिब्यूशन सोर्स इवेंट हो सकते हैं. सभी वीएएसटी (वीडियो विज्ञापन देने के लिए टेंप्लेट) लागू करने से, इन इवेंट के लिए रजिस्ट्रेशन की ज़रूरी शर्तों को पूरा किया जाना चाहिए.
VAST ऐडेंडम, इन एलिमेंट के लिए नए एट्रिब्यूट तय करता है. इससे एट्रिब्यूशन रजिस्ट्रेशन के लिए, खास तौर पर सेकंडरी यूआरएल सेट किया जा सकता है. जब किसी इवेंट में attributiontype="DOUBLE_PING" और attributionsrc="[URL]" शामिल हों, तो उस इवेंट को ट्रिगर करने वाले कोड को, Attribution Reporting API चालू करते समय attributionsrc एट्रिब्यूट की वैल्यू के तौर पर [URL] का इस्तेमाल करना चाहिए. वीएएसटी ऐडेंडम में, हर स्थिति के उदाहरण दिए गए हैं.
ज़्यादा से ज़्यादा कवरेज के लिए, VAST लागू करने वाले सभी इवेंट को डिफ़ॉल्ट रूप से रजिस्ट्रेशन के लिए उपलब्ध कराना चाहिए. ऐसा तब करना चाहिए, जब इवेंट पिंग फ़ायर किए जाते हैं. उदाहरण के लिए, <Impression> इवेंट यूआरएल को ट्रिगर करते समय, अनुरोध भेजने के लिए इस्तेमाल किए गए <img> एलिमेंट पर (खाली) attributionsrc एट्रिब्यूट का इस्तेमाल किया जाना चाहिए. इसके अलावा, फ़ेच कॉल पर भी इसका इस्तेमाल किया जाना चाहिए, ताकि इवेंट को पाने वाला पक्ष हमेशा Attribution Reporting API के साथ उस इवेंट को रजिस्टर कर सके.
दूसरा चरण: तीसरे पक्ष के ऑरिजिन के लिए एट्रिब्यूशन रिपोर्टिंग चालू करना
तीसरे पक्षों को Attribution Reporting API का इस्तेमाल करने की अनुमति देने के लिए, मौजूदा रीडायरेक्ट का इस्तेमाल किया जा सकता है. इसके अलावा, attributionsrc एट्रिब्यूट में तीसरे पक्षों की सूची जोड़ी जा सकती है. ज़्यादातर मामलों में, हर विज्ञापन टेक्नोलॉजी कंपनी के पास अपना इंडिपेंडेंट इंप्रेशन ट्रैकर होता है. इसलिए, रीडायरेक्ट, क्लिक ट्रैकर के लिए ज़्यादा काम के होते हैं.
रीडायरेक्ट चेन में तीसरे पक्ष के ऑरिजिन को मैनेज करना
विज्ञापन पर क्लिक करने के बाद, कई क्लिक ट्रैकर मौजूद हो सकते हैं. ये ट्रैकर, फ़ाइनल लैंडिंग पेज पर नेविगेट करने के दौरान 302 रीडायरेक्ट की चेन के तौर पर मौजूद होते हैं. रीडायरेक्ट चेन में मौजूद हर अनुरोध को Attribution Reporting API के साथ रजिस्टर किया जा सकता है. ऐसा तब किया जा सकता है, जब ओरिजनल क्लिक टारगेट को attributionsrc के साथ एनोटेट किया गया हो या उसे registerAdBeacon/registerAdMacro में Protected Audience API के साथ रजिस्टर किया गया हो. रीडायरेक्ट चेन में मौजूद विज्ञापन टेक्नोलॉजी को भी रजिस्टर करना होगा.
ध्यान दें कि रीडायरेक्ट पर, शुरुआती अनुरोध का मुख्य हिस्सा नहीं भेजा जाता. Protected Audience की नीलामी के लिए, अगर eventData को reportEvent में पास किया जाता है और setReportEventDataForAutomaticBeacons को रीडायरेक्ट के हिस्से के तौर पर इस्तेमाल करना है, तो इसे रीडायरेक्ट यूआरएल के हिस्से के तौर पर साफ़ तौर पर पास किया जाना चाहिए.
यहां दिए गए उदाहरण में, हम विज्ञापन दिखाने वाली टेक्नोलॉजी (serving-adtech.example) और तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी (3p-measurement.example) को दो अलग-अलग इकाइयों के तौर पर इस्तेमाल करेंगे. ये इकाइयां, एट्रिब्यूशन रिपोर्ट जनरेट और हासिल करना चाहती हैं. इस उदाहरण में, विज्ञापन दिखाने वाली विज्ञापन टेक्नोलॉजी, एक ऐसा डीएसपी हो सकता है जो पब्लिशर की साइट पर क्रिएटिव रेंडर करता है. साथ ही, उसके पास रिपोर्टिंग का अपना प्रॉडक्ट होता है. तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी, ऐसी इकाई हो सकती है जिसका इस्तेमाल विज्ञापन देने वाला व्यक्ति या कंपनी, कन्वर्ज़न रिपोर्टिंग के लिए करती है.
सोर्स रजिस्टर करते समय, यह प्रोसेस होती है:
serving-adtech.exampleक्रिएटिव मेंattributionsrcएट्रिब्यूट सेट करता है.उपयोगकर्ता, पब्लिशर के पेज पर जाता है और ब्राउज़र,serving-adtech.example.को अनुरोध भेजता हैserving-adtech.example,Attribution-Reporting-Register-Sourceहेडर औरLocationहेडर के साथ जवाब देता है.serving-adtech.example, रजिस्टर किए जाने वाले सोर्स के मेटाडेटा के साथ जवाब देने के लिए,Attribution-Reporting-Register-Sourceहेडर का इस्तेमाल करता है.serving-adtech.example,Locationहेडर का इस्तेमाल करके3p-measurement.exampleपर रीडायरेक्ट करता है. ध्यान दें कि ऐसा हो सकता है किLocationहेडर का इस्तेमाल, आपके मौजूदा क्लिकट्रैकिंग फ़्लो में पहले से ही किया जा रहा हो. ऐसा तीसरे पक्ष को302रीडायरेक्ट करने की सुविधा देने के लिए किया जाता है.
- ब्राउज़र को
serving-adtech.exampleसे रिस्पॉन्स मिलता है और वहAttribution-Reporting-Register-Sourceहेडर को पार्स करता है. ब्राउज़र, सोर्स इवेंट को सेव करता है. इसके लिए,serving-adtech.exampleको रिपोर्टिंग ऑरिजिन के तौर पर इस्तेमाल करता है. - यह अनुरोध रीडायरेक्ट किया गया है. इसलिए, ब्राउज़र
3p-measurement.exampleको एक नया अनुरोध भी करता है. 3p-measurement.example,Attribution-Reporting-Register-Sourceहेडर वाला जवाब देता है.- ब्राउज़र को यह जवाब
3p-measurement.exampleसे मिलता है और वहAttribution-Reporting-Register-Sourceको पढ़ता है. ब्राउज़र, सोर्स इवेंट को सेव करता है. इसके लिए,3p-measurement.exampleको रिपोर्टिंग ऑरिजिन के तौर पर इस्तेमाल करता है.
रीडायरेक्ट चेन में शामिल नहीं होने वाले तीसरे पक्ष के ऑरिजिन के लिए, attributionsrc का इस्तेमाल करना
अगर कई रिपोर्टर ऑरिजिन, नेविगेशन इवेंट पर किसी सोर्स को रजिस्टर करना चाहते हैं, लेकिन किसी वजह से रीडायरेक्ट चेन में नहीं दिख सकते, तो attributionsrc में कई साइटों को एट्रिब्यूशन सोर्स के तौर पर सूची में शामिल किया जा सकता है.
| आपका मौजूदा सेटअप | एआरए में बदलाव करने की सुविधा के साथ |
|---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]">...</a>
|
इस उदाहरण में, Attribution Reporting API के ज़रूरी शर्तें पूरी करने वाले अनुरोध, REPORTING_URL_1 और REPORTING_URL_2, दोनों को भेजे जाएंगे. क्लिकथ्रू यूआरएल को भेजे गए नेविगेशन अनुरोध के लिए भी एट्रिब्यूशन सोर्स रजिस्टर किए जा सकते हैं.
तीसरा चरण: Attribution Reporting API के अनुरोधों के लिए जवाब सेट अप करना
जिन सभी ऑरिजिन को Attribution Reporting API का अनुरोध मिलता है उनके लिए, पुष्टि करें कि सर्वर सही Attribution-Reporting-Register-Source हेडर के साथ जवाब देता हो. जवाब को कैसे तैयार किया जाना चाहिए, यह जानने के लिए सोर्स रजिस्टर करें गाइड और एक्सप्लेनर देखें.
एक से ज़्यादा ट्रिगर रजिस्टर करना
कन्वर्ज़न साइड पर एक से ज़्यादा पिक्सल एलिमेंट (हर ट्रिगर के लिए एक) जोड़कर, एक से ज़्यादा एट्रिब्यूशन ट्रिगर रजिस्टर किए जा सकते हैं. ट्रिगर रजिस्ट्रेशन के लिए, attributionsrc एलिमेंट का इस्तेमाल करना ज़रूरी नहीं है.
रीडायरेक्ट अनुरोधों का इस्तेमाल करके या सोर्स रजिस्ट्रेशन की तरह ही attributionsrc एलिमेंट में कई यूआरएल लिस्ट करके, एक पिक्सल एलिमेंट से कई ट्रिगर भी रजिस्टर किए जा सकते हैं. एक ही ऑरिजिन से जनरेट हुए सोर्स इवेंट और ट्रिगर इवेंट को मैच किया जाएगा.