Chartboost'u Uyumlulaştırma ile Entegre Etme

Bu kılavuzda, Chartboost'tan reklam yüklemek ve görüntülemek için uyumlulaştırma ve ş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. 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ı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

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

Chartboost 'i GDPR ve ABD eyalet düzenlemeleri 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

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.

• Chartboost bağdaştırıcısının en son sürümünü Changelog'daki indirme bağlantısından indirin ve projenizde ChartboostAdapter.framework bağlantısını oluşturun.

• 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 kodda, veri kullanımı izni CHBGDPRConsentNonBehavioral 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.GDPR(CHBDataUseConsent.GDPR.Consent.nonBehavioral)
Chartboost.addDataUseConsent(dataUseConsent)

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

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

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 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.2.0 SDK sürümünde addDataUseConsent yöntemini ekledi. Aşağıdaki örnek kod, CHBCCPAConsentOptInSale için veri kullanımı iznini ayarlar. Bu yöntemi çağırmayı seçerseniz Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce bunu 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üğü

9.8.0.0 sürümü

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

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

• Google Mobile Ads SDK'sı sürüm 11.11.0.
• 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ı 11.10.0 sürümü.
• Chartboost SDK sürümü 9.7.0.

Sürüm 9.7.0.0

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

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

• 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ü

• Şu an için en az iOS 12.0 sürümü gereklidir.
• Artık Google Mobile Ads SDK'sının 11.0 veya üzeri bir sürümünü gerektirmektedir.
• ChartboostAdapter.xcframework içindeki çerçevelere Info.plist dahil edildi.

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

• Google Mobile Ads SDK'sı 11.0.1 sürümü.
• 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ı sürüm 10.14.0.
• 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ı sürüm 10.12.0.
• Chartboost SDK sürümü 9.5.1.

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 tasarlanıp test edilmiştir:

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

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

9.3.0.0 sürümü

• 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ürümü 9.3.0.

Sürüm 9.2.0.0

• ChartboostAdapter üstbilgi dosyasında GADMChartboostExtras içe aktarma kaldırıldı.
• Chartboost SDK'sının 9.2.0 sürümüyle uyumluluğu 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 minimum iOS sürümü 11.0'a yükseltildi.

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

• Google Mobile Ads SDK'sı 10.0.0 sürümü.
• 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ının 9.0.0 sürümü ile uyumluluk 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ı 9.0.0 sürümü.
• 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ı.

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

• 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ı sürüm 8.12.0.
• Chartboost SDK sürümü 8.5.0.

8.4.2.0 sürümü

• Chartboost SDK 8.4.2 ile uyumluluk doğrulandı.

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

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

Sürüm 8.4.1.1

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

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

• 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 8.4.1 ile uyumluluk doğrulandı.
• Artık Google Mobile Ads SDK'sının 8.1.0 veya daha sonraki bir sürümünü gerektirmektedir.

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

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

Sürüm 8.4.0.1

• Standartlaştırılmış adaptör hata kodları ve mesajları eklendi.
• Bağdaştırıcı, .xcframework biçimini kullanacak şekilde güncellendi.
• Artık Google Mobile Ads SDK'sının 8.0.0 veya daha sonraki bir sürümünü gerektirmektedir.

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

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

Sürüm 8.4.0.0

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

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

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

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.
• Bağdaştırıcı, uyarlanabilir banner isteklerini destekleyecek şekilde güncellendi.

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

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

8.2.1.0 sürümü

• Chartboost SDK'sı 8.2.1 ile uyumluluk doğrulandı.
• Artık Google Mobile Ads SDK'sı 7.64.0 veya daha yeni bir sürüm gereklidir.
• 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ı 7.64.0 sürümü.
• Chartboost SDK sürümü 8.2.1.

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ı sürüm 7.61.0.
• 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.
• Bağdaştırıcı, Chartboost'un yeni API'sini kullanacak şekilde güncellendi ve kullanımdan kaldırılmış 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.

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

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

Sürüm 8.1.0.0

• Chartboost SDK'sı 8.1.0 ile uyumluluk doğrulandı.
• Google Mobile Ads SDK'sı için gereken minimum 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'sı 7.5.0 ile uyumluluk 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.

7.3.0.0 sürümü

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

Sürüm 7.2.0.1

• 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 7.1.1 ile uyumluluğu 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 7.0.4 ile uyumluluk doğrulandı.

7.0.3.0 sürümü

• Chartboost SDK 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 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'sı 6.6.1 ile uyumluluk doğrulandı.

Sürüm 6.6.0.0

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

6.5.2.1 sürümü

• 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.
• Gerekli minimum Chartboost SDK sürümü 6.5.1 olarak 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üle dayalı video reklamları ve geçiş reklamlarını destekler.