Chartboost'u uyumlulaştırma ile entegre etme

Bu kılavuzda, şelale entegrasyonlarını kapsayan arabuluculuk 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 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 Flutter uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

Şartlar

• En son Google Mobile Ads SDK'sı
• Flutter 3.7.0 veya sonraki sürümler
• Android'de dağıtmak için
  • Android API düzeyi 21 veya üzeri
• iOS'e dağıtmak için
  • iOS dağıtım hedefi 12.0 veya daha yeni bir sürüm olmalıdır.
• Google Mobile Ads SDK'sı ile yapılandırılmış çalışan bir Flutter projesi. Ayrıntılar için Başlayın bölümüne bakın.
• 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ğ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 Test modu'nu etkinleştirebilir veya devre dışı bırakabilirsiniz.

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ı 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: AdMob kullanıcı arayüzünde Chartboost talebini ayarlayın

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

Chartboost'u GDPR ve ABD eyalet yönetmelikleri 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

pub.dev üzerinden entegrasyon

Paketinizin pubspec.yaml dosyasına Chartboost SDK'sının ve bağdaştırıcının en son sürümleriyle aşağıdaki bağımlılığı ekleyin:

dependencies:
  gma_mediation_chartboost: ^1.0.0

Manuel Entegrasyon

Chartboost için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı ayıklayın ve ayıklanan eklenti klasörünü (ve içeriğini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml dosyanızdaki eklentiye referans verin:

dependencies:
  gma_mediation_chartboost:
    path: path/to/local/package

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, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili 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) şartlarını yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel verileri 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 3.1.0 sürümü için Google Mobile Ads uyumlulaştırma eklentisi Chartboost.AddDataUseConsent() yöntemini içerir. Aşağıdaki örnek kod, veri kullanımı iznini NonBehavioral olarak ayarlar. Bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sını kullanarak reklam istemeden önce yapmanız önerilir.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

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ı 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 her reklam ağı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 3.1.0 sürümü için Google Mobile Ads uyumlulaştırma eklentisi Chartboost.AddDataUseConsent() yöntemini içerir. Aşağıdaki örnek kod, veri kullanımı iznini OptInSale olarak ayarlar. Bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sını kullanarak reklam istemeden önce yapmanız önerilir.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

5. adım: Gerekli kodu ekleyin

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

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

Hata kodları

Adaptör Chartboost'tan reklam alamıyorsa yayıncılar aşağıdaki sınıflar altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

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

GADMAdapterChartboost
GADMediationAdapterChartboost

Bir reklam yüklenemezse Chartboost adaptörü tarafından oluşturulan kodlar ve bunlarla birlikte gönderilen mesajlar şunlardır:

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

1.0.0

• İlk sürüm.
• Chartboost Android adaptörü 9.8.1.0 sürümü ile uyumluluğu doğrulandı
• Chartboost iOS adaptörü 9.8.0.0 sürümü ile uyumluluğu doğrulandı
• Google Mobile Ads Flutter eklentisi 5.2.0 sürümü ile oluşturulup test edilmiştir.