Gösterim düzeyinde reklam geliri

Bir gösterim gerçekleştiğinde Google Mobile Ads SDK'sı, bu gösterimle ilişkilendirilen reklam geliri verilerini sağlar. Verileri bir kullanıcının yaşam boyu değerini hesaplamak veya aşağı akış niteliğindeki verileri diğer ilgili sistemlere iletmek için kullanabilirsiniz.

Bu kılavuz, Unity projenizde gösterim düzeyinde reklam geliri veri yakalamayı uygulamanıza yardımcı olmayı amaçlamaktadır.

Ön koşullar

Ücretli etkinlik işleyici uygulama

Her reklam biçiminde bir OnPaidEvent etkinliği vardır. Bir reklam etkinliğinin yaşam döngüsü sırasında Google Mobile Ads SDK'sı, gösterim etkinliklerini izler ve işleyiciyi kazanılan bir değerle çağırır.

Aşağıdaki kod, ödüllü reklam için ücretli etkinliklerin nasıl ele alınacağını gösterir:


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

Kazanan reklam kaynağı hakkında daha fazla bilgi için reklam yanıtı hakkında bilgi alma bölümüne bakın.

Uygulama İlişkilendirme Ortakları (AAP) ile Entegrasyon

Reklam geliri verilerini analiz platformlarına yönlendirme hakkında tüm ayrıntılar için iş ortağının kılavuzuna bakın:

İş Ortağı SDK'sı
Adjust
AppsFlyer
Singular
Tenjin

Kullanımla ilgili en iyi uygulamalar

  • OnPaidEvent etkinliğini, reklam nesnesini oluşturduktan veya reklam nesnesine erişim elde ettikten hemen sonra ve kesinlikle reklamı göstermeden önce ayarlayın. Bu, geri çağırmaları kaçırmamanızı sağlar.
  • Gösterim düzeyindeki reklam geliri bilgilerini, OnPaidEvent işleyicinizde hemen tercih ettiğiniz analiz sunucusuna gönderin. Bu, geri çağırmaları yanlışlıkla bırakmamanızı ve veri tutarsızlıklarını önlemenizi sağlar.

AdValue

AdValue, bir reklam için kazanılan parasal değeri temsil eden bir sınıftır. Değerin para birimi kodu ve aşağıdaki gibi kodlanmış hassasiyet türü.

AdValue.PrecisionType Açıklama
Unknown Bilinmeyen bir reklam değeri. Bu hata, YBD geri pingi etkinleştirildiğinde ancak yeterli veri olmadığında döndürülür.
Estimated Birleştirilmiş verilerden tahmin edilen bir reklam değeri.
PublisherProvided Yayıncının sağladığı reklam değeri (ör. uyumlulaştırma grubundaki manuel BGBM'ler)
Precise Bu reklamın tam değeri.

Uyumlulaştırma söz konusu olduğunda AdMob, optimize edilmiş reklam kaynakları için bir ESTIMATEDdeğer sağlamaya çalışır. Optimize edilmemiş reklam kaynakları için veya anlamlı bir tahmin raporlamak için yeterli birleştirilmiş verinin olmadığı durumlarda PUBLISHER_PROVIDED değeri döndürülür.