Chartboost'u Uyumlulaştırma ile Entegre Etme

Bu kılavuzda, şelale entegrasyonlarını kapsayan uyumlulaştırma kullanılarak Chartboost'tan reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu makalede, Chartboost'un bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Chartboost SDK'sının ve bağdaştırıcının bir uygulamaya nasıl entegre edileceği ele alınmaktadır. Android

Desteklenen entegrasyonlar ve reklam biçimleri

Chartboost için uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:

Şartlar

• Android API düzeyi 21 veya sonraki sürümler

• En son Google Mobile Ads SDK'sı

• Uyumlulaştırmayı tamamlama Başlangıç kılavuzu

1. Adım: Chartboost kullanıcı arayüzünde yapılandırmaları ayarlayın

Chartboost hesabına kaydolun ve hesabınız doğrulandıktan sonra giriş yapın. Ardından Uygulama yönetimi sekmesine gidin.

Uygulamanızı oluşturmak için Yeni uygulama ekle düğmesini tıklayın.

Formun geri kalanını doldurun ve uygulamanıza son halini vermek için Uygulama Ekle düğmesini tıklayın.

Uygulamanız oluşturulduktan sonra uygulamanın kontrol paneline yönlendirilirsiniz. Uygulamanızın uygulama kimliğini ve uygulama imzasını not edin.

AdMob reklam birimi kimliğinizi ayarlamak için Chartboost Kullanıcı Kimliği ve Kullanıcı İmzası gerekir. Bu parametreleri, Chartboost kullanıcı arayüzünde Chartboost uyumlulaştırması'nı tıklayarak bulabilirsiniz.

Kaynaklar > API Gezgini sekmesine gidin ve Kimlik Doğrulama bölümünün altındaki Kullanıcı Kimliğinizi ve Kullanıcı İmzasını not edin.

Test modunu etkinleştirme

Chartboost kullanıcı arayüzünden Uygulama yönetimi sekmesine gidip listeden uygulamanızı seçip Uygulama ayarlarını düzenle'yi tıklayarak uygulamanızda test modunu etkinleştirebilirsiniz.

Uygulamanızın ayarlarından, uygulamanızda Test modunu açıp kapatabilirsiniz.

Test modu etkinleştirildikten sonra, daha önce oluşturulan reklam birimi kimliğini kullanarak reklam isteyebilir ve bir Chartboost test reklamı alabilirsiniz.

Chartboost test reklamları almaya başladıktan sonra uygulamanız Chartboost'un Yayıncı Uygulama İncelemesi'ne yerleştirilir. Chartboost'ta para kazanma özelliğinin çalışması için yayıncı uygulama incelemesinin Chartboost tarafından onaylanması gerekir.

2. adım: Chartboost talebini Ad Manager kullanıcı arayüzünde ayarlayın

Chartboost 'i GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme

AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Chartboost'u eklemek için GDPR ayarlarındaki ve ABD eyalet düzenlemeleri ayarlarındaki adımları uygulayın.

3. Adım: Chartboost SDK'sını ve bağdaştırıcısını içe aktarın

Android Studio entegrasyonu (önerilen)

Proje düzeyindeki settings.gradle.kts dosyanıza aşağıdaki depoları ekleyin:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
    }
  }
}

Ardından, uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulama bağımlılıkları ve yapılandırmaları ekleyin. Chartboost SDK'sı ve bağdaştırıcısının en yeni sürümlerini kullanın:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:chartboost:9.7.0.0")
}

Manuel entegrasyon

1. Chartboost SDK'sının en son sürümünün .aar dosyasını Maven Central'dan indirip projenize ekleyin.

2. Google'ın Maven deposunda Chartboost bağdaştırıcısı yapılarına gidin. En son sürümü seçin, Chartboost bağdaştırıcının .aar dosyasını indirin ve projenize ekleyin.

4. adım: Chartboost SDK'sında gizlilik ayarlarını uygulayın

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı (AEA)'daki kullanıcılara belirli açıklamaların yapılmasını ve izinlerin alınmasını sağlamanız gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) gereksinimlerini yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel veri toplayabilecek, alabilecek veya kullanabilecek her reklam ağını tanımlamanız ve her ağın kullanımı hakkında bilgi vermeniz gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak iletememektedir.

Chartboost, 8.1.0 SDK sürümünde addDataUseConsent() yöntemini ekledi. Aşağıdaki örnek kod, NON_BEHAVIORAL için veri kullanımı iznini ayarlar. Bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sı üzerinden reklam istemeden önce yapmanız önerilir.

DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);

val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)

Daha fazla ayrıntı ve her yöntemde sağlanabilecek değerler için Chartboost'un GDPR makalesine ve Android Gizlilik Yöntemleri bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, kişisel bilgilerinin "satışının" (bu terimlerin yasalardaki tanımlarına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılıyor. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" gibi bir bağlantıyla sunulur. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam sunumu için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar. Ancak Google, bu ayarı uyumlulaştırma zincirinizdeki tüm reklam ağlarına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgi satışına katılabilecek her bir reklam ağını belirlemeli ve uygunluğu sağlamak için bu ağların her birinin talimatlarını takip etmelisiniz.

Chartboost, SDK 8.1.0 sürümünde addDataUseConsent() yöntemini ekledi. Aşağıdaki örnek kodda, veri kullanımı izni OPT_IN_SALE olarak ayarlanmıştır. Bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sı üzerinden reklam isteğinde bulunmadan önce yapmanız önerilir.

DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);

val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)

Daha fazla bilgi ve her yöntemde sağlanabilecek değerler için Chartboost'un CCPA makalesine ve Android Gizlilik Yöntemleri bakın.

5. Adım: Gerekli kodu ekleyin

AndroidManifest dosyasını değiştirme

Diğer öğeler

Chartboost reklamları gösterecek ve farklı yönleri destekleyecek AndroidManifest.xml dosyasındaki her etkinliğe aşağıdaki özelliği ekleyin:

android:configChanges="keyboardHidden|orientation|screenSize"

Yaşam döngüsü etkinlikleri

Chartboost'un önerisi uyarınca, etkinliğinizin Chartboost reklamları gösterecek tüm yaşam döngüsü etkinliklerine aşağıdaki kodu ekleyin.

import com.chartboost.sdk.Chartboost;
// ...

@Override
public void onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed()) {
        return;
    } else {
        super.onBackPressed();
    }
}

import com.chartboost.sdk.Chartboost
// ...

@Override
fun onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed())
        return
    else
        super.onBackPressed()
}

6. adım: Uygulamanızı test edin

Test reklamlarını etkinleştirme

AdMob için test cihazınızı kaydettiğinizden ve Chartboost kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.

Test reklamlarını doğrulama

Chartboost'tan test reklamları aldığınızı doğrulamak için Chartboost (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

İzinler

Chartboost, optimum performans için uygulamanızın AndroidManifest.xml dosyasına aşağıdaki isteğe bağlı izinleri eklemenizi önerir:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

Hata kodları

Bağdaştırıcı Chartboost'tan reklam alamazsa aşağıdaki sınıfların altında ResponseInfo.getAdapterResponses() kodunu kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

Bir reklam yüklenemezse Chartboost bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:

Chartboost Android Uyumlulaştırma Adaptörü Değişiklik Günlüğü

Sürüm 9.7.0.0

• Chartboost SDK'sının 9.7.0 sürümüyle uyumluluğu doğrulandı.
• Zorunlu minimum Google Mobile Ads SDK sürümü 23.0.0 olarak güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 23.0.0 sürümü.
• Chartboost SDK sürümü 9.7.0.

Sürüm 9.6.1.0

• Chartboost SDK 9.6.1 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 22.6.0 sürümü.
• Chartboost SDK sürümü 9.6.1.

Sürüm 9.6.0.0

• Chartboost SDK'sının 9.6.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 22.5.0 sürümü.
• Chartboost SDK sürümü 9.6.0.

Sürüm 9.5.0.0

• Chartboost SDK 9.5.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 22.3.0 sürümü.
• Chartboost SDK'sı 9.5.0 sürümü.

Sürüm 9.4.1.0

• Chartboost SDK 9.4.1 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 22.2.0 sürümü.
• Chartboost SDK sürümü 9.4.1.

Sürüm 9.4.0.0

• Chartboost SDK'sı 9.4.0 sürümü ile uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 22.1.0 sürümü.
• Chartboost SDK'sı 9.4.0 sürümü.

Sürüm 9.3.1.0

• Chartboost SDK 9.3.1 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 22.1.0 sürümü.
• Chartboost SDK sürümü 9.3.1.

Sürüm 9.3.0.0

• Chartboost SDK'sı 9.3.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 22.0.0 sürümü.
• Chartboost SDK'sı 9.3.0 sürümü.

Sürüm 9.2.1.1

• Bağdaştırıcının yeni VersionInfo sınıfını kullanacak şekilde güncellenmesi.
• Zorunlu minimum Google Mobile Ads SDK sürümü 22.0.0 olarak güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 22.0.0 sürümü.
• Chartboost SDK sürümü 9.2.1.

Sürüm 9.2.1.0

• Chartboost SDK 9.2.1 ile uyumluluğu doğrulandı.

Aşağıdakilerle derlenip test edildi:

• Google Mobile Ads SDK'sı sürüm 21.5.0.
• Chartboost SDK sürümü 9.2.1.

Sürüm 9.2.0.0

• Chartboost SDK'sı 9.2.0 ile uyumluluk doğrulandı.
• Zorunlu olan minimum Google Mobile Ads SDK sürümü 21.5.0 olarak güncellendi.

Aşağıdakilerle derlenip test edildi:

• Google Mobile Ads SDK'sı 21.5.0 sürümü.
• Chartboost SDK sürümü 9.2.0.

Sürüm 9.1.1.0

• Chartboost SDK'sını başlatmak için hangi uygulama kimliğinin ve uygulama imzasının kullanılacağını sabit kodlamanın isteğe bağlı bir yolu olarak ChartboostMediationAdapter.setAppParams(String, String) yöntemi eklendi.
• Chartboost SDK 9.1.1 ile uyumluluk doğrulandı.
• Google Mobile Ads SDK'sı için gereken minimum sürüm 21.3.0 olarak güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı sürüm 21.3.0.
• Chartboost SDK sürümü 9.1.1.

Sürüm 8.4.3.1

• Google Mobile Ads SDK'sı için gereken minimum sürüm 21.0.0 olarak güncellendi.
• Gerekli minimum Android API düzeyi 19 olarak güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 21.0.0 sürümü.
• Chartboost SDK sürümü 8.4.3.

Sürüm 8.4.3.0

• Chartboost SDK 8.4.3 ile uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı sürüm 20.6.0.
• Chartboost SDK'sı 8.4.3 sürümü

Sürüm 8.4.2.0

• Chartboost SDK 8.4.2 ile uyumluluk doğrulandı.
• compileSdkVersion ve targetSdkVersion API 31 olarak güncellendi.
• Zorunlu minimum Google Mobile Ads SDK sürümü 20.6.0 olarak güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı sürüm 20.6.0.
• Chartboost SDK'sı 8.4.2 sürümü

Sürüm 8.4.1.0

• Chartboost SDK 8.4.1 ile uyumluluk doğrulandı.
• Zorunlu minimum Google Mobile Ads SDK sürümü 20.6.0 olarak güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 20.6.0 sürümü.
• Chartboost SDK sürümü 8.4.1.

Sürüm 8.3.1.0

• Chartboost SDK'sı 8.3.1 ile uyumluluk doğrulandı.
• Bağdaştırıcı, yeni AdError API'yi kullanacak şekilde güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı sürüm 20.5.0.
• Chartboost SDK sürümü 8.3.1.

Sürüm 8.3.0.0

• Chartboost SDK 8.3.0 ile uyumluluk doğrulandı.
• Zorunlu minimum Google Mobile Ads SDK sürümü 20.5.0 olarak güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı sürüm 20.5.0.
• Chartboost SDK'sı 8.3.0 sürümü

Sürüm 8.2.1.0

• Chartboost SDK 8.2.1 ile uyumluluğu doğrulandı.
• Zorunlu minimum Google Mobile Ads SDK sürümü 20.1.0 olarak güncellendi.

Aşağıdakilerle derlenip test edildi:

• Google Mobile Ads SDK'sı 20.1.0 sürümü.
• Chartboost SDK sürümü 8.2.1.

Sürüm 8.2.0.1

• Zorunlu minimum Google Mobile Ads SDK sürümü 20.0.0 olarak güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 20.0.0 sürümü.
• Chartboost SDK sürümü 8.2.0.

Sürüm 8.2.0.0

• Chartboost SDK'sı 8.2.0 ile uyumluluk doğrulandı.
• Zorunlu olan minimum Google Mobile Ads SDK sürümü 19.5.0 olarak güncellendi.

Aşağıdakilerle derlenip test edildi:

• Google Mobile Ads SDK'sı 19.5.0 sürümü.
• Chartboost SDK sürümü 8.2.0.

Sürüm 8.1.0.0

• Chartboost SDK 8.1.0 ile uyumluluk doğrulandı.

Aşağıdakilerle derlenip test edildi:

• Google Mobile Ads SDK'sı sürüm 19.2.0.
• Chartboost SDK'sı 8.1.0 sürümü

Sürüm 8.0.3.2

• Açıklayıcı hata kodları ve adaptör yükleme/gösterme hatalarının nedenleri eklendi.
• Zorunlu olan minimum Google Mobile Ads SDK sürümü 19.2.0 olarak güncellendi.

Aşağıdakilerle derlenip test edildi:

• Google Mobile Ads SDK'sı 19.2.0 sürümü.
• Chartboost SDK'sı 8.0.3 sürümü

Sürüm 8.0.3.1

• Chartboost banner reklamları için destek eklendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 19.1.0 sürümü.
• Chartboost SDK sürümü 8.0.3.

Sürüm 8.0.3.0

• Chartboost SDK 8.0.3 ile uyumluluk doğrulandı.
• Zorunlu olan minimum Google Mobile Ads SDK sürümü 19.1.0 olarak güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 19.1.0 sürümü.
• Chartboost SDK sürümü 8.0.3.

Sürüm 8.0.2.0

• Chartboost SDK 8.0.2 ile uyumluluk doğrulandı.
• Zorunlu minimum Google Mobile Ads SDK sürümü 19.0.1 olarak güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 19.0.1 sürümü.
• Chartboost SDK sürümü 8.0.2.

Sürüm 8.0.1.0

• Chartboost SDK 8.0.1 ile uyumluluk doğrulandı.
• Chartboost SDK'sı 8.0.1 veya daha yeni bir sürüm gerekir.
• Reklam yüklemek için artık etkinlik bağlamı gerekmiyor.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı sürüm 18.3.0.
• Chartboost SDK sürümü 8.0.1.

Sürüm 7.5.0.1

• Chartboost bağdaştırıcısının reklam etkinliklerini çağırmasına neden olan hata düzeltildi.
• Zorunlu minimum Google Mobile Ads SDK sürümü 18.3.0 olarak güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

• Google Mobile Ads SDK'sı 18.3.0 sürümü.
• Chartboost SDK sürümü 7.5.0.

Sürüm 7.5.0.0

• Chartboost SDK 7.5.0 ile uyumluluğu doğrulandı.
• Bağdaştırıcının AndroidX bağımlılıkları kullanacak şekilde taşınması.
• Google Mobile Ads SDK'sı için gereken minimum sürüm 18.1.1 olarak güncellendi.

7.3.1.1 sürümü

• Bağdaştırıcı, yeni açık beta Ödüllü API'yi destekleyecek şekilde güncellendi.
• Google Mobile Ads SDK'sı için gereken minimum sürüm 17.2.0 olarak güncellendi.

7.3.1.0 sürümü

• Chartboost SDK 7.3.1 ile uyumluluğu doğrulandı.

Sürüm 7.3.0.0

• Chartboost SDK 7.3.0 ile uyumluluğu doğrulandı.

Sürüm 7.2.1.0

• Chartboost SDK 7.2.1 ile uyumluluğu doğrulandı.

7.2.0.1 sürümü

• Adaptör, onRewardedVideoComplete() reklam etkinliğini çağıracak şekilde güncellendi.

Sürüm 7.2.0.0

• Chartboost SDK 7.2.0 ile uyumluluk doğrulandı.

Sürüm 7.1.0.0

• Chartboost SDK 7.1.0 ile uyumluluk doğrulandı.

Sürüm 7.0.1.0

• Chartboost SDK 7.0.1 ile uyumluluk doğrulandı.
• Yeni Chartboost hata kodları için destek eklendi.
• Android Studio 3.0 için Bağdaştırıcı projesi güncellendi

Sürüm 7.0.0.0

• Adaptör, Chartboost SDK 7.0.0 ile uyumlu olacak şekilde güncellendi.

6.6.3.0 sürümü

• Chartboost SDK'sı 6.6.3 ile uyumluluk doğrulandı.

6.6.2.0 sürümü

• Chartboost SDK 6.6.2 ile uyumluluğu doğrulandı.

Sürüm 6.6.1.0

• Chartboost SDK 6.6.1 ile uyumluluk doğrulandı.

Sürüm 6.6.0.0

• Sürüm adlandırma sistemi [Chartboost SDK sürümü].[adaptör yaması sürümü] olarak değiştirildi.
• Bağdaştırıcılar artık build.gradle dosyasının bağımlılıklar etiketine aşağıdaki kod eklenerek bir derleme bağımlılığı olarak eklenebilir: compile 'com.google.ads.mediation:chartboost:6.6.0.0'
• Bağdaştırıcıyı jar dosyası yerine aar olarak dağıtmaya taşındı (ek talimatlar için BENİOKU bölümüne bakın).

Sürüm 1.1.0

• Chartboost Reklam Konumu Chartboost ekstralarından kaldırıldı. Chartboost'u uyumlulaştırma için yapılandırırken reklam konumu artık AdMob konsolunda belirtiliyor.

Sürüm 1.0.0

• İlk sürüm. Ödüllü video reklamları ve geçiş reklamlarını destekler.