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

एट्रिब्यूशन ट्रिगर रजिस्टर करना

अपने कन्वर्ज़न की गिनती करने के लिए, एट्रिब्यूशन ट्रिगर को रजिस्टर करने का तरीका जानें.

एट्रिब्यूशन ट्रिगर वह इवेंट है जो ब्राउज़र को कन्वर्ज़न कैप्चर करने के लिए कहता है.

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

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

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

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

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

कन्वर्ज़न को एट्रिब्यूट करने के लिए ट्रिगर रजिस्टर करना

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

ट्रिगर के रजिस्ट्रेशन की प्रक्रिया शुरू करें. अनुरोध करने के लिए, Pixel या fetch() कॉल का इस्तेमाल करें.
ट्रिगर रजिस्ट्रेशन हेडर से जवाब देकर ट्रिगर रजिस्ट्रेशन पूरा करें.

पिक्सल का अनुरोध मिलने पर—या तो सामान्य src एट्रिब्यूट में तय किए गए एंडपॉइंट पर या अगर आपने attributionsrc का इस्तेमाल करने का विकल्प चुना है और उसे कोई वैल्यू दी है, तो उसे attributionsrc में तय किए गए एंडपॉइंट पर भेजा जाता है—हेडर Attribution-Reporting-Register-Trigger के साथ जवाब दें.

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

इवेंट-लेवल की रिपोर्ट के लिए उदाहरण:
```
{
  "event_trigger_data": [{
    "trigger_data": "[unsigned 64-bit integer]",
    "priority": "[signed 64-bit integer]",
    "deduplication_key": "[unsigned 64-bit integer]"
  }]
}
```

**Example for summary reports:**

```json
{
  ... // existing fields, such as "event_trigger_data"

  "aggregatable_trigger_data": [
   {
     "key_piece": "0x400",
     "source_keys": ["campaignCounts"]
   },
   {
     "key_piece": "0xA80",
     "source_keys": ["geoValue", "nonMatchingKeyIdsAreIgnored"]
   }
  ],
  "aggregatable_values": {
    "campaignCounts": 32768,
    "geoValue": 1664
  }
}
```
```

ध्यान दें: जब ब्राउज़र को किसी पेज पर, Attributionsrc यूआरएल से एट्रिब्यूशन ट्रिगर का जवाब मिलता है, तो लोकल स्टोरेज लुकअप से एक ऐसा सोर्स खोजा जाता है जो एट्रिब्यूशनsrc के ऑरिजिन और उस पेज के eTLD+1, दोनों से मेल खाता हो. <br> अगर एक से ज़्यादा सोर्स मिल जाते हैं, तो ब्राउज़र हाल ही में सेव किए गए सोर्स को चुनता है—जब तक कि सोर्स की अलग-अलग प्राथमिकताएं न हों और ब्राउज़र सबसे ज़्यादा प्राथमिकता वाले सोर्स को चुनता हो.

सबडोमेन मैनेज करना

अगर destination https://advertiser.example है, तो https://advertiser.example और इसके सबडोमेन, दोनों पर होने वाले कन्वर्ज़न, जैसे कि https://shop.advertiser.example को एट्रिब्यूट किया जा सकता है.

अगर destination की वैल्यू https://shop.advertiser.example है, तो https://advertiser.example और https://shop.advertiser.example, दोनों पर कन्वर्ज़न एट्रिब्यूट किए जा सकते हैं.

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

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

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

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

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

आप पिक्सल (<img> टैग) या स्क्रिप्ट टैग का इस्तेमाल करके ट्रिगर रजिस्टर कर सकते हैं.

नए या मौजूदा कन्वर्ज़न पिक्सल का इस्तेमाल करना

<img src="https://ad-tech.example/conversionpixel"
     attributionsrc="https://adtech.example/attribution_trigger?purchase=13">

अहम जानकारी: * src का ऑरिजिन, सोर्स का रजिस्ट्रेशन करने वाले ऑरिजिन से मेल खाना चाहिए. * एट्रिब्यूशन सिर्फ़ ऐसे पेज से ट्रिगर हो सकता है जिसका eTLD+1, सोर्स रजिस्ट्रेशन के दौरान डेस्टिनेशन में दी गई साइट से मेल खाता हो.

स्क्रिप्ट टैग का इस्तेमाल करना

आप किसी स्क्रिप्ट टैग के साथ ट्रिगर रजिस्ट्रेशन कर सकते हैं; यह <img> के जैसा काम करता है. यहां दिए गए कोड सैंपल, fetch() और XMLHttpRequest() (XHR) के इस्तेमाल के बारे में बताते हैं.

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

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

// 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 XMLHttpRequest:
const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

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

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

attributionsrc को वैल्यू के साथ या उसके बिना जोड़ा जा सकता है.

<!-- Without a value -->
<img src="..." width="1" height="1" attributionsrc>

<!--With a value (URL) -->
<img src="..." width="1" height="1" attributionsrc="https://...">

अगर attributionsrc के लिए एक वैल्यू सेट की जाती है, तो यह एक ही यूआरएल होना चाहिए.

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

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

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

दूसरा चरण: हेडर के साथ जवाब देना

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

JSON.stringify({event_trigger_data: [{
      trigger_data: '412444888111012',
      // Optional
      priority: '1000000000000',
      deduplication_key: '2345698765'
    }], debug_key: '1115698977'})

अगले चरण

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