Bu sayfa, Cloud Translation API ile çevrilmiştir.

Chartboost'u Uyumlulaştırma ile entegre etme

Bu kılavuzda, şelale entegrasyonlarını ele alan uyumlulaştırma özelliğini kullanarak 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 kılavuzda, Chartboost'un reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Chartboost SDK ile bağdaştırıcısının bir uygulamaya nasıl Android entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

Entegrasyon
Teklif
Şelale
Formatlar
Banner
Geçişli
Ödül olarak verildi
Yerel biçim

Koşullar

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.

Chartboost uygulamaları kontrol paneli

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

Uygulama Yönetimi

Formun geri kalanını doldurun ve uygulamanızı tamamlamak için Uygulama Ekle düğmesini tıklayın.

Yeni uygulama formu

Uygulamanız oluşturulduktan sonra kontrol paneline yönlendirilirsiniz. Uygulamanızın Uygulama Kimliği'ni ve Uygulama İmzası'nı not edin.

Uygulama ayarları

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

Chartboost uyumlulaştırma kontrol paneli

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

Chartboost API gezgini

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.

Uygulama ayarlarını düzenle

Uygulamanızın ayarlarından, Test modu'nu açıp kapatabilirsiniz.

Chartboost test modu

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

Chartboost test reklamlarını aldıktan sonra, uygulamanız Chartboost'un Yayıncı Uygulaması İncelemesi'ne yerleştirilir. Chartboost'ta para kazanma özelliğinin çalışması için yayıncı uygulaması incelemesinin Chartboost tarafından onaylanması gerekir.

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

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

Ad Manager hesabınızda oturum açın.

Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın.

Getiri grubunuz için benzersiz bir Ad girin, Durum'u Etkin olarak ayarlayın, Reklam Biçimi'ni seçin ve Envanter türü'nü Mobil Uygulama olarak ayarlayın. Hedefleme > Envanter bölümünün altında Envanter ve Mobil uygulama altında uyumlulaştırma eklemek istediğiniz reklam birimini seçin.

Ardından, Getiri iş ortağı ekle düğmesini tıklayın.

Chartboostiçin zaten bir Getiri iş ortağınız varsa bunu seçebilirsiniz. Aksi takdirde, Yeni bir getiri iş ortağı oluştur'u seçin.

Reklam ağı olarak Chartboost'i seçin, benzersiz bir Ad girin ve Uyumlulaştırma'yı etkinleştirin.

Otomatik veri toplama'yı açın ve önceki bölümde belirtilen User ID and User Signature değerini girin.

Getiri iş ortağı seçildikten sonra Entegrasyon türü olarak Mobil SDK Uyumlulaştırması'nı, Platform olarak Android'yi ve Durum olarak Etkin'i seçin. Bir önceki bölümde verilenApp ID, App Signature and Ad Location kodunu girin. Ardından, Varsayılan BGBM değerini girin.

Chartboost Reklam Konumları (Adlandırılmış Konumlar), uygulamanızda reklam göstermek istediğiniz bir yeri temsil eden basit adlardır. Ad Manager istekleri ayarlarda belirtilen konuma gönderir. İstekler gönderildikten sonra Chartboost, raporlama amacıyla konumu kullanıcı arayüzüne ekler.

Chartboost kullanıcı arayüzünde, Gelişmiş Ayarlar'ı tıklayarak Reklam Konumlarınızı Temel Ayarlar sayfasında görebilirsiniz. Daha ayrıntılı bilgi için Chartboost Adlandırılmış Konumlar kılavuzuna bakın.

olduğu gibi, hedeflenen uygulamayla ilişkilendirilmelidir.

İşiniz bittiğinde sayfanın alt kısmındaki Kaydet'i tıklayın.

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

GDPR ayarları ve ABD eyalet yönetmelikleri ayarları bölümündeki adımları uygulayarak Ad Manager kullanıcı arayüzünde GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Chartboost ekleyin.

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

Android Studio entegrasyonu (önerilir)

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ı ekleyin. Chartboost SDK'sı ve bağdaştırıcısının en son sürümlerini kullanın:

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

Manuel entegrasyon

Maven Central'dan Chartboost SDK'sının en son 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 adaptörü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ı alma ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara cihaz tanımlayıcılarının ve kişisel verilerin kullanımıyla ilgili belirli açıklamalar yapılması ve bu kullanıcılardan izin alınması gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) gereksinimlerini yansıtmaktadır. İzin isterken, uyumlulaştırma zincirinizde kişisel verileri toplayabilen, alabilen veya kullanabilen ve her bir ağın kullanımı hakkında bilgi verebilecek her bir reklam ağını tanımlamanız 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 makalesine bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerini" "satma" (yasaların bu terimleri tanımladığı şekilde) özelliğinin kapsamı dışında kalma hakkı sunmayı zorunlu kılıyor. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Satma" bağlantısıyla sunuluyor. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam yayını için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar ancak Google, bu ayarı uyumlulaştırma zincirinizdeki her reklam ağına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgi satışına dahil olabilecek tüm reklam ağlarını belirlemeniz ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

Chartboost, SDK 8.1.0 sürümünde addDataUseConsent() yöntemini ekledi. Aşağıdaki örnek kod, OPT_IN_SALE 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 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)

Daha fazla ayrıntı ve her yöntemde sağlanabilecek değerler için Chartboost'un CCPA makalesini ve Android Gizlilik Yöntemleri makalesini inceleyin.

5. Adım: Gerekli kodu ekleyin

AndroidManifest'te değişiklik yapma

Diğer öğeler

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

android:configChanges="keyboardHidden|orientation|screenSize"

Yaşam döngüsü etkinlikleri

Chartboost'un önerisine göre Chartboost reklamları gösterecek olan tüm etkinlik 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 etme

Test reklamlarını etkinleştir

Ad Manager 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

Chartboostreklam kaynağından test reklamları aldığınızı doğrulamak için Chartboost (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

İzinler

En iyi performans için Chartboost, 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.getAdapterResponse() kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

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

Bir reklam yüklenemediğinde Chartboost bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajları burada bulabilirsiniz:

Hata kodu	Neden
0-99	Chartboost SDK'sı bir hata döndürdü. Daha ayrıntılı bilgi için Chartboost belgelerine bakın.
101	İstenen reklam boyutu, Chartboost tarafından desteklenen 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ılan Chartboost sunucu parametreleri Ad Manager eksik/geçersiz.
104	Chartboost geçiş reklamı veya ödüllü reklamı gösterilmeye hazır değil.
101	Kullanıcı arayüzünde yapılandırılan Chartboost sunucu parametreleri Ad Manager eksik/geçersiz.
102	Chartboost SDK'sı bir başlatma hatası döndürdü.
103	Chartboost reklamı, gösterim zamanında önbelleğe alınmaz.
104	İstenen reklam boyutu, Chartboost tarafından desteklenen banner boyutuyla eşleşmiyor.
105	Cihazın işletim sistemi sürümü, Chartboost SDK'sının desteklenen minimum OS sürümünden daha düşük.
200-299	Chartboost SDK önbellek hataları. Daha fazla bilgi için kodu inceleyin.
300-399	Chartboost SDK'sı hata gösteriyor. Daha fazla bilgi için kodu inceleyin.
400-499	Chartboost SDK tıklama hataları. Daha fazla bilgi için kodu inceleyin.