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

जब कोई इंप्रेशन मिलता है, तो 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"];
}

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

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

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

Partner SDK
Adjust
AppsFlyer
Singular
Tenjin

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

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

AdValue

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

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

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

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

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

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

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

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

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