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

एट्रिब्यूशन सोर्स रजिस्टर करें

क्लिक और व्यू का एट्रिब्यूट सही इवेंट को देने के लिए, सोर्स को रजिस्टर करने का तरीका जानें.

एट्रिब्यूशन सोर्स, विज्ञापन से जुड़ा एक इवेंट (क्लिक या व्यू) है, जिसमें विज्ञापन टेक्नोलॉजी इस तरह की जानकारी अटैच कर सकती है: - विज्ञापन क्रिएटिव आईडी, कैंपेन के बारे में जानकारी या देश/इलाके की जानकारी जैसे काम की रिपोर्टिंग का डेटा. - कन्वर्ज़न डेस्टिनेशन, यानी कि वह साइट जहां आप उपयोगकर्ता के ग्राहक में बदलने की उम्मीद करते हैं.

इस दस्तावेज़ में दिए गए चरणों का पालन करके, ऐसे सोर्स—विज्ञापन इंप्रेशन या क्लिक रजिस्टर किए जा सकते हैं जिन्हें ब्राउज़र कन्वर्ज़न एट्रिब्यूट करता है.

रजिस्ट्रेशन के तरीके

एट्रिब्यूशन सोर्स रजिस्टर करने के लिए, एचटीएमएल एलिमेंट या JavaScript कॉल का इस्तेमाल करें:

<a> टैग
<img> टैग
<script> टैग
fetch कॉल
XMLHttpRequest
window.open

इससे ऐसे नेटवर्क अनुरोध जनरेट होते हैं जिनका जवाब आपको फिर से, सोर्स रजिस्ट्रेशन के एचटीटीपी रिस्पॉन्स हेडर से दिया जाता है.

क्लिक या व्यू के लिए सोर्स रजिस्टर करें

क्लिक या व्यू के लिए एट्रिब्यूशन सोर्स को रजिस्टर करने के लिए, यहां दिया गया तरीका अपनाएं. इसके बाद, पूरे चरण पूरे किए जाएंगे. यहां खास जानकारी दी गई है:

सोर्स के रजिस्ट्रेशन की प्रक्रिया शुरू करें. अनुरोध करने के लिए, एचटीएमएल एलिमेंट या JavaScript कॉल का इस्तेमाल करें. यह चरण क्लिक और व्यू के लिए अलग है, जैसा कि आपको नीचे दिए गए सेक्शन में दिखेगा.
सोर्स रजिस्ट्रेशन हेडर की मदद से जवाब देकर, सोर्स रजिस्ट्रेशन की प्रक्रिया पूरी करें. वह अनुरोध मिलने पर, Attribution-Reporting-Register-Source हेडर के साथ जवाब दें. उस हेडर में पसंदीदा एट्रिब्यूशन रिपोर्टिंग कॉन्फ़िगरेशन तय करें. यह चरण क्लिक और व्यू, दोनों के लिए एक ही है.

खास जानकारी वाली रिपोर्ट के उदाहरण:
```
{
  "aggregation_keys": {
    "campaignCounts": "0x159", 
    "geoValue": "0x5" 
  },
  "aggregatable_report_window": "86400",
  "destination": "https://example.com"
}
```
इवेंट-लेवल की रिपोर्ट के लिए उदाहरण:
```
{
  "source_event_id": "12340873456",
  "destination": "[eTLD+1]",
  "expiry": "[64-bit signed integer]",
  "priority": "[64-bit signed integer]",
  "event_report_window": "[64-bit signed integer]"
}
```

ज़रूरी और वैकल्पिक एट्रिब्यूट

एचटीएमएल एलिमेंट का इस्तेमाल करते समय या सोर्स को रजिस्टर करने के लिए JavaScript कॉल करते समय, हो सकता है कि आपको attributionsrc या attributionReporting का इस्तेमाल करना पड़े. इनकी ज़रूरत कब होती है, इसके बारे में जानने के लिए नीचे दी गई टेबल देखें.

जब attributionsrc ज़रूरी नहीं है, तो इसका इस्तेमाल करने से पता चलता है कि अनुरोध को एट्रिब्यूशन रिपोर्टिंग के लिए मंज़ूरी दी गई है. अगर attributionsrc का इस्तेमाल किया जाता है, तो ब्राउज़र Attribution-Reporting-Eligible हेडर भेजता है. यह ऐप्लिकेशन-से-वेब को मापने के लिए भी उपयोगी है: अगर attributionsrc मौजूद है, तो ब्राउज़र Attribution-Reporting-Support हेडर भेजता है.

रजिस्ट्रेशन का तरीका	सोर्स
`<a>` टैग	(नेविगेशन सोर्स) `attributionsrc` ज़रूरी है.
`<img>` टैग	(इवेंट का सोर्स) `attributionsrc` ज़रूरी है.
`<script>` टैग	(इवेंट का सोर्स) `attributionsrc` ज़रूरी है.
`fetch` कॉल	`attributionReporting` विकल्प ज़रूरी है.
`XMLHttpRequest`	`attributionReporting` विकल्प ज़रूरी है.
`window.open()`	(नेविगेशन सोर्स) `attributionsrc` ज़रूरी है.

पहला चरण: सोर्स रजिस्ट्रेशन की प्रोसेस शुरू करें

क्लिक और व्यू के लिए, पहला चरण अलग है. हर टैब से जुड़े टैब खोलें.

किसी क्लिक के लिए, एट्रिब्यूशन सोर्स को रजिस्टर करने के लिए, <a> टैग या JavaScript window.open() का इस्तेमाल किया जा सकता है.

ऐंकर का इस्तेमाल करना

attributionsrc को उन मौजूदा <a> टैग में जोड़ें जिनके लिए आपको इंप्रेशन या क्लिक का आकलन करना है:

<a href="https://shoes.example/..." 
  attributionsrc>Click me</a>

ज़्यादा जानकारी के लिए, कोड का उदाहरण देखें.

स्क्रिप्ट का उपयोग करना

attributionsrc की मदद से window.open() को कॉल करें:

window.open(
  "https://shoes.example/...",
  "_blank",
  "attributionsrc");

ध्यान दें कि इस तरीके को उपयोगकर्ता के इंटरैक्शन के पांच सेकंड के अंदर ही कॉल किया जाना चाहिए.

attributionsrc को खुद जोड़ने के बजाय, किसी इमेज या स्क्रिप्ट के लिए सिर्फ़ एक यूआरएल वैल्यू तय की जा सकती है:

<a href=... attributionsrc="https://a.example/register-source">

JavaScript के मामले में, अगर attributionsrc को कोई वैल्यू दी जाती है, तो उस यूआरएल को कोड में बदलना न भूलें. इससे, अगर उसमें '=' जैसे विशेष वर्ण शामिल होते हैं, तो पैरामीटर को गलत तरीके से पार्स कर दिया जाएगा.

इस तरह कोड में बदलें:

const encodedUrl = encodeURIComponent(
  'https://adtech.example/attribution_source?ad_id=...');
window.open(
  "https://shoes.example/landing",
   "_blank",
   attributionsrc=${encodedUrl});

attributionsrc, यूआरएल के स्पेस से अलग की गई सूची भी ले सकता है, जैसा कि यहां ऐंकर टैग की मदद से दिखाया गया है:

<!-- With an anchor tag -->
<a href=... attributionsrc="https://a.example/register-source 
  https://b.example/register-source">

या window.open() के इस्तेमाल से, यहां मौजूद है.

// With window.open()
window.open('...', '_blank', attributionsrc=${encodedUrl1}
  attributionsrc=${encodedUrl2})

ऐसे मामलों में, दोनों यूआरएल को attributionsrc के navigation-source-eligible अनुरोध (ऐसे अनुरोध जिनमें Attribution-Reporting-Eligible हेडर शामिल होता है) मिलता है.

वैल्यू के साथ या उसके बिना `attributionsrc`

जैसा कि आपने पहले देखा था, बिना यूआरएल के attributionsrc तय किया जा सकता है. आप एक यूआरएल भी तय कर सकते हैं. इसके अलावा, सिर्फ़ सोर्स (ट्रिगर पर लागू नहीं) के लिए, स्पेस से अलग की गई यूआरएल वाली सूची का इस्तेमाल करें.

यूआरएल का इस्तेमाल करने से, ब्राउज़र अलग कीपअलाइव फ़ेच अनुरोध शुरू कर देता है—हर यूआरएल के लिए एक—जिसमें Attribution-Reporting-Eligible अनुरोध का हेडर शामिल होता है.

ऐसा तब किया जा सकता है, जब आपको एलिमेंट के मुख्य अनुरोध से अलग अनुरोध का जवाब देकर, सोर्स का रजिस्ट्रेशन करना हो.

उदाहरण के लिए, अगर आपको किसी ऐंकर एलिमेंट पर क्लिक के लिए सोर्स रजिस्टर करने हों, तो हो सकता है कि आपके पास डेस्टिनेशन का कंट्रोल न हो. इस मामले में, आपको एक कॉन्फ़िगरेशन की ज़रूरत होगी. इसमें सोर्स रजिस्ट्रेशन हेडर, नेविगेशन से अलग किसी अनुरोध के रिस्पॉन्स के तौर पर भेजें और इसे पूरी तरह से कंट्रोल करें. attributionsrc के लिए खास वैल्यू तय करने का मतलब है कि ब्राउज़र को यह अतिरिक्त अनुरोध करने का निर्देश दिया जा रहा है. साथ ही, इसका डेस्टिनेशन कॉन्फ़िगर किया जा रहा है.

व्यू रजिस्टर करने के पहले चरण के लिए, टैब पर जाएं और व्यू का पहला चरण चुनें.

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

इसके अलावा, JavaScript fetch() या XMLHttpRequest() का इस्तेमाल भी किया जा सकता है.

इमेज के साथ

<img attributionsrc
src="https://adtech.example/attribution_source?ad_id=..."/>

स्क्रिप्ट के साथ

<script attributionsrc
  src="https://adtech.example/attribution_source?ad_id=..."/>

इसके अलावा, attributionsrc के लिए यूआरएल वैल्यू ठीक उसी तरह तय की जा सकती है जैसे क्लिक के लिए दी जाती है. जैसे, किसी इमेज या स्क्रिप्ट के लिए , attributionsrc यूआरएल या यूआरएल इस तरह सेट किए जा सकते हैं:

एक यूआरएल होने पर:

 attributionsrc="https://adtech.example/attribution_source?ad_id=123"

यूआरएल की सूची के साथ:

  attributionsrc="https://a.example/register-source
    https://b.example/register-source"

`fetch()` या `XMLHttpRequest()` का इस्तेमाल किया जा रहा है

यह कोड असरदार तरीके से सिम्युलेट करता है कि attributionsrc के साथ एचटीएमएल अनुरोध करने पर क्या होगा:

// With fetch
const attributionReporting = {
  eventSourceEligible: true,
  triggerEligible: false,
};

// Optionally set keepalive to ensure the request outlives the page.
window.fetch("https://adtech.example/attribution_source?my_ad_id=123", { 
  keepalive: true, attributionReporting });

// With XHR
const attributionReporting = {
  eventSourceEligible: true,
  triggerEligible: false,
};

const req = new XMLHttpRequest();
  req.open('GET', url);
  req.setAttributionReporting(
    attributionReporting);
  req.send();

क्लिक रजिस्टर करने के पहले चरण के लिए, टैब पर जाएं और क्लिक का पहला चरण चुनें.

दूसरा चरण: हेडर के साथ जवाब देना (क्लिक और व्यू)

क्लिक और व्यू, दोनों के लिए अगला चरण Attribution-Reporting-Register-Source हेडर के साथ जवाब देना है.

ज़्यादा जानकारी के लिए, कोड का उदाहरण देखें.

सर्वर पर ब्राउज़र का अनुरोध मिलने पर, जवाब दें और अपने जवाब में Attribution-Reporting-Register-Source हेडर शामिल करें.

 res.set(
  'Attribution-Reporting-Register-Source',    
  JSON.stringify({
    // Use source_event_id to map it to any granular information
      // you need at ad-serving time
      source_event_id: '412444888111012',
      destination: 'https://advertiser.example',
      // Optional fields
      expiry: '604800',
      priority: '100',
      debug_key: '122939999'
    })
 );

स्ट्रिंग तय हो जाने के बाद, आपका हेडर कुछ ऐसा दिखेगा:

{"source_event_id":"412444888111012","destination":"https://advertiser.example","expiry":"604800","priority":"100","debug_key":"122939999"}

अगले चरण

एट्रिब्यूशन ट्रिगर रजिस्टर करने का तरीका जानें.