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

Unity Reklamlarını Uyumlulaştırma ile Entegre Etme

Bu kılavuzda, şelale entegrasyonlarını ele alan uyumlulaştırma özelliğini kullanarak Unity Ads'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu kılavuzda, Unity Reklamlarının reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Unity Ads SDK'sı ile bağdaştırıcısının bir uygulamaya nasıl entegre edileceği Android ele alınmıştır.

Desteklenen entegrasyonlar ve reklam biçimleri

Unity Ads 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ü

En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu

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

Unity Ads'e kaydolun veya giriş yapın.

Proje oluşturma

Unity Reklam Kontrol Paneli'nde Projeler'e gidin ve Proje Oluştur'u tıklayın.

Formu doldurun ve projenizi eklemek için Proje Oluştur'u tıklayın.

Para kazanma > Başlayın'a gidin ve Başlayın'ı tıklayın.

Proje Kurulumu iletişim kutusunda, Uyumlulaştırma İş Ortağı için Uyumlulaştırmayı kullanmayı planlıyorum'u ve Google AdMob'u seçip İleri'yi tıklayın.

Reklam ayarlarınızı belirleyin ve Sonraki'yi tıklayın.

Formu doldurun ve Proje Ekle'yi tıklayın.

Oyun Kimliğini not edin.

Reklam Birimi Oluşturma

Para Kazanma > Reklam Birimleri'ne gidin ve Reklam Birimi Ekle'yi tıklayın.

Bir Reklam Birimi Adı girin, ardından Platform ve Reklam Biçimi'ni seçin.

Son olarak, reklam biriminizi kaydetmek için Oluştur'u tıklayın.

Yerleşim Ekleme

Proje oluşturulduktan sonra Para Kazanma > Yerleşimler'e gidin. Yeni bir yerleşim oluşturmak amacıyla reklam biriminiz için Yerleşim Ekle'yi tıklayın.

Gerekli ayrıntıları doldurun ve Yerleşim Ekle'yi tıklayın.

Yerleşim Kimliğini not edin.

Kimlik bilgilerinizi alın

Reklam birimi kimliğinizi oluşturmak için Oyun Kimliği ve Yerleşim Kimliği'ne ek olarak Unity Ads API Anahtarınız ve Kuruluş temel kimliğiniz de gerekir.Ad Manager

Para Kazanma > Kurulum > API Yönetimi'ne gidin ve Monetization Stats API Erişim Anahtarı'nı not edin.

Ardından, Para Kazanma > Kuruluş Ayarları'na gidin ve Temel kuruluş kimliğini not edin.

Test modunu aç

Test modu Unity Ads kontrol panelinden etkinleştirilebilir. Projenizin ayarları altında Test sekmesini seçin.

Google Play Store yanındaki düzenle düğmesini tıklayıp İstemci test modunu geçersiz kıl seçeneğini işaretleyerek ve Test modunu tüm cihazlar için zorunlu olarak AÇIK (ör. test reklamları kullan) seçeneğini belirleyerek uygulamanız için test modunu zorunlu kılabilirsiniz.

Alternatif olarak, Test Cihazı Ekle düğmesini tıklayarak test modunu belirli cihazlar için etkinleştirebilirsiniz.

Formu doldurun ve Kaydet'i tıklayın.

2. Adım: Kullanıcı arayüzünde Unity Ads talebi oluşturma Ad Manager

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

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

Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın.

Getiri grubunuz için benzersiz bir Ad girin, Durum'u Etkin olarak ayarlayın, Reklam Biçimi'ni seçin ve Envanter türü'nü Mobil Uygulama olarak ayarlayın. Hedefleme > Envanter bölümünün altında Envanter ve Mobil uygulama altında uyumlulaştırma eklemek istediğiniz reklam birimini seçin.

Ardından, Getiri iş ortağı ekle düğmesini tıklayın.

Unity Adsiçin zaten bir Getiri iş ortağınız varsa bunu seçebilirsiniz. Aksi takdirde, Yeni bir getiri iş ortağı oluştur'u seçin.

Reklam ağı olarak Unity Ads'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 and Organization core ID değerini girin.

Getiri iş ortağı seçildikten sonra Entegrasyon türü olarak Mobil SDK Uyumlulaştırması'nı, Platform olarak Android'yi ve Durum olarak Etkin'i seçin. Bir önceki bölümde verilenGame ID and Placement ID kodunu girin. Ardından, Varsayılan BGBM değerini girin.

olduğu gibi, hedeflenen uygulamayla ilişkilendirilmelidir.

İşiniz bittiğinde sayfanın alt kısmındaki Kaydet'i tıklayın.

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

3. Adım: Unity Ads 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. Unity Ads 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.unity3d.ads:unity-ads:4.9.3")
    implementation("com.google.ads.mediation:unity:4.9.3.0")
}

Manuel entegrasyon

GitHub deposundan en yeni Unity Ads SDK'sını (unity-ads.aar) indirip projenize ekleyin.
Google'ın Maven deposunda Unity Reklam bağdaştırıcısı yapılarına gidin. En son sürümü seçin, Unity reklam bağdaştırıcısının .aar dosyasını indirin ve projenize ekleyin.

4. Adım: Unity Ads SDK'sında gizlilik ayarlarını uygulayın

AB kullanıcı rızası alma 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.

SDK 2.0.0 sürümünde, Unity Ads gizlilik ayarlarını destekleyen bir API ekledi. Aşağıdaki örnek kod, bu izin bilgilerinin Unity Ads SDK'sına nasıl iletileceğini gösterir. İzin bilgilerini Unity Ads SDK'sına manuel olarak aktarmayı seçerseniz bu kodun Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce çağrılması önerilir.

Java

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();

Kotlin

import com.unity3d.ads.metadata.MetaData
// ...

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()

Unity Ads Gizlilik İzni ve veri API'leri ile GDPR'ye uygunluk daha fazla ayrıntı ve her yöntemle sağlanabilecek değerler için kılavuzları 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.

Java

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();

Kotlin

import com.unity3d.ads.metadata.MetaData
// ...

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()

Unity Ads Gizlilik Kullanıcı Rızası ve veri API'leri ile CCPA'ya uygunluk daha fazla ayrıntı ve her yöntemde sağlanabilecek değerler için kılavuzları inceleyin.

5. Adım: Gerekli kodu ekleyin

Unity Ads entegrasyonları için ek koda gerek yoktur.

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

Test reklamlarını etkinleştir

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

Test reklamlarını doğrulama

Unity Adsreklam kaynağından test reklamları aldığınızı doğrulamak için Unity Ads (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

Hata kodları

Bağdaştırıcı Unity Ads'den reklam alamazsa yayıncılar aşağıdaki sınıfların altında ResponseInfo.getAdapterResponse() kullanarak reklam yanıtındaki temel hatayı kontrol edebilirler:

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

Bir reklam yüklenemediğinde UnityAds bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajları burada bulabilirsiniz:

Hata kodu	Neden
0-10	UnityAds SDK'sı bir hata döndürdü. Daha fazla bilgi için kodu inceleyin.
101	Kullanıcı arayüzünde yapılandırılan UnityAds sunucu parametreleri Ad Manager eksik/geçersiz.
102	UnityAds NO_FILL durumuna sahip bir yerleşim döndürdü.
103	UnityAds, DEVRE DIŞI durumuna sahip bir yerleşim döndürdü.
104	UnityAds boş bağlam içeren bir reklam göstermeye çalıştı.
105	Unity Ads'den reklamları başlatmak, yüklemek ve/veya göstermek için kullanılan bağlam bir etkinlik örneği değildir.
106	UnityAds gösterilmeye hazır olmayan bir reklam göstermeye çalıştı.
107	Cihazda UnityAds desteklenmiyor.
108	UnityAds yerleşim başına aynı anda yalnızca 1 reklam yükleyebilir.
109	UnityAds işlemi HATA durumuyla tamamlandı.
200-204	UnityAds Banner'a özgü hata. Daha fazla bilgi için kodu inceleyin.
0-9	UnityAds SDK'sı bir hata döndürdü. Daha fazla bilgi için Unity belgelerini inceleyin.
101	Kullanıcı arayüzünde yapılandırılan UnityAds sunucu parametreleri Ad Manager eksik/geçersiz.
102	Cihaz UnityAds tarafından desteklenmiyor.
103	UnityAds, kUnityAdsFinishStateError hata durumuyla sunmayı tamamladı.
104	Unity reklam nesnesi, başlatıcıyı çağırdıktan sonra boş.
105	Reklam hazır olmadığı için Unity Reklamları gösterilemedi.
106	UnityAds, geri çağırmayı kUnityAdsYerleşimStateNoFill yerleşim durumuyla değiştirdi.
107	UnityAds bir yerleşimi çağırırken geri çağırmayı kUnityAdsYerleşimStateDisabled yerleşim durumuyla değiştirdi.
108	Bu yerleşim için zaten bir reklam yüklendi. UnityAds SDK'sı aynı yerleşim için birden fazla reklam yüklemeyi desteklemez.