Chartboost'u uyumlulaştırma ile entegre etme

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:

Ş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

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

2. 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.

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ı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.

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)

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.

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

İ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 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 ve targetSdkVersion 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.