इंप्रेशन-लेवल पर विज्ञापन से मिलने वाला रेवेन्यू

प्लैटफ़ॉर्म चुनें: Android iOS Unity Android (लेगसी)

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

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

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

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

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

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

पैसे चुकाकर देखे जाने वाले इवेंट के लिए हैंडलर लागू करना

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

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

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

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

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

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

पार्टनर एसडीके
Adjust
AppsFlyer
Singular
Tenjin

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

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

AdValue

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

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

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

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

ओपन बिडिंग से मिले टेस्ट इंप्रेशन

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

• Unknown: इससे पता चलता है कि रेवेन्यू कितना सटीक है.

• 0: इससे विज्ञापन की वैल्यू का पता चलता है.

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

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