Gösterim düzeyinde reklam geliri

Gösterim gerçekleştiğinde Google Mobile Ads SDK'sı reklam geliri verilerini sağlar bu gösterimle ilişkilidir. Verilerden yararlanarak kullanıcının veya satışa dönük verileri diğer ilgili sistemlere iletebilir.

Bu kılavuzun amacı, gösterim düzeyinde reklam gelirini uygulamanıza yardımcı olmaktır. veri yakalamayı deneyin.

Ön koşullar

Ücretli bir etkinlik işleyici uygulama

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

Aşağıdaki kod, ödüllü reklam 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 edinmek için Bilgi Alma bölümüne bakın. hakkında bilgi edinin.

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ğı kılavuzuna bakın:

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

Kullanımla ilgili en iyi uygulamalar

  • OnPaidEvent etkinliğini oluşturduktan veya içeriğe erişim elde ettikten hemen sonra reklam nesnesi olarak ayarlayın ve kesinlikle reklamı göstermeden önce. Bu sayede projenizde hiçbir geri çağırmayı kaçırmazsınız.
  • Gösterim düzeyindeki reklam geliri bilgilerini tercih ettiğiniz analizlere gönderin sunucuyu hemen OnPaidEvent işleyicinizde görürsünüz. Bu sayede projenizde ve veri tutarsızlıklarını önler.

AdValue

AdValue, bir reklamdan elde edilen parasal değeri temsil eden bir sınıftır. aşağıdaki gibi kodlanan değerin para birimi kodu ve kesinlik türü dahil edilir.

AdValue.PrecisionType Açıklama
Unknown Bilinmeyen bir reklam değeri. Bu, YBD geri ping'i şu olduğunda döndürülür: etkin ancak yeterli veri yok.
Estimated Birleştirilmiş verilerden tahmin edilen bir reklam değeri.
PublisherProvided Yayıncı tarafından sağlanan reklam değeri (ör. bir uyumlulaştırma grubundaki manuel BGBM'ler).
Precise Bu reklamın tam değeri.

Uyumlulaştırma durumunda 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.