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

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

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

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

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

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

  • बैनर
  • इंटरस्टीशियल विज्ञापन
  • इनाम वाले विज्ञापन
  • इनाम वाला इंटरस्टीशियल विज्ञापन
  • नेटिव विज्ञापन

पैसे चुकाकर इस्तेमाल किया जाने वाला इवेंट हैंडलर लागू करना

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

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

private void LoadRewardedAd()
{
   // Send the request to load the ad.
   AdRequest adRequest = new AdRequest();
   RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
   {
      // If the operation failed with a reason.
      if (error != null)
      {
         Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
         return;
      }

      rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
   });
}

public void HandleAdPaidEvent(AdValue adValue)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    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"];
}

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

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

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

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

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

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

AdValue

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

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

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

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

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

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

• Unknown: सटीक जानकारी के टाइप के बारे में बताता है.

• 0: विज्ञापन की वैल्यू दिखाता है.

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

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