Gösterim düzeyinde reklam geliri

Platform seçin: Android iOS Unity Android (Eski)

Bir gösterim gerçekleştiğinde Google Mobile Ads Unity Plugin, bu gösterimle ilişkili reklam geliri verilerini sağlar. Bu verileri, bir kullanıcının yaşam boyu değerini hesaplamak için kullanabilir veya diğer ilgili sistemlere iletebilirsiniz.

Bu kılavuz, Unity projenizde gösterim düzeyi reklam geliri verilerini yakalama özelliğini uygulamanıza yardımcı olmak için hazırlanmıştır.

Ön koşullar

Ücretli etkinlik işleyici uygulama

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

Aşağıdaki kod, ödüllü reklamlar için ücretli etkinliklerin nasıl işleneceğini 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&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"];
}

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 ayrıntılı bilgi için iş ortağının kılavuzuna bakın:

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

Kullanımla ilgili en iyi uygulamalar

  • Reklam nesnesini oluşturduktan veya nesneye erişim elde ettikten hemen sonra ve reklamı göstermeden önce OnPaidEvent etkinliğini ayarlayın. Bu sayede hiçbir geri aramayı kaçırmazsınız.
  • Gösterim düzeyinde reklam geliri bilgilerini, OnPaidEvent işleyicinizde hemen tercih ettiğiniz analiz sunucusuna gönderin. Bu sayede, geri çağırmaları yanlışlıkla silmez ve veri tutarsızlıklarını önlersiniz.

AdValue

AdValue, bir reklamdan kazanılan maddi değeri temsil eden bir sınıftır. Bu değerin para birimi kodu ve kesinlik türü aşağıdaki gibi kodlanır.

AdValue.PrecisionType Açıklama
Unknown Bilinmeyen bir reklam değeri. Bu, 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ğeridir.
PublisherProvided Yayıncı tarafından sağlanan reklam değeri (ör. uyumlulaştırma grubundaki manuel BGBM'ler).
Precise Bu reklamın kesin değeri.

Uyumlulaştırma söz konusu olduğunda Ad Manager, otomatik veri toplama özelliğinin etkin olduğu reklam kaynakları için ESTIMATED değeri sağlamaya çalışır. Daha fazla bilgi için Otomatik veri toplama başlıklı makaleyi inceleyin. Otomatik veri toplama özelliği etkinleştirilmemiş reklam kaynakları için veya anlamlı bir tahmin bildirmek için yeterli birleştirilmiş veri bulunmadığı durumlarda PUBLISHER_PROVIDED değeri döndürülür.

Open Bidding'den gelen test gösterimleri

Bir test isteği aracılığıyla Open Bidding reklam kaynağı için gösterim düzeyinde reklam geliri etkinliği gerçekleştiğinde yalnızca aşağıdaki değerleri alırsınız:

  • Unknown: Kesinlik türünü gösterir.
  • 0: Reklam değerini gösterir.
Daha önce kesinlik türünü Unknown dışında bir değer, reklam değerini ise 0 değerinden yüksek olarak görmüş olabilirsiniz.

Test reklamı isteği gönderme hakkında ayrıntılı bilgi için Test cihazlarını etkinleştirme başlıklı makaleyi inceleyin.