Chartboost'u uyumlulaştırma ile entegre etme

Bu kılavuzda, şelale entegrasyonlarını kapsayan AdMob Uyumlulaştırması, 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. iOS

Desteklenen entegrasyonlar ve reklam biçimleri

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

Şartlar

• 12.0 veya sonraki bir iOS dağıtım hedefi

• 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, AdMob reklam birimi kimliğinizi ayarlamak için Chartboost kullanıcı kimliği ve kullanıcı imzası gerektirir. 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ündeki Kullanıcı Kimliği ile Kullanıcı İmzası'nı not edin.

Test modunu etkinleştirme

Uygulamanızda test modunu etkinleştirmek için Chartboost kullanıcı arayüzünden Uygulama yönetimi sekmesine gidin, listeden uygulamanızı seçin ve Uygulama ayarlarını düzenle'yi tıklayın.

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 isteyebilir ve bir 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

CocoaPods'u kullanma (önerilir)

• Projenizin Podfile dosyasına aşağıdaki satırı ekleyin:

  pod 'GoogleMobileAdsMediationChartboost'
  

• Komut satırından şunu çalıştırın:

  pod install --repo-update

Manuel entegrasyon

• Chartboost SDK'sının en son sürümünü indirin ve Chartboost.framework ile CHAMoatMobileAppKit.framework'i projenize bağlayın.

• Değişiklikler Günlüğü'ndeki indirme bağlantısından Chartboost bağdaştırıcının en son sürümünü indirin ve ChartboostAdapter.framework dosyasını projenize bağlayın.

• Projenize aşağıdaki çerçeveleri ekleyin:

  • StoreKit
  • Foundation
  • CoreGraphics
  • WebKit
  • AVFoundation
  • UIKit

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) şartlarını 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.2.0 SDK sürümünde addDataUseConsent yöntemini ekledi. Aşağıdaki örnek kod, CHBGDPRConsentNonBehavioral 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.

let dataUseConsent = CHBDataUseConsent.GDPR(CHBDataUseConsent.GDPR.Consent.nonBehavioral)
Chartboost.addDataUseConsent(dataUseConsent)

CHBGDPRDataUseConsent *dataUseConsent = [CHBGDPRDataUseConsent gdprConsent:CHBGDPRConsentNonBehavioral];
[Chartboost addDataUseConsent:dataUseConsent];

Daha fazla ayrıntı ve her yöntemde sağlanabilecek değerler için Chartboost'un GDPR makalesine ve iOS 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ı 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 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, 8.2.0 SDK sürümünde addDataUseConsent yöntemini ekledi. Aşağıdaki örnek kodda, veri kullanımı izni CHBCCPAConsentOptInSale olarak ayarlanmıştır. Bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sı üzerinden reklam istemeden önce yapmanız önerilir.

let dataUseConsent = CHBDataUseConsent.CCPA(CHBDataUseConsent.CCPA.Consent.optInSale)
Chartboost.addDataUseConsent(dataUseConsent)

CHBCCPADataUseConsent *dataUseConsent = [CHBCCPADataUseConsent ccpaConsent:CHBCCPAConsentOptInSale];
[Chartboost addDataUseConsent:dataUseConsent];

Chartboost'un CCPA makalesini ve iOS Gizlilik Yöntemleri'ni inceleyin ve her yöntemde sağlayabileceğiniz değerleri öğrenin.

Hata kodları

Bağdaştırıcı Chartboost'tan reklam alamazsa aşağıdaki sınıfların altında GADResponseInfo.adNetworkInfoArray şu sınıflarda:

GADMAdapterChartboost
GADMediationAdapterChartboost

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 iOS Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü

Sürüm 9.8.0.0

• Chartboost SDK'sı 9.8.0 sürümü ile uyumluluk doğrulandı.

Aşağıdakilerle derlenip test edildi:

• Google Mobile Ads SDK'sı 11.11.0 sürümü.
• Chartboost SDK sürümü 9.8.0.

9.7.0.1 sürümü

• CFBundleShortVersionString, dört yerine üç bileşen içerecek şekilde güncellendi.

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

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

9.7.0.0 sürümü

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

Aşağıdakilerle derlenip test edildi:

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

9.6.0.1 sürümü

• Artık minimum iOS sürümü 12.0'dir.
• Artık Google Mobile Ads SDK'sının 11.0 veya daha yeni bir sürümü gereklidir.
• ChartboostAdapter.xcframework içindeki çerçevelere Info.plist dahil edildi.

Aşağıdakilerle derlenip test edildi:

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

9.6.0.0 sürümü

• Chartboost SDK'sının 9.6.0 sürümü ile uyumluluk doğrulandı.
• Kullanımdan kaldırılan GADMobileAds.sharedInstance.sdkVersion yöntemi GADMobileAds.sharedInstance.versionNumber ile değiştirildi.
• GADMediationInterstitialAd uygulaması eklendi.

Aşağıdakilerle derlenip test edildi:

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

Sürüm 9.5.1.0

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

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

• Google Mobile Ads SDK'sı 10.12.0 sürümü.
• Chartboost SDK'sı 9.5.1 sürümü

9.4.0.0 sürümü

• Chartboost SDK'sının 9.4.0 sürümü ile uyumluluk doğrulandı.

Aşağıdakilerle derlenip test edildi:

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

9.3.1.0 sürümü

• 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ı 10.7.0 sürümü.
• Chartboost SDK'sı 9.3.1 sürümü

Sürüm 9.3.0.0

• Chartboost SDK'sı 9.3.0 sürümüyle uyumluluğu doğrulandı.
• Artık minimum iOS sürümü 11.0'a yükseltildi.
• Artık Google Mobile Ads SDK'sı 10.4.0 veya daha yeni bir sürüm gereklidir.

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

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

Sürüm 9.2.0.0

• ChartboostAdapter başlık dosyasındaki GADMChartboostExtras içe aktarma işlemi kaldırıldı.
• Chartboost SDK'sının 9.2.0 sürümü ile uyumluluk doğrulandı.
• Artık Google Mobile Ads SDK'sı 10.0.0 veya daha yeni bir sürüm gereklidir.
• armv7 mimarisi için destek kaldırıldı.
• Artık iOS için en az 11.0 sürümü gereklidir.

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

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

Sürüm 9.1.0.0

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

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

• Google Mobile Ads SDK'sı 9.11.0 sürümü.
• Chartboost SDK sürümü 9.1.0.

9.0.0.0 sürümü

• Chartboost SDK'sı 9.0.0 sürümü ile uyumluluğu doğrulandı.
• Google Mobile Ads SDK'sı 9.10.0 sürümü ile uyumluluğu doğrulandı.
• Bağdaştırıcı, didRewardUser API'yi kullanacak şekilde güncellendi.
• Artık Google Mobile Ads SDK'sı 9.8.0 veya daha yeni bir sürüm gereklidir.

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

• Google Mobile Ads SDK'sı 9.10.0 sürümü.
• Chartboost SDK sürümü 9.0.0.

Sürüm 8.5.0.2

• Google Mobile Ads SDK'sı 9.0.0 sürümü ile uyumluluğu doğrulandı.
• Artık Google Mobile Ads SDK'sı 9.0.0 veya daha yeni bir sürüm gereklidir.

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

• Google Mobile Ads SDK'sı sürüm 9.0.0.
• Chartboost SDK'sı 8.5.0 sürümü

Sürüm 8.5.0.1.0

• CocoaPods'daki 8.5.0.1 sürümüne karşılık gelen Chartboost SDK'sı 8.5.0 ile uyumluluk doğrulandı.

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

• Google Mobile Ads SDK'sı 8.13.0 sürümü.
• Chartboost SDK sürümü 8.5.0.

Sürüm 8.5.0.0

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

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

• Google Mobile Ads SDK'sı 8.12.0 sürümü.
• Chartboost SDK'sı 8.5.0 sürümü

8.4.2.0 sürümü

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

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

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

8.4.1.1 sürümü

• Google Mobile Ads SDK'sının 8.0.0 veya sonraki bir sürümüne olan bağımlılık azaltıldı.

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

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

Sürüm 8.4.1.0

• Chartboost SDK'sı 8.4.1 ile uyumluluk doğrulandı.
• Artık Google Mobile Ads SDK'sının 8.1.0 veya daha yeni bir sürümü gereklidir.

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

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

Sürüm 8.4.0.1

• Standartlaştırılmış adaptör hata kodları ve mesajları eklendi.
• Adaptör, .xcframework biçimini kullanacak şekilde güncellendi.
• Artık Google Mobile Ads SDK'sı 8.0.0 veya daha yeni bir sürüm gereklidir.

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

• Google Mobile Ads SDK'sı 8.0.0 sürümü.
• Chartboost SDK sürümü 8.4.0.

Sürüm 8.4.0.0

• Chartboost SDK 8.4.0 ile uyumluluk doğrulandı.
• Artık Google Mobile Ads SDK'sının 7.68.0 veya daha yeni bir sürümü gereklidir.

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

• Google Mobile Ads SDK'sı 7.68.0 sürümü.
• Chartboost SDK'sı 8.4.0 sürümü

Sürüm 8.3.1.0

• Chartboost SDK'sı 8.3.1 ile uyumluluk doğrulandı.
• Artık Google Mobile Ads SDK'sı 7.66.0 veya daha yeni bir sürüm gereklidir.
• Artık minimum iOS sürümü 10.0 olmalıdır.
• Uyumlu banner isteklerini desteklemek için adaptör güncellendi.

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

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

8.2.1.0 sürümü

• Chartboost SDK 8.2.1 ile uyumluluğu doğrulandı.
• Artık Google Mobile Ads SDK'sının 7.64.0 veya sonraki bir sürümünü gerektirmektedir.
• Artık iOS için en az 9.0 sürümü gerekiyor.

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

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

Sürüm 8.2.0.0

• Chartboost SDK'sı 8.2.0 ile uyumluluğu doğrulandı.
• Artık Google Mobile Ads SDK'sının 7.61.0 veya daha yeni bir sürümü gereklidir.

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

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

Sürüm 8.1.0.1

• Zorunlu minimum Google Mobile Ads SDK sürümü 7.60.0 olarak güncellendi.
• Adaptör, Chartboost'un yeni API'sini kullanacak şekilde güncellendi ve desteği sonlandırılan API'ler kaldırıldı.
• Uyumlulayıcı artık aynı Chartboost konumunu kullanarak aynı biçime sahip birden fazla reklamın yüklenmesini destekliyor.
• Ödül, AdMob veya Ad Manager kullanıcı arayüzünde geçersiz kılınmazsa ödüllü reklamların ödül değeri artık 0 yerine Chartboost kullanıcı arayüzünde belirtilen değer olacaktır.

Birlikte tasarladığınız ve test ettiğiniz

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

Sürüm 8.1.0.0

• Chartboost SDK 8.1.0 ile uyumluluk doğrulandı.
• Zorunlu olan minimum Google Mobile Ads SDK sürümü 7.59.0 olarak güncellendi.
• i386 mimarisi desteği kaldırıldı.

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

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

Sürüm 8.0.4.0

• Chartboost SDK 8.0.4 ile uyumluluk doğrulandı.

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

• Google Mobile Ads SDK'sı 7.52.0 sürümü.
• Chartboost SDK sürümü 8.0.4.

8.0.1.1 sürümü

• Banner reklam isteğinde bulunmanın hiçbir dolgu döndürmediği sorun düzeltildi.

Sürüm 8.0.1.0

• Chartboost SDK 8.0.1 ile uyumluluk doğrulandı.
• Banner reklam isteğinde bulunma desteği eklendi.

7.5.0.1 sürümü

• Chartboost SDK'sını doğru şekilde başlatmak için kod eklendi.

Sürüm 7.5.0.0

• Chartboost SDK 7.5.0 ile uyumluluğu doğrulandı.
• Bağdaştırıcı, yeni ödüllü API'yi kullanacak şekilde güncellendi.
• Adaptör, birden fazla geçiş reklamı isteğini işleyebilecek şekilde güncellendi.
• Artık Google Mobile Ads SDK'sı 7.42.2 veya daha yeni bir sürüm gereklidir.

Sürüm 7.3.0.0

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

7.2.0.1 sürümü

• Adaptöre adapterDidCompletePlayingRewardBasedVideoAd: geri çağırma işlevi eklendi.

Sürüm 7.2.0.0

• Chartboost SDK 7.2.0 ile uyumluluk doğrulandı.

Sürüm 7.1.2.0

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

Sürüm 7.1.1.0

• Chartboost SDK'sı 7.1.1 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.4.0

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

7.0.3.0 sürümü

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

Sürüm 7.0.2.0

• Chartboost SDK'sı 7.0.2 ile uyumluluk doğrulandı.
• İki yeni Chartboost hata kodu için destek eklendi.

Sürüm 7.0.1.0

• Chartboost SDK 7.0.1 ile uyumluluk doğrulandı.

Sürüm 7.0.0.0

• Chartboost SDK 7.0.0 ile uyumluluk doğrulandı.

6.6.3.0 sürümü

• Chartboost SDK'sı 6.6.3 ile uyumluluk doğrulandı.
• "armv7s" mimarisi desteği kaldırıldı.
• Yayıncıların, modüler olmayan Chartboost SDK'sını içe aktaran bir modül olarak ChartboostAdapter.framework'ü içe aktarırken Swift'te derleme sorunuyla karşılaşmasına neden olan bir hata düzeltildi.

6.6.2.0 sürümü

• Chartboost SDK'sı 6.6.2 ile uyumluluk 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

• Chartboost SDK 6.6.0 ile uyumluluk doğrulandı.

Sürüm 6.5.2.1

• Bit kodu desteği etkinleştirildi.
• Chartboost bağdaştırıcısı artık bir çerçeve olarak dağıtılmaktadır.
• ChartboostAdapter.framework dosyasını projenize aktarmak için hedefinizin Derleme Ayarları bölümünde Allow Non-modular Includes in Framework Modules değerini YES olarak ayarladığınızdan emin olun.

Sürüm 6.5.2.0

• Sürüm adlandırma sistemi [Chartboost SDK sürümü].[adaptör yaması sürümü] olarak değiştirildi.
• Gereken minimum Chartboost SDK'sı 6.5.1 sürümüne güncellendi.
• Zorunlu olan minimum Google Mobile Ads SDK sürümü 7.10.1 olarak güncellendi.
• Birden fazla Chartboost reklam konumunu desteklemeyle ilgili bir hata düzeltildi.
• Uygulamalar artık geçiş reklamı kapatılmak üzereyken interstitialWillDismissScreen: geri çağırma işlevini alıyor.
• Uygulamalar artık ödül tabanlı bir video reklam açıldığında rewardBasedVideoAdDidOpen: geri çağırma işlevini alıyor.

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.