एट्रिब्यूशन रिपोर्टिंग का इस्तेमाल शुरू करना

यहां पर सेटअप और खास जानकारी के साथ शुरुआत करने का तरीका बताया गया है.

रिपोर्ट टाइप चुनें

Attribution Reporting API का इस्तेमाल करके दो तरह की रिपोर्ट जनरेट की जा सकती हैं: इवेंट-लेवल और खास जानकारी वाली रिपोर्ट. एग्रीगेट की जा सकने वाली या खास जानकारी वाली रिपोर्ट की तुलना में, इवेंट-लेवल रिपोर्ट को कम सेटअप करना पड़ता है. इसलिए, शुरुआत करने के लिए ये एक अच्छी जगह हो सकती है. खास जानकारी वाली रिपोर्ट को एग्रीगेशन सेवा के साथ इंटिग्रेट करना ज़रूरी है; इवेंट-लेवल की रिपोर्ट में ऐसा नहीं होता.

इवेंट-लेवल और खास जानकारी वाली, दोनों रिपोर्ट के लिए रिपोर्टिंग सेट अप की जा सकती है. वे कॉम्प्लिमेंट्री हैं.

इवेंट-लेवल की रिपोर्ट

इवेंट-लेवल की रिपोर्ट किसी खास विज्ञापन पर क्लिक या व्यू (विज्ञापन की ओर मौजूद) को कन्वर्ज़न साइड के डेटा से जोड़ती हैं. सभी साइटों पर उपयोगकर्ता की पहचान को सीमित करके, उपयोगकर्ता की निजता बनाए रखने के लिए, कन्वर्ज़न साइड का डेटा बहुत सीमित होता है और इसमें ज़्यादा जानकारी नहीं होती.

खास जानकारी वाली रिपोर्ट

Attribution Reporting API और Private Aggregation API रिपोर्ट टाइप. खास जानकारी वाली रिपोर्ट में, उपयोगकर्ता का इकट्ठा किया गया डेटा शामिल होता है. साथ ही, इसमें ग़ैर-ज़रूरी डेटा के साथ कन्वर्ज़न का पूरा डेटा भी शामिल हो सकता है. खास जानकारी वाली रिपोर्ट, एग्रीगेट रिपोर्ट से बनी होती हैं. ये इवेंट-लेवल की रिपोर्टिंग की तुलना में ज़्यादा सुविधाएं देते हैं और बेहतर डेटा मॉडल उपलब्ध कराते हैं. खास तौर पर, कन्वर्ज़न वैल्यू जैसे कुछ इस्तेमाल के उदाहरणों के लिए.

लागू करना

शुरू करने के लिए, यहां दिया गया तरीका आज़माएं.

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

इवेंट-लेवल की रिपोर्ट जनरेट करना

इवेंट-लेवल की रिपोर्ट जनरेट करने के लिए, इन ज़रूरी चरणों को पूरा करें:

  1. सोर्स रजिस्टर करें. निर्देशों के लिए, एट्रिब्यूशन सोर्स रजिस्टर करना लेख पढ़ें. ध्यान दें कि क्लिक और व्यू के लिए कदम अलग-अलग होते हैं.

  2. ट्रिगर रजिस्टर करें. निर्देशों के लिए, एट्रिब्यूशन ट्रिगर रजिस्टर करें देखें.

  3. इस यूआरएल के साथ एंडपॉइंट सेट अप करें:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution.
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है POST तरीका देखने के लिए, adtech.js में उदाहरण कोड देखें और .well-known पर ज़्यादा जानकारी के लिए Wikipedia देखें.

ज़्यादा जानकारी के लिए, इवेंट लेवल की रिपोर्ट की जानकारी देखें.

खास जानकारी वाली रिपोर्ट जनरेट करना

खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, यह तरीका अपनाएं:

  1. सोर्स रजिस्टर करें. निर्देशों के लिए, एट्रिब्यूशन सोर्स रजिस्टर करना लेख पढ़ें. ध्यान दें कि क्लिक और व्यू के लिए कदम अलग-अलग होते हैं. अतिरिक्त जानकारी एट्रिब्यूशन सोर्स रजिस्ट्रेशन में देखी जा सकती है.

  2. ट्रिगर रजिस्टर करें. निर्देशों के लिए, एट्रिब्यूशन ट्रिगर रजिस्टर करें देखें.

  3. इस यूआरएल की मदद से, एग्रीगेट की जा सकने वाली रिपोर्ट के लिए एंडपॉइंट सेट अप करें:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution.
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है POST तरीका देखने के लिए, adtech.js में उदाहरण कोड देखें और .well-known पर ज़्यादा जानकारी के लिए Wikipedia देखें.

  4. एग्रीगेशन सेवा की मदद से आगे की प्रोसेस के लिए, रिपोर्ट का बैच बनाएं और भेजें. इससे खास जानकारी वाली रिपोर्ट तैयार की जाएगी. बैच की गई एग्रीगेट करने लायक रिपोर्ट देखें.

ज़्यादा जानकारी एग्रीगेटेबल रिपोर्ट एक्सप्लेनर में उपलब्ध है.

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

खास जानकारी में अतिरिक्त कॉन्सेप्ट को शामिल किया जाता है

यहां लागू करने के चरणों को समझने के अलावा, नीचे दी गई कॉन्सेप्ट से आपको समरी रिपोर्टिंग की रणनीति बनाने में भी मदद मिलेगी:

वैकल्पिक चरण

  1. फ़िल्टर सेट अप करें (ज़रूरी नहीं):
    1. इसमें दिए गए निर्देशों का पालन करें फ़िल्टर का इस्तेमाल करके कस्टम नियम तय करें.
    2. इकट्ठा की जा सकने वाली रिपोर्ट के फ़िल्टर से जुड़ी जानकारी की समीक्षा करें ट्रिगर सेक्शन में जानकारी देने वाला.

सुविधा की पहचान करना न भूलें

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

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

अगर सुविधा की पहचान करने वाली यह जांच सही नतीजे दिखाती है, तो एपीआई को उस कॉन्टेक्स्ट (पेज) में अनुमति दी जाती है जहां जांच की जाती है.

ध्यान दें कि सिर्फ़ जांच करने से इस बात की गारंटी नहीं मिलती कि एपीआई को उस पेज पर इस्तेमाल किया जा सकता है; हो सकता है कि उपयोगकर्ता ने अपनी ब्राउज़र सेटिंग का इस्तेमाल करके, एपीआई को बंद किया हो या ऐसी अन्य सेटिंग हों जो एपीआई को इस्तेमाल किए जाने से रोकती हों. उपयोगकर्ता की निजता को सुरक्षित रखने के लिए, प्रोग्राम के हिसाब से इसकी जांच करने का कोई तरीका नहीं है.

अगले चरण

अगर आप इन्हें लागू करने के लिए तैयार हैं, तो ये दस्तावेज़ देखें:

सेटअप

बैकग्राउंड

डेमो और टूल

प्लानिंग

अगर आप अब भी प्लान बना रहे हैं, तो इन दस्तावेज़ों को देखें: