Gösterim düzeyinde reklam geliri

Bir gösterim gerçekleştiğinde Google Mobile Ads SDK'sı, söz konusu gösterimle ilişkili reklam geliri verilerini sağlar. Kullanıcının ömür boyu değerini hesaplamak için verileri kullanabilir veya verileri diğer alakalı sistemlere iletebilirsiniz.

Bu kılavuzun amacı, Unity projenizde gösterim düzeyinde reklam geliri veri yakalama özelliğini uygulamanıza yardımcı olmaktır.

Ön koşullar

Ücretli etkinlik işleyici uygulama

Her reklam biçiminin bir OnAdPaid etkinliği vardır. Google Mobile Ads SDK'sı, bir reklam etkinliğinin yaşam döngüsü sırasında gösterim etkinliklerini izler ve kazanılan değeri temsil eden bir AdValue ile işleyiciyi çağırır.

Aşağıdaki örnekte, ödüllü reklam için ücretli etkinlikler ele alınmaktadır:

private void LoadRewardedAd()
{
   // Send the request to load the ad.
   AdRequest adRequest = new AdRequest();
   RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
   {
      // If the operation failed with a reason.
      if (error != null)
      {
         Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
         return;
      }

      rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
   });
}

public void HandleAdPaidEvent(AdValue adValue)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

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

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

Reklam geliri verilerini analiz platformlarına yönlendirmeyle ilgili tüm ayrıntılar için iş ortağı kılavuzunu inceleyin:

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

Kullanımla ilgili en iyi uygulamalar

  • Reklam nesnesini oluşturduktan veya reklam nesnesine eriştikten hemen sonra ve kesinlikle reklamı göstermeden önce OnPaidEvent etkinliğini ayarlayın. Bu sayede, geri aramaları kaçırmazsınız.
  • Gösterim düzeyindeki reklam geliri bilgilerini OnPaidEvent işleyicinizde hemen tercih ettiğiniz analiz sunucusuna gönderin. Bu sayede, geri aramaları yanlışlıkla düşürmezsiniz ve veri tutarsızlıklarını önlersiniz.

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ğıda kodlanmış hassasiyet türü de bu sınıfa dahildir.

AdValue.PrecisionType Açıklama
Unknown Bilinmeyen bir reklam değeri. Bu değer, YBD pingback'i 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.

Uyumlulaştırma durumunda AdMob, optimize edilmiş reklam kaynakları için bir Estimateddeğeri sağlamaya çalışır. Optimize edilmemiş reklam kaynakları için veya anlamlı bir tahmin bildirmek üzere yeterli birleştirilmiş veri bulunmayan durumlarda PublisherProvided değeri döndürülür.

Teklifli sistem reklam kaynaklarından gelen gösterimleri test etme

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

  • Unknown: Kesinlik türünü belirtir.
  • 0: Reklam değerini belirtir.

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