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

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

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

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

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

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

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

<img> टैग
<script> टैग
fetch कॉल
XMLHttpRequest

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

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

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

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

Pixel का अनुरोध मिलने पर—इन्हें या तो सामान्य 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]"
  }]
}
```
खास जानकारी वाली रिपोर्ट के लिए उदाहरण:
```
{
  ... // 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 यूआरएल से एट्रिब्यूशन ट्रिगर का रिस्पॉन्स मिलता है, तो लोकल स्टोरेज लुकअप का इस्तेमाल करके उस सोर्स को ढूंढा जाता है जो attributionsrc ऑरिजिन और डेस्टिनेशन साइट, दोनों से मेल खाता हो. अगर एक से ज़्यादा सोर्स मिलते हैं, तो ब्राउज़र उसे चुनता है जिसे सबसे हाल ही में सेव किया गया था. हालांकि, ऐसा तब ही होता है, जब सोर्स की प्राथमिकताएं अलग-अलग न हों. ऐसा होने पर ब्राउज़र, सबसे ज़्यादा प्राथमिकता वाले सोर्स को चुनता है.

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

अगर 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> टैग) या स्क्रिप्ट टैग का इस्तेमाल करके, ट्रिगर को रजिस्टर किया जा सकता है.

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

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

attributionsrc का ऑरिजिन, उस ऑरिजिन से मेल खाना चाहिए जिससे सोर्स रजिस्ट्रेशन किया गया है.

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

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

src का ऑरिजिन, उस ऑरिजिन से मेल खाना चाहिए जिससे सोर्स रजिस्ट्रेशन किया गया है.

<img src="https://adtech.example/conversionpixel"
     attributionsrc>

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

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

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

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

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

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

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 });

`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"
});

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

चेतावनी: event_trigger_data फ़ील्ड की वैल्यू को स्क्वेयर ब्रैकेट में नेस्ट किया जाना चाहिए, क्योंकि ब्राउज़र को JSON फ़ॉर्मैट में कलेक्शन चाहिए. यह फ़िल्टर के लिए काम का है.

अगले चरण

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

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

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

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

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

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

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

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

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

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

दूसरा चरण: हेडर का इस्तेमाल करके जवाब देना

अगले चरण

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