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

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

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

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

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

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

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

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

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

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

  1. ट्रिगर रजिस्ट्रेशन शुरू करें. अनुरोध करने के लिए, पिक्सल या fetch() कॉल का इस्तेमाल करें.

  2. ट्रिगर रजिस्ट्रेशन हेडर का इस्तेमाल करके, ट्रिगर रजिस्ट्रेशन पूरा करें.

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

    इस हेडर में, वह ट्रिगर डेटा डालें जिसे आपको रिपोर्ट में दिखाना है. कोई भी रिस्पॉन्स इस हेडर को सेट कर सकता है. जब तक यह 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
  }
}

सबडोमेन से जुड़ी समस्याएं हल करना

अगर 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,
};

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

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

अगले चरण

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