कन्वर्ज़न एट्रिब्यूशन मेज़रमेंट में कई पक्ष शामिल हो सकते हैं. जैसे, पब्लिशर, विज्ञापन देने वाला, विज्ञापन टेक्नोलॉजी (विज्ञापन दिखाने वाली इकाई), मेज़रमेंट की सेवा देने वाली कंपनी वगैरह. इस दस्तावेज़ में, हम कन्वर्ज़न मेज़रमेंट के सामान्य उदाहरणों के बारे में बताते हैं. हालांकि, आम तौर पर, Attribution Reporting API (ARA) से एट्रिब्यूशन रिपोर्ट पाने के लिए, यह ज़रूरी है कि इस दस्तावेज़ में बताए गए इंटिग्रेशन के चरणों का पालन किया जाए.
उदाहरण के लिए, आम तौर पर पब्लिशर के पास विज्ञापन दिखाने के लिए एक या उससे ज़्यादा विज्ञापन टेक्नोलॉजी पार्टनर होते हैं. इनमें क्रिएटिव के लिए मार्कअप की सुविधा देने वाली पार्टियां, क्रिएटिव पर इंप्रेशन या ट्रैकिंग पिक्सल की सुविधा देने वाली पार्टियां, और पब्लिशर पेज पर विज्ञापन स्लॉट के लिए एसडीके या टैग की सुविधा देने वाली पार्टियां शामिल हो सकती हैं. हो सकता है कि ये विज्ञापन टेक्नोलॉजी कंपनियां, ARA से एट्रिब्यूशन रिपोर्ट पाने की इच्छा न रखें. हालांकि, इनकी भूमिका यह पक्का करना है कि डाउनस्ट्रीम विज्ञापन टेक्नोलॉजी कंपनियों को एट्रिब्यूशन रिपोर्ट मिल सकें.
इसके अलावा, विज्ञापन देने वाला व्यक्ति या कंपनी, क्रॉस-नेटवर्क एट्रिब्यूशन के साथ-साथ अन्य रिपोर्टिंग सुविधाओं के लिए, तीसरे पक्ष के कन्वर्ज़न मेज़रमेंट की सेवा देने वाली कंपनी का भी इस्तेमाल कर सकती है. विज्ञापन देने वाले लोग या कंपनियां, कई यूनीक पब्लिशर और चैनलों पर विज्ञापन में किए गए निवेश पर रिटर्न को समझने के लिए, उस डेटा का इस्तेमाल करती हैं. इसलिए, यह ज़रूरी है कि डीएसपी या विज्ञापन सर्वर, इस्तेमाल के इन उदाहरणों के साथ काम करने के लिए, एट्रिब्यूशन रिपोर्टिंग एपीआई को चालू करने का तरीका समझें. विज्ञापन देने वाले जो लोग या कंपनियां तीसरे पक्ष का इस्तेमाल करना चाहती हैं वे ऐसा कर सकती हैं. इसके लिए, वे तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी का इस्तेमाल कर सकती हैं या एपीआई से रिपोर्ट रजिस्टर करने और पाने के लिए, इन-हाउस सर्वर सेट अप कर सकती हैं.
Attribution Reporting API की मदद से, एक ही इंप्रेशन या कन्वर्ज़न के लिए, कई विज्ञापन टेक्नोलॉजी एट्रिब्यूशन सोर्स और ट्रिगर रजिस्टर कर सकती हैं. साथ ही, एपीआई से अलग-अलग रिपोर्ट भी पा सकती हैं. उदाहरण के लिए, किसी डीएसपी को Attribution Reporting API से अपनी एट्रिब्यूशन रिपोर्ट मिल सकती हैं. साथ ही, विज्ञापन देने वाले के तीसरे पक्ष के मेज़रमेंट प्रोवाइडर के लिए अलग रिपोर्टिंग की अनुमति भी दी जा सकती है. एपीआई से रिपोर्ट पाने के लिए, विज्ञापन टेक्नोलॉजी कंपनी को एट्रिब्यूशन सोर्स और ट्रिगर, दोनों को रजिस्टर करना होगा. साथ ही, एट्रिब्यूशन उन एट्रिब्यूशन सोर्स और ट्रिगर के बीच किया जाता है जिन्हें विज्ञापन टेक्नोलॉजी कंपनी ने एपीआई के साथ अलग-अलग रजिस्टर किया है.
कन्वर्ज़न मेज़रमेंट के सामान्य उदाहरण
इस सेक्शन में, हम कन्वर्ज़न मेज़रमेंट के लिए दो सामान्य स्थितियों की जांच करेंगे.
पहली स्थिति: विज्ञापन दिखाने वाली टेक्नोलॉजी और तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी, दोनों को Attribution Reporting API से रिपोर्ट मिलनी चाहिए
विज्ञापन देने वाली कंपनी, तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी का इस्तेमाल करके, विज्ञापन इन्वेंट्री पर कन्वर्ज़न एट्रिब्यूट करना चाहती है. साथ ही, क्रिएटिव को होस्ट करने वाली विज्ञापन टेक्नोलॉजी कंपनी, विज्ञापन इन्वेंट्री पर कन्वर्ज़न एट्रिब्यूट करना चाहती है. यह डीएसपी या विज्ञापन देने वाले के विज्ञापन सर्वर (तीसरे पक्ष का विज्ञापन सर्वर — 3PAS) के लिए आम बात है. ये विज्ञापन क्रिएटिव के लिए मार्कअप उपलब्ध कराते हैं, अपनी एट्रिब्यूशन रिपोर्टिंग करते हैं, और विज्ञापन देने वाले उन लोगों या कंपनियों के साथ काम करते हैं जो तीसरे पक्ष के मेज़रमेंट या ऐनलिटिक्स प्रोवाइडर के साथ इंटिग्रेट होती हैं.
इस मामले में, विज्ञापन दिखाने वाली विज्ञापन टेक्नोलॉजी, मौजूदा सेटअप में क्लिक और इंप्रेशन इवेंट को ट्रिगर करने के लिए भी ज़िम्मेदार है. विज्ञापन दिखाने वाली विज्ञापन टेक्नोलॉजी कंपनी को, सही जगहों पर नया attributionsrc
सेट करना चाहिए. साथ ही, यह पक्का करना चाहिए कि रीडायरेक्ट सही तरीके से कॉन्फ़िगर किए गए हों. साथ ही, विज्ञापन दिखाने वाली टेक्नोलॉजी और मेज़रमेंट की सेवा देने वाली तीसरे पक्ष की कंपनी, दोनों को यह पक्का करना होगा कि वे रजिस्टर हों और उनके सर्वर, एट्रिब्यूशन रिपोर्टिंग एपीआई के अनुरोधों को पाने और उनका जवाब देने के लिए तैयार हों.
एक सामान्य कैंपेन सेटअप इस तरह दिख सकता है:
विज्ञापन देने वाले का विज्ञापन सर्वर (3PAS), विज्ञापन क्रिएटिव के लिए मार्कअप को डीएसपी को देता है. इसमें, मेज़रमेंट की सेवा देने वाली तीसरे पक्ष की कंपनी के इंप्रेशन और क्लिक ट्रैकिंग पिक्सल शामिल होते हैं. विज्ञापन सर्वर को यह पक्का करना चाहिए कि
attributionsrc
को विज्ञापन क्रिएटिव मार्कअप में शामिल किया गया हो.डीएसपी, अतिरिक्त मेज़रमेंट इंप्रेशन और क्लिक ट्रैकिंग पिक्सल जोड़ने की सुविधाएं देता है. साथ ही, यह पक्का करना चाहिए कि
attributionsrc
उस फ़ाइनल विज्ञापन क्रिएटिव मार्कअप में शामिल हो जिसके लिए बिडिंग की जा रही है.
दूसरी स्थिति: सिर्फ़ तीसरे पक्ष के मेज़रमेंट प्रोवाइडर को Attribution Reporting API से रिपोर्ट मिलनी चाहिए
विज्ञापन देने वाला व्यक्ति या कंपनी, तीसरे पक्ष की मेज़रमेंट सेवा देने वाली कंपनी का इस्तेमाल करके, विज्ञापन इन्वेंट्री पर कन्वर्ज़न एट्रिब्यूट करना चाहता है. हालांकि, क्रिएटिव को होस्ट करने वाली विज्ञापन टेक्नोलॉजी में, एट्रिब्यूशन मेज़रमेंट की कोई ज़रूरत नहीं है. ऐसा पब्लिशर, एसएसपी या पब्लिशर विज्ञापन सर्वर के लिए आम तौर पर होता है जो क्रिएटिव होस्ट करते हैं और खुद एट्रिब्यूशन रिपोर्टिंग का इस्तेमाल नहीं करना चाहते. हालांकि, वे अपने डीएसपी पार्टनर या मेज़रमेंट टैगिंग कंपनियों के लिए, एट्रिब्यूशन रिपोर्टिंग एपीआई को चालू करना चाहते हैं. जैसे, तीसरे पक्ष के विज्ञापन सर्वर, मेज़रमेंट या आंकड़े देने वाली कंपनियां.
इस मामले में, मौजूदा सेटअप में क्लिक और इंप्रेशन इवेंट को ट्रिगर करने वाली पार्टी को क्रिएटिव में नया attributionsrc
एट्रिब्यूट जोड़ना होगा. साथ ही, यह पक्का करना होगा कि रीडायरेक्ट सही तरीके से काम कर रहे हों. यह हर पब्लिशर के इंटिग्रेशन पर निर्भर करता है. हालांकि, क्लिक इवेंट के लिए, यह एसएसपी, विज्ञापन टेक्नोलॉजी या पब्लिशर खुद हो सकता है. इंप्रेशन इवेंट के लिए, आम तौर पर तीसरे पक्ष का मेज़रमेंट प्रोवाइडर होता है.
पहली स्थिति के सामान्य कैंपेन सेटअप के उदाहरण में, पब्लिशर विज्ञापन सर्वर, एसएसपी या पब्लिशर को सिर्फ़ यह पक्का करना पड़ सकता है कि डीएसपी से मिला attributionsrc
एट्रिब्यूट, पब्लिशर पेज पर दिखे.
क्रियान्वयन विवरण
नीचे दी गई टेबल में, एट्रिब्यूशन रिपोर्टिंग एपीआई को लागू करने के चरणों के बारे में खास जानकारी दी गई है:
कदम | काम की ज़िम्मेदारी | उदाहरण |
---|---|---|
पहला चरण: मौजूदा क्रिएटिव और मेज़रमेंट कोड के लिए एट्रिब्यूशन सोर्स चालू करना | इंप्रेशन इवेंट ट्रिगर करने या क्लिक इवेंट मैनेज करने वाली इकाई, attributionsrc एट्रिब्यूट जोड़ती है. |
क्लिक इवेंट के लिए, आम तौर पर क्रिएटिव को रेंडर करने वाला कोई खरीदार (डीएसपी/विज्ञापन देने वाला विज्ञापन सर्वर) एट्रिब्यूट जोड़ता है.
इंप्रेशन इवेंट के लिए, डिमांड-साइड प्लैटफ़ॉर्म (डीएसपी), सप्लाई-साइड प्लैटफ़ॉर्म (एसएसपी), पब्लिशर, विज्ञापन सर्वर या मेज़रमेंट की सेवा देने वाली कंपनी, एट्रिब्यूट जोड़ती है. यह पब्लिशर के सेटअप पर निर्भर करता है. वीएएसटी फ़ॉर्मैट का इस्तेमाल करने वाले वीडियो विज्ञापनों के लिए, पब्लिशर और वीडियो SDK टूल, एट्रिब्यूट जोड़ते हैं. |
दूसरा चरण: तीसरे पक्ष के सोर्स के लिए एट्रिब्यूशन रिपोर्टिंग चालू करना | अगर 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
खाली है, तो ARA के अनुरोध, ऐंकर टैग के href
एट्रिब्यूट में बताए गए यूआरएल (क्लिक मिलने पर खुलने वाला यूआरएल) पर भेजे जाएंगे. attributionsrc
एट्रिब्यूट की वैल्यू तय करने पर, ARA के अनुरोध attributionsrc
एट्रिब्यूट में तय किए गए यूआरएल पर भेजे जाएंगे. क्लिकथ्रू यूआरएल से भी सोर्स रजिस्टर किए जा सकते हैं.
आम तौर पर, अगर क्लिक मिलने पर खुलने वाले यूआरएल को होस्ट करने वाला सर्वर, एट्रिब्यूशन रिपोर्टिंग एपीआई के अनुरोधों को स्वीकार और उनका जवाब दे सकता है, तो खाली attributionsrc
एट्रिब्यूट का इस्तेमाल करें. अगर आपको Attribution Reporting API के अनुरोधों को किसी दूसरे सर्वर पर भेजना है, तो अपना attributionsrc
यूआरएल तय करें.
खाली attributionsrc
एट्रिब्यूट का उदाहरण:
आपका मौजूदा सेटअप | ARA इंटिग्रेशन के साथ |
---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
|
attributionsrc
एट्रिब्यूट खाली होने पर, Attribution Reporting API के अनुरोध, एंकर टैग के href
एट्रिब्यूट से तय किए गए यूआरएल पर भेजे जाएंगे.
ऐसे attributionsrc एट्रिब्यूट का उदाहरण जिसमें कोई वैल्यू मौजूद है:
आपका मौजूदा सेटअप | ARA इंटिग्रेशन के साथ |
---|---|
<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 का इस्तेमाल करने वाले इंप्रेशन इवेंट में, फ़ेच एपीआई कॉल में पास किए गए options आर्ग्युमेंट में
attributionReporting
ऑब्जेक्ट शामिल होना चाहिए.
- आम तौर पर,
क्लिक और इंप्रेशन इवेंट के लिए ज़रूरी बदलावों की खास जानकारी के लिए, यहां दी गई टेबल देखें:
इवेंट | टैग | आपका मौजूदा सेटअप | ARA इंटिग्रेशन के बाद |
---|---|---|---|
क्लिक | एचटीएमएल |
<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
का इस्तेमाल किया जा सकता है. इससे एट्रिब्यूशन सोर्स को रजिस्टर करने की सुविधा चालू होती है.
सुरक्षित ऑडियंस के सिग्नल की रिपोर्टिंग के लिए, registerAdBeacon
फ़ंक्शन रिपोर्टिंग वर्कलेट में उपलब्ध है. साथ ही, registerAdMacro
फ़ंक्शन, खरीदार की जीत की रिपोर्टिंग वर्कलेट में उपलब्ध है. इसके बाद, फ़ेंस किए गए फ़्रेम विज्ञापन रिपोर्टिंग एपीआई के reportEvent
और setReportEventDataForAutomaticBeacons
फ़ंक्शन की मदद से, विज्ञापन फ़्रेम में मौजूद इवेंट डेटा को रजिस्टर किए गए बीकन और मैक्रो में जोड़ा जा सकता है. इससे, सुरक्षित ऑडियंस रिपोर्टिंग वर्कलेट और विज्ञापन क्रिएटिव फ़्रेम इवेंट के पेलोड के सिग्नल को एक-दूसरे से जोड़ा जा सकता है.
जब किसी फ़्रेम से reportEvent
कॉल करके बीकन और मैक्रो ट्रिगर किए जाते हैं या ब्राउज़र से अपने-आप ट्रिगर होने वाले बीकन ट्रिगर किए जाते हैं, तब अनुरोध में Attribution-Reporting-Eligible
एचटीटीपी हेडर जोड़ा जाता है. एट्रिब्यूशन सोर्स को रजिस्टर करने के लिए, बीकन के रिस्पॉन्स का इस्तेमाल किया जा सकता है. तीसरे पक्ष के मेज़रमेंट की अनुमति देने के लिए, बीकन अनुरोधों को रीडायरेक्ट किया जा सकता है.
ज़्यादा जानकारी के लिए, फ़ेंस किए गए फ़्रेम वाले Ad Reporting API के बारे में बताने वाले लेख में, एट्रिब्यूशन रिपोर्टिंग सेक्शन के लिए सहायता देखें.
VAST फ़ॉर्मैट के लिए एट्रिब्यूशन रिपोर्टिंग की सुविधा चालू करना
VAST, वीडियो विज्ञापन इन्वेंट्री को दिखाने और मेज़र करने के लिए एक सामान्य फ़ॉर्मैट है. इस स्टैंडर्ड में बताए गए कई इवेंट को संभावित सोर्स इवेंट माना जाना चाहिए, जो 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
के साथ एनोटेट किया गया हो या उसे Protected Audience API में registerAdBeacon/registerAdMacro
के साथ रजिस्टर किया गया हो. रीडायरेक्ट चेन में मौजूद विज्ञापन टेक्नोलॉजी को भी रजिस्टर किया जाना चाहिए.
ध्यान दें कि शुरुआती अनुरोध का मुख्य हिस्सा, रीडायरेक्ट पर नहीं भेजा जाता. 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
,3p-measurement.example
पर रीडायरेक्ट करने के लिएLocation
हेडर का इस्तेमाल करता है. ध्यान दें कि हो सकता है कि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-Register-Source
हेडर के साथ जवाब दे. जवाब को कैसे तैयार करना चाहिए, यह जानने के लिए सोर्स रजिस्टर करने की गाइड और एक्सप्लेनर देखें.
एक से ज़्यादा ट्रिगर रजिस्टर करना
कन्वर्ज़न साइड पर एक से ज़्यादा पिक्सल एलिमेंट जोड़कर, कई एट्रिब्यूशन ट्रिगर रजिस्टर किए जा सकते हैं. हर ट्रिगर के लिए एक एलिमेंट जोड़ा जाता है. ट्रिगर रजिस्ट्रेशन के लिए, attributionsrc
एलिमेंट का इस्तेमाल करना ज़रूरी नहीं है.
रीडायरेक्ट अनुरोधों का इस्तेमाल करके या सोर्स रजिस्ट्रेशन की तरह ही attributionsrc
एलिमेंट में कई यूआरएल डालकर, एक ही पिक्सल एलिमेंट से कई ट्रिगर भी रजिस्टर किए जा सकते हैं. एक ही ऑरिजिन से जनरेट किए गए सोर्स इवेंट और ट्रिगर इवेंट मैच कर दिए जाएंगे.