इंप्रेशन लेवल पर विज्ञापन से होने वाली आय

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

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

ज़रूरी शर्तें

• पक्का करें कि आपने AdMob यूज़र इंटरफ़ेस (यूआई) में इंप्रेशन-लेवल पर विज्ञापन से होने वाली आय की सुविधा चालू की है.
• Unity प्लगिन 5.0.0 या इसके बाद का वर्शन.
• शुरू करें को पूरा करें. आपके Unity ऐप्लिकेशन में, Google Mobile Ads Unity प्लगिन को पहले से इंपोर्ट किया जाना चाहिए.

• कोई भी इंप्रेशन-लेवल पर विज्ञापन से होने वाली आय का डेटा पाने से पहले, आपको कम से कम एक विज्ञापन फ़ॉर्मैट लागू करना होगा:

  • बैनर
  • अचानक दिखने वाला (इंटरस्टीशियल) विज्ञापन
  • इनाम वाला विज्ञापन
  • इनाम वाले इंटरस्टीशियल विज्ञापन
  • नेटिव

पेड इवेंट हैंडलर को लागू करना

हर विज्ञापन फ़ॉर्मैट में एक OnPaidEvent इवेंट होता है. किसी विज्ञापन इवेंट के लाइफ़साइकल के दौरान, Google Mobile Ads SDK, इंप्रेशन इवेंट पर नज़र रखता है और किसी विज्ञापन से मिली वैल्यू के साथ हैंडलर को शुरू करता है.

यहां दिए गए कोड से पता चलता है कि इनाम वाले विज्ञापन के लिए, पैसे चुकाकर लिए गए इवेंट को कैसे मैनेज किया जाए:

RewardedAd rewardedAd;

private void RequestRewardedAd()
{
   rewardedAd = new RewardedAd("AD_UNIT_ID");
   
   rewardedAd.OnPaidEvent += this.HandleAdPaidEvent;
   
   AdRequest adRequest = new AdRequest();
   rewardedAd.LoadAd(adRequest);
}


public void HandleAdPaidEvent(object sender, AdValueEventArgs args)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    AdValue adValue = args.AdValue;
    long valueMicros = adValue.Value;
    string currencyCode = adValue.CurrencyCode;
    PrecisionType precision = adValue.Precision;

    ResponseInfo responseInfo = rewardedAd.GetResponseInfo();
    string responseId = responseInfo.GetResponseId();

    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
    string adSourceId = loadedAdapterResponseInfo.AdSourceId;
    string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
    string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
    string adSourceName = loadedAdapterResponseInfo.AdSourceName;
    string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
    long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
    Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary<string, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

जीतने वाले विज्ञापन स्रोत के बारे में ज़्यादा जानने के लिए, विज्ञापन रिस्पॉन्स के बारे में जानकारी पाना देखें.

ऐप्लिकेशन एट्रिब्यूशन पार्टनर (एएपी) के साथ इंटिग्रेट करना

विज्ञापन से मिलने वाले रेवेन्यू के डेटा को Analytics प्लैटफ़ॉर्म पर फ़ॉरवर्ड करने के बारे में पूरी जानकारी पाने के लिए, पार्टनर की गाइड देखें:

पार्टनर SDK टूल
Adjust
AppsFlyer
Singular
Tenjin

लागू करने के सबसे सही तरीके

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

AdValue

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

अहम जानकारी: AdValue की वैल्यू एक माइक्रो वैल्यू होती है, जो हर विज्ञापन की लागत के बारे में बताती है. उदाहरण के लिए, 5,000 की वैल्यू से पता चलता है कि इस विज्ञापन की वैल्यू 0.005 डॉलर हो सकती है.

AdValue.PrecisionType	ब्यौरा
Unknown	विज्ञापन की ऐसी वैल्यू जिसके बारे में जानकारी नहीं है. लाइफ़टाइम पिंगबैक चालू होने पर, ज़रूरत के मुताबिक डेटा उपलब्ध न होने पर यह नतीजा दिखता है.
Estimated	एग्रीगेट किए गए डेटा से अनुमानित विज्ञापन वैल्यू.
PublisherProvided	पब्लिशर की ओर से दी गई विज्ञापन वैल्यू, जैसे कि मीडिएशन ग्रुप में मैन्युअल सीपीएम.
Precise	इस विज्ञापन की सटीक वैल्यू.

मीडिएशन के मामले में, AdMob ऑप्टिमाइज़ किए गए विज्ञापन स्रोतों के लिए, ESTIMATED वैल्यू देने की कोशिश करता है. ऑप्टिमाइज़ नहीं किए गए विज्ञापन स्रोतों के लिए या ऐसे मामलों में जहां काम का अनुमान लगाने के लिए, इकट्ठा किया गया ज़रूरी डेटा नहीं होता, PUBLISHER_PROVIDED वैल्यू दिखती है.