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

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

इस गाइड की मदद से, अपने 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&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

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

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

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

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

पार्टनर SDK टूल
अडजस्ट करें
AppsFlyer
Singular
Tenjin

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

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

AdValue

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

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

मीडिएशन के मामले में, Ad Manager उन विज्ञापन स्रोतों के लिए ESTIMATED वैल्यू देने की कोशिश करता है जिनके लिए डेटा अपने-आप इकट्ठा होने की सुविधा चालू है. ज़्यादा जानकारी के लिए, अपने-आप डेटा इकट्ठा होना देखें. जिन विज्ञापन स्रोतों के लिए डेटा अपने-आप इकट्ठा होने की सुविधा चालू नहीं है या जिन मामलों में काम का अनुमान देने के लिए ज़रूरत के मुताबिक एग्रीगेट किया गया डेटा उपलब्ध नहीं है उनके लिए PUBLISHER_PROVIDED वैल्यू दिखती है.

ओपन बिडिंग से मिलने वाले इंप्रेशन की जांच करना

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

  • Unknown: सटीक जानकारी के टाइप के बारे में बताता है.
  • 0: विज्ञापन की वैल्यू दिखाता है.

पहले, आपको प्रिसिज़न टाइप को Unknown के अलावा किसी और वैल्यू के तौर पर दिख सकता था. साथ ही, विज्ञापन की वैल्यू 0 से ज़्यादा हो सकती थी.

टेस्ट विज्ञापन अनुरोध भेजने के बारे में जानकारी पाने के लिए, टेस्ट डिवाइसों को चालू करना लेख पढ़ें.