GMA Yeni Nesil SDK hakkındaki geri bildiriminizi Google Advertising and Measurement Community sunucusunun #gma-next-gen-sdk Discord kanalında paylaşın.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Gösterim düzeyinde reklam geliri

Platform seçin: Android

Android iOS Unity

Bir gösterim gerçekleştiğinde GMA Next-Gen SDK, bu gösterimle ilişkili reklam geliri verilerini sağlar. Verileri, 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 veri yakalama özelliğini Android uygulamanızda uygulamanıza yardımcı olmak için hazırlanmıştır.

Ön koşullar

AdMob kullanıcı arayüzünde gösterim düzeyi reklam geliri özelliğini etkinleştirdiğinizden emin olun.

GMA Next-Gen SDK kurulumunu yapın.
Gösterim düzeyinde reklam geliri elde edebilmek için en az bir reklam biçimi uygulamanız gerekir:

Ücretli etkinlik işleyici

Her reklam biçiminin bir onAdPaid etkinlik geri araması vardır. Bir reklam etkinliğinin yaşam döngüsü sırasında GMA Next-Gen SDK, gösterim etkinliklerini izler ve kazanılan değerle işleyiciyi çağırır.

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

Kotlin

ad.adEventCallback =
  object : RewardedAdEventCallback {
    override fun onAdPaid(adValue: AdValue) {
      // Send the impression-level ad revenue information to your
      // preferred analytics server directly within this callback.

      // Extract the impression-level ad revenue data.
      val valueMicros = adValue.valueMicros
      val currencyCode = adValue.currencyCode
      val precisionType = adValue.precisionType

      val loadedAdSourceResponseInfo = ad.getResponseInfo().loadedAdSourceResponseInfo
      val adSourceName = loadedAdSourceResponseInfo?.name
      val adSourceId = loadedAdSourceResponseInfo?.id
      val adSourceInstanceName = loadedAdSourceResponseInfo?.instanceName
      val adSourceInstanceId = loadedAdSourceResponseInfo?.instanceId
      val extras = ad.getResponseInfo().responseExtras
      val mediationGroupName = extras.getString("mediation_group_name")
      val mediationABTestName = extras.getString("mediation_ab_test_name")
      val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
    }
  }ImpressionLevelAdRevenueSnippets.kt

Java

ad.setAdEventCallback(
    new RewardedAdEventCallback() {
      @Override
      public void onAdPaid(@NonNull AdValue value) {
        // Send the impression-level ad revenue information to your preferred
        // analytics server directly within this callback.

        // Extract the impression-level ad revenue data.
        long valueMicros = value.getValueMicros();
        String currencyCode = value.getCurrencyCode();
        PrecisionType precisionType = value.getPrecisionType();

        AdSourceResponseInfo loadedAdSourceResponseInfo =
            ad.getResponseInfo().getLoadedAdSourceResponseInfo();
        String adSourceName = loadedAdSourceResponseInfo.getName();
        String adSourceId = loadedAdSourceResponseInfo.getId();
        String adSourceInstanceName = loadedAdSourceResponseInfo.getInstanceName();
        String adSourceInstanceId = loadedAdSourceResponseInfo.getInstanceId();

        Bundle extras = ad.getResponseInfo().getResponseExtras();
        String mediationGroupName = extras.getString("mediation_group_name");
        String mediationABTestName = extras.getString("mediation_ab_test_name");
        String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
      }
    });ImpressionLevelAdRevenueSnippets.java

Özel etkinlik reklam kaynağı adını belirleme

Özel etkinlik reklam kaynakları için AdSourceResponseInfo.name özelliği, reklam kaynağı adını Custom event döndürür. Birden fazla özel etkinlik kullanıyorsanız reklam kaynağı adı, birden fazla özel etkinlik arasında ayrım yapacak kadar ayrıntılı değildir. Belirli bir özel etkinliği bulmak için:

AdSourceResponseInfo.name özelliğini alın.
Benzersiz bir reklam kaynağı adı ayarlayın.

Aşağıdaki örnekte, özel bir etkinlik için benzersiz bir reklam kaynağı adı ayarlanmaktadır:

Kotlin

private fun getUniqueAdSourceName(loadedAdapterResponseInfo: AdSourceResponseInfo): String {
  var adSourceName = loadedAdapterResponseInfo.name
  if (adSourceName == "Custom Event") {
    if (
      loadedAdapterResponseInfo.adapterClassName ==
        "com.google.ads.mediation.sample.customevent.SampleCustomEvent"
    ) {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}ImpressionLevelAdRevenueSnippets.kt

Java

private String getUniqueAdSourceName(@NonNull AdSourceResponseInfo loadedAdapterResponseInfo) {
  String adSourceName = loadedAdapterResponseInfo.getName();
  if (adSourceName.equals("Custom Event")) {
    if (loadedAdapterResponseInfo
        .getAdapterClassName()
        .equals("com.google.ads.mediation.sample.customevent.SampleCustomEvent")) {
      adSourceName = "Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}ImpressionLevelAdRevenueSnippets.java

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 Ortağı (AAP) entegrasyonu

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

İş ortağının kılavuzu, GMA Next-Gen SDK'ya referans verecek şekilde güncellenmemiş olabilir.

Aşağıdaki örneklerde, GMA Next-Gen SDK kullanılarak gösterim düzeyindeki gelir verilerinin AAP iş ortaklarına nasıl gönderileceği gösterilmektedir:

Ayarla

Java

rewardedAd.setAdEventCallback(
    new RewardedAdEventCallback() {
      @Override
      public void onAdPaid(@NonNull AdValue value) {
        // Send ad revenue info to Adjust.
        AdjustAdRevenue adRevenue = new AdjustAdRevenue("admob_sdk");
        adRevenue.setRevenue(value.getValueMicros() / 1000000.0, value.getCurrencyCode());
        if (rewardedAd.getResponseInfo().getLoadedAdSourceResponseInfo() != null) {
          adRevenue.setAdRevenueNetwork(
              rewardedAd.getResponseInfo().getLoadedAdSourceResponseInfo().getName());
        }
        Adjust.trackAdRevenue(adRevenue);
      }
    });

Kotlin

rewardedAd.adEventCallback =
  object : RewardedAdEventCallback {
    override fun onAdPaid(value: AdValue) {
      // Send ad revenue info to Adjust.
      val adRevenue = AdjustAdRevenue("admob_sdk")
      adRevenue.setRevenue(value.valueMicros / 1000000.0, value.currencyCode)
      val loadedAdSourceResponseInfo = rewardedAd.getResponseInfo().loadedAdSourceResponseInfo
      loadedAdSourceResponseInfo?.let { adRevenue.setAdRevenueNetwork(it.name) }
      Adjust.trackAdRevenue(adRevenue)
    }
  }

AppsFlyer

Java

rewardedAd.setAdEventCallback(
    new RewardedAdEventCallback() {
      @Override
      public void onAdPaid(@NonNull AdValue value) {
        long valueMicros = value.getValueMicros();
        String currencyCode = value.getCurrencyCode();

        AFAdRevenueData adRevenueData =
            new AFAdRevenueData(
                "AdMob Mediation", // monetizationNetwork
                MediationNetwork.GOOGLE_ADMOB, // mediationNetwork
                currencyCode, // currencyIso4217Code
                (double) valueMicros // revenue
                );

        Map<String, Object> additionalParameters = new HashMap<>();
        additionalParameters.put(COUNTRY, "US");
        additionalParameters.put(AD_UNIT, AD_UNIT_ID);
        additionalParameters.put(AD_TYPE, AdFormat.REWARDED);

        AppsFlyerLib.getInstance().logAdRevenue(adRevenueData, additionalParameters);
      }
    });

Kotlin

rewardedAd.adEventCallback =
  object : RewardedAdEventCallback {
    override fun onAdPaid(value: AdValue) {
      val valueMicros = value.valueMicros
      val currencyCode = value.currencyCode

      val adRevenueData =
        AFAdRevenueData(
          "AdMob Mediation", // monetizationNetwork
          MediationNetwork.GOOGLE_ADMOB, // mediationNetwork
          currencyCode, // currencyIso4217Code
          valueMicros.toDouble(), // revenue
        )

      val additionalParameters: MutableMap<String?, Any?> = HashMap()
      additionalParameters[COUNTRY] = "US"
      additionalParameters[AD_UNIT] = AD_UNIT_ID
      additionalParameters[AD_TYPE] = AdFormat.REWARDED

      appsflyer.logAdRevenue(adRevenueData, additionalParameters)
    }
  }

Tekil

Java

rewardedAd.setAdEventCallback(
    new RewardedAdEventCallback() {
      @Override
      public void onAdPaid(@NonNull AdValue value) {
        // Convert revenue from micros to standard units.
        double revenue = value.getValueMicros() / 1000000.0;
        String currency = value.getCurrencyCode();

        // Validate ad revenue data before sending.
        if (revenue > 0 && !currency.isEmpty()) {
          SingularAdData adData = new SingularAdData("AdMob", currency, revenue);
          Singular.adRevenue(adData);
        }
      }
    });

Kotlin

rewardedAd.adEventCallback =
  object : RewardedAdEventCallback {
    override fun onAdPaid(value: AdValue) {
      // Convert revenue from micros to standard units.
      val revenue = value.valueMicros / 1000000.0
      val currency = value.currencyCode

      // Validate ad revenue data before sending.
      if (revenue > 0 && currency.isNotEmpty()) {
        val adData = SingularAdData("AdMob", currency, revenue)
        Singular.adRevenue(adData)
      }
    }
  }

Tenjin

GMA Next-Gen SDK için JSON nesnesi kullanarak entegrasyon yapmanız gerekir. Aşağıdaki örnekte, gösterim düzeyindeki gelir verileri bir JSON nesnesi kullanılarak Tenjin'e gönderilmektedir:

Java

rewardedAd.setAdEventCallback(
    new RewardedAdEventCallback() {
      @Override
      public void onAdPaid(@NonNull AdValue value) {
        ResponseInfo responseInfo = rewardedAd.getResponseInfo();

        // Extract the impression-level ad revenue data.
        long valueMicros = value.getValueMicros();
        String currencyCode = value.getCurrencyCode();
        PrecisionType precisionType = value.getPrecisionType();

        JSONObject json = new JSONObject();
        try {
          json.put("ad_unit_id", AD_UNIT_ID);
          json.put("currency_code", currencyCode);
          json.put("response_id", responseInfo.getResponseId());
          json.put("value_micros", valueMicros);
          if (responseInfo.getLoadedAdSourceResponseInfo() != null) {
            json.put(
                "mediation_adapter_class_name",
                responseInfo.getLoadedAdSourceResponseInfo().getAdapterClassName());
          }
          json.put("precision_type", precisionType);

          tenjinInstance.eventAdImpressionAdMob(json);
        } catch (JSONException e) {
          // Handle error.
        }
      }
    });

Kotlin

rewardedAd.adEventCallback =
  object : RewardedAdEventCallback {
    override fun onAdPaid(value: AdValue) {
      val responseInfo = rewardedAd.getResponseInfo()

      // Extract the impression-level ad revenue data.
      val valueMicros = value.valueMicros
      val currencyCode = value.currencyCode
      val precisionType = value.precisionType

      val json = JSONObject()
      try {
        json.put("ad_unit_id", AD_UNIT_ID)
        json.put("currency_code", currencyCode)
        json.put("response_id", responseInfo.responseId)
        json.put("value_micros", valueMicros)
        responseInfo.loadedAdSourceResponseInfo?.let {
          json.put("mediation_adapter_class_name", it.adapterClassName)
        }
        json.put("precision_type", precisionType)

        tenjinInstance.eventAdImpressionAdMob(json)
      } catch (_: JSONException) {
        // Handle error.
      }
    }
  }

Kullanımla ilgili en iyi uygulamalar

Reklam nesnesini oluşturur veya nesneye erişir erişmez ve kesinlikle reklamı göstermeden önce dinleyiciyi ayarlayın. Bu sayede, ücretli etkinlik geri aramalarını kaçırmazsınız.
Ücretli etkinlik geri çağırması çağrıldığında gösterim düzeyindeki reklam geliri bilgilerini tercih ettiğiniz analiz sunucusuna hemen gönderin. Bu sayede, geri aramaları yanlışlıkla bırakmadığınızdan emin olabilir ve veri tutarsızlıklarını önleyebilirsiniz.

AdValue

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

PrecisionType	Açıklama
`UNKNOWN`	Bilinmeyen bir reklam değeri. Bu hata, YBD geri ping etkinleştirildiğinde ancak yeterli veri olmadığında döndürülür.
`ESTIMATED`	Birleştirilmiş verilerden tahmin edilen bir reklam değeri.
`PUBLISHER_PROVIDED`	Yayıncı tarafından sağlanan bir reklam değeri (ör. bir uyumlulaştırma grubundaki manuel BGBM'ler).
`PRECISE`	Bu reklam için ödenen kesin değerdir.

AdMob uyumlulaştırmasında AdMob, optimize edilmiş reklam kaynakları için ESTIMATED değeri sağlamaya çalışır. Optimize edilmemiş reklam kaynakları için veya anlamlı bir tahmin raporlamak üzere yeterli toplu verinin olmadığı durumlarda PUBLISHER_PROVIDED değeri döndürülür.

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

Bir test isteği aracılığıyla teklif verme 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 değerinden 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.

Gösterim düzeyinde reklam geliri Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Ön koşullar

Ücretli etkinlik işleyici

Kotlin

Java

Özel etkinlik reklam kaynağı adını belirleme

Kotlin

Java

Uygulama İlişkilendirme Ortağı (AAP) entegrasyonu

Ayarla

Java

Kotlin

AppsFlyer

Java

Kotlin

Tekil

Java

Kotlin

Tenjin

Java

Kotlin

Kullanımla ilgili en iyi uygulamalar

AdValue

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

Gösterim düzeyinde reklam geliri