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

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

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

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

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

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

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

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

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

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

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

  2. ट्रिगर रजिस्ट्रेशन हेडर के साथ रिस्पॉन्स देकर, ट्रिगर रजिस्ट्रेशन को पूरा करें.

    पिक्सल का अनुरोध मिलने पर, यह अनुरोध आम तौर पर 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
  }
}

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

अगर 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 ensure 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"
});

अगले चरण

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