Bu kılavuzda, Chartboost'tan reklam yüklemek ve görüntülemek için AdMob Uyumlulaştırması, şelale entegrasyonlarını kapsayan Google Mobile Ads SDK'sını nasıl kullanacağınız 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:
Entegrasyon | |
---|---|
Teklif verme | |
Şelale | |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü | |
Yerel biçim |
Şartlar
- Android API düzeyi 21 veya üstü
En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlayın 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ızı tamamlamak 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ği'ni ve Uygulama İmzası'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 aç
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 isteğinde bulunabilir ve Chartboost test reklamı alabilirsiniz.
Chartboost test reklamlarını almaya başladıktan sonra, uygulamanız Chartboost'un Yayıncı Uygulama İncelemesi bölümü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: Kullanıcı arayüzünde Chartboost talebini AdMob ayarlayın
GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Chartboost ekleyin
Chartboost'u AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için GDPR ayarları ve ABD eyalet düzenlemeleri ayarlarında belirtilen 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ını ve yapılandırmalarını ekleyin. Chartboost SDK'sının ve bağdaştırıcının en son 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
Maven Central'dan Chartboost SDK'sının en yeni sürümünün
.aar
dosyasını indirip projenize ekleyin.Google'ın Maven deposunda Chartboost bağdaştırıcı yapılarına gidin. En son sürümü seçin, Chartboost bağdaştırıcısı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ının ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara belirli açıklamaların yapıldığından ve bu kullanıcılardan alınan izinlerin alındığından emin olmanı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 aktaramamaktadır.
Chartboost, SDK 8.1.0 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ı aracılığıyla reklam isteğinde bulunmadan önce yapmanız önerilir.
Java
DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);
Kotlin
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ılmasını" (yasaların bu terimlerin tanımladığı şekilde) devre dışı bırakma seçeneği sunmasını gerektirir. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" bağlantısı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 bilgilerin satışına katılabilir her reklam ağını tanımlamanız ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.
Chartboost, 8.1.0 SDK 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.
Java
DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);
Kotlin
val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)
Chartboost'un CCPA makalesini ve Android Gizlilik Yöntemleri'ni inceleyin ve her yöntemde sağlayabileceğiniz değerleri öğrenin.
5. adım: Gerekli kodu ekleyin
AndroidManifest dosyasını değiştirme
Diğer öğeler
AndroidManifest.xml
dosyasında, Chartboost reklamları gösterecek ve farklı yönleri destekleyecek 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.
Java
import com.chartboost.sdk.Chartboost;
// ...
@Override
public void onBackPressed() {
// If an interstitial is on screen, close it.
if (Chartboost.onBackPressed()) {
return;
} else {
super.onBackPressed();
}
}
Kotlin
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
İ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:
Hata kodu | Neden |
---|---|
0-99 | Chartboost SDK'sı hata döndürdü. Daha fazla ayrıntı için Chartboost'un belgelerine bakın. |
101 | İstenen reklam boyutu, Chartboost tarafından desteklenen bir banner boyutuyla eşleşmiyor. |
102 | Chartboost, konum başına aynı anda yalnızca 1 reklam yükleyebilir. |
103 | Kullanıcı arayüzünde yapılandırılmış Chartboost sunucu parametreleri AdMob eksik/geçersiz. |
104 | Chartboost geçiş reklamı veya ödüllü reklam gösterilmeye hazır değil. |
Chartboost Android Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü
Sürüm 9.7.0.0
- Chartboost SDK'sının 9.7.0 sürümü ile uyumluluk 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ı sürüm 23.0.0.
- 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ı sürüm 22.6.0.
- 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 derlenip test edildi:
- 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'sının 9.5.0 sürümü ile uyumluluk 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 derlenip test edildi:
- Google Mobile Ads SDK'sı 22.2.0 sürümü.
- Chartboost SDK'sı 9.4.1 sürümü
Sürüm 9.4.0.0
- Chartboost SDK'sının 9.4.0 sürümü ile uyumluluk doğrulandı.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı sürüm 22.1.0.
- 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ı sürüm 22.1.0.
- 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ürümü 9.3.0.
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 derlenip test edildi:
- 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 tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı sürüm 21.5.0.
- Chartboost SDK'sı 9.2.1 sürümü
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 tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 21.5.0 sürümü.
- Chartboost SDK'sı 9.2.0 sürümü.
Sürüm 9.1.1.0
- Chartboost SDK'sını başlatmak için kullanılacak uygulama kimliğini ve uygulama imzasını 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ı 21.3.0 sürümü.
- Chartboost SDK sürümü 9.1.1.
Sürüm 8.4.3.1
- Zorunlu olan minimum Google Mobile Ads SDK sürümü 21.0.0 olarak güncellendi.
- Gerekli minimum Android API düzeyi 19 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.0.0.
- Chartboost SDK'sı 8.4.3 sürümü
Sürüm 8.4.3.0
- Chartboost SDK 8.4.3 ile uyumluluğu doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı 20.6.0 sürümü.
- Chartboost SDK'sı 8.4.3 sürümü
Sürüm 8.4.2.0
- Chartboost SDK'sı 8.4.2 ile uyumluluk doğrulandı.
compileSdkVersion
vetargetSdkVersion
API 31 olarak güncellendi.- Google Mobile Ads SDK'sı için gereken minimum 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'sı 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ı sürüm 20.6.0.
- Chartboost SDK sürümü 8.4.1.
Sürüm 8.3.1.0
- Chartboost SDK 8.3.1 ile uyumluluğu doğrulandı.
- Bağdaştırıcı, yeni
AdError
API'yi kullanacak şekilde güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı 20.5.0 sürümü.
- Chartboost SDK sürümü 8.3.1.
Sürüm 8.3.0.0
- Chartboost SDK 8.3.0 ile uyumluluk doğrulandı.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 20.5.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı 20.5.0 sürümü.
- 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ı.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 20.1.0 olarak güncellendi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı sürüm 20.1.0.
- Chartboost SDK sürümü 8.2.1.
Sürüm 8.2.0.1
- Google Mobile Ads SDK'sı için gereken minimum sürüm 20.0.0 olarak güncellendi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı sürüm 20.0.0.
- 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ı 8.2.0 sürümü
Sürüm 8.1.0.0
- Chartboost SDK'sı 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 bağdaştırıcı yükleme/gösteri hatalarının nedenleri eklendi.
- Zorunlu olan minimum Google Mobile Ads SDK sürümü 19.2.0 olarak güncellendi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı sürüm 19.2.0.
- Chartboost SDK sürümü 8.0.3.
Sürüm 8.0.3.1
- Chartboost banner reklamları için destek eklendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 19.1.0.
- Chartboost SDK'sı 8.0.3 sürümü
Sürüm 8.0.3.0
- Chartboost SDK 8.0.3 ile uyumluluk doğrulandı.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 19.1.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 19.1.0.
- Chartboost SDK sürümü 8.0.3.
Sürüm 8.0.2.0
- Chartboost SDK'sı 8.0.2 ile uyumluluk doğrulandı.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 19.0.1 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- 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ı 18.3.0 sürümü.
- Chartboost SDK'sı 8.0.1 sürümü
Sürüm 7.5.0.1
- Chartboost bağdaştırıcının reklam etkinliklerini çağıramadığı bir hata düzeltildi.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 18.3.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı 18.3.0 sürümü.
- Chartboost SDK'sı 7.5.0 sürümü
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'sı 7.3.1 ile uyumluluk doğrulandı.
7.3.0.0 sürümü
- 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ı.
Sürüm 7.2.0.1
- Adaptör,
onRewardedVideoComplete()
reklam etkinliğini çağıracak şekilde güncellendi.
Sürüm 7.2.0.0
- Chartboost SDK'sı 7.2.0 ile uyumluluk doğrulandı.
Sürüm 7.1.0.0
- Chartboost SDK'sı 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
- Bağdaştırıcıyı, Chartboost SDK'sı 7.0.0 ile uyumlu olacak şekilde güncellendi.
Sürüm 6.6.3.0
- 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'sı 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.
- Artık build.gradle dosyasının dependencies etiketine aşağıdakiler eklenerek bağdaştırıcılar 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).
1.1.0 sürümü
- 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üle dayalı video reklamları ve geçiş reklamlarını destekler.