SKAdNetwork 4.0 गाइड: तीनों पोस्टबैक विंडो कैसे काम करती हैं

SKAdNetwork 4.0 मल्टी-विंडो एट्रिब्यूशन कैसे काम करता है? SKAdNetwork 4.0 कन्वर्जन माप को ऐप के पहली बार लॉन्च होने के बाद के दिनों (0–2, 3–7 और 8–35) को कवर करने वाली तीन क्रमिक विंडो में विभाजित करता है। Apple प्रत्येक ऐप डाउनलोड को एक पोस्टबैक डेटा टियर असाइन करता है, जो यह निर्धारित करता है कि योग्य पोस्टबैक में विस्तृत (fine-grained), मोटे (coarse-grained) या कम एट्रिब्यूशन डेटा प्रदर्शित होगा या नहीं।

SKAdNetwork 4.0 Apple का गोपनीयता-संरक्षित मोबाइल विज्ञापन एट्रिब्यूशन फ्रेमवर्क है जो iOS पर गोपनीयता-सुरक्षित कैंपेन माप को सक्षम बनाता है। यह पहली बार लॉन्च होने के बाद 35 दिनों तक की तीन क्रमिक कन्वर्जन विंडो, पदानुक्रमित स्रोत पहचानकर्ता (hierarchical source identifiers), मोटे कन्वर्जन मान और लगातार डिवाइस पहचान एकत्र किए बिना मिड-फनल यूजर लाइफटाइम वैल्यू का मूल्यांकन करने के लिए विंडो लॉकिंग तंत्र पेश करता है।

এক নজরে: প্রধান পোস্টব্যাক টাইমলাইন এবং প্রকাশ নিয়ম (एक नज़र में: मुख्य पोस्टबैक टाइमलाइन और प्रकटीकरण नियम)

• विंडो 1 (पहला लॉन्च होने के बाद 0–2 दिन): विस्तृत (0–63) या मोटे (low, medium, high) मान प्रदर्शित कर सकता है; अतिरिक्त यादृच्छिक 24–48 घंटे की देरी के बाद भेजा जाता है।
• विंडो 2 (पहला लॉन्च होने के बाद 3–7 दिन): पोस्टबैक डेटा टियर द्वारा प्रदान किए जाने और अनुमति दिए जाने पर coarse-conversion-value प्रदर्शित कर सकता है; अन्यथा वह फ़ील्ड अनुपस्थित होता है। अतिरिक्त यादृच्छिक 24–144 घंटे की देरी के बाद भेजा जाता है।
• विंडो 3 (पहला लॉन्च होने के बाद 8–35 दिन): पोस्टबैक डेटा टियर द्वारा प्रदान किए जाने और अनुमति दिए जाने पर coarse-conversion-value प्रदर्शित कर सकता है; अन्यथा वह फ़ील्ड अनुपस्थित होता है। अतिरिक्त यादृच्छिक 24–144 घंटे की देरी के बाद भेजा जाता है।
• टियर 0 डेटा बाधा: टियर 0 में आने वाले डाउनलोड को 2-अंकों की सोर्स आईडी और बिना किसी कन्वर्जन मान के एक ही पोस्टबैक प्राप्त होता है; दूसरा और तीसरा पोस्टबैक छोड़ दिया जाता है।
• मल्टीपल-पोस्टबैक आवश्यकता: एकाधिक विजेता पोस्टबैक के लिए पात्र होने के लिए, विज्ञापन को SKAdNetwork 4 या बाद के संस्करण का उपयोग करके साइन किया जाना चाहिए, और विज्ञापित ऐप को लागू कन्वर्जन विंडो के दौरान कन्वर्जन मानों को अपडेट करना चाहिए।

SKAdNetwork 4.0 क्या है और मल्टी-विंडो एट्रिब्यूशन कैसे काम करता है

एकल-टाइमर बाधाओं से मल्टी-विंडो लाइफसाइकेल ट्रैकिंग तक संरचनात्मक विकास

Apple के StoreKit Ad Network (SKAdNetwork 2.0 और 3.0) के शुरुआती संस्करण एक ही 24-घंटे के रोलिंगタイमर के तहत काम करते थे। SKAdNetwork 3 और उससे पहले, वैध बढ़ते कन्वर्जन-मान अपडेट 24-घंटे के टाइमर को रीस्टार्ट करके रोलिंग कन्वर्जन अवधि को बढ़ा सकते थे। एक बार जब अपडेट के बिना 24 घंटे बीत जाते थे, तो विंडो बंद हो जाती थी, और Apple यादृच्छिक देरी के बाद एक ही पोस्टबैक भेजता था।

इस सिंगल-टाइमर आर्किटेक्चर ने परिचालन संबंधी बाधाएं पैदा कीं:

• सीमित अवलोकन क्षितिज: विज्ञापनदाता केवल इंस्टॉलेशन के बाद के शुरुआती दिनों के दौरान होने वाली शुरुआती सहभागिता को माप सकते थे।
• रिपोर्टिंग में देरी: बार-बार योग्य कन्वर्जन अपडेट प्रभावी माप अवधि को बढ़ा सकते थे और अंतिम पोस्टबैक में देरी कर सकते थे, जिससे स्वचालित विज्ञापन बिडिंग एल्गोरिदम धीमे हो जाते थे।
• सीमित लॉन्ग-टेल विजिबिलिटी: संरचित Day-7-to-Day-30 माप के लिए SKAdNetwork 3 में कोई समर्पित बाद की कन्वर्जन विंडो नहीं थी।

SKAdNetwork 4.0 यूजर के पहले एप्लिकेशन लॉन्च से जुड़ी तीन निश्चित, क्रमिक माप विंडो स्थापित करके इस मॉडल को पुनर्गठित करता है।

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

SKAdNetwork 4.0 में, कन्वर्जन विंडो निरंतर यूजर गतिविधि के बजाय निश्चित कैलेंडर अवधि के आधार पर आगे बढ़ती हैं। जब किसी एट्रिब्यूटेड विज्ञापन इंप्रेशन के बाद पहली बार कोई ऐप खोला जाता है, तो ऑपरेटिंग सिस्टम विंडो 1 शुरू करता है।

चाहे यूजर पहले 48 घंटों के दौरान एप्लिकेशन को एक बार खोले या पचास बार, विंडो 1 48 घंटे के निशान पर बंद हो जाती है (जब तक कि विंडो लॉकिंग के माध्यम से इसे स्पष्ट रूप से समय से पहले अंतिम रूप न दिया जाए)। इसके बाद सिस्टम स्वचालित रूप से विंडो 2 (दिन 3 से दिन 7) पर आगे बढ़ता है, जिसके बाद विंडो 3 (दिन 8 से दिन 35) आती है। यह अलगाव डाउनस्ट्रीम डेटा पाइपलाइनों के लिए संरचित पोस्टबैक प्रेषण अंतराल की गारंटी देता है।

दो-चरणीय क्रिप्टोग्राफिक हस्ताक्षर श्रृंखला (Cryptographic Signature Chain)

SKAdNetwork दो अलग-अलग चरणों में पब्लिक-की क्रिप्टोग्राफी का उपयोग करके डेटा अखंडता बनाए रखता है:

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

यह भी देखें: SKAdNetwork ──> मोबाइल एट्रिब्यूशन मॉडल

तीन पोस्टबैक विंडो और माप समयसीमा की कार्यप्रणाली

विंडो 1: शुरुआती सहभागिता और उच्च-शुद्धता कन्वर्जन सिग्नलों को कैप्चर करना

• माप अंतराल: दिन 0 से दिन 2 (पहले लॉन्च के बाद पहले 48 घंटे)।
• उपलब्ध डेटा प्रकटीकरण: असाइन किए गए पोस्टबैक डेटा टियर द्वारा निर्धारित, ठीक कन्वर्जन मान (0 से 63 तक का 6-बिट पूर्णांक) या मोटा मान (low, medium, high)।
• यादृच्छिक पोस्टबैक देरी: विंडो बंद होने या लॉक होने के 24 से 48 घंटे बाद।
• विश्लेषणात्मक उद्देश्य: तत्काल ऑनबोर्डिंग पूर्ण होना, ट्यूटोरियल मील का पत्थर, प्रारंभिक खरीद कन्वर्जन, और शुरुआती चर्न जोखिम को मापना।

विंडो 2: शुरुआती यूजर रिटेंशन और मिड-फनल मील के पत्थरों का मूल्यांकन

• माप अंतराल: पहले लॉन्च के बाद दिन 3 से दिन 7 (घंटे 48 से 168)।
• उपलब्ध डेटा प्रकटीकरण: पोस्टबैक डेटा टियर द्वारा प्रदान किए जाने और अनुमति दिए जाने पर coarse-conversion-value (low, medium, high) प्रदर्शित कर सकता है; अन्यथा वह फ़ील्ड अनुपस्थित होता है। विंडो 2 में ठीक मान (0 से 63) समर्थित नहीं हैं।
• यादृच्छिक पोस्टबैक देरी: विंडो बंद होने या लॉक होने के 24 से 144 घंटे (1 से 6 दिन) बाद।
• विश्लेषणात्मक उद्देश्य: Day-3 से Day-7 रिटेंशन, बहु-दिवसीय सहभागिता लूप, प्रारंभिक सब्सक्रिप्शन ट्रायल, और बार-बार खरीदारी के व्यवहार का आकलन करना।

विंडो 3: लॉन्ग-टेल रिटेंशन और संचयी लाइफटाइम वैल्यू को मापना

• माप अंतराल: पहले लॉन्च के बाद दिन 8 से दिन 35 (घंटे 168 से 840)।
• उपलब्ध डेटा प्रकटीकरण: पोस्टबैक डेटा टियर द्वारा प्रदान किए जाने और अनुमति दिए जाने पर coarse-conversion-value (low, medium, high) प्रदर्शित कर सकता है; अन्यथा वह फ़ील्ड अनुपस्थित होता है।
• यादृच्छिक पोस्टबैक देरी: विंडो बंद होने या लॉक होने के 24 से 144 घंटे (1 से 6 दिन) बाद।
• विश्लेषणात्मक उद्देश्य: महीने-1 के रिटेंशन बेंचमार्क, ट्रायल-से-पैड सब्सक्रिप्शन कन्वर्जन, और लॉन्ग-टेल मुद्रीकरण मील के पत्थरों को कैप्चर करना।

विज्ञापन इंप्रेशन
      │
      ▼
ऐप इंस्टॉल
      │
      ▼
पहला ऐप लॉन्च  ← कन्वर्जन माप t = 0
      │
      ├── विंडो 1: पहले लॉन्च के बाद दिन 0–2
      │      ठीक या मोटा प्रकटीकरण
      │      बंद होने/लॉक होने के बाद 24–48 घंटे की यादृच्छिक देरी
      │
      ├── विंडो 2: पहले लॉन्च के बाद दिन 3–7
      │      केवल मोटा प्रकटीकरण (या अनुपस्थित)
      │      बंद होने/लॉक होने के बाद 24–144 घंटे की यादृच्छिक देरी
      │
      └── विंडो 3: पहले लॉन्च के बाद दिन 8–35
             केवल मोटा प्रकटीकरण (या अनुपस्थित)
             बंद होने/लॉक होने के बाद 24–144 घंटे की यादृच्छिक देरी

यादृच्छिक देरी की कार्यप्रणाली: विंडो 1 बनाम विंडो 2 और 3

टाइमिंग-अटैक हेरफेर को रोकने के लिए, जहां कोई ऑब्ज़र्वर इन-ऐप लेनदेन की सटीक मिलीसेकंड को एट्रिब्यूशन पोस्टबैक की प्राप्ति के साथ सहसंबद्ध करता है, Apple यादृच्छिक प्रेषण देरी लागू करता है:

• विंडो 1 टाइमर: यदि विंडो 1 बिना शुरुआती लॉक के स्वाभाविक रूप से बंद हो जाती है, तो पहला पोस्टबैक अतिरिक्त 24 से 48 घंटे की यादृच्छिक देरी के बाद भेजा जाता है।
• विंडो 2 और 3 टाइमर: माप अवधि की विस्तारित अवधि को ध्यान में रखते हुए Apple यादृच्छिक देरी विंडो को 24 से 144 घंटे (पूरे 6 दिन तक) तक बढ़ा देता है।

पोस्टबैक डेटा टियर प्रकटीकरण को कैसे नियंत्रित करते हैं

आधिकारिक पोस्टबैक डेटा टियर मैट्रिक्स

Apple स्रोत ऐप या डोमेन से जुड़े क्राउड, विज्ञापित ऐप, इंस्टॉल के देश और पदानुक्रमित स्रोत पहचानकर्ता के आधार पर ऐप डाउनलोड को एक पोस्टबैक डेटा टियर (टियर 0 से टियर 3) असाइन करता है। Apple टियर 0 से टियर 3 के लिए सार्वभौमिक इंस्टॉल-काउंट Thresholds (सीमाएं) प्रकाशित नहीं करता है।

पदानुक्रमित स्रोत पहचानकर्ता कैसे काम करते हैं

स्रोत पहचानकर्ता की संरचना और ग्रैनुलैरिटी

SKAdNetwork 4.0 पुराने 2-अंकों के कैंपेन आईडी को सोर्स आइडेंटिफ़ायर नामक 4-अंकों के पदानुक्रमित पूर्णांक से बदल देता है:

विज्ञापन नेटवर्क और डेवलपर आंतरिक रिपोर्टिंग आवश्यकताओं के आधार पर पदानुक्रमित स्रोत पहचानकर्ता के अर्थ को परिभाषित करते हैं:

• निचले दो अंक ($d_2 d_1$): पदानुक्रमित स्रोत पहचानकर्ता का न्यूनतम दो-अंकों वाला हिस्सा बनाते हैं जिसे प्रकट किया जा सकता है। विज्ञापन नेटवर्क व्यापक कैंपेन समूहीकरण के लिए इस हिस्से का उपयोग कर सकते हैं, लेकिन Apple कोई निश्चित व्यावसायिक अर्थ निर्धारित नहीं करता है।
• उच्च-क्रम के अंक ($d_4 d_3$): विज्ञापन प्लेसमेंट, क्रिएटिव आईडी, या भौगोलिक लक्ष्य जैसे आंतरिक आयामों को एन्कोड कर सकते हैं। Apple व्यक्तिगत अंकों को निश्चित व्यावसायिक सिमेंटिक्स असाइन नहीं करता है।

मूल स्रोत पहचानकर्ता: [ d4 ] [ d3 ] [ d2 ] [ d1 ]

पहले विजेता पोस्टबैक में संभावित प्रकट रूप:
2-अंकों का प्रकटीकरण:          [ d2 ] [ d1 ]
3-अंकों का प्रकटीकरण:    [ d3 ][ d2 ] [ d1 ]
4-अंकों का प्रकटीकरण: [ d4 ][ d3 ][ d2 ] [ d1 ]

प्रकट किए गए अंकों की सटीक संख्या Apple के पोस्टबैक डेटा टियर पर निर्भर करती है।

कैंपेन समेकन (consolidation) विशिष्ट स्रोत पहचानकर्ताओं से जुड़े क्राउड को बढ़ा सकता है, लेकिन Apple सार्वभौमिक इंस्टॉल सीमाएं प्रकाशित नहीं करता है और समेकन किसी विशिष्ट पोस्टबैक डेटा टियर की गारंटी नहीं देता है।

फाइन-ग्रेनेड (विस्तृत) बनाम कोर्स-ग्रेनेड (मोटे) कन्वर्जन मान

फाइन-ग्रेनेड कन्वर्जन मान

फाइन-ग्रेनेड कन्वर्जन मान 0 से 63 तक के पूर्णांकों का प्रतिनिधित्व करने वाली 6-बिट बाइनरी संख्याओं के रूप में काम करते हैं ($2^6 = 64$ अलग-अलग मान)। टियर 2 या टियर 3 पोस्टबैक डेटा टियर के तहत विशेष रूप से विंडो 1 में उपलब्ध, फाइन मान डेवलपर्स को दानेदार राजस्व श्रेणियों, फ़नल चरणों, या बिटवाइज़ इवेंट संयोजनों को एन्कोड करने की अनुमति देते हैं।

कोर्स-ग्रेनेड कन्वर्जन मान

जब लागू पोस्टबैक डेटा टियर फाइन-ग्रेनेड प्रकटीकरण की अनुमति नहीं देता है, तो कोर्स-ग्रेनेड कन्वर्जन मान कम-ग्रैनुलैरिटी विकल्प प्रदान करते हैं और दूसरे और तीसरे पोस्टबैक के लिए कन्वर्जन-मान प्रारूप के रूप में कार्य करते हैं। Apple low, medium, या high को कोई पूर्व निर्धारित व्यावसायिक सिमेंटिक्स असाइन नहीं करता है; नीचे दिए गए उदाहरण सांकेतिक एप्लिकेशन-परिभाषित मैपिंग हैं:

• low: बेसलाइन सहभागिता के लिए सांकेतिक मैपिंग (उदा., प्रारंभिक ऐप ओपन या पंजीकरण)।
• medium: मध्यम सहभागिता के लिए सांकेतिक मैपिंग (उदा., पूर्ण किया गया ट्यूटोरियल या बहु-दिवसीय सक्रिय सत्र)।
• high: उच्च-मूल्य कन्वर्जन मील के पत्थरों के लिए सांकेतिक मैपिंग (उदा., इन-ऐप खरीदारी या ट्रायल एक्टिवेशन)।

कार्यान्वयन-विशिष्ट कन्वर्जन स्कीमा डिज़ाइन के लिए, SKAN कन्वर्जन मैपिंग दस्तावेज़ देखें।

पोस्टबैक सीक्वेंस इंडेक्स मैपिंग

SKAdNetwork 4 पोस्टबैक में, postback-sequence-index फ़ील्ड संबंधित कन्वर्जन विंडो की पहचान करता है:

Apple निर्दिष्ट करता है कि एक इंस्टॉल-सत्यापन पोस्टबैक में या तो conversion-value (फाइन) या coarse-conversion-value (कोर्स) हो सकता है, लेकिन कभी भी दोनों एक साथ नहीं हो सकते।

नीचे दिए गए पेलोड सांकेतिक SKAdNetwork 4 उदाहरण हैं। वास्तविक पोस्टबैक फ़ील्ड पोस्टबैक अनुक्रम, पोस्टबैक डेटा टियर, विज्ञापन प्रकार और गोपनीयता प्रकटीकरण स्थितियों के आधार पर भिन्न होते हैं। नमूना attribution-signature मान प्लेसहोल्डर हैं और क्रिप्टोग्राफ़िक रूप से मान्य नहीं हैं।

नीचे दिया गया उदाहरण 1 विंडो 1 फाइन-ग्रेनेड पोस्टबैक पेलोड को दर्शाता है, और उदाहरण 2 विंडो 2 कोर्स-ग्रेनेड पोस्टबैक पेलोड को दर्शाता है:

{
  "version": "4.0",
  "ad-network-id": "example123.skadnetwork",
  "source-identifier": "4821",
  "app-id": 1234567890,
  "transaction-id": "6a8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "postback-sequence-index": 0,
  "conversion-value": 47,
  "fidelity-type": 1,
  "did-win": true,
  "attribution-signature": "MEQCIFz8...SAMPLE_CRYPTOGRAPHIC_SIGNATURE...=="
}

{
  "version": "4.0",
  "ad-network-id": "example123.skadnetwork",
  "source-identifier": "48",
  "app-id": 1234567890,
  "transaction-id": "6a8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "postback-sequence-index": 1,
  "coarse-conversion-value": "high",
  "fidelity-type": 1,
  "did-win": true,
  "attribution-signature": "MEQCIFz8...SAMPLE_CRYPTOGRAPHIC_SIGNATURE...=="
}

कन्वर्जन विंडो को समय से पहले लॉक करने के ट्रेड-ऑफ़

lockWindow पैरामीटर के साथ माप में तेजी लाना

डिफ़ॉल्ट रूप से, प्रत्येक माप विंडो अपनी पूरी कैलेंडर अवधि (विंडो 1 के लिए 48 घंटे, विंडो 2 के लिए 5 दिन, विंडो 3 के लिए 28 दिन) के लिए खुली रहती है। जब lockWindow true होता है, तो अपडेट सक्रिय विंडो के लिए अंतिम कन्वर्जन-मान अपडेट बन जाता है। सिस्टम पोस्टबैक तैयार करता है और उस विंडो के शेष समय के लिए अतिरिक्त कन्वर्जन-मान अपडेट को अनदेखा कर देता है।

डिफ़ॉल्ट विंडो 1 (कोई लॉक नहीं):
[पहला लॉन्च] ─────────────── 48 घंटे खुला ───────────────► [बंद होता है] ──► देरी (24-48h) ──► पोस्टबैक 1

लॉक की गई विंडो 1 (छठे घंटे पर खरीदारी):
[पहला लॉन्च] ── 6h (लॉक: true) ──► [कन्वर्जन मान लॉक / पोस्टबैक तैयार] ──► देरी (24-48h) ──► पोस्टबैक 1 जल्दी भेजा गया

विंडो लॉक लागू करते समय परिचालन संबंधी विचार

• त्वरित पोस्टबैक प्रेषण: जब किसी कन्वर्जन को समय से पहले अंतिम रूप दे दिया जाता है, तो पूरी कैलेंडर विंडो बीतने का इंतजार करने के बजाय, लॉक कन्वर्जन के अंतिम होते ही पोस्टबैक की देरी शुरू हो जाती है।
• विंडो स्वतंत्रता: वर्तमान विंडो को लॉक करने से अगली विंडो की शुरुआत आगे नहीं बढ़ती है। अगली कन्वर्जन विंडो अभी भी अपनी पूर्वनिर्धारित समय सीमा पर शुरू होती है (उदा., विंडो 1 कब लॉक हुई थी, इससे कोई फर्क नहीं पड़ता, विंडो 2 हमेशा दिन 3 पर शुरू होती है)।
• बाद की घटना का लॉकआउट: एक बार जब lockWindow: true निष्पादित हो जाता है, तो ऑपरेटिंग सिस्टम उस विशिष्ट विंडो के शेष समय के दौरान सभी बाद के कन्वर्जन मान अपडेट कॉल को अनदेखा कर देता है।

नीचे दिया गया Swift कोड यह प्रदर्शित करता है कि StoreKit का उपयोग करके ठीक और मोटे कन्वर्जन मानों को कैसे अपडेट करें और विंडो लॉक कैसे लागू करें:

import Foundation
import StoreKit

enum SKANError: Error {
    case invalidFineValue
    case unsupportedOSVersion
}

final class SKAN4Manager {

    static let shared = SKAN4Manager()
    private init() {}

    /// कन्वर्जन मानों को अपडेट करता है और वैकल्पिक रूप से सक्रिय SKAN 4.0 विंडो को लॉक करता है
    /// - Parameters:
    ///   - fineValue: विंडो 1 के लिए 6-बिट पूर्णांक (0 से 63)। नोट: विंडो 2 और 3 में, SKAdNetwork fineValue पैरामीटर को अनदेखा करता है।
    ///   - coarseValue: सभी विंडो के लिए मोटा मान स्ट्रिंग ("low", "medium", "high")
    ///   - shouldLock: सक्रिय विंडो को तुरंत अंतिम रूप देने के लिए बूलियन ध्वज
    func updateConversionState(
        fineValue: Int,
        coarseValue: SKAdNetwork.CoarseConversionValue,
        shouldLock: Bool,
        completion: ((Error?) -> Void)? = nil
    ) {
        guard #available(iOS 16.1, *) else {
            completion?(SKANError.unsupportedOSVersion)
            return
        }

        // ठीक-दाने वाले मान सीमाओं को सत्यापित करें (0 से 63)
        guard (0...63).contains(fineValue) else {
            completion?(SKANError.invalidFineValue)
            return
        }

        // असमकालिक SKAN 4.0 कन्वर्जन अपडेट निष्पादित करें
        SKAdNetwork.updatePostbackConversionValue(
            fineValue,
            coarseValue: coarseValue,
            lockWindow: shouldLock
        ) { error in
            if let error = error {
                print("SKAN 4.0 अपडेट विफल: \(error.localizedDescription)")
            } else {
                print("SKAN 4.0 अपडेट सफल - Fine: \(fineValue), Coarse: \(coarseValue.rawValue), Locked: \(shouldLock)")
            }
            completion?(error)
        }
    }

    /// सांकेतिक राजस्व मैपिंग वर्कफ़्लो (विशिष्ट Thresholds को सीधे प्रोडक्शन में कॉपी न करें)
    /// नोट: प्रोडक्शन में, सक्रिय कन्वर्जन विंडो निर्धारित करें और विंडो-विशिष्ट मोटे-मान तर्क को परिभाषित करें।
    func handleInAppPurchase(amountUSD: Double) {
        let fineVal: Int
        let coarseVal: SKAdNetwork.CoarseConversionValue
        let lock: Bool

        switch amountUSD {
        case 0.0..<5.0:
            fineVal = 10
            coarseVal = .low
            lock = false
        case 5.0..<25.0:
            fineVal = 25
            coarseVal = .medium
            lock = false
        case 25.0...:
            fineVal = 60
            coarseVal = .high
            // उच्च-मूल्य कन्वर्जन के लिए पोस्टबैक तैयारी में तेजी लाने के लिए विंडो को तुरंत लॉक करें
            lock = true
        default:
            fineVal = 0
            coarseVal = .low
            lock = false
        }

        updateConversionState(fineValue: fineVal, coarseValue: coarseVal, shouldLock: lock)
    }
}

SKAdNetwork 4.0 और AdAttributionKit इंटरऑपरेबिलिटी

SKAdNetwork और Apple AdAttributionKit के बीच संबंध

Apple ने iOS 17.4 और बाद के संस्करणों के लिए एक विस्तारित एट्रिब्यूशन फ्रेमवर्क के रूप में AdAttributionKit पेश किया। AdAttributionKit और SKAdNetwork सह-अस्तित्व में रह सकते हैं, लेकिन वे अलग-अलग एट्रिब्यूशन API बने हुए हैं:

• फ्रेमवर्क-विशिष्ट API आह्वान: ऐप्स को उस कन्वर्जन-अपडेट API को कॉल करना चाहिए जो विज्ञापन नेटवर्क द्वारा उपयोग किए जाने वाले फ्रेमवर्क से मेल खाता है। यदि कोई विज्ञापन नेटवर्क AdAttributionKit के माध्यम से विज्ञापन परोसता है, तो ऐप AdAttributionKit कन्वर्जन विधियों को调用 करता है; यदि SKAdNetwork का उपयोग कर रहा है, तो यह StoreKit API को कॉल करता है।
• क्रॉस-फ्रेमवर्क विजेता चयन: जब दोनों फ्रेमवर्क एक ही इंस्टॉलेशन के लिए योग्य इंप्रेशन रिकॉर्ड करते हैं, तो ऑपरेटिंग सिस्टम उनका एक साथ मूल्यांकन करता है और एट्रिब्यूशन के लिए एक ही विजेता इंप्रेशन का चयन करता है।
• ब्रिजिंग व्यवहार: माप परतों में संगतता सुनिश्चित करने के लिए Apple कुछ SKAdNetwork अपडेट कॉल के लिए कन्वर्जन-मान ब्रिजिंग व्यवहार प्रदान करता है।

मौजूदा App Store एट्रिब्यूशन इंटीग्रेशन को संचालित करने के लिए SKAdNetwork 4 महत्वपूर्ण बना हुआ है, जबकि Apple नए ऐप विज्ञापन कार्यान्वयन को AdAttributionKit की ओर निर्देशित करता है और दोनों फ्रेमवर्क के बीच इंटरऑपरेबिलिटी का दस्तावेजीकरण करता है।

तुलनात्मक मैट्रिक्स: लीगेसी SKAN 3.0 बनाम SKAN 4.0 मल्टी-विंडो मॉडल

सारांश और निर्णय ढांचा (Decision Framework)

SKAdNetwork 4.0 एट्रिब्यूशन विजिबिलिटी को पहले ऐप लॉन्च से 35 दिनों तक बढ़ाता है, जब फ़ाइन-ग्रेनेड प्रकटीकरण उपलब्ध न हो तो कम-ग्रैनुलैरिटी माप प्रदान करने के लिए कोर्स-ग्रेनेड कन्वर्जन मान पेश करता है, और जब कन्वर्जन विंडो को समय से पहले अंतिम रूप दिया जाता है तो पोस्टबैक विलंबता को कम करने के लिए डेवलपर्स को माप विंडो को लॉक करने की अनुमति देता है। सफल कार्यान्वयन के लिए सभी तीन विंडो में सावधानीपूर्वक कन्वर्जन स्कीमा मैपिंग और वास्तविक व्यावसायिक मील के पत्थरों के साथ क्लाइंट-साइड अपडेट कॉल को संरेखित करने की आवश्यकता होती है।

एप्लिकेशन-स्तरीय डीप-लिंक रूटिंग एक अलग माप और ऑनबोर्डिंग परत के रूप में Apple के गोपनीयता-संरक्षित एट्रिब्यूशन फ्रेमवर्क के साथ काम कर सकती है। कार्यान्वयन-विशिष्ट डीप-लिंक रूटिंग और एट्रिब्यूशन वर्कफ़्लो के लिए, OpoInstall दस्तावेज़ देखें।

संबंधित सामग्री

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

• प्रौद्योगिकियां: Apple SKAdNetwork, Apple AdAttributionKit, StoreKit फ्रेमवर्क, OpoInstall मोबाइल SDK

• मानक: IETF RFC 8259 JSON विनिर्देश

• API: StoreKit updatePostbackConversionValue API, SKAdNetwork इंस्टॉल-सत्यापन पोस्टबैक

आधिकारिक दस्तावेज़

• SKAdNetwork पर Apple डेवलपर दस्तावेज़

• AdAttributionKit पर Apple डेवलपर दस्तावेज़

• एकाधिक कन्वर्जन विंडो में पोस्टबैक प्राप्त करने पर Apple डेवलपर दस्तावेज़

• इंस्टॉल-सत्यापन पोस्टबैक में पैरामीटर की पहचान करने पर Apple डेवलपर दस्तावेज़

• पोस्टबैक कन्वर्जन मानों को अपडेट करने पर Apple डेवलपर दस्तावेज़

• AdAttributionKit और SKAdNetwork इंटरऑपरेबिलिटी को समझना