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

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 uygulamaya nasıl Android entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

AdColony 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 19 veya üstü

[Teklifli sistem için]: AdColony bağdaştırıcısı 3.3.10.1 veya sonraki sürümleri (en son sürüm önerilir)

En son Google Mobile Ads SDK'sı
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.

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.

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 Ad Manager ile uyumlulaştırma için yeni bir reklam alt bölgesi oluşturmanızı öneririz.

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.

Zone is Active? (Bölge Etkin mi?) değerini Evet olarak ayarlayın.
Reklam Bölgeniz için bir Ad girin.
Reklam Bölgesi Boyutu olarak Banner'ı seçin.
Günlük oynatma sınırı için bir değer girin.

Geçişli

Zone is Active? (Bölge Etkin mi?) değerini Evet olarak ayarlayın.
Reklam Bölgeniz için bir Ad girin.
Alt Bölge Türü olarak Videodan Önce Gösterilen/Geçiş Reklamı'nı seçin.
Günlük oynatma sınırı için bir değer girin.

Ödül olarak verildi

Zone is Active? (Bölge Etkin mi?) değerini Evet olarak ayarlayın.
Reklam Bölgeniz için bir Ad girin.
Alt Bölge Türü olarak Değer Değişimi/V4VC'yi seçin.
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.

Not: Burada belirtilen ödül değeri, kullanıcı arayüzünde ödül değerleri geçersiz kılınmadığı sürece bağdaştırıcı tarafından yönlendirilir Ad Manager.
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

Ad Manager 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 Ad Manager ayarlayın

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

Şirketlere AdColony Ekle

Teklif

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

Şelale

Yönetici > Şirketler'e gidin ve ardından Tüm şirketler sekmesinde Yeni şirket düğmesini tıklayın. Reklam ağı'nı seçin.

Reklam ağı olarak AdColony'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 API Key değerini girin.

Kullanıcı adı veya şifre girmenize gerek yoktur. İşlem tamamlandığında Kaydet'i tıklayın.

Güvenli sinyal paylaşımını etkinleştirin

Teklif

Yönetici > Genel ayarlar'a gidin. Ad Exchange hesap ayarları sekmesine gidip Güvenli sinyal paylaşımı'nı inceleyip etkinleştirin. Save'i (Kaydet) tıklayın.

Şelale

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

Teklifli sistemi AdColony yapılandırın

Teklif

Yayınlama > Teklif Verenler'e gidin ve SDK Teklifi sekmesinin altında Yeni teklif veren'i tıklayın.

Teklif veren olarak AdColony simgesini seçin.

Bu teklif verenin sinyal kitaplığını izin verilen sinyaller listesine ekle ve Sinyallerin bu teklif verenle paylaşılmasına izin ver seçeneklerini açık duruma getirin. Ardından Devam'ı tıklayın.

Devam'ı tıklayın.

Done'ı (Bitti) tıklayın.

Şelale

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

Reklam birimi eşlemesini yapılandır

Teklif

Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Verme sekmesi altındaAdColony şirketini seçin.

Reklam birimi eşleme sekmesine gidin ve Yeni reklam birimi eşleme'yi tıklayın.

Belirli reklam birimi'ni seçin. Bir reklam birimi ve biçim seçin, Envanter türü olarak Mobil uygulamayı ve Mobil uygulamanızı seçin. Ardından, bir önceki bölümde aldığınızApp ID and Zone ID kodunu girin. Son olarak Kaydet'i tıklayın.

Şelale

Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın. Mobil uygulamanızı seçin.

Aşağı kaydırın ve Getiri iş ortağı ekle'yi tıklayın.

Önceki bölümde AdColony şirket için oluşturduğunuzu seçin. Entegrasyon türü olarak Mobil SDK uyumlulaştırması'nı, Platform olarak Android'yi ve Durum olarak Etkin'i seçin.

Önceki bölümde belirtilen App ID and Zone ID değerini ve Varsayılan BGBM değerini girin. Kaydet'i tıklayın.

Not: Otomatik veri toplama özelliğinin bir uyumlulaştırma ağı için Dinamik BGBM değerini doğru şekilde hesaplayabilmesi için verileri toplaması birkaç gün sürer. eBGBM hesaplandığında sizin adınıza otomatik olarak güncellenir.

GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine AdColony 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 AdColony ekleyin.

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

Android Studio entegrasyonu (önerilir)

Uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulama bağımlılıklarını ve yapılandırmaları ekleyin. AdColony SDK'sının ve bağdaştırıcı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:adcolony:4.8.0.2")
}

Projeyi AndroidX'e taşı

AdColony SDK'sı, Android destek kitaplıklarına bağlıdır ancak en yeni Google Mobile Ads SDK'sı Jetpack kitaplıklarını kullanır.

AdColony SDK'sı ile Google Mobile Ads SDK'sının uyumlu olduğundan emin olmak için projenizin üst düzeyinde bir gradle.properties dosyası oluşturun ve aşağıdaki kodu ekleyin:

android.useAndroidX=true
android.enableJetifier=true

Bu işlem, Jetpack kitaplıklarını kullanmak için AdColony SDK ikili programını yeniden yazar. Bu ayarlar hakkında daha fazla bilgi için AndroidX taşıma rehberine bakın.

Manuel entegrasyon

AdColony Android SDK'yı indirin ve Library klasöründen adcolony.jar öğesini çıkarıp projenize ekleyin.
AdColony SDK'sı Ek Açıklama Destek Kitaplığı'na bağlıdır. Ek Açıklamalar Destek Kitaplığı'nın projenize nasıl ekleneceğiyle ilgili ayrıntılar için Ek Açıklamalarla Kod İncelemesini İyileştirme bölümüne bakın.
Google'ın Maven deposunda AdColony bağdaştırıcı yapılarına gidin. En son sürümü seçin, AdColony bağdaştırıcısının .aar dosyasını indirin ve projenize ekleyin.

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

AB İzni 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.

AdColony bağdaştırıcısı, AdColony'nin SDK'sına gönderilecek parametreleri özelleştirmek için AdColonyMediationAdapter.getAppOptions() yöntemini sağlar. Bu seçeneklerde GDPR için geçerli iki yöntem şunlardır: setPrivacyFrameworkRequired() ve setPrivacyConsentString(). Aşağıdaki örnek kod, daha sonra AdColony'nin başlatma yönteminde kullanılan izin bilgilerinin AdColony bağdaştırıcısına nasıl iletileceğini gösterir. 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.

Java

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter;
//...

AdColonyAppOptions appOptions = AdColonyMediationAdapter.getAppOptions();
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.GDPR, true);
appOptions.setPrivacyConsentString(AdColonyAppOptions.GDPR, "1");

Kotlin

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter
//...

val appOptions = AdColonyMediationAdapter.getAppOptions()
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.GDPR, true)
appOptions.setPrivacyConsentString(AdColonyAppOptions.GDPR, "1")

Bu yöntemlerde hangi değerlerin sağlanabileceği hakkında daha fazla ayrıntı için AdColony'nin GDPR uygulama ayrıntıları bölümüne 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.

AdColony bağdaştırıcısı, AdColony'nin SDK'sına gönderilecek parametreleri özelleştirmek için AdColonyMediationAdapter.getAppOptions() yöntemini sağlar. Bu seçeneklerde CCPA için geçerli iki yöntem şunlardır: setPrivacyFrameworkRequired() ve setPrivacyConsentString(). Aşağıdaki örnek kod, daha sonra AdColony'nin başlatma yönteminde kullanılan izin bilgilerinin AdColony bağdaştırıcısına nasıl iletileceğini gösterir. 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.

Java

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter;
//...

AdColonyAppOptions appOptions = AdColonyMediationAdapter.getAppOptions();
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.CCPA, true);
appOptions.setPrivacyConsentString(AdColonyAppOptions.CCPA, "1");

Kotlin

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter
//...

val appOptions = AdColonyMediationAdapter.getAppOptions()
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.CCPA, true)
appOptions.setPrivacyConsentString(AdColonyAppOptions.CCPA, "1")

Bu yöntemlerde hangi değerlerin sağlanabileceği hakkında daha fazla bilgi için AdColony'nin CCPA uygulama ayrıntılarını inceleyin.

5. Adım: Gerekli kodu ekleyin

AdColony entegrasyonu için ek kod gerekmez.

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

Test reklamlarını etkinleştir

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

İzinler

AdColony, en iyi performans için uygulamanızın 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" />

Geçiş reklamlarını ve ödüllü reklamları kullanma

Ağa özgü parametreler

AdColony bağdaştırıcısı, AdColonyBundleBuilder sınıfı kullanılarak bağdaştırıcıya iletilebilecek ek istek parametrelerini destekler. AdColonyBundleBuilder aşağıdaki yöntemleri içerir:

setShowPrePopup(boolean): Reklam göstermeden önce pop-up'ın gösterilip gösterilmeyeceğini ayarlar. Reklam gösterilmeden önce pop-up görüntülenmemesi için "false" (yanlış) değerine ayarlayın.
setShowPostPopup(boolean): Bir reklam gösterildikten sonra pop-up'ın gösterilip gösterilmeyeceğini ayarlar. Reklam gösterildikten sonra hiçbir pop-up gösterilmemesi için "false" (yanlış) değerine ayarlayın.

Aşağıda, bu reklam isteği parametrelerini nasıl ayarlayacağınıza ilişkin bir kod örneği verilmiştir:

Java

AdColonyBundleBuilder.setShowPrePopup(true);
AdColonyBundleBuilder.setShowPostPopup(true);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdColonyAdapter.class, AdColonyBundleBuilder.build())
  .build();
rewardedInterstitialAd.loadAd(request);

Kotlin

AdColonyBundleBuilder.setShowPrePopup(true)
AdColonyBundleBuilder.setShowPostPopup(true)

val request = AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdColonyAdapter::class.java, AdColonyBundleBuilder.build())
  .build()
rewardedInterstitialAd.loadAd(request)

Bağdaştırıcınızı ve SDK sürümlerinizi doğrulama

Bağdaştırıcı ve SDK sürümlerini günlüğe kaydetmek için aşağıdaki kod snippet'ini kullanın:

AdColonyMediationAdapter adapter = new AdColonyMediationAdapter();
VersionInfo adapterVersion = adapter.getVersionInfo();
VersionInfo sdkVersion = adapter.getSDKVersionInfo();
// Log the adapter patch version to 3 digits to represent the x.x.x.x versioning
// used by adapters.
Log.d("TAG", String.format(
    "Adapter version: %d.%d.%03d",
    adapterVersion.getMajorVersion(),
    adapterVersion.getMinorVersion(),
    adapterVersion.getMicroVersion()));
Log.d("TAG", String.format(
    "SDK version: %d.%d.%d",
    sdkVersion.getMajorVersion(),
    sdkVersion.getMinorVersion(),
    sdkVersion.getMicroVersion()));

Hata kodları

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

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

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

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