Gösterim düzeyinde reklam geliri

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

Bu kılavuz, gösterim düzeyi reklam geliri verisi yakalama özelliğini Unity projenizde 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. Google Mobile Ads SDK'sı, bir reklam etkinliğinin yaşam döngüsü boyunca gösterim etkinliklerini izler ve işleyiciyi kazanılan değerle birlikte çağırır.

Aşağıdaki kodda, ödüllü reklam için ücretli etkinliklerin nasıl işleneceği gösterilmektedir:

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 başlıklı makaleyi inceleyin.

Uygulama İlişkilendirme Ortaklarıyla (AAP) 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şturur veya bu nesneye erişir erişmez ve kesinlikle reklamı göstermeden önce ayarlayın. Bu sayede geri aramaları kaçırmazsınız.
  • Gösterim düzeyinde reklam geliri bilgilerini OnPaidEvent işleyicinizde hemen tercih ettiğiniz Analytics sunucusuna gönderin. Bu sayede, geri çağırmaları yanlışlıkla bırakmaz ve veri tutarsızlıklarını önlersiniz.

AdValue

AdValue, bir reklamdan kazanılan parasal değeri temsil eden bir sınıftır. Değerin para birimi kodu ve aşağıda kodlandığı gibi hassasiyet türü de dahildir.

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

Aracılık söz konusu olduğunda Ad Manager, otomatik veri toplama özelliği etkin olan 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 etkin olmayan reklam kaynakları veya anlamlı bir tahmin raporlamak için yeterli toplu verinin olmadığı durumlarda PUBLISHER_PROVIDED değeri döndürülür.

Open Bidding'den gelen gösterimleri test etme

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

  • Unknown: Hassasiyet türünü gösterir.
  • 0: Reklam değerini gösterir.

Daha önce, hassasiyet türünü Unknown dışında bir değer ve reklam değerini 0'den fazla 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.