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

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

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

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

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

Partner SDK
Adjust
AppsFlyer
Singular
Tenjin

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

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

AdValue

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

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

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

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

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

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

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

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