SKAdNetwork की मदद से, iOS इंस्टॉल को एट्रिब्यूट करना

Google Exchange उन सिग्नल के साथ काम करता है जिनका इस्तेमाल Google Mobile Ads SDK, Apple के SKAdNetwork API के साथ SKAdNetwork एट्रिब्यूशन शुरू करने के लिए करता है. SKAdNetwork सिग्नल के साथ इंटिग्रेट किया जा सकता है. इससे विज्ञापन देने वाले लोग या कंपनियां, iOS डिवाइसों के लिए ऐप्लिकेशन इंस्टॉल करने का बढ़ावा देने वाले विज्ञापन कैंपेन की सफलता का आकलन कर सकती हैं. साथ ही, उपयोगकर्ताओं की निजता को बनाए रख सकती हैं.

यहां दी गई सूची में बताया गया है कि SKAdNetwork के वर्शन के आधार पर, ऐप्लिकेशन इंस्टॉल एट्रिब्यूशन का व्यवहार कैसे बदलता है:

• 2.0-2.1: विज्ञापन वाले ऐप्लिकेशन के इंस्टॉल होने का एट्रिब्यूशन, StoreKit से रेंडर किए गए App Store के प्रॉडक्ट पेज से तय होता है. ऐसा तब होता है, जब उपयोगकर्ता आपके विज्ञापन पर क्लिक करता है और ऐप्लिकेशन इंस्टॉल करता है.
• 2.2+: व्यू-थ्रू विज्ञापनों के लिए अतिरिक्त सहायता. इसमें, विज्ञापन वाले ऐप्लिकेशन को इंस्टॉल करने का एट्रिब्यूशन तब दिया जाता है, जब उपयोगकर्ता आपका विज्ञापन देखने के बाद ऐप्लिकेशन इंस्टॉल करता है.

SKAdNetwork के अलग-अलग वर्शन के बीच के अंतर के बारे में ज़्यादा जानने के लिए, SKAdNetwork के रिलीज़ नोट देखें.

यूज़र इंटरफ़ेस (यूआई) में SKAdNetwork आईडी कॉन्फ़िगर करना

SKAdNetwork आईडी वाले बिड अनुरोध पाने के लिए, आपको Authorized Buyers या ओपन बिडिंग के यूज़र इंटरफ़ेस (यूआई) में अपने SKAdNetwork आईडी की जानकारी देनी होगी. उदाहरण के लिए, SKAdNetwork आईडी की वैल्यू a1b2c3d4e5.skadnetwork जैसी हो सकती है.

Authorized Buyers या ओपन बिडिंग के यूज़र इंटरफ़ेस (यूआई) में अपना SKAdNetwork आईडी डालने के लिए, यह तरीका अपनाएं:

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

यहां दी गई इमेज में, अनुमति वाले iOS SKAdNetwork आईडी बॉक्स में SKAdNetwork आईडी का एक उदाहरण दिखाया गया है:

एट्रिब्यूशन के लिए क्रिएटिव कॉन्फ़िगर करना

Google Mobile Ads SDK, SKAdNetwork एट्रिब्यूशन को सिर्फ़ तब शुरू करता है, जब क्लिक-थ्रू यूआरएल, Apple App Store पर ले जाता हो. रीयल-टाइम बिडिंग एपीआई का इस्तेमाल करके, समीक्षा के लिए क्रिएटिव सबमिट करते समय, क्रिएटिव में क्लिक-थ्रू यूआरएल का इस्तेमाल करना ज़रूरी है. यह यूआरएल, ऐप स्टोर में मौजूद उस ऐप्लिकेशन का डायरेक्ट लिंक होना चाहिए जिसका विज्ञापन दिखाया जा रहा है. इसके अलावा, एचटीटीपी रीडायरेक्ट का इस्तेमाल किया जा सकता है. इसमें फ़ाइनल डेस्टिनेशन, ऐप स्टोर में मौजूद उस ऐप्लिकेशन का होना चाहिए जिसका विज्ञापन दिखाया जा रहा है. Google Mobile Ads SDK, एट्रिब्यूशन तब शुरू करता है, जब आपके क्रिएटिव के क्लिक-थ्रू यूआरएल का फ़ाइनल डेस्टिनेशन, इनमें से किसी प्रीफ़िक्स से शुरू होता है:

• https://apps.apple.com
• https://itunes.apple.com
• itms-apps://
• itms://

अगर आपके क्रिएटिव के क्लिक-थ्रू यूआरएल का फ़ाइनल डेस्टिनेशन इन प्रीफ़िक्स से मैच नहीं होता है या आपका क्लिक-थ्रू यूआरएल, क्लाइंट-साइड रीडायरेक्ट के किसी ऐसे तरीके का इस्तेमाल करता है जो App Store पर नहीं ले जाता, तो हो सकता है कि Google Mobile Ads SDK, SKAdNetwork एट्रिब्यूशन शुरू न करे. यहां दी गई सूची में, ऐसे उदाहरण शामिल हैं जहां यह प्रोसेस लागू हो सकती है:

• एक ऐसा एचटीएमएल पेज जिस पर उपयोगकर्ता को ऐप स्टोर पर रीडायरेक्ट करने के लिए, कोई कार्रवाई करनी पड़ती है.
• एक ऐसा एचटीएमएल पेज जिसमें JavaScript पर आधारित, अपने-आप काम करने वाली रीडायरेक्ट स्क्रिप्ट हो. यह स्क्रिप्ट, उपयोगकर्ता को ऐप स्टोर पर रीडायरेक्ट करती हो.
• मेटा रीफ़्रेश टैग.

क्रिएटिव टाइप के हिसाब से एट्रिब्यूशन शुरू करना

SKAdNetwork एट्रिब्यूशन को शुरू करने के लिए, क्लिक ऐक्शन को अलग-अलग क्रिएटिव टाइप के लिए इस तरह सेट अप किया जा सकता है:

एचटीएमएल

इसे क्लिक किए जा सकने वाले एलिमेंट के आस-पास मौजूद ऐंकर टैग पर डेस्टिनेशन यूआरएल के तौर पर सेट अप किया जा सकता है. इसके अलावा, इसे JavaScript पर आधारित ऑन-क्लिक इवेंट से window.location कार्रवाइयों के टारगेट यूआरएल के तौर पर भी सेट अप किया जा सकता है.

MRAID

SKAdNetwork एट्रिब्यूशन शुरू करने के लिए, क्लिक ऐक्शन को Mraid.open() को कॉल करना होगा.

VAST वीडियो

ऐप स्टोर का यूआरएल, VAST एक्सएमएल में ClickThrough एलिमेंट में सेट होना चाहिए.

मूल भाषा वाला

ऐप्लिकेशन के ऐप स्टोर का यूआरएल, BidResponse.seatbid.bid.{adm/adm_native}.link.url फ़ील्ड में सेट होना चाहिए.

BidRequest सिग्नल की पहचान करना

BidRequest.imp.ext.skadn फ़ील्ड की मदद से, रजिस्टर किए गए उन SKAdNetwork आईडी की जानकारी देखी जा सकती है जो पब्लिशर ऐप्लिकेशन के साथ काम करते हैं. अगर skadn फ़ील्ड की जानकारी दी गई है, तो एट्रिब्यूट का इस्तेमाल करके, ऐप्लिकेशन इंस्टॉल करने का बढ़ावा देने वाले विज्ञापन या फिर से यूज़र ऐक्टिविटी बढ़ाने वाले विज्ञापन के लिए रिस्पॉन्स बनाया जा सकता है. यह विज्ञापन, इंस्टॉल या कन्वर्ज़न को शामिल किए गए SKAdNetwork आईडी में से किसी एक से जोड़ता है. skadn फ़ील्ड, एक SKAdNetworkRequest ऑब्जेक्ट है. इसमें ये एट्रिब्यूट शामिल हैं:

यहां मोबाइल इन्वेंट्री के लिए बिड रिक्वेस्ट का उदाहरण दिया गया है. इसमें पब्लिशर का ऐप्लिकेशन, आपके SKAdNetwork आईडी के साथ काम करता है:

{
  "id": "9NaI48SmPW7Zf3MAHR43DY",
  "imp": [
    {
      "id": "1",
      // OMITTED...
      "ext": {
        // OMITTED...
        "skadn": {
          "sourceapp": "com.google.testapp",
          "skadnetids": [
            "cF58w81X"
          ],
          "versions": [
            "2.0",
            "2.1",
            "4.0"
          ],
          "fidelities": [
            1,
            0
          ]
        }
        // OMITTED...
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "5.6.0",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-6156239328255091",
      "ext": {
        "country": "JP"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "livestream": 0,
      "language": "ja"
    },
    "storeurl": "https://www.google.com"
  }
  // OMITTED...
}

BidResponse फ़ील्ड में जानकारी भरें

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

आपको एट्रिब्यूशन की ऐसी जानकारी देनी होगी जो बिड रिक्वेस्ट में शामिल जानकारी से मेल खाती हो. एट्रिब्यूशन की जानकारी, BidResponse.seatbid.bid.ext.skadn फ़ील्ड में दी जाती है. यह एक SKAdNetworkResponse ऑब्जेक्ट होता है, जिसमें ये एट्रिब्यूट होते हैं:

इस उदाहरण में, ऐप्लिकेशन इंस्टॉल करने के एट्रिब्यूशन की जानकारी के साथ बिड रिस्पॉन्स दिखाया गया है:

{
  "id": "9NaI48SmPW7Zf3MAHR43DY",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9NaI48SmPW7Zf3MAHR43DY",
          // OMITTED...
          "ext": {
            // OMITTED...
            "skadn": {
              "version": "4.0",
              "network": "cF58w81X",
              "itunesitem": "788729094",
              "sourceapp": "1422994973",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "11iF1L96q2cw8tu790p301c10530ogr7h250k1P9pLxqcJ2qe37klG8xB3M592YbpafQ9861493838C521XA6AEF4A40DK8X"
                },
                {
                  "fidelity": 1,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "f67L3C138Y6XB7940141011Pd58AZbdBk9Xo1Mlf1973706DsB5808ILLKumU2ic9fr72b9bSs3CD25CCZo8DJB65JB0615L"
                }
              ],
              "sourceidentifier": "5507"
            },
            "app_promotion_type": 1
            // OMITTED...
          }
        }
      ]
      // OMITTED...
    }
  ]
  // OMITTED...
}

यहां दी गई सूची में, बिड रिस्पॉन्स के हिसाब से SKAdNetwork के अनुमानित व्यवहार के बारे में बताया गया है:

• जब विज्ञापन को कम से कम तीन सेकंड तक देखने के बाद, 24 घंटों के अंदर विज्ञापन में दिखाया गया ऐप्लिकेशन इंस्टॉल किया जाता है, तो विज्ञापन देने वाले व्यक्ति या कंपनी को SKAdNetwork व्यू-थ्रू एट्रिब्यूशन पोस्टबैक की सूचना भेजी जाती है.
• विज्ञापन पर क्लिक करने पर, विज्ञापन में दिखाए गए ऐप्लिकेशन का इनलाइन स्टोर ओवरले दिखता है. साथ ही, अगर उपयोगकर्ता विज्ञापन में दिखाए गए ऐप्लिकेशन को इंस्टॉल करके खोलता है, तो विज्ञापन देने वाले व्यक्ति या कंपनी को SKAdNetwork क्लिक-थ्रू एट्रिब्यूशन पोस्टबैक की सूचना भेजी जाती है.

SKOverlay की मदद से एट्रिब्यूशन बढ़ाना

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

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

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

Google, इंटरस्टीशियल या इनाम वाले विज्ञापनों में मौजूद एचटीएमएल स्निपेट और वीएएसटी वीडियो क्रिएटिव के लिए, SKOverlay के साथ काम करता है.

यह तय करना कि SKOverlay काम करता है या नहीं

बिड रिक्वेस्ट मिलने पर, BidRequest.imp.ext.skadn.skoverlay फ़ील्ड की वैल्यू देखकर यह पता लगाया जा सकता है कि SKOverlay काम करता है या नहीं. SKOverlay का इस्तेमाल तब किया जा सकता है, जब OpenRTB Protobuf फ़ॉर्मैट का इस्तेमाल करने वाले बिडिंग एंडपॉइंट के लिए, skoverlay फ़ील्ड को true पर सेट किया गया हो या OpenRTB JSON फ़ॉर्मैट का इस्तेमाल करने वाले बिडिंग एंडपॉइंट के लिए, 1 पर सेट किया गया हो.

SKOverlay की मदद से अपना विज्ञापन दिखाना

SKOverlay के साथ काम करने पर, BidResponse.seatbid.bid.ext.skadn.skoverlay फ़ील्ड की वैल्यू तय की जा सकती है. इससे यह पता चलता है कि आपको SKOverlay दिखाना है. skoverlay फ़ील्ड में ये एट्रिब्यूट होते हैं:

• delay: यह एक पूर्णांक है, जो विज्ञापन दिखने और SKOverlay दिखने के बीच के समय को सेकंड में दिखाता है. वीडियो क्रिएटिव के लिए, डिसप्ले टाइम वह समय होता है जब वीडियो चलना शुरू होता है. अगर यह फ़ील्ड सेट नहीं है, तो SKOverlay नहीं दिखाया जाता.
• endcarddelay: यह एक पूर्णांक है, जो वीडियो क्रिएटिव के एंड कार्ड के दिखने और SKOverlay के दिखने के बीच के समय को सेकंड में दिखाता है. अगर इस फ़ील्ड को सेट नहीं किया जाता है, तो एंड कार्ड के बाद SKOverlay नहीं दिखेगा. यह सिर्फ़ इंटरस्टीशियल या इनाम वाले विज्ञापनों में मौजूद, वीएएसटी वीडियो क्रिएटिव पर लागू होता है.
• dismissible: यह बूलियन वैल्यू बताती है कि उपयोगकर्ता, SKOverlay को खारिज कर सकता है या नहीं.

यहां बिड रिस्पॉन्स का एक उदाहरण दिया गया है:

{
  // OMITTED...
  "seatbid": [
    {
      "bid": [
        {
          // OMITTED...
          "ext": {
            // OMITTED...
            "skadn": {
              // OMITTED...
              "itunesitem": "422689480",
              "skoverlay": {
                "delay": 5,
                "endcarddelay": 0
              },
              "productpageid": "some_id"
            }
          }
        }
      ]
    }
  ]
}

SKOverlay के व्यवहार की समीक्षा करना

यहां SKOverlay के व्यवहार के बारे में बताया गया है. यह व्यवहार, ऊपर दिए गए बिड रिस्पॉन्स के हिसाब से है:

• वीडियो शुरू होने के पांच सेकंड बाद, SKOverlay दिखाएं.
• एंड कार्ड के तुरंत बाद SKOverlay दिखाएं.

• जब उपयोगकर्ता SKOverlay पर क्लिक करे, तब ऐप स्टोर खुल जाए.

• अगर BidResponse.seatbid.bid.ext.skadn.productpageid की वैल्यू दी गई है, तो SKOverlay पर मौजूद ऐप्लिकेशन लिस्टिंग का डेटा, कस्टम प्रॉडक्ट पेज में मौजूद आइकॉन होता है.

• VAST वीडियो क्रिएटिव के लिए, जब कोई उपयोगकर्ता SDKoverlay पर क्लिक करता है, तो क्लिक-थ्रू और क्लिक ट्रैकिंग यूआरएल को पिंग किया जाता है.

• VAST वीडियो क्रिएटिव के लिए, अगर कोई उपयोगकर्ता वीडियो के दौरान SKOverlay को खारिज कर देता है, तो भी एंड कार्ड के बाद SKOverlay दिखता है. हालांकि, ऐसा तब होता है, जब BidResponse.seatbid.bid.ext.skadn.skoverlay.endcarddelay फ़ील्ड सेट हो.