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

सुझाव या राय देना

हाल ही के अपडेट

  • आने वाले समय में होने वाले बदलावों और पहले से मालूम समस्याओं की सूची को अपडेट किया गया है
  • लाइट-फ़्लेक्सिबल इवेंट-लेवल कॉन्फ़िगरेशन की शुरुआत की गई. फ़्लेक्सिबल इवेंट-लेवल कॉन्फ़िगरेशन
  • सितंबर 2023 से, registerWebSource, registerWebTrigger, registerAppSource और registerAppTrigger को उन फ़ील्ड के लिए स्ट्रिंग का इस्तेमाल करना चाहिए संख्या वाली वैल्यू हो सकती है (जैसे कि priority, source_event_id, debug_key, trigger_data, deduplication_key वगैरह)
  • साल 2023 की चौथी तिमाही में, Android Attribution Reporting API में Google Cloud की सहायता टीम Google पर एग्रीगेशन सेवा का इस्तेमाल करके खास जानकारी वाली रिपोर्ट जनरेट करने के लिए जोड़ा जाना चाहिए क्लाउड, ज़्यादा सटीक समय यहां दिखाया गया है. ज़्यादा जानकारी के लिए डिप्लॉयमेंट गाइड देखें Google Cloud के साथ एग्रीगेशन सेवा सेट अप करने के बारे में जानकारी.
  • यूनीक डेस्टिनेशन के लिए, निजता बनाए रखने की नई दर की सीमाएं.
  • लुकबैक विंडो ट्रिगर फ़िल्टर के लिए अपडेट की गई सुविधा, साल 2024 की पहली तिमाही में लॉन्च होगी. ज़्यादा जानकारी के लिए यह नोट देखें.

खास जानकारी

आज-कल मोबाइल एट्रिब्यूशन और परफ़ॉर्मेंस को जांचने वाले टूल का इस्तेमाल करना आम बात है क्रॉस-पार्टी आइडेंटिफ़ायर, जैसे कि विज्ञापन आईडी. Attribution Reporting API दूसरे पक्षों पर निर्भरता को हटाकर, उपयोगकर्ता की निजता को बेहतर बनाने के लिए डिज़ाइन किया गया है उपयोगकर्ता आइडेंटिफ़ायर और एट्रिब्यूशन और कन्वर्ज़न के इस्तेमाल के मुख्य उदाहरणों में मदद करने के लिए मेज़रमेंट के लिए इस्तेमाल किया जा सकता है.

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

पिछले सभी तरीके, उपयोगकर्ता की पहचान को दो यूआरएल से लिंक करने की सुविधा को सीमित करते हैं अलग-अलग ऐप्लिकेशन या डोमेन पर कैसे काम करते हैं.

Attribution Reporting API की मदद से, ये काम किए जा सकते हैं:

  • कन्वर्ज़न रिपोर्टिंग: विज्ञापन देने वाले लोगों या कंपनियों को उनकी परफ़ॉर्मेंस का आकलन करने में मदद करना उनका इस्तेमाल कैंपेन को कन्वर्ज़न (ट्रिगर) की संख्या और कन्वर्ज़न दिखाकर किया जाता है (ट्रिगर) अलग-अलग डाइमेंशन में वैल्यू का इस्तेमाल करें, जैसे कि कैंपेन, विज्ञापन ग्रुप के आधार पर, के बारे में बात करते हैं.
  • ऑप्टिमाइज़ेशन: इवेंट-लेवल की ऐसी रिपोर्ट उपलब्ध कराना जिनमें ऑप्टिमाइज़ेशन की सुविधा काम करती हो हर इंप्रेशन के लिए एट्रिब्यूशन डेटा उपलब्ध कराकर, विज्ञापन पर खर्च को कम किया जा सकता है. इस डेटा का इस्तेमाल इन कामों के लिए किया जा सकता है एमएल मॉडल को ट्रेन करें.
  • अमान्य गतिविधि का पता लगाना: ऐसी रिपोर्ट उपलब्ध कराएं जिनका इस्तेमाल अमान्य गतिविधि के लिए किया जा सके विज्ञापन से जुड़ी धोखाधड़ी की पहचान और विश्लेषण करता है.

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

  1. AdTech, रजिस्ट्रेशन की प्रक्रिया पूरी करती है, ताकि Attribution Reporting API का इस्तेमाल करना है.
  2. विज्ञापन टेक्नोलॉजी, एट्रिब्यूशन सोर्स रजिस्टर करती है—विज्ञापन क्लिक या व्यू—एट्रिब्यूशन रिपोर्टिंग एपीआई के साथ.
  3. AdTech ट्रिगर, एट्रिब्यूशन रिपोर्टिंग एपीआई के साथ विज्ञापन देने वाले के ऐप्लिकेशन या वेबसाइट पर.
  4. Attribution Reporting API, एट्रिब्यूशन सोर्स से ट्रिगर से मैच करता है—a कन्वर्ज़न एट्रिब्यूशन—और एक या ज़्यादा ट्रिगर डिवाइस से बाहर भेजे जाते हैं इवेंट-लेवल और विज्ञापन टेक्नोलॉजी से जुड़ी एग्रीगेट की जा सकने वाली रिपोर्ट.

Attribution Reporting API का ऐक्सेस पाना

Attribution Reporting API को ऐक्सेस करने के लिए, AdTech प्लैटफ़ॉर्म को रजिस्टर करना होगा. इसके बारे में जानने के लिए, ज़्यादा जानकारी के लिए, Privacy Sandbox खाते के लिए रजिस्टर करें.

एट्रिब्यूशन सोर्स रजिस्टर करना (क्लिक या व्यू)

Attribution Reporting API का मतलब, विज्ञापन पर हुए क्लिक और व्यू से है एट्रिब्यूशन स्रोत. विज्ञापन पर होने वाले क्लिक या विज्ञापन व्यू को रजिस्टर करने के लिए, registerSource() पर कॉल करें. यह एपीआई यहां दिए गए पैरामीटर की उम्मीद करता है:

  • एट्रिब्यूशन सोर्स यूआरआई: प्लैटफ़ॉर्म इस यूआरएल को अनुरोध भेजने के लिए यहां जारी करता है: का इस्तेमाल, एट्रिब्यूशन सोर्स से जुड़े मेटाडेटा को फ़ेच करने के लिए किया जाता है.
  • इनपुट इवेंट: कोई InputEvent ऑब्जेक्ट (क्लिक इवेंट के लिए) या null (व्यू इवेंट के लिए).

जब एपीआई, एट्रिब्यूशन सोर्स के यूआरआई को अनुरोध करता है, तो विज्ञापन टेक्नोलॉजी को नए एचटीटीपी हेडर में एट्रिब्यूशन सोर्स मेटाडेटा के साथ जवाब देना Attribution-Reporting-Register-Source में ये फ़ील्ड शामिल हैं:

  • सोर्स इवेंट आईडी: यह वैल्यू, इवेंट-लेवल से जुड़ा डेटा दिखाती है के साथ लिंक किया जाएगा (विज्ञापन पर क्लिक या व्यू). 64-बिट साइन नहीं होना चाहिए स्ट्रिंग के रूप में फ़ॉर्मैट किया गया पूर्णांक.
  • डेस्टिनेशन: ऐसा ऑरिजिन जिसका eTLD+1 या ऐप्लिकेशन पैकेज का नाम जहां ट्रिगर इवेंट होता है.
  • समयसीमा खत्म होने की तारीख (ज़रूरी नहीं): सोर्स को कब-कब खत्म होना चाहिए, इसकी जानकारी सेकंड में दें डिवाइस से मिटा दिया गया. डिफ़ॉल्ट तौर पर, यह अवधि 30 दिन की होती है. हालांकि, कम से कम एक दिन की समयसीमा सेट की जा सकती है और ज़्यादा से ज़्यादा 30 दिनों की वैल्यू डाली जा सकती है. इसे नज़दीकी दिन में बदल दिया जाता है. इनमें से कोई भी हो सकता है 64-बिट बिना हस्ताक्षर वाले पूर्णांक या स्ट्रिंग के फ़ॉर्मैट में होना चाहिए.
  • इवेंट की रिपोर्ट वाली विंडो (ज़रूरी नहीं): सोर्स के बाद सेकंड में कुल समय रजिस्ट्रेशन के दौरान, इस स्रोत के लिए इवेंट रिपोर्ट बनाई जा सकती हैं. अगर आपने इवेंट रिपोर्ट की विंडो बीत चुकी है, लेकिन समयसीमा खत्म नहीं हुई है, फिर भी ट्रिगर का मिलान किसी स्रोत से किया जा सकता है, लेकिन इवेंट रिपोर्ट उस ट्रिगर के लिए भेजा गया. समयसीमा खत्म होने की तारीख से ज़्यादा नहीं हो सकता. इसे इस रूप में फ़ॉर्मैट किया जा सकता है 64-बिट बिना हस्ताक्षर वाला पूर्णांक या स्ट्रिंग.
  • एग्रीगेट की जा सकने वाली रिपोर्ट विंडो (ज़रूरी नहीं): सोर्स के बाद सेकंड में कुल समय इस विज्ञापन के लिए आवेदन करने के दौरान, एग्रीगेटेबल रिपोर्ट बनाई जा सकती हैं स्रोत. समयसीमा खत्म होने की तारीख से ज़्यादा नहीं हो सकता. इसे 64-बिट में फ़ॉर्मैट किया जा सकता है साइन नहीं किया गया पूर्णांक या स्ट्रिंग.
  • सोर्स प्राथमिकता (ज़रूरी नहीं): इसका इस्तेमाल यह चुनने के लिए किया जाता है कि किस एट्रिब्यूशन सोर्स को अगर एक से ज़्यादा एट्रिब्यूशन हैं, तो दिया गया ट्रिगर उससे जुड़ा होना चाहिए सोर्स, ट्रिगर से जुड़े हो सकते हैं. 64-बिट में साइन किया हुआ होना चाहिए स्ट्रिंग के रूप में फ़ॉर्मैट किया गया पूर्णांक.

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

    ज़्यादा वैल्यू, ज़्यादा प्राथमिकताओं को दिखाती हैं.
  • इंस्टॉल और पोस्ट-इंस्टॉल एट्रिब्यूशन विंडो (ज़रूरी नहीं): इनका इस्तेमाल इन कामों के लिए किया जाता है: पोस्ट-इंस्टॉल इवेंट के लिए एट्रिब्यूशन तय करना, इस लेख में आगे बताया गया है.
  • डेटा फ़िल्टर करना (ज़रूरी नहीं): इसका इस्तेमाल, कुछ ट्रिगर को चुनिंदा तरीके से फ़िल्टर करने के लिए किया जाता है, और असरदार तरीके से उन्हें अनदेखा कर देते हैं. ज़्यादा जानकारी के लिए, यह देखें ट्रिगर फ़िल्टर सेक्शन पर जाएं.
  • एग्रीगेशन की (ज़रूरी नहीं): बताएं इसके लिए सेगमेंटेशन एग्रीगेट की जा सकने वाली रिपोर्ट.

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

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

यहां दिए गए चरण में, वर्कफ़्लो का एक उदाहरण दिया गया है:

  1. विज्ञापन टेक्नोलॉजी SDK टूल, एट्रिब्यूशन सोर्स का रजिस्ट्रेशन शुरू करने के लिए एपीआई को कॉल करता है, कॉल करने के लिए API के लिए यूआरआई तय करें:

    registerSource(
    Uri.parse("https://adtech.example/attribution_source?AD_TECH_PROVIDED_METADATA"),
    myClickEvent);

  2. एपीआई इन चीज़ों के लिए अनुरोध करता है: https://adtech.example/attribution_source?AD_TECH_PROVIDED_METADATA, इनमें से किसी एक हेडर का इस्तेमाल करके:

    <!-- For click events -->
Attribution-Reporting-Source-Info: navigation

<!-- For view events -->
Attribution-Reporting-Source-Info: event

  3. इस विज्ञापन टेक्नोलॉजी का एचटीटीपीएस सर्वर, इन हेडर के साथ जवाब देता है:

    Attribution-Reporting-Register-Source: {
    "destination": "android-app://com.advertiser.example",
    "source_event_id": "234",
    "expiry": "60000",
    "priority": "5"
}
Attribution-Reporting-Redirect:
https://adtechpartner1.example?their_ad_click_id=567
Attribution-Reporting-Redirect:
https://adtechpartner2.example?their_ad_click_id=890

  4. एपीआई, यहां दिए गए हर यूआरएल को एक अनुरोध भेजता है Attribution-Reporting-Redirect. इस उदाहरण में, विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाले दो पार्टनर के यूआरएल बताया गया होता है, तो एपीआई https://adtechpartner1.example?their_ad_click_id=567 और दूसरा अनुरोध https://adtechpartner2.example?their_ad_click_id=890 तक.

  5. इस विज्ञापन टेक्नोलॉजी का एचटीटीपीएस सर्वर, इन हेडर के साथ जवाब देता है:

    Attribution-Reporting-Register-Source: {
    "destination": "android-app://com.advertiser.example",
    "source_event_id": "789",
    "expiry": "120000",
    "priority": "2"
}

तीन नेविगेशन (क्लिक) एट्रिब्यूशन स्रोत पिछले चरण में दिखाए गए अनुरोध.

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

वेबव्यू उस इस्तेमाल के उदाहरण का इस्तेमाल करता है जिसमें ऐप्लिकेशन, विज्ञापन को रेंडर करने के लिए वेबव्यू. इसे वेबव्यू, registerSource() को सीधे बैकग्राउंड अनुरोध. यह कॉल, एट्रिब्यूशन सोर्स को ऐप्लिकेशन से जोड़ता है का इस्तेमाल करें. एम्बेड किए गए वेब कॉन्टेंट से सोर्स रजिस्टर करना जो ब्राउज़र में ही काम करता हो; एपीआई कॉलर और ऐप्लिकेशन, दोनों को सेटिंग एडजस्ट कर सकें. एट्रिब्यूशन स्रोत और ट्रिगर को रजिस्टर करें वेबव्यू एपीआई कॉल करने वालों के लिए निर्देशों और निर्देशों के लिए, वेबव्यू से एट्रिब्यूशन का सोर्स और रजिस्ट्रेशन को ट्रिगर करें आज़माएं.

विज्ञापन टेक्नोलॉजी, पूरे वेब और वेबव्यू में कॉमन कोड का इस्तेमाल करती हैं. इसलिए, वेबव्यू एचटीटीपी 302 को फ़ॉलो करता है मान्य रजिस्ट्रेशन को प्लैटफ़ॉर्म पर रीडायरेक्ट करता है और पास करता है. हम ऐसे इस स्थिति के लिए Attribution-Reporting-Redirect हेडर के साथ काम करने के लिए कहें, लेकिन अगर आप पर इसका असर हुआ है, तो हमसे संपर्क करें.

ट्रिगर (कन्वर्ज़न) रजिस्टर करें

विज्ञापन टेक्नोलॉजी से जुड़े प्लैटफ़ॉर्म, ट्रिगर रजिस्टर कर सकते हैं—कन्वर्ज़न जैसे कि इंस्टॉल या पोस्ट-इंस्टॉल इवेंट—registerTrigger() तरीके का इस्तेमाल करके.

registerTrigger() तरीके के लिए, ट्रिगर यूआरआई पैरामीटर का इस्तेमाल किया जाता है. एपीआई ट्रिगर से जुड़ा मेटाडेटा फ़ेच करने के लिए, इस यूआरआई को अनुरोध भेजता है.

एपीआई, रीडायरेक्ट को फ़ॉलो करता है. AdTech सर्वर से मिले रिस्पॉन्स में एचटीटीपी शामिल होना चाहिए Attribution-Reporting-Register-Trigger नाम का हेडर, जो दिखाता है कि के बारे में जानकारी होनी चाहिए. हेडर में मौजूद कॉन्टेंट ऐसा होना चाहिए JSON कोड में बदला गया और नीचे दिए गए फ़ील्ड शामिल करें:

  • ट्रिगर डेटा: ट्रिगर इवेंट की पहचान करने के लिए डेटा (क्लिक के लिए 3 बिट, 1 देखने के लिए बिट चुनें). स्ट्रिंग के तौर पर फ़ॉर्मैट किया गया 64-बिट वाला पूर्णांक होना चाहिए.
  • ट्रिगर प्राथमिकता (ज़रूरी नहीं): इस ट्रिगर की प्राथमिकता दिखाती है एक ही एट्रिब्यूशन सोर्स के दूसरे ट्रिगर की तुलना में. 64-बिट होना चाहिए स्ट्रिंग के रूप में फ़ॉर्मैट किया गया हस्ताक्षर वाला पूर्णांक. प्राथमिकता के बारे में ज़्यादा जानने के लिए इसलिए, रिपोर्टिंग पर असर डालने के लिए प्राथमिकता सेक्शन सेक्शन देखें.
  • डिडुप्लीकेशन पासकोड (ज़रूरी नहीं): इसका इस्तेमाल उन मामलों की पहचान करने के लिए किया जाता है जहां एक जैसी ट्रिगर को एक ही विज्ञापन टेक्नोलॉजी प्लैटफ़ॉर्म से कई बार रजिस्टर किया जाता है. एक ही एट्रिब्यूशन सोर्स का इस्तेमाल करें. यह 64-बिट वाला पूर्णांक होना चाहिए. स्ट्रिंग.
  • एग्रीगेशन की (ज़रूरी नहीं): A एग्रीगेशन कुंजियों के बारे में बताने वाली डिक्शनरी की सूची और किन एग्रीगेशन रिपोर्ट की वैल्यू एग्रीगेट की जानी चाहिए.
  • एग्रीगेशन वैल्यू (ज़रूरी नहीं): वैल्यू की वह लिस्ट जिसमें हर कुंजी के लिए योगदान दें.
  • फ़िल्टर (ज़रूरी नहीं): इनका इस्तेमाल, फ़िल्टर करने के लिए किया जाता है ट्रिगर या ट्रिगर करता है. ज़्यादा जानकारी के लिए, यह देखें ट्रिगर फ़िल्टर सेक्शन पर जाएं.

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

विज्ञापन टेक्नोलॉजी से जुड़ी कई कंपनियां, एक ही ट्रिगर इवेंट को रजिस्टर करने के लिए Attribution-Reporting-Redirect फ़ील्ड या registerTrigger() तरीका. हमारा सुझाव है कि आप डिडुप्लीकेशन कुंजी का इस्तेमाल करें फ़ील्ड को समान स्थिति में रिपोर्ट में डुप्लीकेट ट्रिगर शामिल करने से रोकें adTech से एक ही ट्रिगर इवेंट के लिए कई रिस्पॉन्स मिलते हैं. इसके बारे में ज़्यादा जानें डिडुप्लीकेशन कुंजी का इस्तेमाल कैसे और कब करें.

डेवलपर गाइड में ऐसे उदाहरण शामिल हैं जिनमें बताया गया है कि ट्रिगर रजिस्ट्रेशन स्वीकार करें.

यहां दिए गए चरण में, वर्कफ़्लो का एक उदाहरण दिया गया है:

  1. AdTech SDK, एपीआई को कॉल करता है, ताकि पहले से रजिस्टर किया गया यूआरआई. ज़्यादा जानकारी के लिए, Privacy Sandbox खाते के लिए रजिस्टर करें लेख देखें जानकारी.

    registerTrigger(
    Uri.parse("https://adtech.example/attribution_trigger?AD_TECH_PROVIDED_METADATA"));

  2. एपीआई इन चीज़ों के लिए अनुरोध करता है: https://adtech.example/attribution_trigger?AD_TECH_PROVIDED_METADATA.

  3. इस विज्ञापन टेक्नोलॉजी का एचटीटीपीएस सर्वर, इन हेडर के साथ जवाब देता है:

    Attribution-Reporting-Register-Trigger: {
    "event_trigger_data": [{
    "trigger_data": "1122",
    // This returns 010 for click-through conversions (CTCs) and 0 for
    // view-through conversions (VTCs) in reports
    "priority": "3",
    "deduplication_key": "3344"
    }],
}
Attribution-Reporting-Redirect: https://adtechpartner.example?app_install=567

  4. एपीआई, यहां दिए गए हर यूआरएल को एक अनुरोध भेजता है Attribution-Reporting-Redirect. इस उदाहरण में, सिर्फ़ एक यूआरएल बताया गया है, तो एपीआई https://adtechpartner.example?app_install=567.

  5. इस विज्ञापन टेक्नोलॉजी का एचटीटीपीएस सर्वर, इन हेडर के साथ जवाब देता है:

    Attribution-Reporting-Register-Trigger: {
"event_trigger_data":[{
  "trigger_data": "5566",
  "priority": "3",
  "deduplication_key": "3344"
}]
}

    पिछले चरण में किए गए अनुरोधों के आधार पर दो ट्रिगर रजिस्टर किए गए हैं.

एट्रिब्यूशन की सुविधाएं

नीचे दिए गए सेक्शन में बताया गया है कि Attribution Reporting API का मैच कैसे होता है कन्वर्ज़न ट्रिगर होते हैं.

सोर्स के लिए प्राथमिकता वाला एट्रिब्यूशन एल्गोरिदम लागू किया गया

Attribution Reporting API, सोर्स के लिए प्राथमिकता वाले एट्रिब्यूशन का इस्तेमाल करता है एल्गोरिदम का इस्तेमाल किया जाता है.

प्राथमिकता पैरामीटर की मदद से, ट्रिगर के एट्रिब्यूशन को पसंद के मुताबिक बनाया जा सकता है, ताकि स्रोत:

  • कुछ खास विज्ञापन इवेंट के लिए, दूसरे ट्रिगर के बजाय ट्रिगर को एट्रिब्यूट किया जा सकता है. उदाहरण के लिए, आपके पास व्यू या फ़ोकस के बजाय, क्लिक पर ज़्यादा फ़ोकस करने का विकल्प है कुछ कैंपेन के इवेंट पर.
  • एट्रिब्यूशन सोर्स को कॉन्फ़िगर करके, उसे इस तरह से ट्रिगर किया जा सकता है कि की दर की सीमाएं सेट करती हैं, तो आपको ऐसी रिपोर्ट मिलने की संभावना बढ़ जाती है आपके लिए महत्वपूर्ण हैं. उदाहरण के लिए, हो सकता है कि आप यह पक्का करना चाहें कि बिड लगाने लायक इनमें कन्वर्ज़न या ज़्यादा वैल्यू वाले कन्वर्ज़न, रिपोर्ट.

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

ट्रिगर फ़िल्टर

सोर्स और ट्रिगर रजिस्ट्रेशन में ऐसी अतिरिक्त सुविधाएं शामिल हैं जो करना ज़रूरी नहीं है निम्न:

  • कुछ ट्रिगर को बेहतर तरीके से अनदेखा करते हुए, उन्हें चुनिंदा तरीके से फ़िल्टर करें.
  • सोर्स डेटा के आधार पर इवेंट-लेवल रिपोर्ट के लिए ट्रिगर डेटा चुनें.
  • इवेंट-लेवल की रिपोर्ट से किसी ट्रिगर को बाहर रखने का विकल्प चुनें.

ट्रिगर को चुनिंदा तरीके से फ़िल्टर करने के लिए, विज्ञापन टेक्नोलॉजी, फ़िल्टर डेटा तय कर सकती है. इसमें शामिल है की और वैल्यू की पहचान की जा सकती है. अगर एक ही कुंजी स्रोत और ट्रिगर दोनों के लिए तय होता है, तो ट्रिगर को अनदेखा कर दिया जाता है, अगर चौराहा खाली है. उदाहरण के लिए, कोई सोर्स "product": ["1234"], जहां product फ़िल्टर कुंजी है और 1234 मान है. अगर ट्रिगर फ़िल्टर "product": ["1111"] पर सेट है, तो ट्रिगर को अनदेखा कर दिया जाता है. अगर कोई ट्रिगर फ़िल्टर कुंजी product से मेल खाती है, फिर फ़िल्टर को अनदेखा कर दिया जाता है.

ऐसा भी हो सकता है कि विज्ञापन टेक्नोलॉजी से जुड़े प्लैटफ़ॉर्म, ट्रिगर को चुनिंदा तरीके से फ़िल्टर करना चाहें एक छोटी समाप्ति अवधि लागू करना है. ट्रिगर रजिस्ट्रेशन पर, कोई विज्ञापन टेक्नोलॉजी कन्वर्ज़न होने के समय की लुकबैक विंडो तय करना (सेकंड में); इसके लिए उदाहरण के लिए, सात दिन की लुकबैक विंडो इस तरह दिखेगी: "_lookback_window": 604800 // 7d

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

विज्ञापन टेक्नोलॉजी से जुड़े प्लैटफ़ॉर्म, सोर्स इवेंट डेटा के आधार पर भी ट्रिगर डेटा चुन सकते हैं. इसके लिए उदाहरण के लिए, एपीआई से source_type अपने-आप जनरेट होता है navigation या event. ट्रिगर रजिस्ट्रेशन के दौरान, trigger_data को सेट किया जा सकता है "source_type": ["navigation"] के लिए एक मान और "source_type": ["event"].

अगर इनमें से कोई भी बात सही है, तो ट्रिगर को इवेंट-लेवल की रिपोर्ट से बाहर रखा जाता है:

  • कोई trigger_data मौजूद नहीं है.
  • स्रोत और ट्रिगर एक ही फ़िल्टर कुंजी का उल्लेख करते हैं, लेकिन मान मेल नहीं खाते. ध्यान दें कि इस मामले में, इवेंट-लेवल और इकट्ठा की जा सकने वाली रिपोर्ट.

ऐप्लिकेशन इंस्टॉल करने के बाद का एट्रिब्यूशन

कुछ मामलों में, पोस्ट-इंस्टॉल ट्रिगर को एट्रिब्यूट करने की ज़रूरत होती है वही एट्रिब्यूशन सोर्स जिसने इंस्टॉल को बढ़ावा दिया है. भले ही, ज़रूरी शर्तें पूरी करने वाले अन्य एट्रिब्यूशन स्रोत शामिल हैं, जो हाल ही में हुए हैं.

विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनियों को पोस्ट-इंस्टॉल सेट करने की अनुमति देकर, एपीआई इस इस्तेमाल के उदाहरण में मदद कर सकता है एट्रिब्यूशन की अवधि:

  • एट्रिब्यूशन सोर्स को रजिस्टर करते समय, इंस्टॉल एट्रिब्यूशन तय करें वह अवधि जिसके दौरान इंस्टॉल किए जाने की उम्मीद होती है (आम तौर पर, दो से सात दिन, स्वीकार किए जाते हैं) की सीमा 1 से 30 दिन तक है). इस समयावधि को सेकंड की संख्या के तौर पर बताएं.
  • एट्रिब्यूशन सोर्स को रजिस्टर करते समय, इंस्टॉल करने के बाद वाला एट्रिब्यूशन तय करें विशिष्टता विंडो, जहां कोई भी पोस्ट-इंस्टॉल ट्रिगर इवेंट होना चाहिए वह एट्रिब्यूशन सोर्स से जुड़ा होता है जिसकी वजह से इंस्टॉल हुआ (आम तौर पर, 7-30 दिन, 0 से 30 दिनों की रेंज में स्वीकार किया जाता है. इस समयावधि को सेकंड की संख्या.
  • Attribution Reporting API, ऐप्लिकेशन इंस्टॉल होने के बाद इसकी पुष्टि करता है और आंतरिक तौर पर, इंस्टॉल को सोर्स-प्राथमिकता वाले एट्रिब्यूशन को एट्रिब्यूट करता है स्रोत. हालांकि, विज्ञापन टेक्नोलॉजी से जुड़ी सेवा की मदद से इंस्टॉल को नहीं भेजा जाता और न ही इसे प्लैटफ़ॉर्म का दर सीमा सेट करें.
  • ऐप्लिकेशन इंस्टॉल करने की पुष्टि करने की सुविधा, डाउनलोड किए गए सभी ऐप्लिकेशन के लिए उपलब्ध है.
  • पोस्ट-इंस्टॉल एट्रिब्यूशन विंडो में ही आगे होने वाले कोई भी ट्रिगर उसी एट्रिब्यूशन स्रोत को एट्रिब्यूट किया जाता है जिसे पुष्टि किए गए इंस्टॉल के तौर पर एट्रिब्यूट किया जाता है, जैसे कि जब तक कि एट्रिब्यूशन सोर्स ज़रूरी शर्तों को पूरा न करता हो.

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

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

इवेंट इवेंट होने का दिन नोट
क्लिक 1 1 install_attribution_window 172800 (2 दिन) पर सेट हो, और post_install_exclusivity_window 864000 पर सेट है (10 दिन)
पुष्टि किया गया इंस्टॉल 2 यह एपीआई, पुष्टि किए गए इंस्टॉल को एट्रिब्यूट करता है, लेकिन वे इंस्टॉल उन्हें ट्रिगर नहीं माना जाता. इसलिए, इस रिपोर्ट में कोई रिपोर्ट नहीं भेजी जाती है अंक.
ट्रिगर 1 (फ़र्स्ट ओपन) 2 पहला ट्रिगर, विज्ञापन टेक्नोलॉजी से रजिस्टर किया गया. इस उदाहरण में, यह दिखाता है कि पहली बार खोला जाता है, लेकिन यह कोई भी ट्रिगर टाइप हो सकता है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है क्लिक 1 को एट्रिब्यूट किया गया (पुष्टि किए गए इंस्टॉल के एट्रिब्यूशन से मेल खाता है).
क्लिक 2 4 इसके लिए समान मानों का उपयोग करता है install_attribution_window और post_install_exclusivity_window क्लिक 1 के तौर पर
ट्रिगर 2 (इंस्टॉल के बाद) 5 दूसरा ट्रिगर, विज्ञापन टेक्नोलॉजी से रजिस्टर किया गया. इस उदाहरण में, यह दिखाता है कि जैसे कि पोस्ट-इंस्टॉल कन्वर्ज़न.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है क्लिक 1 को एट्रिब्यूट किया गया (पुष्टि किए गए इंस्टॉल के एट्रिब्यूशन से मेल खाता है).
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है क्लिक 2 को छोड़ दिया गया है और यह भावी एट्रिब्यूशन के लिए योग्य नहीं है.

नीचे दी गई सूची में, पोस्ट-इंस्टॉल करने के बारे में कुछ और जानकारी दी गई है विशेषता:

  • अगर पुष्टि किए गए इंस्टॉल, बताए गए दिनों के अंदर नहीं होते हैं install_attribution_window तक, पोस्ट-इंस्टॉल एट्रिब्यूशन लागू नहीं होगा.
  • पुष्टि किए गए इंस्टॉल, विज्ञापन टेक्नोलॉजी से जुड़ी कंपनियों के ज़रिए रजिस्टर नहीं किए जाते और उन्हें रिपोर्ट. इन्हें विज्ञापन टेक्नोलॉजी की दर सीमाओं में नहीं गिना जाता. पुष्टि किए गए इंस्टॉल का उपयोग केवल उस एट्रिब्यूशन स्रोत की पहचान करने के लिए किया जाता है जिसे इंस्टॉल.
  • पिछली टेबल के उदाहरण में, ट्रिगर 1 और ट्रिगर 2 फ़र्स्ट ओपन और पोस्ट-इंस्टॉल कन्वर्ज़न के तौर पर मिलते हैं. हालांकि, AdTech प्लैटफ़ॉर्म पर किसी भी तरह का ट्रिगर रजिस्टर किया जा सकता है. दूसरे शब्दों में, पहला वह पहला ओपन ट्रिगर नहीं होना चाहिए.
  • अगर post_install_exclusivity_window के बाद ज़्यादा ट्रिगर रजिस्टर किए जाते हैं की समयसीमा खत्म हो जाती है, तो क्लिक 1 अब भी एट्रिब्यूशन के लिए योग्य है, यह मानते हुए कि की समयसीमा खत्म हो चुकी है और इसकी दर सीमा पूरी नहीं हुई है.
    • ज़्यादा प्राथमिकता होने पर, हो सकता है कि क्लिक 1 अब भी न दिखे या खारिज कर दिया जाए एट्रिब्यूशन सोर्स रजिस्टर किया गया है.
  • अगर विज्ञापन देने वाले के ऐप्लिकेशन को अनइंस्टॉल करके फिर से इंस्टॉल किया जाता है, तो इसका मतलब है कि फिर से इंस्टॉल को नए पुष्टि किए गए इंस्टॉल के रूप में गिना जाता है.
  • अगर इसके बजाय क्लिक 1 एक व्यू इवेंट था, तो "फ़र्स्ट ओपन" दोनों और पोस्ट-इंस्टॉल हालांकि, ट्रिगर को अब भी एट्रिब्यूट किया जाता है. एपीआई, एट्रिब्यूशन को एक हर व्यू के हिसाब से ट्रिगर होता है. हालांकि, पोस्ट-इंस्टॉल एट्रिब्यूशन के मामले में ऐसा नहीं है जहां प्रति दृश्य दो ट्रिगर की अनुमति है. पोस्ट-इंस्टॉल एट्रिब्यूशन के मामले में, AdTech को दो अलग-अलग रिपोर्टिंग विंडो (दो दिन या सोर्स के हिसाब से) मिल सकती हैं समयसीमा खत्म होने वाली है या नहीं).

ऐप्लिकेशन और वेब पर आधारित ट्रिगर पाथ के सभी कॉम्बिनेशन काम करते हैं

Attribution Reporting API की मदद से इन ट्रिगर पाथ का एट्रिब्यूशन चालू होता है एक Android डिवाइस पर इस्तेमाल कर सकते हैं:

  • App-to-app: उपयोगकर्ता किसी ऐप्लिकेशन में विज्ञापन देखता है, तो उस या इंस्टॉल किए गए किसी अन्य ऐप्लिकेशन का इस्तेमाल किया जा सकता है.
  • App-to-web: उपयोगकर्ता किसी ऐप्लिकेशन में विज्ञापन देखता है, फिर मोबाइल में ग्राहक में बदल जाता है या ऐप ब्राउज़र खोलें.
  • Web-to-app: उपयोगकर्ता को किसी मोबाइल या ऐप्लिकेशन ब्राउज़र में कोई विज्ञापन दिखता है, फिर एक ऐप्लिकेशन में ग्राहक में बदलते हैं.
  • Web-to-web: उपयोगकर्ता को किसी मोबाइल या ऐप्लिकेशन ब्राउज़र में कोई विज्ञापन दिखता है, फिर एक ही ब्राउज़र या उसी डिवाइस पर किसी अन्य ब्राउज़र में रूपांतरण करता है.

हम वेब ब्राउज़र को वेब ब्राउज़र में उपलब्ध नई सुविधाओं के साथ काम करने की अनुमति देते हैं, जैसे के समान है Web's Attribution Reporting API के लिए प्राइवसी सैंडबॉक्स, जो ऐप्लिकेशन और वेब पर एट्रिब्यूशन चालू करने के लिए Android API को कॉल कर सकती है.

जानें कि विज्ञापन टेक्नोलॉजी और ऐप्लिकेशन में विज्ञापन टेक्नोलॉजी को बेहतर बनाने के लिए, आपको कौनसे बदलाव करने होंगे इसके लिए ट्रिगर पाथ क्रॉस ऐप्लिकेशन और वेब मेज़रमेंट के लिए भी उपलब्ध है.

एक ही एट्रिब्यूशन सोर्स के लिए कई ट्रिगर को प्राथमिकता देना

एक एट्रिब्यूशन सोर्स से कई ट्रिगर हो सकते हैं. उदाहरण के लिए, परचेज़ फ़्लो में "ऐप्लिकेशन इंस्टॉल" शामिल हो सकता है ट्रिगर, एक या ज़्यादा "कार्ट में जोड़ें" ट्रिगर, और "purchase" ट्रिगर होना चाहिए. हर ट्रिगर एक या उससे ज़्यादा को एट्रिब्यूट किया जाता है एट्रिब्यूशन के सोर्स, जो कि सोर्स के लिए प्राथमिकता वाला एट्रिब्यूशन एल्गोरिदम, इस लेख में आगे बताया गया है.

किसी एक एट्रिब्यूशन के लिए कितने ट्रिगर का क्रेडिट दिया जा सकता है, इसकी सीमाएं हैं source; ज़्यादा जानकारी के लिए, मेज़रमेंट डेटा देखना एट्रिब्यूशन रिपोर्ट बाद में पढ़ें. ऐसे मामलों में जहां से परे कई ट्रिगर को टेस्ट किया जा सकता है. इसलिए, का इस्तेमाल करें. उदाहरण के लिए, किसी विज्ञापन टेक्नोलॉजी, शायद "खरीदारी" को प्राथमिकता देना चाहे "कार्ट-में-जोड़ें" पर ट्रिगर होते हैं ट्रिगर हैं.

इस लॉजिक के साथ काम करने के लिए, ट्रिगर पर एक अलग प्राथमिकता फ़ील्ड सेट किया जा सकता है और सबसे ज़्यादा प्राथमिकता वाले ट्रिगर, सीमाएं लागू होने से पहले चुने जाते हैं. दी गई रिपोर्टिंग विंडो.

एक से ज़्यादा विज्ञापन टेक्नोलॉजी को एट्रिब्यूशन सोर्स या ट्रिगर रजिस्टर करने की अनुमति दें

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

ऐसे विज्ञापन देने वाले जो क्रॉस-नेटवर्क परफ़ॉर्म करने के लिए किसी तीसरे पक्ष का इस्तेमाल करना चाहते हैं नीचे दी गई तकनीक का इस्तेमाल करके, डुप्लीकेट कॉपी हटाने की तकनीक का इस्तेमाल जारी रखा जा सकता है:

  • एपीआई से रिपोर्ट पाने और रजिस्टर करने के लिए, इन-हाउस सर्वर सेट अप किया जा रहा है.
  • किसी मौजूदा मोबाइल मेज़रमेंट पार्टनर का इस्तेमाल जारी रखना.

एट्रिब्यूशन सोर्स

एट्रिब्यूशन सोर्स के रीडायरेक्ट, registerSource() तरीके में इस्तेमाल किए जाते हैं:

  1. registerSource() तरीके को कॉल करने वाली विज्ञापन टेक्नोलॉजी, अपने जवाब में अतिरिक्त Attribution-Reporting-Redirect फ़ील्ड जोड़ देते हैं, जो पार्टनर ऐड टेक के रीडायरेक्ट यूआरएल के सेट को दिखाता है.
  2. इसके बाद एपीआई, रीडायरेक्ट यूआरएल को कॉल करता है, ताकि एट्रिब्यूशन सोर्स विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली पार्टनर कंपनियों ने रजिस्टर किया हो.

एक से ज़्यादा पार्टनर की विज्ञापन टेक्नोलॉजी के यूआरएल, Attribution-Reporting-Redirect फ़ील्ड और पार्टनर विज्ञापन तकनीक से जुड़ी जानकारी नहीं हो सकती Attribution-Reporting-Redirect फ़ील्ड भरने की कोशिश कर रहे हैं.

एपीआई की मदद से, हर कॉल registerSource() के लिए, विज्ञापन टेक्नोलॉजी से जुड़ी अलग-अलग टेक्नोलॉजी का इस्तेमाल किया जा सकता है.

ट्रिगर

ट्रिगर रजिस्ट्रेशन के लिए, तीसरे पक्ष की सेवाएं इसी तरह से काम करती हैं: विज्ञापन टेक्नोलॉजी अतिरिक्त Attribution-Reporting-Redirect फ़ील्ड का इस्तेमाल कर सकते हैं या वे क्या हर व्यक्ति registerTrigger() तरीके को कॉल कर सकता है.

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

डुप्लीकेट ट्रिगर मैनेज करना

कोई विज्ञापन टेक्नोलॉजी, एपीआई की मदद से एक ही ट्रिगर को कई बार रजिस्टर कर सकती है. Scenarios निम्नलिखित शामिल करें:

  • उपयोगकर्ता एक ही कार्रवाई (ट्रिगर) कई बार करता है. उदाहरण के लिए, जब कोई उपयोगकर्ता एक ही रिपोर्टिंग में एक ही प्रॉडक्ट को कई बार ब्राउज़ करता है विंडो.
  • विज्ञापन देने वाले का ऐप्लिकेशन, कन्वर्ज़न मेज़रमेंट के लिए कई SDK टूल का इस्तेमाल करता है. सभी उपयोगकर्ताओं को एक ही विज्ञापन टेक्नोलॉजी पर रीडायरेक्ट करते हैं. उदाहरण के लिए, विज्ञापन देने वाले व्यक्ति या कंपनी का ऐप्लिकेशन, दो मेज़रमेंट पार्टनर, MMP #1 और MMP #2. दोनों एमएमपी, विज्ञापन टेक्नोलॉजी #3 पर रीडायरेक्ट करते हैं. ट्रिगर होने पर, दोनों एमएमपी उस ट्रिगर को एट्रिब्यूशन के साथ रजिस्टर करते हैं रिपोर्टिंग एपीआई. इसके बाद, AdTech #3 को दो अलग-अलग रीडायरेक्ट मिलते हैं. पहला रीडायरेक्ट एक ही ट्रिगर के लिए, MMP #1 और MMP #2 से एक.

ऐसे मामलों में, इवेंट-लेवल की रिपोर्ट को बंद करने के कई तरीके हैं. डुप्लीकेट ट्रिगर का इस्तेमाल किया जाता है, जिससे संभावित रूप से इवेंट-लेवल की रिपोर्ट पर लागू दर की सीमाएं. हमारा सुझाव है कि डुप्लीकेट कॉपी हटाने वाली कुंजी का इस्तेमाल करें.

सुझाया गया तरीका: डुप्लीकेट कॉपी हटाने वाली कुंजी

हमारा सुझाव है कि विज्ञापन देने वाला ऐप्लिकेशन, डुप्लीकेट कॉपी हटाने की यूनीक प्रोसेस को पास कर सके की मदद ली जा सकती है. जब कन्वर्ज़न होने के बाद ऐप्लिकेशन, विज्ञापन टेक्नोलॉजी या SDK टूल को डुप्लीकेट कॉपी हटाने वाली कुंजी पास करता है. इसके बाद, ये विज्ञापन टेक्नोलॉजी या SDK टूल, डिडुप्लीकेशन कुंजी को रीडायरेक्ट के लिए पास करते रहते हैं Attribution-Reporting-Redirect में बताए गए यूआरएल में पैरामीटर का इस्तेमाल करके.

विज्ञापन टेक्नोलॉजी, दिए गए दिए गए ट्रिगर के साथ सिर्फ़ पहले ट्रिगर को रजिस्टर करने का विकल्प चुन सकती हैं हटा सकता है या कई ट्रिगर या सभी ट्रिगर को रजिस्टर करने का विकल्प चुन सकता है. डुप्लीकेट रजिस्टर करते समय, AdTech की मदद से deduplication_key तय किया जा सकता है ट्रिगर हैं.

अगर कोई विज्ञापन टेक्नोलॉजी, डुप्लीकेट कॉपी हटाने वाली एक ही कुंजी के साथ कई ट्रिगर रजिस्टर करती है और एट्रिब्यूट किया गया सोर्स, इवेंट-लेवल पर सिर्फ़ रजिस्टर किया गया पहला ट्रिगर भेजा जाता है रिपोर्ट. डुप्लीकेट ट्रिगर अब भी एन्क्रिप्ट (सुरक्षित) की गई इकट्ठा की जा सकने वाली रिपोर्ट में भेजे जाते हैं.

दूसरा तरीका: विज्ञापन टेक्नोलॉजी, हर विज्ञापन देने वाले के ट्रिगर टाइप के हिसाब से तय होती हैं

ऐसे मामलों में, जहां विज्ञापन टेक्नोलॉजी, डुप्लीकेट कॉपी हटाने वाली कुंजी का इस्तेमाल नहीं करना चाहतीं या जहां अगर विज्ञापन देने वाला ऐप्लिकेशन, डुप्लीकेट कॉपी हटाने वाली कुंजी को पास नहीं कर पाता है, तो एक और विकल्प मौजूद है. किसी विज्ञापन देने वाले के लिए, कन्वर्ज़न को मेज़र करने वाली सभी विज्ञापन टेक्नोलॉजी को साथ मिलकर काम करना होगा का इस्तेमाल करें.

जिन विज्ञापन टेक्नोलॉजी से रजिस्ट्रेशन कॉल शुरू होती है (उदाहरण के लिए, SDK टूल) Attribution-Reporting-Redirect में बताए गए यूआरएल में पैरामीटर जोड़ें, जैसे duplicate_trigger_id. duplicate_trigger_id पैरामीटर में शामिल हो सकता है SDK टूल का नाम और विज्ञापन देने वाले व्यक्ति या कंपनी के ट्रिगर टाइप जैसी जानकारी. विज्ञापन टेक्नोलॉजी इसके बाद, इन डुप्लीकेट ट्रिगर का सबसेट इवेंट-लेवल की रिपोर्ट को भेजा जा सकता है. विज्ञापन टेक्नोलॉजी, अपनी एग्रीगेशन कुंजियों में इस duplicate_trigger_id को भी शामिल कर सकती हैं.

क्रॉस-नेटवर्क एट्रिब्यूशन का उदाहरण

इस सेक्शन में दिए गए उदाहरण में, विज्ञापन देने वाला व्यक्ति या कंपनी, दो विज्ञापनों का इस्तेमाल कर रही है टेक्नोलॉजी प्लैटफ़ॉर्म (Ad tech A और Ad tech B) और एक मेज़रमेंट पार्टनर (MMP).

शुरुआत करने के लिए, AdTech A, AdTech B, और MMP को अपने-आप रजिस्टर होने की प्रोसेस पूरी करनी होगी, ताकि Attribution Reporting API. Privacy Sandbox खाते के लिए रजिस्टर करना लेख पढ़ें ज़्यादा जानकारी देखें.

नीचे दी गई सूची में, उपयोगकर्ता की उन कार्रवाइयों की काल्पनिक सीरीज़ दी गई है जिनमें से हर एक दिन बाद होता है और Attribution Reporting API इन कार्रवाइयों को कैसे मैनेज करता है AdTech A, AdTech B, और MMP के हिसाब से:

पहला दिन: उपयोगकर्ता, AdTech A से दिखाए गए किसी विज्ञापन पर क्लिक करता है

विज्ञापन तकनीक A, registerSource() को उनके यूआरआई के साथ कॉल करती है. एपीआई इन चीज़ों के लिए अनुरोध करता है: यूआरआई और क्लिक को AdTech A के मेटाडेटा से रजिस्टर किया जाता है सर्वर प्रतिक्रिया.

विज्ञापन तकनीक A में Attribution-Reporting-Redirect में MMP का यूआरआई भी शामिल है हेडर. एपीआई, MMP के यूआरआई को अनुरोध भेजता है और क्लिक रजिस्टर किया जाता है MMP के सर्वर जवाब से मिले मेटाडेटा के साथ.

दूसरा दिन: उपयोगकर्ता, AdTech B से दिखाए गए विज्ञापन पर क्लिक करता है

AdTech B, registerSource() को उनके यूआरआई के साथ कॉल करता है. एपीआई इन चीज़ों के लिए अनुरोध करता है: यूआरआई और क्लिक को AdTech B's से मिले मेटाडेटा के साथ रजिस्टर किया जाता है सर्वर प्रतिक्रिया.

AdTech A की तरह, AdTech B ने भी इसमें MMP का यूआरआई शामिल किया है Attribution-Reporting-Redirect हेडर. एपीआई, MMP की यूआरआई, और क्लिक को MMP के सर्वर से मिले मेटाडेटा के साथ रजिस्टर किया जाता है जवाब.

तीसरा दिन: उपयोगकर्ता, AdTech A से मिले विज्ञापन को देखता है

एपीआई पहले दिन की तरह ही जवाब देता है, सिवाए इसके कि एक व्यू इसे Ad Tech A और MMP के लिए रजिस्टर किया गया है.

चौथा दिन: उपयोगकर्ता ने ऐप्लिकेशन इंस्टॉल किया है, जिसमें कन्वर्ज़न मेज़रमेंट के लिए MMP का इस्तेमाल किया जाता है

MMP, registerTrigger() को उसके यूआरआई के साथ कॉल करता है. एपीआई, यूआरएल और कन्वर्ज़न को MMP के सर्वर से मिले मेटाडेटा के साथ रजिस्टर किया जाता है जवाब.

MMP में Attribution-Reporting-Redirect हेडर. एपीआई, AdTech A को अनुरोध भेजता है और AdTech B के सर्वर पर सेव किया जाएगा. साथ ही, कन्वर्ज़न को तो सर्वर के रिस्पॉन्स का मेटाडेटा.

यहां दिए गए डायग्राम में, पिछली सूची में बताई गई प्रोसेस को दिखाया गया है:

Attribution Reporting API का उदाहरण यह उपयोगकर्ता की कार्रवाइयों की सीरीज़ का जवाब देता है.

एट्रिब्यूशन इस तरह काम करता है:

  • AdTech A, व्यू से ज़्यादा क्लिक की प्राथमिकता सेट करती है, ताकि वह इंस्टॉल जो पहले दिन क्लिक को एट्रिब्यूट किया गया.
  • विज्ञापन तकनीक B को दूसरे दिन एट्रिब्यूट किया गया इंस्टॉल मिलता है.
  • MMP, व्यू से ज़्यादा क्लिक की प्राथमिकता सेट करता है और इंस्टॉल करता है दूसरे दिन पर क्लिक को एट्रिब्यूट किया गया. दूसरे दिन का क्लिक सबसे ज़्यादा प्राथमिकता है, सबसे हाल का विज्ञापन इवेंट.

रीडायरेक्ट के बिना क्रॉस-नेटवर्क एट्रिब्यूशन

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

हाई लेवल फ़्लो

  1. सोर्स रजिस्ट्रेशन पर, विज्ञापन दिखाने वाला टेक्नोलॉजी नेटवर्क अपना सोर्स शेयर करता है एग्रीगेशन कुंजियां.
  2. ट्रिगर रजिस्ट्रेशन पर, विज्ञापन देने वाला या मेज़रमेंट पार्टनर यह चुनता है कि सोर्स-साइड मुख्य हिस्सों का इस्तेमाल करें. साथ ही, इनके एट्रिब्यूशन कॉन्फ़िगरेशन को तय करने के लिए भी किया जा सकता है.
  3. एट्रिब्यूशन, एट्रिब्यूशन कॉन्फ़िगरेशन, शेयर की गई कुंजी, और किसी भी सोर्स पर आधारित होता है जिन्हें विज्ञापन देने वाले या मेज़रमेंट पार्टनर ने असल में रजिस्टर किया हो (उदाहरण के लिए, विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाले किसी ऐसे नेटवर्क से लिया गया है जिसमें रीडायरेक्ट करने की सुविधा चालू है).
  4. अगर ट्रिगर, रीडायरेक्ट न होने वाले किसी विज्ञापन से जुड़े सोर्स को एट्रिब्यूट किया गया है टेक्नोलॉजी के बारे में, ऐडवर्टाइज़र या मेज़रमेंट पार्टनर को रिपोर्ट, जो सोर्स को जोड़ती है और चरण #2 में बताए गए मुख्य हिस्सों को ट्रिगर करती है.

सोर्स रजिस्ट्रेशन

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

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

रजिस्ट्रेशन ट्रिगर करें

ट्रिगर रजिस्ट्रेशन पर, मेज़रमेंट विज्ञापन टेक्नोलॉजी से यह तय होता है कि कौनसी सोर्स-साइड कुंजी हर ट्रिगर की ज़रूरी चीज़ पर लागू किए जाने वाले हिस्से. इनमें विज्ञापन के ज़रिए शेयर किए जाने वाले हिस्से भी शामिल हैं तकनीक.

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

एट्रिब्यूशन

Attribution Reporting API, सोर्स को प्राथमिकता के साथ आखिरी बार दिखाता है एट्रिब्यूशन कॉन्फ़िगरेशन के आधार पर, मेज़रमेंट विज्ञापन टेक्नोलॉजी के लिए एट्रिब्यूशन, शेयर किए गए पासकोड और रजिस्टर किए गए कोई भी सोर्स शामिल हैं. उदाहरण के लिए:

  • उपयोगकर्ता ने विज्ञापन टेक्नोलॉजी A, B, C, और D के ज़रिए दिखाए गए विज्ञापनों पर क्लिक किया. इसके बाद उपयोगकर्ता विज्ञापन देने वाले का ऐप्लिकेशन इंस्टॉल किया है. यह मेज़रमेंट ऐड टेक पार्टनर का इस्तेमाल करता है (एमएमपी).
  • AdTech A, अपने सोर्स को MMP पर रीडायरेक्ट करती है.
  • AdTech B और C, रीडायरेक्ट नहीं करते, बल्कि अपनी एग्रीगेशन कुंजियां शेयर करते हैं.
  • Ad Tech D, न तो एग्रीगेशन कुंजियों को रीडायरेक्ट करता है और न ही उन्हें शेयर करता है.

एमएमपी, AdTech A से सोर्स को रजिस्टर करता है और एट्रिब्यूशन कॉन्फ़िगरेशन के बारे में बताता है इनमें Ad Tech B और Ad Tech D शामिल है.

एमएमपी के लिए एट्रिब्यूशन में अब ये चीज़ें शामिल हैं:

  • AdTech A, क्योंकि एमएमपी ने विज्ञापन टेक्नोलॉजी के उस रीडायरेक्ट से सोर्स रजिस्टर किया था.
  • Ad tech B ने, क्योंकि Ad tech B ने अपनी कुंजियां शेयर की थीं और MMP ने इसे अपने एट्रिब्यूशन कॉन्फ़िगरेशन.

एमएमपी के लिए एट्रिब्यूशन में ये शामिल नहीं हैं:

  • AdTech C. ऐसा इसलिए, क्योंकि एमएमपी ने इसे अपने एट्रिब्यूशन कॉन्फ़िगरेशन में शामिल नहीं किया था.
  • AdTech D, क्योंकि उन्होंने न तो एग्रीगेशन कुंजियों को रीडायरेक्ट किया था और न ही उन्हें शेयर किया था.

डीबग करना

रीडायरेक्ट के बिना क्रॉस-नेटवर्क एट्रिब्यूशन को डीबग करने की सुविधा देने के लिए, shared_debug_key नाम का एक अतिरिक्त फ़ील्ड उपलब्ध है, जिसे विज्ञापन टेक्नोलॉजी से जुड़ी सेवाओं के लिए सेट किया जा सकता है सोर्स रजिस्ट्रेशन के लिए. अगर मूल सोर्स रजिस्ट्रेशन पर सेट किया जाता है, तो यह ट्रिगर रजिस्ट्रेशन के दौरान, इससे जुड़े डिराइव्ड सोर्स पर debug_key के रूप में सेट किया गया का इस्तेमाल किया जा सकता है. यह डीबग कुंजी इस तरह से अटैच की गई है इवेंट और एग्रीगेट रिपोर्ट में source_debug_key.

यह डीबग सुविधा, क्रॉस-नेटवर्क एट्रिब्यूशन के बिना ही नीचे दी गई स्थितियों में रीडायरेक्ट करता है:

  • ऐप्लिकेशन से ऐप्लिकेशन का मेज़रमेंट जहां विज्ञापन आईडी है अनुमति है
  • ऐप्लिकेशन टू वेब मेज़रमेंट जहां विज्ञापन आईडी की अनुमति है और जो सभी जगहों पर मेल खाते हैं ऐप्लिकेशन का सोर्स और वेब ट्रिगर, दोनों
  • वेब से वेब की परफ़ॉर्मेंस का आकलन ब्राउज़र ऐप्लिकेशन) जब ar_debug`, सोर्स और ट्रिगर, दोनों में मौजूद हो

रीडायरेक्ट के बिना क्रॉस-नेटवर्क एट्रिब्यूशन के लिए मुख्य खोज

मुख्य खोज का मकसद, विज्ञापन टेक्नोलॉजी (आम तौर पर एमएमपी) को लागू करने के तरीके को व्यवस्थित करना है क्रॉस-नेटवर्क एट्रिब्यूशन के मकसद से अपना एट्रिब्यूशन कॉन्फ़िगरेशन बनाया जा सकता है. ऐसा तब होता है, जब या विज्ञापन टेक्नोलॉजी से जुड़ी कई विज्ञापन टेक्नोलॉजी, शेयर की गई एग्रीगेशन कुंजियों का इस्तेमाल कर रही हैं. (जैसा कि रीडायरेक्ट के बिना क्रॉस-नेटवर्क एट्रिब्यूशन).

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

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

मुख्य खोज की सुविधा की शुरुआत:

  • एग्रीगेशन सेवा को अब पूरी जानकारी की ज़रूरत नहीं है एग्रीगेशन कुंजियां.
  • संभावित कुंजियों की पूरी सूची देने के बजाय, एमएमपी बना सकता है कुंजियों का एक खाली (या आंशिक रूप से खाली) सेट और एक थ्रेशोल्ड सेट करे, ताकि सिर्फ़ (पहले से तय नहीं की गई) थ्रेशोल्ड से ज़्यादा वैल्यू वाली कुंजियां, आउटपुट.
  • MMP को खास जानकारी वाली एक रिपोर्ट मिलती है. इसमें उन कुंजियों के लिए शोर वाली वैल्यू शामिल होती हैं जिनके मान तय सीमा से ज़्यादा हों. रिपोर्ट में ये चीज़ें भी शामिल हो सकती हैं ऐसी कुंजियां जिनके पास असली उपयोगकर्ता का कोई योगदान नहीं है और जो पूरी तरह से शोर वाली हैं.
  • MMP, ट्रिगर रजिस्ट्रेशन में x_network_bit_mapping फ़ील्ड का इस्तेमाल इन कामों के लिए करता है यह तय किया जा सकता है कि कौनसी विज्ञापन टेक्नोलॉजी किस कुंजी के साथ काम करती है.
  • इसके बाद, एमएमपी वैल्यू को समझने के लिए, विज्ञापन दिखाने वाली सही टेक्नोलॉजी से संपर्क कर सकता है को सोर्स कुंजी में शामिल करें.

खास जानकारी यह है कि कुंजी की खोज से, एमएमपी बिना किसी समस्या के एग्रीगेशन कुंजियां हासिल कर सकते हैं पहले से ही उनके बारे में पहले से जान लें और ज़्यादा सोर्स कुंजियों को प्रोसेस करने से बचें अतिरिक्त शोर की वजह से होता है.

एट्रिब्यूशन रिपोर्ट में मेज़रमेंट डेटा देखें

Attribution Reporting API की मदद से इस तरह की रिपोर्ट चालू होती हैं, जिनके बारे में जानकारी दी गई है इस पेज पर बाद में ज़्यादा जानकारी मिलेगी:

  • इवेंट-लेवल की रिपोर्ट में किसी खास इवेंट को हाई फ़िडेलिटी के सीमित बिट के साथ एट्रिब्यूशन सोर्स (क्लिक या व्यू) ट्रिगर डेटा.
  • यह ज़रूरी नहीं है कि एग्रीगेट की जा सकने वाली रिपोर्ट एक-दूसरे से जुड़ी हों इस्तेमाल किया जा सकता है. इन रिपोर्ट से बेहतर जानकारी मिलती है, इवेंट-लेवल की रिपोर्ट की तुलना में, हाई फ़िडेलिटी वाला डेटा ट्रिगर करता है. हालांकि, यह डेटा सिर्फ़ एग्रीगेट फ़ॉर्म में उपलब्ध है.

ये दोनों रिपोर्ट टाइप एक-दूसरे से जुड़ी हैं और इनका इस्तेमाल किया जा सकता है साथ-साथ

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

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

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

इवेंट-लेवल की रिपोर्ट में यह डेटा शामिल होता है:

  • डेस्टिनेशन: विज्ञापन देने वाले व्यक्ति या कंपनी के ऐप्लिकेशन के पैकेज का नाम या eTLD+1 जहां हुआ
  • एट्रिब्यूशन सोर्स आईडी: वही एट्रिब्यूशन सोर्स आईडी जिसका इस्तेमाल इनके लिए किया गया था एट्रिब्यूशन सोर्स रजिस्टर करना
  • ट्रिगर टाइप: लो-फ़िडेलिटी वाले ट्रिगर डेटा के एक या तीन बिट, जो एट्रिब्यूशन सोर्स का टाइप

निजता बनाए रखने के तरीके, सभी रिपोर्ट पर लागू किए गए

नीचे दी गई सीमाएं, एट्रिब्यूशन सोर्स से जुड़ी प्राथमिकताओं के बाद लागू होती हैं और ट्रिगर पर ध्यान दिया जाता है.

विज्ञापन टेक्नोलॉजी की संख्या की सीमाएं

रिपोर्ट रजिस्टर करने या पाने वाली विज्ञापन टेक्नोलॉजी की संख्या की सीमाएं हैं एपीआई से लिया गया है, जिसके लिए मौजूदा प्रस्ताव रखा गया है:

  • हर {source app, destination app, 30 के एट्रिब्यूशन सोर्स के साथ 100 विज्ञापन टेक्नोलॉजी दिन, device}.
  • हर {source ऐप्लिकेशन, डेस्टिनेशन ऐप्लिकेशन, 30 के लिए एट्रिब्यूट किए गए ट्रिगर के साथ 10 विज्ञापन तकनीकें दिन, device}.
  • विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली 20 कंपनियां, एक एट्रिब्यूशन सोर्स या ट्रिगर रजिस्टर कर सकती हैं Attribution-Reporting-Redirect)

यूनीक डेस्टिनेशन की संख्या की सीमाएं

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

  • रजिस्टर किए गए सभी सोर्स में, विज्ञापन की सभी टेक्नोलॉजी में एपीआई का इस्तेमाल हर सोर्स ऐप्लिकेशन के लिए, हर मिनट 200 से ज़्यादा यूनीक डेस्टिनेशन.
  • रजिस्टर किए गए सभी खातों में किसी एक विज्ञापन टेक्नोलॉजी के लिए, एपीआई 50 से ज़्यादा यूनीक सोर्स के साथ काम नहीं करता हर मिनट, हर सोर्स ऐप्लिकेशन के हिसाब से डेस्टिनेशन. यह सीमा, एक विज्ञापन टेक्नोलॉजी को ऊपर बताई गई दर सीमा में से पूरे बजट का इस्तेमाल करके.

किराये की सीमाओं में उन सोर्स की गिनती नहीं की जाती जिनकी समयसीमा खत्म हो चुकी है.

हर सोर्स ऐप्लिकेशन के लिए, हर दिन एक रिपोर्टिंग ऑरिजिन

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

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

  1. AdTech A का रिपोर्टिंग ऑरिजिन 1, ऐप्लिकेशन B पर सोर्स रजिस्टर करता है
  2. 12 घंटे बाद, AdTech A की रिपोर्टिंग के ऑरिजिन 2 ने सोर्स को रजिस्टर करने की कोशिश की ऐप्लिकेशन B पर

AdTech A के रिपोर्टिंग ऑरिजिन 2 के दूसरे सोर्स को एपीआई. AdTech A की रिपोर्टिंग ऑरिजिन 2, डेटा स्रोत उसी डिवाइस पर अगले दिन तक काम करेगा.

कूलडाउन और रेट लिमिट

किसी {source, destination} के बीच उपयोगकर्ता की पहचान लीक होने की मात्रा को सीमित करने के लिए जोड़ी है, तो एपीआई दिए गए समय में भेजी गई कुल जानकारी को थ्रॉटल करता है अवधि तय होती है.

मौजूदा प्रस्ताव में हर विज्ञापन टेक्नोलॉजी को, एट्रिब्यूट किए गए 100 ट्रिगर तक सीमित किया जाना है. {सोर्स ऐप्लिकेशन, डेस्टिनेशन ऐप्लिकेशन, 30 दिन, डिवाइस}.

यूनीक डेस्टिनेशन की संख्या

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

मौजूदा प्रस्ताव है कि हर विज्ञापन टेक्नोलॉजी को 100 अलग-अलग डेस्टिनेशन तक सीमित किया जाए. हर सोर्स ऐप्लिकेशन के लिए, जिनकी समयसीमा खत्म नहीं हुई है.

इवेंट-लेवल की रिपोर्ट पर, निजता बनाए रखने के तरीके लागू किए जाते हैं

ट्रिगर के डेटा की क्वालिटी सीमित है

एपीआई, व्यू-थ्रू ट्रिगर के लिए एक बिट और क्लिक-थ्रू के लिए तीन बिट मुहैया कराता है ट्रिगर हैं. एट्रिब्यूशन सोर्स, मेटाडेटा के पूरे 64 बिट के साथ काम करते रहते हैं.

आपको यह आकलन करना चाहिए कि ट्रिगर में बताई गई जानकारी को कम किया जाए या नहीं. अगर किया जाए, तो कैसे किया जाए इसलिए, ये इवेंट-लेवल रिपोर्ट में उपलब्ध सीमित बिट के साथ काम करते हैं.

डिफ़रेंशियल प्राइवसी नॉइज़ के लिए फ़्रेमवर्क

इस एपीआई का लक्ष्य, इवेंट-लेवल मेज़रमेंट को यह अनुमति देना है कि डिफ़रेंशियल प्राइवसी रिक्वेस्ट के लिए को-रैंडमाइज़्ड रिस्पॉन्स का इस्तेमाल करके हर सोर्स इवेंट के लिए नॉइज़ी आउटपुट.

शोर इस बात पर लागू होता है कि एट्रिब्यूशन सोर्स इवेंट को सही तरीके से रिपोर्ट किया गया है या नहीं. डिवाइस पर कोई एट्रिब्यूशन सोर्स रजिस्टर किया गया हो और उसकी 1-p $ संभावना हो एट्रिब्यूशन सोर्स, सामान्य तौर पर रजिस्टर किया गया है. साथ ही, इसकी संभावना $ p $ है डिवाइस, एपीआई की सभी संभावित आउटपुट स्थितियों में से किसी भी क्रम में चुन सकता है (इनमें किसी भी चीज़ की शिकायत न करना या एक से ज़्यादा फ़र्ज़ी रिपोर्ट की शिकायत करना शामिल है).

k-रैंडमाइज़्ड रिस्पॉन्स एक एल्गोरिदम है, जो epsilon डिफ़रेंशियली होता है निजी, अगर नीचे दिया गया समीकरण संतुष्ट है:

\[ p = \frac{k}{k + e^ε - 1} \]

DATE की कम वैल्यू के लिए, सही आउटपुट को k-रैंडम तरीके से सुरक्षित किया जाता है प्रतिक्रिया देने का तरीका. ग़ैर-ज़रूरी आवाज़ों के पैरामीटर पर काम चल रहा है और ये काम कर रहे हैं नीचे दिए गए एक प्रस्ताव के साथ अपने सुझाव, शिकायत या राय के आधार पर बदलाव करें:

  • नेविगेशन सोर्स के लिए p=0.24%
  • इवेंट सोर्स के लिए p=0.00025%

उपलब्ध ट्रिगर की सीमाएं (कन्वर्ज़न)

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

  • विज्ञापन व्यू एट्रिब्यूशन सोर्स के लिए एक या दो ट्रिगर (दो ट्रिगर सिर्फ़ पोस्ट-इंस्टॉल एट्रिब्यूशन के मामले में)
  • क्लिक विज्ञापन एट्रिब्यूशन सोर्स के लिए तीन ट्रिगर

रिपोर्ट भेजने के लिए खास टाइम विंडो (डिफ़ॉल्ट व्यवहार)

विज्ञापन व्यू एट्रिब्यूशन सोर्स के लिए, इवेंट-लेवल की रिपोर्ट, कन्वर्ज़न इवेंट की तारीख के एक घंटे बाद भेजी जाती हैं सोर्स की समयसीमा खत्म हो जाती है. ऐक्सेस खत्म होने की इस तारीख को कॉन्फ़िगर किया जा सकता है. हालांकि, यह एक से कम नहीं हो सकता दिन या 30 दिन से ज़्यादा हो. अगर किसी विज्ञापन व्यू के लिए दो ट्रिगर एट्रिब्यूट किए जाते हैं एट्रिब्यूशन सोर्स (पोस्ट-इंस्टॉल एट्रिब्यूशन के ज़रिए), इवेंट-लेवल की रिपोर्ट इसे रिपोर्टिंग विंडो के इंटरवल पर भेजा जाएगा. इसके बारे में नीचे बताया गया है.

विज्ञापन क्लिक एट्रिब्यूशन सोर्स के लिए, इवेंट-लेवल की रिपोर्ट कॉन्फ़िगर नहीं की जा सकतीं और सोर्स की समयसीमा खत्म होने से पहले या समयसीमा खत्म होने के बाद, एक-दूसरे से मिलते-जुलते समय पर भेजी जाती हैं जब तक सोर्स को रजिस्टर किया गया था. एट्रिब्यूशन सोर्स और एट्रिब्यूशन सोर्स के बीच का समय खत्म होने की अवधि को एक से ज़्यादा रिपोर्टिंग विंडो में बांट दिया गया है. हर रिपोर्टिंग विंडो में आखिरी तारीख (एट्रिब्यूशन सोर्स के समय से). हर रिपोर्टिंग के आखिर में विंडो में, डिवाइस सभी ट्रिगर को इकट्ठा करता है. पिछली रिपोर्टिंग विंडो पर क्लिक करता है और शेड्यूल की गई रिपोर्ट भेजता है. यह एपीआई, ये रिपोर्टिंग विंडो देखें:

  • 2 दिन: डिवाइस ऐसे सभी ट्रिगर इकट्ठा करता है जो ज़्यादा से ज़्यादा दो बार ट्रिगर होते हैं एट्रिब्यूशन सोर्स के रजिस्टर होने के बाद. यह रिपोर्ट दो दिन में भेजी जाती है एट्रिब्यूशन सोर्स के रजिस्टर होने के एक घंटे बाद.
  • सात दिन: डिवाइस उन सभी ट्रिगर को इकट्ठा करता है जो दो से ज़्यादा समय में ट्रिगर हुए थे एट्रिब्यूशन सोर्स के रजिस्टर होने के बाद सात दिन से ज़्यादा नहीं होना चाहिए. यह रिपोर्ट, एट्रिब्यूशन सोर्स के 7 दिन और 1 घंटे बाद भेजी जाती है रजिस्टर किया गया.
  • पसंद के मुताबिक समयसीमा, जिसे "समयसीमा खत्म होने" के आधार पर तय किया जाता है इसका एट्रिब्यूट एट्रिब्यूशन सोर्स. समयसीमा खत्म होने के एक घंटे बाद रिपोर्ट भेजी जाती है समय. यह वैल्यू 1 दिन से कम या 30 दिनों से ज़्यादा की नहीं हो सकती.

सुविधाजनक इवेंट-लेवल कॉन्फ़िगरेशन

इवेंट लेवल की रिपोर्टिंग के लिए डिफ़ॉल्ट कॉन्फ़िगरेशन को विज्ञापन टेक्नोलॉजी से जुड़ी सलाह दी जाती है इस्तेमाल करना शुरू कर दें, क्योंकि वे यूटिलिटी टेस्टिंग शुरू करते हैं. हालांकि, हो सकता है कि यह हर तरह के इस्तेमाल के लिए सही न हो मामले. Attribution Reporting API, वैकल्पिक और ज़्यादा लचीले पेज के साथ काम करता है. कॉन्फ़िगरेशन की मदद से, विज्ञापन टेक्नोलॉजी को साथ ही, डेटा का ज़्यादा से ज़्यादा फ़ायदा उठा सकती हैं.

यह अतिरिक्त सुविधा एट्रिब्यूशन रिपोर्टिंग में उपलब्ध होगी एपीआई के दो चरण हैं:

  • पहला चरण: इवेंट लेवल का लाइट कॉन्फ़िगरेशन
    • इस वर्शन में सभी सुविधाओं का सबसेट दिया गया है. इन्हें दूसरे चरण में अलग से इस्तेमाल किया जाता है.
  • दूसरा चरण: इवेंट लेवल के सुविधाजनक कॉन्फ़िगरेशन का पूरा वर्शन

पहले चरण (लाइट सुविधाजनक इवेंट लेवल) का इस्तेमाल इन कामों के लिए किया जा सकता है:

  • रिपोर्टिंग विंडो की संख्या तय करके, रिपोर्ट की फ़्रीक्वेंसी में बदलाव करें
  • हर सोर्स रजिस्ट्रेशन के हिसाब से एट्रिब्यूशन की संख्या में बदलाव होना
  • ऊपर दिए गए पैरामीटर को घटाकर, कुल गै़र-ज़रूरी डेटा को कम करें
  • डिफ़ॉल्ट के बजाय रिपोर्टिंग विंडो कॉन्फ़िगर करें

दूसरा चरण (इवेंट के सभी लेवल पर लागू होने वाला) का इस्तेमाल, ये सभी काम करने के लिए किया जा सकता है पहले चरण में ये सुविधाएँ उपलब्ध हैं और:

  • रिपोर्ट में ट्रिगर डेटा के एलिमेंट की संख्या में बदलाव करें
  • ट्रिगर डेटा के एलिमेंट की संख्या कम करके, कुल गै़र-ज़रूरी डेटा को कम करें

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

इसके अलावा, आपकी चुनी गई टेक्नोलॉजी के आधार पर गै़र-ज़रूरी डेटा को डाइनैमिक तरीके से सेट करने में कॉन्फ़िगरेशन के अनुसार, बड़े कंप्यूटेशन से बचने के लिए हमारे पास कुछ पैरामीटर सीमाएं होंगी लागत और कॉन्फ़िगरेशन बहुत ज़्यादा आउटपुट वाली स्थितियों के साथ (जहां शोर बढ़ जाएगा) पर्याप्त रूप से). यहां पाबंदियों के सेट का एक उदाहरण दिया गया है. सुझाव, राय या शिकायत के लिए [डिज़ाइन प्रस्ताव][50]:

  • दुनिया भर में और हर query_data की ज़्यादा से ज़्यादा कुल 20 रिपोर्ट
  • हर ट्रिगर_डेटा के लिए ज़्यादा से ज़्यादा पांच संभावित रिपोर्टिंग विंडो
  • ट्रिगर किए गए डेटा के लिए ज़्यादा से ज़्यादा 32 एलिमेंट की संख्या (पहले चरण: Lite के लिए लागू नहीं होता) सुविधाजनक इवेंट लेवल)

जैसे-जैसे विज्ञापन टेक्नोलॉजी इस सुविधा का इस्तेमाल शुरू कर रही हैं, ध्यान रखें कि एक्स्ट्रीम वैल्यू का इस्तेमाल करने से हो सकता है कि बहुत ज़्यादा शोर हो जाए. इसके अलावा, अगर निजता के स्तर हैं, तो शर्तों की पुष्टि नहीं हुई.

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

एग्रीगेट की जा सकने वाली रिपोर्ट का इस्तेमाल करने से पहले, आपको अपना क्लाउड खाता सेट अप करना होगा और इकट्ठा की जा सकने वाली रिपोर्ट मिलने शुरू हो जाएंगे.

इकट्ठा की जा सकने वाली रिपोर्ट में, डिवाइस से हाई फ़िडेलिटी वाला ट्रिगर डेटा मिलता है इवेंट-लेवल की रिपोर्ट में मिलने वाली सुविधाओं के मुकाबले काफ़ी जल्दी हो जाता है. यह हाई-फ़िडेलिटी डेटा सिर्फ़ एग्रीगेट में जाना जा सकता है, न कि किसी ट्रिगर या उपयोगकर्ता से जुड़ा होता है. एग्रीगेशन कुंजियों में ज़्यादा से ज़्यादा 128 वर्ण हो सकते हैं बिट शामिल हैं और इससे एग्रीगेट करने लायक रिपोर्ट को ऐसे मामलों में रिपोर्टिंग में मदद मिलती है जैसे:

  • रेवेन्यू जैसी ट्रिगर वैल्यू की रिपोर्ट
  • ज़्यादा ट्रिगर टाइप मैनेज करना

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

Attribution Reporting API को तैयार करने और उसे भेजने के तरीके का पूरा डिज़ाइन इस डायग्राम में दिखाई गई हैं:

  1. डिवाइस, विज्ञापन टेक्नोलॉजी को एन्क्रिप्ट (सुरक्षित) की गई एग्रीगेट की जा सकने वाली रिपोर्ट भेजता है. में प्रोडक्शन एनवायरमेंट के दौरान, विज्ञापन टेक्नोलॉजी से जुड़ी कंपनियां इन रिपोर्ट का सीधे तौर पर इस्तेमाल नहीं कर सकतीं.
  2. AdTech, एग्रीगेशन सेवा को इकट्ठा की जा सकने वाली रिपोर्ट का एक बैच भेजती है का इस्तेमाल करें.
  3. एग्रीगेशन सेवा इकट्ठा की जा सकने वाली रिपोर्ट के बैच को पढ़ती है, डिक्रिप्ट करती है और उन्हें इकट्ठा करे.
  4. फ़ाइनल एग्रीगेट को विज्ञापन तकनीक पर वापस भेजा जाता है खास जानकारी वाली रिपोर्ट.
Attribution Reporting API के ज़रिए इस्तेमाल की जाने वाली प्रोसेस एग्रीगेट की जा सकने वाली रिपोर्ट तैयार करने और उन्हें भेजने के लिए.

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

  • डेस्टिनेशन: ऐप्लिकेशन का पैकेज नाम या eTLD+1 वेब यूआरएल जहां ट्रिगर हुआ है.
  • तारीख: वह तारीख जब इवेंट को एट्रिब्यूशन सोर्स ने दिखाया हुआ.
  • पेलोड: ट्रिगर वैल्यू, जिन्हें एन्क्रिप्ट (सुरक्षित) किए गए की/वैल्यू पेयर के तौर पर इकट्ठा किया जाता है. का इस्तेमाल भरोसेमंद एग्रीगेशन सेवा में किया जाता है, कंप्यूट एग्रीगेशन.

एग्रीगेशन सेवाएं

नीचे दी गई सेवाएं, डेटा इकट्ठा करने की सुविधा मुहैया कराती हैं. साथ ही, इकट्ठा करने वाले डेटा के गलत ऐक्सेस के ख़िलाफ़ है.

इन सेवाओं को अलग-अलग पक्ष मैनेज करते हैं. इनके बारे में ज़्यादा जानकारी में बताया गया है इस पेज पर बाद में इस बारे में जानकारी:

  • सिर्फ़ एग्रीगेशन सेवा का इस्तेमाल विज्ञापन टेक्नोलॉजी की मदद से किया जाता है डिप्लॉय करें.
  • मुख्य मैनेजमेंट और एग्रीगेटेबल रिपोर्ट अकाउंटिंग की सेवाएं, भरोसेमंद कंपनी चलाती हैं कोऑर्डिनेटर नाम की अलग-अलग पार्टियों का स्वागत करता है. ये कोऑर्डिनेटर प्रमाणित करते हैं कि कोड एग्रीगेशन सेवा चलाने की अनुमति Google और सभी एग्रीगेशन सेवा के उपयोगकर्ताओं के पास एक ही कुंजी और उन पर लागू की गई एग्रीगेटेबल रिपोर्ट अकाउंटिंग सेवाएं.
एग्रीगेशन सेवा

विज्ञापन टेक्नोलॉजी से जुड़े प्लैटफ़ॉर्म को पहले से, ऐसी एग्रीगेशन सेवा को डिप्लॉय करना चाहिए जो उपयोगकर्ताओं की Google की ओर से उपलब्ध कराई गई बाइनरी पर.

यह एग्रीगेशन सेवा ट्रस्टेड एक्ज़ीक्यूशन एनवायरमेंट (टीईई) में काम करती है को क्लाउड पर होस्ट किया जाता है. TEE को सुरक्षा से जुड़े ये फ़ायदे मिलते हैं:

  • इससे यह पक्का होता है कि TEE में काम करने वाला कोड खास बाइनरी है इसे Google ने बनाया है. जब तक यह शर्त पूरी नहीं होती, तब तक एग्रीगेशन सेवा इसके लिए ज़रूरी डिक्रिप्शन कुंजियों को ऐक्सेस करना होगा.
  • यह प्रोसेस को सुरक्षित रखते हुए, उसे बाहरी प्रोसेस से अलग करता है निगरानी या छेड़छाड़ करना.

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

इसके डिज़ाइन, वर्कफ़्लो, और सुरक्षा से जुड़ी पहलुओं के बारे में ज़्यादा जानकारी पाने के लिए, एग्रीगेशन सेवा के बारे में जानने के लिए, एग्रीगेशन सेवा का दस्तावेज़ GitHub पर.

डिजिटल बटन को मैनेज करने की सेवा

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

एग्रीगेटेबल रिपोर्ट अकाउंटिंग

यह सेवा ट्रैक करती है कि AdTech की एग्रीगेशन सेवा ने कितनी बार खास ट्रिगर—जिसमें कई एग्रीगेशन कुंजियां हो सकती हैं—और यह ऐक्सेस को सीमित करता है डिक्रिप्शन की सही संख्या डालें. इसके लिए एग्रीगेशन सेवा देखें ज़्यादा जानकारी के लिए, Attribution Reporting API के डिज़ाइन का प्रस्ताव.

एग्रीगेशन रिपोर्ट एपीआई

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

इकट्ठा किए जा सकने वाले सोर्स डेटा को रजिस्टर करें

जब एपीआई, एट्रिब्यूशन सोर्स के यूआरआई को अनुरोध करता है, तो विज्ञापन टेक्नोलॉजी ये काम कर सकती है: एग्रीगेशन कुंजियों की सूची रजिस्टर करें. इसका नाम histogram_contributions है. इसके हिसाब से एचटीटीपी हेडर में aggregation_keys नाम के नए फ़ील्ड के साथ रिस्पॉन्स दिया जाता है Attribution-Reporting-Register-Source, जिसमें key_name और वैल्यू के तौर पर कुंजी है key_piece के तौर पर:

  • (कुंजी) कुंजी का नाम: कुंजी के नाम के लिए स्ट्रिंग. इन कामों के लिए 'जॉइन की' के तौर पर इस्तेमाल किया जाता है अंतिम कुंजी बनाने के लिए ट्रिगर-साइड कुंजियों के साथ संयोजित करें.
  • (वैल्यू) कुंजी का टुकड़ा: कुंजी के लिए बिटस्ट्रिंग की वैल्यू.

फ़ाइनल हिस्टोग्राम बकेट की कुंजी, ट्रिगर होने के समय पर इन हिस्सों और ट्रिगर-साइड के हिस्सों पर बाइनरी OR ऑपरेशन.

फ़ाइनल पासकोड ज़्यादा से ज़्यादा 128 बिट तक सीमित हैं; इस अवधि से लंबी कुंजियां काट-छांट की गई है. इसका मतलब है कि JSON में ज़्यादा से ज़्यादा हेक्स स्ट्रिंग का इस्तेमाल किया जाना चाहिए 32 अंक.

एग्रीगेशन कुंजियों के स्ट्रक्चर और उन्हें बनाने के तरीके के बारे में ज़्यादा जानें तो एग्रीगेशन कुंजियों को कॉन्फ़िगर किया जा सकता है.

नीचे दिए गए उदाहरण में, विज्ञापन टेक्नोलॉजी, एपीआई का इस्तेमाल करके इनकी जानकारी इकट्ठा करती है:

  • कैंपेन लेवल पर कन्वर्ज़न की कुल संख्या
  • भौगोलिक स्तर पर खरीदारी की एग्रीगेट वैल्यू
// This is where the Attribution-Reporting-Register-Source object appears when
// an ad tech registers an attribution source.

// Attribution source metadata specifying histogram contributions in aggregate report.
Attribution-Reporting-Register-Source:
…
aggregation_keys: {
  // Generates a "0x159" key piece named (low order bits of the key) for the key
  // named "campaignCounts".
  // User saw an ad from campaign 345 (out of 511).

  "campaignCounts": "0x159",
  // Generates a "0x5" key piece (low order bits of the key) for the key name "geoValue"
  // Source-side geo region = 5 (US), out of a possible ~100 regions.
  "geoValue": "0x5"
}

एग्रीगेटेबल ट्रिगर को रजिस्टर करें

ट्रिगर रजिस्ट्रेशन में दो अतिरिक्त फ़ील्ड शामिल होते हैं.

पहले फ़ील्ड का इस्तेमाल, ट्रिगर पर एग्रीगेट कुंजियों की सूची रजिस्टर करने के लिए किया जाता है की ओर. विज्ञापन टेक्नोलॉजी, aggregatable_trigger_data फ़ील्ड के साथ जवाब देगी एचटीटीपी हेडर Attribution-Reporting-Register-Trigger में, सूची में मौजूद हर एग्रीगेट कुंजी के लिए नीचे दिए गए फ़ील्ड:

  • मुख्य हिस्सा: कुंजी के लिए बिटस्ट्रिंग की वैल्यू.
  • सोर्स कुंजियां: एट्रिब्यूशन सोर्स साइड के नाम वाली स्ट्रिंग की सूची आखिरी कुंजियां बनाने के लिए ट्रिगर कुंजी को जोड़ना ज़रूरी है.

दूसरे फ़ील्ड का इस्तेमाल वैल्यू की सूची रजिस्टर करने के लिए किया जाता है. इन वैल्यू को को जोड़ा जा सकता है. विज्ञापन टेक्नोलॉजी, aggregatable_values फ़ील्ड के साथ जवाब देगी एचटीटीपी हेडर Attribution-Reporting-Register-Trigger में. दूसरा फ़ील्ड है का इस्तेमाल उन वैल्यू की सूची को रजिस्टर करने के लिए किया जाता है जिन्हें हर कुंजी में योगदान देना चाहिए. इससे हर कुंजी को $ [1, 2^{16}] $ की सीमा में पूर्णांक होना चाहिए.

हर ट्रिगर, इकट्ठा की जा सकने वाली रिपोर्ट में कई योगदान दे सकता है. कॉन्टेंट बनाने किसी सोर्स इवेंट में योगदान की कुल रकम पर L1 डॉलर तय होता है पैरामीटर, जो सभी में योगदान (वैल्यू) का ज़्यादा से ज़्यादा योग होता है दिए गए सोर्स के लिए एग्रीगेट बटन. $ L1 $ का मतलब L1 संवेदनशीलता या मानदंड से है हर सोर्स इवेंट के लिए, हिस्टोग्राम योगदान का. इन सीमाओं को पार करने से होने वाली वजहें आने वाले समय में, योगदान में तेज़ी से गिरावट आएगी. शुरुआती प्रस्ताव है कि $ L1 $ को सेट करें $ 2^{16} $ (65536).

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

यहां दिए गए उदाहरण में, निजता बजट को इनके बीच बराबर बांटा गया है campaignCounts और geoValue, दोनों के बीच $ L1 $ योगदान बांटकर:

// This is where the Attribution-Reporting-Register-Trigger object appears
// when an ad tech registers a conversion trigger.

// Specify a list of dictionaries that generates aggregation keys.
Attribution-Reporting-Register-Trigger:{
    …
    "aggregatable_trigger_data":

    [
    // Each dictionary independently adds pieces to multiple source keys.
    {
    // Conversion type purchase = 2 at a 9-bit offset, i.e. 2 << 9.
    // A 9-bit offset is needed because there are 511 possible campaigns, which
    // will take up 9 bits in the resulting key.
        "key_piece": "0x400",// Conversion type purchase = 2
        // Apply this key piece to:
        "source_keys": ["campaignCounts"]
    },
    {
    // Purchase category shirts = 21 at a 7-bit offset, i.e. 21 << 7.
    // A 7-bit offset is needed because there are ~100 regions for the geo key,
    // which will take up 7 bits of space in the resulting key.
        "key_piece": "0xA80",
        // Apply this key piece to:
        "source_keys": ["geoValue", "nonMatchingIdsListedHereAreIgnored"]
    }
    ]

    // Specify an amount of an abstract value which can be integers in [1, 2^16] to
    // contribute to each key that is attached to aggregation keys in the order that
    // they're generated.
    aggregatable_values:
    {
    // Privacy budget for each key is L1 / 2 = 2^15 (32768).
    // Conversion count was 1.
    // Scale the count to use the full budget allocated: 1 * 32768 = 32768.
        "campaignCounts": 32768,

    // Purchase price was $52.
    // Purchase values for the app range from $1 to $1,024 (integers only).
    // Scaling factor applied is 32768 / 1024 = 32.
    // For $52 purchase, scale the value by 32 ($52 * 32 = $1,664).
        "geoValue": 1664
    }
}

ऊपर दिए गए उदाहरण में इस तरह के हिस्टोग्राम योगदान जनरेट किए गए हैं:

[
  // campaignCounts:
  {
    "key": "0x559", // = 0x159 | 0x400
    "value": 32768
  },
  // geoValue:
  {
    "key": "0xA85",  // = 0x5 | 0xA80
    "value": 1664
  }
]

सही वैल्यू पाने के लिए, स्केलिंग फ़ैक्टर को उलटा जा सकता है, लागू किया गया मॉड्यूलो नॉइज़:

L1 = 65536
trueCampaignCounts = campaignCounts / (L1 / 2)
trueGeoValue = geoValue / (L1 / 2) * 1024

डिफ़रेंशियल प्राइवसी

इस एपीआई का मकसद ऐसा फ़्रेमवर्क उपलब्ध कराना है जो अलग तरीके से काम कर सके निजी एग्रीगेट मेज़रमेंट. इसके लिए, गै़र-ज़रूरी डेटा के अनुपात को जोड़कर ऐसा किया जा सकता है का बजट $ L1

\[ Laplace(\frac{L1}{ε}) \]

Protected Audience API और Attribution Reporting API का इंटिग्रेशन

Protected Audience और एट्रिब्यूशन रिपोर्टिंग में, क्रॉस-एपीआई इंटिग्रेशन एपीआई की मदद से, AdTech अलग-अलग प्लैटफ़ॉर्म पर अपने एट्रिब्यूशन की परफ़ॉर्मेंस का आकलन कर सकते हैं रीमार्केटिंग की रणनीतियों का इस्तेमाल करके यह समझा जा सकता है कि आपकी साइट पर किस तरह की ऑडियंस सबसे ज़्यादा आरओआई.

इस क्रॉस-एपीआई इंटिग्रेशन की मदद से, AdTech ये काम कर सकते हैं:

  • दोनों के लिए इस्तेमाल किए जाने के लिए यूआरआई का एक की-वैल्यू मैप बनाएं 1) इंटरैक्शन रिपोर्टिंग और 2) सोर्स रजिस्ट्रेशन.
  • एग्रीगेट करने के लिए, CustomAudience को सोर्स-साइड की मैपिंग में शामिल करें खास जानकारी वाली रिपोर्टिंग (Attribution Reporting API का इस्तेमाल करके).

जब कोई उपयोगकर्ता किसी विज्ञापन को देखता है या उस पर क्लिक करता है:

  • Protected Audience की मदद से, इंटरैक्शन की शिकायत करने के लिए इस्तेमाल किया जाने वाला यूआरएल भी व्यू या क्लिक को मंज़ूरी दिए गए सोर्स के तौर पर Attribution Reporting API.
  • विज्ञापन तकनीक कस्टम ऑडियंस (या अन्य प्रासंगिक प्रासंगिक) को पास करना चुन सकती है विज्ञापन प्लेसमेंट या देखने में बिताया गया कुल समय जैसी जानकारी) यूआरएल, ताकि यह मेटाडेटा विज्ञापन टेक्नोलॉजी से जुड़ी खास जानकारी वाली रिपोर्ट में कॉपी हो सके कैंपेन की कुल परफ़ॉर्मेंस की समीक्षा की जा रही है.

Protected Audience में इसे चालू करने के तरीके के बारे में ज़्यादा जानने के लिए, Protected Audience API के बारे में जानकारी देने वाला सेक्शन पढ़ें.

रजिस्ट्रेशन की प्राथमिकता, एट्रिब्यूशन, और रिपोर्टिंग के उदाहरण

इस उदाहरण में, उपयोगकर्ता के इंटरैक्शन का एक सेट दिखाया गया है. साथ ही, यह भी बताया गया है कि विज्ञापन टेक्नोलॉजी को कैसे परिभाषित किया जाता है एट्रिब्यूशन सोर्स और ट्रिगर की प्राथमिकताओं से, एट्रिब्यूट की गई रिपोर्ट पर असर पड़ सकता है. तय सीमा में हम नीचे दी गई शर्तों को पूरा करते हैं:

  • सभी एट्रिब्यूशन सोर्स और ट्रिगर, एक ही विज्ञापन टेक्नोलॉजी से रजिस्टर किए जाते हैं, ताकि उसी विज्ञापन देने वाले को टारगेट न करें.
  • सभी एट्रिब्यूशन सोर्स और ट्रिगर पहले इवेंट के दौरान हो रहे हैं (शुरुआत में विज्ञापन दिखाने के दो दिनों के अंदर) प्रकाशक ऐप्लिकेशन).

उस मामले पर विचार करें जहां उपयोगकर्ता निम्न करता है:

  1. उपयोगकर्ता को कोई विज्ञापन दिखता है. AdTech, एट्रिब्यूशन सोर्स को एपीआई के साथ रजिस्टर करता है. 0 की प्राथमिकता के साथ (#1 देखें).
  2. उपयोगकर्ता को एक विज्ञापन दिखता है, जो 0 की प्राथमिकता के साथ रजिस्टर किया गया है (व्यू #2).
  3. उपयोगकर्ता 1 की प्राथमिकता के साथ रजिस्टर किए गए किसी विज्ञापन पर क्लिक करता है (#1 पर क्लिक करें).
  4. जब कोई उपयोगकर्ता विज्ञापन देने वाले के ऐप्लिकेशन में ग्राहक में बदलता है (लैंडिंग पेज पर पहुंचता है). AdTech 0 (कन्वर्ज़न #1) की प्राथमिकता के साथ एपीआई के साथ एक ट्रिगर रजिस्टर करता है.
    • ट्रिगर के रजिस्टर होने पर एपीआई, एट्रिब्यूशन से पहले एट्रिब्यूशन करता है रिपोर्ट जनरेट करना.
    • तीन एट्रिब्यूशन सोर्स उपलब्ध हैं: व्यू #1, व्यू #2, और #1 पर क्लिक करें. एपीआई, इस ट्रिगर को #1 पर क्लिक करने का एट्रिब्यूट देता है, क्योंकि यह सबसे ज़्यादा प्राथमिकता मिलेगी और सबसे हाल की
    • व्यू #1 और व्यू #2 को खारिज कर दिया गया है और अब यह आने वाले समय में इस्तेमाल नहीं किया जा सकता एट्रिब्यूशन.
  5. उपयोगकर्ता, विज्ञापन देने वाले के ऐप्लिकेशन में अपने कार्ट में किसी आइटम को जोड़ता है. इसके लिए, यह तरीका अपनाया जाता है: 1 की प्राथमिकता (कन्वर्ज़न #2).
    • क्लिक #1 ही एट्रिब्यूशन का एक ऐसा सोर्स है जिसे मंज़ूरी दी गई है. एपीआई एट्रिब्यूट इस ट्रिगर को क्लिक #1 पर क्लिक करना होगा.
  6. उपयोगकर्ता, विज्ञापन देने वाले के ऐप्लिकेशन में अपने कार्ट में किसी आइटम को जोड़ता है. इसके लिए, यह तरीका अपनाया जाता है: 1 की प्राथमिकता (कन्वर्ज़न #3).
    • क्लिक #1 ही एट्रिब्यूशन का एक ऐसा सोर्स है जिसे मंज़ूरी दी गई है. एपीआई एट्रिब्यूट इस ट्रिगर को क्लिक #1 पर क्लिक करना होगा.
  7. उपयोगकर्ता, विज्ञापन देने वाले के ऐप्लिकेशन में अपने कार्ट में किसी आइटम को जोड़ता है. इसके लिए, यह तरीका अपनाया जाता है: 1 की प्राथमिकता (कन्वर्ज़न #4).
    • क्लिक #1 ही एट्रिब्यूशन का एक ऐसा सोर्स है जिसे मंज़ूरी दी गई है. एपीआई एट्रिब्यूट इस ट्रिगर को क्लिक #1 पर क्लिक करना होगा.
  8. उपयोगकर्ता, विज्ञापन देने वाले के ऐप्लिकेशन में खरीदारी करता है और उसे प्राथमिकता के साथ रजिस्टर करता है 2 में से (कन्वर्ज़न #5).
    • क्लिक #1 ही एट्रिब्यूशन का एक ऐसा सोर्स है जिसे मंज़ूरी दी गई है. एपीआई एट्रिब्यूट इस ट्रिगर को क्लिक #1 पर क्लिक करना होगा.

इवेंट-लेवल की रिपोर्ट में ये विशेषताएं होती हैं:

  • डिफ़ॉल्ट रूप से, क्लिक और पहले ट्रिगर को एट्रिब्यूट किए गए पहले तीन ट्रिगर उन रिपोर्टिंग विंडो के बाद भेजे जाते हैं जो एक व्यू के लिए एट्रिब्यूट किए गए हैं.
  • अगर रिपोर्टिंग विंडो में, उच्च के साथ रजिस्टर किए गए ट्रिगर हैं प्राथमिकता वाले ट्रिगर को प्राथमिकता दी जाती है और उन्हें प्राथमिकता दी जाती है और सबसे हाल के ट्रिगर की जगह ले ली जाती है.
  • पिछले उदाहरण में, विज्ञापन टेक्नोलॉजी को कन्वर्ज़न #2, कन्वर्ज़न #3, और कन्वर्ज़न #5 के लिए, दो दिन की रिपोर्टिंग विंडो.
    • सभी पांच ट्रिगर को क्लिक #1 के लिए एट्रिब्यूट किया जाता है. डिफ़ॉल्ट रूप से, एपीआई पहले 3 ट्रिगर के लिए रिपोर्ट भेजें: रूपांतरण #1, रूपांतरण #2, और कन्वर्ज़न #3.
    • हालांकि, कन्वर्ज़न #4 की प्राथमिकता (1), कन्वर्ज़न #1 की प्राथमिकता से ज़्यादा है प्राथमिकता (0). कन्वर्ज़न #4 की इवेंट रिपोर्ट, कन्वर्ज़न #1 की जगह ले रही है इवेंट रिपोर्ट भेजी जाएगी.
    • इसके अलावा, कन्वर्ज़न #5 की प्राथमिकता (2), किसी भी दूसरे कन्वर्ज़न से ज़्यादा है ट्रिगर होना चाहिए. कन्वर्ज़न #5 की इवेंट रिपोर्ट, कन्वर्ज़न #4 की रिपोर्ट को बदलकर यह करती है भेजा नहीं जा सकता.

इकट्ठा की जा सकने वाली रिपोर्ट में ये विशेषताएं होती हैं:

  • एन्क्रिप्ट (सुरक्षित) की गई एग्रीगेट की जा सकने वाली रिपोर्ट, विज्ञापन टेक्नोलॉजी से जुड़ी टीम को तुरंत भेज दी जाती हैं प्रोसेस किए जाएंगे और ट्रिगर के रजिस्टर होने के कुछ घंटों बाद.

    विज्ञापन टेक्नोलॉजी के तौर पर, आपके पास हमारे प्लैटफ़ॉर्म पर आने वाली जानकारी के आधार पर उनके बैच बनाने का विकल्प होता है एन्क्रिप्ट (सुरक्षित) नहीं की जाती हैं. यह जानकारी इसमें है आपकी एग्रीगेशन रिपोर्ट में shared_info फ़ील्ड होता है. साथ ही, इसमें टाइमस्टैंप होता है और रिपोर्टिंग ऑरिजिन. एन्क्रिप्ट (सुरक्षित) की गई किसी भी जानकारी के हिसाब से बैच नहीं बनाया जा सकता: आपके एग्रीगेशन के की-वैल्यू पेयर्स. ये कुछ आसान रणनीतियां हैं जिनका पालन किया जा सकता है रोज़ या हर हफ़्ते रिपोर्ट के बैच बनाना. आम तौर पर, बैच में कम से कम हर एक को 100 रिपोर्ट मिलती हैं.

  • यह विज्ञापन टेक्नोलॉजी पर निर्भर करता है कि इकट्ठा की जा सकने वाली रिपोर्ट को कब और कैसे तैयार किया जाए और एग्रीगेशन सेवा को भेजें.

  • इवेंट-लेवल की रिपोर्ट की तुलना में, एन्क्रिप्ट (सुरक्षित) की गई एग्रीगेट की जा सकने वाली रिपोर्ट किसी सोर्स को ज़्यादा ट्रिगर एट्रिब्यूट करना.

  • पिछले उदाहरण में, इकट्ठा की जा सकने वाली पांच रिपोर्ट भेजी गई हैं. हर रिपोर्ट के लिए एक रिपोर्ट भेजी जाएगी रजिस्टर किया गया ट्रिगर.

डीबगिंग रिपोर्ट की ट्रांज़िशनल रिपोर्ट

Attribution Reporting API, एट्रिब्यूशन करने का नया और काफ़ी जटिल तरीका है क्रॉस-ऐप्लिकेशन आइडेंटिफ़ायर के बिना मेज़रमेंट. इसलिए, हम पब्लिशर के लिए एट्रिब्यूशन रिपोर्ट के बारे में अधिक जानकारी प्राप्त करने का एक नया तरीका है जब विज्ञापन आईडी उपलब्ध हो (उपयोगकर्ता ने मनमुताबिक बनाने की सुविधा से ऑप्ट आउट नहीं किया है विज्ञापन आईडी का इस्तेमाल करके और पब्लिशर या विज्ञापन देने वाले के ऐप्लिकेशन ने विज्ञापन आईडी का एलान किया है अनुमतियां) में बदलें. इससे यह पक्का होता है कि एपीआई को रोल-आउट करना, सभी गड़बड़ियों को ठीक करने में मदद करना, और परफ़ॉर्मेंस की तुलना करना विज्ञापन आईडी के आधार पर उपलब्ध विकल्पों में से किसी एक को चुनना होगा. डीबग करने की रिपोर्ट दो तरह की होती हैं: ज़्यादा शब्दों में जानकारी दें.

डीबग करने के बारे में ज़्यादा जानकारी के लिए, ट्रांज़िशनल डीबगिंग रिपोर्ट से जुड़ी गाइड पढ़ें ऐप्लिकेशन-टू-वेब और वेब-टू-ऐप्लिकेशन मेज़रमेंट वाली रिपोर्ट.

एट्रिब्यूशन-सफलता डीबग करने की रिपोर्ट

सोर्स और ट्रिगर रजिस्ट्रेशन, दोनों ही 64-बिट debug_key का नया फ़ील्ड स्वीकार करते हैं (स्ट्रिंग के तौर पर फ़ॉर्मैट किया गया). इसे विज्ञापन की टेक्नोलॉजी अपने-आप भर देती है. source_debug_key और trigger_debug_key को इवेंट-लेवल और एग्रीगेट, दोनों में बिना किसी बदलाव के पास किया जाता है रिपोर्ट.

अगर सोर्स और ट्रिगर डीबग पासकोड, दोनों का इस्तेमाल करके रिपोर्ट बनाई गई है, तो एक डुप्लीकेट डीबग रिपोर्ट को .well-known/attribution-reporting/debug/report-event-attribution एंडपॉइंट. कॉन्टेंट बनाने डीबग रिपोर्ट, सामान्य रिपोर्ट जैसी होती हैं. इनमें, दोनों डीबग कुंजी फ़ील्ड शामिल होते हैं. दोनों में ये कुंजियां शामिल करने से सामान्य रिपोर्ट को अलग स्ट्रीम से जोड़ा जा सकता है डीबग रिपोर्ट.

  • इवेंट-लेवल की रिपोर्ट के लिए:
    • डुप्लीकेट डीबग रिपोर्ट सीमित समय के साथ भेजी जाती हैं. इसलिए, इन्हें उपलब्ध ट्रिगर की सीमा से कम की गई, जिससे विज्ञापन टेक्नोलॉजी को अनुमति मिलती है इवेंट-लेवल रिपोर्ट के लिए उन सीमाओं के असर को समझने के लिए.
    • गलत ट्रिगर इवेंट से जुड़ी इवेंट-लेवल की रिपोर्ट में trigger_debug_key. इससे AdTech को, यह समझने में मदद मिलती है कि नॉइज़ को एपीआई में लागू किया जाता है.
  • इकट्ठा की जा सकने वाली रिपोर्ट के लिए:
    • हम एक नया debug_cleartext_payload फ़ील्ड इस्तेमाल करेंगे जिसमें यह शामिल होगा डिक्रिप्ट किया गया पेलोड. ऐसा सिर्फ़ तब करें, जब source_debug_key और trigger_debug_key सेट हैं.

Verbose डीबग करने की रिपोर्ट

Verbose डीबगिंग रिपोर्ट की मदद से, डेवलपर एट्रिब्यूशन सोर्स या ट्रिगर रजिस्ट्रेशन का इस्तेमाल करता है. डीबग करने की ये रिपोर्ट भेजी जाती हैं एट्रिब्यूशन सोर्स के बाद सीमित समय के साथ या को अपनाएं.well-known/attribution-reporting/debug/verbose एंडपॉइंट.

हर वर्बोस रिपोर्ट में ये फ़ील्ड होते हैं:

  • टाइप: रिपोर्ट जनरेट होने की वजह. इनकी पूरी सूची देखें ज़्यादा शब्दों में जानकारी देने वाली रिपोर्ट के टाइप.
    • आम तौर पर, सोर्स वर्बोस रिपोर्ट और ट्रिगर वर्बोस रिपोर्ट होती हैं.
    • सोर्स वबोज़ रिपोर्ट के लिए ज़रूरी है कि विज्ञापन आईडी, और ट्रिगर वर्बोस रिपोर्ट के लिए विज्ञापन आईडी का होना ज़रूरी है विज्ञापन देने वाले के ऐप्लिकेशन में उपलब्ध होता है.
    • ज़्यादा जानकारी वाली रिपोर्ट ट्रिगर करें. हालांकि, इन रिपोर्ट में trigger-no-matching-source) विकल्प के तौर पर, source_debug_key को शामिल कर सकता है. इसे सिर्फ़ तब शामिल किया जा सकता है, जब विज्ञापन आईडी पब्लिश करने के लिए.
  • मुख्य हिस्सा: रिपोर्ट का मुख्य हिस्सा, जो उसके टाइप के आधार पर तय होता है.

AdTech को ऑप्ट-इन करना होगा, ताकि वे इसमें debug_reporting डिक्शनरी का फ़ील्ड है: Attribution-Reporting-Register_Source और Attribution-Reporting-Register-Trigger हेडर.

  • सोर्स वर्बोस रिपोर्ट के लिए, सिर्फ़ सोर्स रजिस्ट्रेशन हेडर पर ऑप्ट-इन करना ज़रूरी होता है.
  • ट्रिगर डीबग रिपोर्ट के लिए, सिर्फ़ ट्रिगर रजिस्ट्रेशन हेडर पर ऑप्ट-इन करना ज़रूरी है.

डीबग रिपोर्ट इस्तेमाल करने का तरीका

अगर कोई कन्वर्ज़न हुआ (आपके मौजूदा मेज़रमेंट सिस्टम के मुताबिक) और उस कन्वर्ज़न के लिए डीबग रिपोर्ट मिली थी, इसका मतलब यह है कि ट्रिगर रजिस्टर हो गया.

हर डीबग एट्रिब्यूशन रिपोर्ट के लिए, देखें कि आपको दो डीबग कुंजियों से मेल खाने वाली एट्रिब्यूशन रिपोर्ट.

कोई मैच उपलब्ध न होने की कई वजहें हो सकती हैं.

उम्मीद के मुताबिक काम करता है:

  • निजता बनाए रखने वाले एपीआई के काम करने का तरीका:
    • जब कोई उपयोगकर्ता, रिपोर्ट में लागू होने वाली दर की सीमा तक पहुंच जाता है. इस वजह से, बाद की सभी रिपोर्ट में ईमेल को इस समयावधि में भेजा गया हो; या समीक्षा बाकी होने की वजह से, सोर्स को हटाया गया हो डेस्टिनेशन की सीमा.
    • इवेंट-लेवल की रिपोर्ट के लिए: इस रिपोर्ट का जवाब किसी भी क्रम में दिया जा सकता है (शोर) और दबाई जाती है. इसके अलावा, आपको बिना किसी क्रम के रिपोर्ट भी मिल सकती है.
    • इवेंट-लेवल की रिपोर्ट के लिए: तीन (क्लिक के लिए) या एक (क्लिक के लिए) की सीमा तक पहुंच चुका है, और बाद की रिपोर्ट में प्राथमिकता सेट कर सकता है या प्राथमिकता सेट कर सकता है, जो मौजूदा रिपोर्ट से कम है.
    • इकट्ठा की जा सकने वाली रिपोर्ट के लिए, योगदान की सीमा पार हो गई है.
  • विज्ञापन टेक्नोलॉजी के हिसाब से कारोबारी नियम:
    • ट्रिगर को फ़िल्टर या प्राथमिकता के नियमों के ज़रिए फ़िल्टर करके बाहर निकाल दिया जाता है.
  • नेटवर्क की उपलब्धता के साथ इंटरैक्शन में लगने वाला समय या देरी (उदाहरण के लिए, जब उपयोगकर्ता को लंबे समय तक बंद रखना हो.

अनजाने में होने वाली वजहें:

  • लागू करने से जुड़ी समस्याएं:
    • सोर्स हेडर गलत तरीके से कॉन्फ़िगर किया गया है.
    • ट्रिगर हेडर गलत तरीके से कॉन्फ़िगर किया गया है.
    • कॉन्फ़िगरेशन से जुड़ी अन्य समस्याएं.
  • डिवाइस या नेटवर्क से जुड़ी समस्याएं:
    • नेटवर्क की शर्तों की वजह से काम नहीं कर रहा है.
    • रजिस्ट्रेशन से जुड़ा सोर्स या ट्रिगर का रिस्पॉन्स क्लाइंट तक नहीं पहुंच रहा.
    • एपीआई की गड़बड़ी.

आने वाले समय के लिए ध्यान देने वाली बातें और खुले सवाल

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

इसके अलावा, हम कुछ मुद्दों पर कम्यूनिटी से सुझाव पाना चाहते हैं:

  1. क्या कोई ऐसा उपयोग का मामला है जहां आप चाहते हैं कि API पुष्टि किया गया इंस्टॉल? इन रिपोर्ट को विज्ञापन टेक्नोलॉजी से जुड़े प्लैटफ़ॉर्म के मुकाबले दर सीमा सेट करें.
  2. क्या आपको ऐप्लिकेशन से InputEvent को पास करने में किसी भी समस्या का सामना करना पड़ रहा है सोर्स रजिस्ट्रेशन के लिए, AdTech से कैसे जुड़ें?
  3. क्या आपके पास पहले से लोड किए गए ऐप्लिकेशन के लिए, एट्रिब्यूशन के इस्तेमाल का कोई खास उदाहरण है या फिर से इंस्टॉल किए गए ऐप्लिकेशन हैं?