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
- AdMob kullanıcı arayüzünde gösterim düzeyinde reklam geliri özelliğini etkinleştirdiğinizden emin olun.
- Unity eklentisi 5.0.0 veya üzeri sürümler.
- Başlarken bölümünü tamamlayın. Unity uygulamanızda Google Mobile Ads Unity eklentisi içe aktarılmış olmalıdır.
Gösterim düzeyinde reklam geliri verilerini alabilmeniz için en az bir reklam biçimi uygulamanız gerekir:
Ü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 ESTIMATED
değ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.