AdColony'yi uyumlulaştırma ile entegre etme

Bu kılavuzda, uyumlulaştırma özelliğini kullanarak AdColony'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sını nasıl kullanacağınız gösterilmektedir. Bu yöntem, hem teklifli sistem hem de şelale entegrasyonlarını kapsar. Bu makalede, AdColony'nin bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve AdColony SDK ile bağdaştırıcısının bir Unity uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

AdColony için AdMob 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

Koşullar

  • Unity 5.6 veya sonraki sürümler
  • En son Google Mobile Ads SDK'sı
  • [Teklifli sistem için]: AdColony 1.0.5 veya üstü için Google Mobile Ads uyumlulaştırma eklentisi (en son sürüm önerilir)
  • Android'de dağıtmak için
    • Android API düzeyi 19 veya üstü
  • iOS'te dağıtmak için
    • 12.0 veya üstü iOS dağıtım hedefi
  • Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Unity projesi. Ayrıntılar için Başlarken bölümüne bakın.
  • Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu

1. Adım: AdColony kullanıcı arayüzünde yapılandırmaları ayarlayın

Kaydolun ve AdColony hesabınıza giriş yapın. Yeni Uygulama Kur düğmesini tıklayarak uygulamanızı AdColony yayıncı kontrol paneline ekleyin.

Yeni AdColony uygulaması kurulumu

Formu doldurun ve uygulamanızı AdColony'ye eklemek için sayfanın alt kısmındaki Oluştur'u tıklayın.

Android

AdColony uygulama oluşturma

iOS

AdColony uygulama oluşturma

Uygulamanız oluşturulduktan sonra Uygulama Kimliğinizi, uygulamanızın Temel Uygulama Bilgileri bölümünün altındaki Para Kazanma > Uygulamalar'a giderek edinebilirsiniz.

Android

AdColony uygulama kimliği

iOS

AdColony uygulama kimliği

Ardından, uygulama sayfanızın Reklam Alt Bölgeleri bölümündeki Yeni Reklam Bölgesi Kur düğmesini tıklayarak yeni bir Reklam Alt Bölgesi oluşturun. Zaten bir reklam alt bölgeniz olsa bile AdMob ile uyumlulaştırma için yeni bir reklam alt bölgesi oluşturmanızı öneririz.

Android

AdColony alt bölge ayarlama

iOS

AdColony alt bölge ayarlama

Reklam yerleşimi oluşturmayla ilgili ek talimatlar için, tercih ettiğiniz reklam biçimine karşılık gelen sekmeyi seçin.

  1. Zone is Active? (Bölge Etkin mi?) değerini Evet olarak ayarlayın.

  2. Reklam Bölgeniz için bir Ad girin.

  3. Reklam Bölgesi Boyutu olarak Banner'ı seçin.

  4. Günlük oynatma sınırı için bir değer girin.

Geçişli

  1. Zone is Active? (Bölge Etkin mi?) değerini Evet olarak ayarlayın.

  2. Reklam Bölgeniz için bir Ad girin.

  3. Alt Bölge Türü olarak Videodan Önce Gösterilen/Geçiş Reklamı'nı seçin.

  4. Günlük oynatma sınırı için bir değer girin.

Ödül olarak verildi

  1. Zone is Active? (Bölge Etkin mi?) değerini Evet olarak ayarlayın.

  2. Reklam Bölgeniz için bir Ad girin.

  3. Alt Bölge Türü olarak Değer Değişimi/V4VC'yi seçin.

  4. Yalnızca İstemci Tarafı mı? seçeneğini Evet olarak ayarlayın ve bir Sanal Para Birimi Adı, Kullanıcı Başına Günlük Maksimum Video ve Ödül Tutarı girin.

  5. Günlük oynatma sınırı için bir değer girin.

Reklam Bölgesini oluşturma işlemini tamamladığınızda Oluştur düğmesini tıklayın.

Ad Zone oluşturulduktan sonra, Ad Zone'un Integration (Entegrasyon) bölümünde Zone ID'yi (Alt Bölge Kimliği) bulabilirsiniz. Alt Bölge Kimliği bir sonraki adımda kullanılacaktır.

AdColony alt bölge kimliği

AdColony API Anahtarınızı bulma

Teklif

Bu adım, teklif entegrasyonları için gerekli değildir.

Şelale

AdMob Reklam birimi kimliğinizi ayarlamak için AdColony API Anahtarınıza ihtiyacınız olacaktır. AdColony yayıncı kontrol panelinizde Hesap Ayarları'na giderek API Anahtarınızı bulun.

AdColony ayarları

Test modunu aç

AdColony'de test reklamlarını etkinleştirmek için AdColony kontrol panelinize gidin ve Para Kazanma > Uygulamalar'a gidin. Uygulamanızın Reklam Alt Bölgeleri bölümünde test reklamlarını etkinleştirmek istediğiniz Alt Bölgenizi seçin. Test reklamları, Geliştirme bölümünde Yalnızca test reklamları gösterilsin mi? seçeneğine karşılık Evet seçeneği işaretlenerek etkinleştirilebilir.

AdColony testi

2. Adım: Kullanıcı arayüzünde AdColony talebini AdMob ayarlayın

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

Android

Talimatlar için Android kılavuzunun 2. adımına bakın.

iOS

Talimatlar için iOS rehberinin 2. adımına göz atın.

AdColony'yi GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme

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

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

Changelog'daki indirme bağlantısından AdColony için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin ve zip dosyasından GoogleMobileAdsAdColonyMediation.unitypackage dosyasını çıkarın.

Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsAdColonyMediation.unitypackage dosyasını bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.

Ardından, Öğeler > Play Hizmetleri Çözümleyicisi > Android Çözümleyici > Çözücüye Zorla'yı seçin. External Dependency Manager kitaplığı, bağımlılık çözümleme işlemini en baştan gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

4. Adım: AdColony SDK'da gizlilik ayarlarını uygulayın

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.

AdColony sürüm 2.6.1 için Google Mobile Ads uyumlulaştırma eklentisi, AdColony SDK'sına izin vermenizi sağlamak amacıyla SetPrivacyFrameworkRequired() ve SetPrivacyConsentString() yöntemleriyle AdColonyAppOptions sınıfını ekledi. Aşağıdaki örnek kod, izin bilgilerinin AdColony bağdaştırıcısına nasıl iletileceğini gösterir. Bu bağdaştırıcı, daha sonra AdColony'nin başlatma yönteminde kullanılır. Bu seçeneklerin, AdColony'nin SDK'sına doğru şekilde yönlendirildiğinden emin olmak için Google Mobile Ads SDK'sını başlatmadan önce ayarlanmalıdır.

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.GDPR, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.GDPR, "myPrivacyConsentString");

Daha fazla ayrıntı ve yöntemde sağlanabilecek değerler için AdColony'nin Tüketici Gizliliği makalesini ve Gizlilik Yasaları uygulama kılavuzunu inceleyin.

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.

AdColony sürüm 2.6.1 için Google Mobile Ads uyumlulaştırma eklentisi, AdColony SDK'sına izin vermenizi sağlamak amacıyla SetPrivacyFrameworkRequired() ve SetPrivacyConsentString() yöntemleriyle AdColonyAppOptions sınıfını ekledi. Aşağıdaki örnek kod, izin bilgilerinin AdColony bağdaştırıcısına nasıl iletileceğini gösterir. Bu bağdaştırıcı, daha sonra AdColony'nin başlatma yönteminde kullanılır. Bu seçeneklerin, AdColony'nin SDK'sına doğru şekilde yönlendirildiğinden emin olmak için Google Mobile Ads SDK'sını başlatmadan önce ayarlanmalıdır.

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.CCPA, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.CCPA, "myPrivacyConsentString");

Daha fazla ayrıntı ve yöntemde sağlanabilecek değerler için AdColony'nin Tüketici Gizliliği makalesini ve Gizlilik Yasaları uygulama kılavuzunu inceleyin.

5. Adım: Gerekli kodu ekleyin

Android

AdColony entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için AdColony dokümanlarındaki talimatları uygulayın.

6. Adım: Uygulamanızı test etme

Test reklamlarını etkinleştir

AdMob için test cihazınızı kaydettiğinizden ve AdColony kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.

Test reklamlarını doğrulama

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

İsteğe bağlı adımlar

Android

İzinler

En iyi performans için AdColony, Unity projenizin Assets/Plugins/Android/GoogleMobileAdsPlugin dizininde bulunan AndroidManifest.xml dosyasına aşağıdaki isteğe bağlı izinleri eklemenizi önerir.

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

iOS

iOS entegrasyonu için ek adımlara gerek yoktur.

Ağa özgü parametreler

AdColony uyumlulaştırma paketi, AdColonyMediationExtras ve AdColonyAppOptions sınıflarını kullanarak bağdaştırıcıya geçirilebilecek ek yapılandırma ve istek parametrelerini destekler.

AdColonyMediationExtras sınıfı aşağıdaki yöntemleri içerir:

SetShowPrePopup(bool)
Reklam göstermeden önce pop-up gösterilip gösterilmeyeceğini ayarlar. Reklamlar gösterilmeden önce pop-up gösterilmesini istemiyorsanız bu değeri false olarak ayarlayın.
SetShowPostPopup(bool)
Bir reklam gösterildikten sonra pop-up'ın gösterilip gösterilmeyeceğini ayarlar. Reklamlar gösterildikten sonra pop-up gösterilmesini istemiyorsanız false olarak ayarlayın.

AdColonyAppOptions sınıfı aşağıdaki yöntemleri içerir:

SetUserId(string)
AdColony Ad Server için daha fazla analiz sağlayan AdColony SDK'sı için User-ID'yi ayarlar.
SetTestMode(bool)
AdColony SDK için test modunun etkinleştirilip etkinleştirilmeyeceğini belirler.

Aşağıda, bu yapılandırmaları ve reklam isteği parametrelerini nasıl ayarlayacağınıza dair bir kod örneği verilmiştir:

// Set app-level configurations
AdColonyAppOptions.SetUserId("myUser");
AdColonyAppOptions.SetTestMode(true);

// Set ad request parameters
AdColonyMediationExtras extras = new AdColonyMediationExtras();
extras.SetShowPrePopup(true);
extras.SetShowPostPopup(true);

AdRequest request = new AdRequest.Builder()
        .AddMediationExtras(extras)
        .Build();

Hata kodları

Bağdaştırıcı AdColony'den reklam alamazsa yayıncılar aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Android

com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter

iOS

GADMAdapterAdColony
GADMediationAdapterAdColony

Aşağıda, bir reklam yüklenemediğinde AdColony bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajlar verilmiştir:

Android

Hata kodu Neden
100 AdColony SDK bir hata döndürdü.
101 Geçersiz sunucu parametreleri (ör. eksik Bölge Kimliği).
102 Aynı Bölge Kimliği için zaten bir reklam istendi.
103 AdColony SDK'sı bir başlatma hatası döndürdü.
104 İstenen banner boyutu geçerli bir AdColony reklam boyutuyla eşleşmiyor.
105 Reklam yüklenmediğinden sunum hatası oluştu.
106 AdColony SDK'sını başlatmak için kullanılan bağlam bir Activity örneği değildi.

iOS

Hata kodu Neden
0 - 3 AdColony SDK bir hata döndürdü. Daha ayrıntılı bilgi için belgeleri inceleyin.
101 Geçersiz sunucu parametreleri (ör. eksik Bölge Kimliği).
102 Reklamı sunan kök görüntüleme denetleyicisi nil.
103 AdColony SDK'sı bir başlatma hatası döndürdü.
104 AdColony SDK, beş saniyelik süre içinde iki kez yapılandırılmasını desteklemez.
105 Reklam gösterilemedi.
106 Ödüllü reklamlar için kullanılan alt bölge, AdColony portalında ödüllü bir alt bölge değildir.

AdColony Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

Sürüm 2.6.3 (Devam Ediyor)

  • MediationExtras için yinelenen tanım uyarısı düzeltildi.

Sürüm 2.6.2

Sürüm 2.6.1

  • GDPR ve CCPA'yı desteklemek için AdColonyAppOptions sınıfındaki gizlilik API'leri aşağıdaki yöntemlere güncellendi:
    • SetGDPRRequired(bool) -> SetPrivacyFrameworkRequired(AdColonyPrivacyFramework, bool)
    • IsGDPRRequired() -> GetPrivacyFrameworkRequired(AdColonyPrivacyFramework)
    • SetGDPRConsentString(string)-> SetPrivacyConsentString(AdColonyPrivacyFramework, string)
    • GetGDPRConsentString() -> GetPrivacyConsentString(AdColonyPrivacyFramework)
  • AdColony Android bağdaştırıcısının 4.8.0.1 sürümünü destekler.
  • AdColony iOS bağdaştırıcısının 4.9.0.2 sürümünü destekler.
  • Google Mobil Reklamlar Unity Eklentisi sürüm 7.4.1 ile geliştirilip test edilmiştir.

Sürüm 2.6.0

Sürüm 2.5.0

Sürüm 2.4.1

Sürüm 2.4.0

Sürüm 2.3.0

Sürüm 2.2.0

Sürüm 2.1.0

Sürüm 2.0.3

Sürüm 2.0.2

Sürüm 2.0.1

Sürüm 2.0.0

Sürüm 1.0.6

Sürüm 1.0.5

  • Aşağıdaki yöntemler AdColonyMediationExtras Builder sınıfından AdColonyAppOptions sınıfına taşındı:
    • SetGDPRRequired()
    • SetGDPRConsentString()
    • SetUserId()
    • SetTestMode()
  • Aşağıdaki yöntemler AdColonyAppOptions sınıfına eklendi:
    • IsGDPRRequired()
    • GetGDPRConsentString()
    • GetUserId()
    • IsTestMode()
  • SetZoneId() yöntemi AdColonyMediationExtras Builder sınıfından kaldırıldı.
  • AdColony Android bağdaştırıcısının 3.3.10.1 sürümünü destekler.
  • AdColony iOS bağdaştırıcısının 3.3.7.2 sürümünü destekler.

Sürüm 1.0.4

  • Eklenti, yeni açık beta Ödüllü API'yi destekleyecek şekilde güncellendi.
  • AdColony Android bağdaştırıcısının 3.3.8.1 sürümünü destekler.
  • AdColony iOS bağdaştırıcısının 3.3.6.1 sürümünü destekler.

Sürüm 1.0.3

  • AdColony Android bağdaştırıcısının 3.3.5.1 sürümünü destekler.
  • AdColony iOS bağdaştırıcısının 3.3.5.0 sürümünü destekler.

Sürüm 1.0.2

  • AdColony Android SDK'sının 3.3.4 sürümünü destekler.
  • AdColony iOS SDK'sının 3.3.4 sürümünü destekler.
  • AdColonyMediationExtras Builder sınıfındaki SetTestMode() artık Android'de yoksayılıyor. Yayıncılar artık AdRequest Builder sınıfından AddTestDevice() aracılığıyla bir test cihazı belirterek Android için AdColony'den test reklamları isteyebilir.
  • Aşağıdaki yöntemler AdColonyMediationExtras Builder sınıfına eklendi:
    • SetGDPRRequired()
    • SetGDPRConsentString()

Sürüm 1.0.1

  • AdColony Android SDK 3.3.0-unity sürümünü destekler.
  • AdColony iOS SDK'sı 3.3.0 sürümünü destekler.

Sürüm 1.0.0

  • İlk sürüm!
  • AdColony Android SDK'sının 3.3.0 sürümünü destekler.
  • AdColony iOS SDK'sı 3.3.0 sürümünü destekler.