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

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

Bu kılavuzda, şelale entegrasyonlarını kapsayan arabuluculuk 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 makalede, Unity Ads'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Unity Ads SDK'sının ve bağdaştırıcının bir Android uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

Entegrasyon
Teklif verme	¹
Şelale
Formatlar
Banner
Geçiş reklamı
Ödüllü
Yerel biçim

¹ Teklif entegrasyonu kapalı beta sürümündedir. Erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.

Şartlar

Android API düzeyi 21 veya sonraki sürümler
[Teklif verme için]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek üzere Unity bağdaştırıcısı 4.11.3.0 veya sonraki bir sürümü kullanın (en son sürüm önerilir)

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

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

Unity Ads'e kaydolun veya oturum açın.

Proje oluşturma

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

Formu doldurup 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 modalinde Uyumlulaştırma kullanmayı planlıyorum'u ve Uyumlulaştırma İş Ortağı için Google AdMob'u seçin, ardından İleri'yi tıklayın.

Reklam ayarlarınızı seçin ve Sonraki'yi tıklayın.

Formu doldurun, ardından 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 platformunuzu ve reklam biçiminizi 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 için reklam biriminiz için Yerleşim Ekle'yi tıklayın.

Gerekli bilgileri doldurun ve Yerleşim Ekle'yi tıklayın.

Yerleşim kimliğini not edin.

Unity Ads Reporting API anahtarını bulma

Teklif verme

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

Şelale

Ad Manager reklam birimi kimliğinizi ayarlamak 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.

Para kazanma > Kurulum > API Yönetimi'ne gidin ve Para kazanma istatistikleri API erişim anahtarını not edin.

Ardından Para kazanma > Kuruluş Ayarları'na gidin ve Kuruluş temel kimliğini not edin.

Test modunu etkinleştirme

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

Google Play Store'un yanındaki düzenle düğmesini tıklayıp İstemci test modunu geçersiz kıl'ı işaretleyip Tüm cihazlar için test modunu AÇ (ör. test reklamları kullan)'ı seçerek uygulamanız için test modunu zorlayabilirsiniz.

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

Formu doldurup Kaydet'i tıklayın.

2. Adım: Ad Manager kullanıcı arayüzünde Unity Ads talebini ayarlayın

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ünde, Envanter ve Mobil uygulama altında uyumlulaştırmayı eklemek istediğiniz reklam birimini seçin.

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

Unity Ads için zaten bir getiri iş ortağınız varsa bu iş ortağını seçebilirsiniz. Aksi takdirde Yeni bir gelir 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 elde edilen API anahtarını ve Kuruluş ana kimliğini girin.

Getiri iş ortağı seçildikten sonra Entegrasyon türü olarak Mobil SDK Uyumlulaştırması'nı, Platform olarak Android'i ve Durum olarak Etkin'i seçin. Önceki bölümde elde edilen Oyun Kimliği ve Yerleşim Kimliği'ni girin. Ardından, bir Varsayılan BGBM değeri girin.

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

Unity Ads'i GDPR ve ABD eyalet yönetmelikleri reklam iş ortakları listesine ekleme

Ad Manager kullanıcı arayüzünde Unity Ads'i GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için GDPR ayarlarındaki ve ABD eyalet düzenlemeleri ayarlarındaki adımları uygulayın.

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

Android Studio entegrasyonu (önerilen)

Uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulama bağımlılıkları 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.6.0")
    implementation("com.unity3d.ads:unity-ads:4.12.3")
    implementation("com.google.ads.mediation:unity:4.12.5.0")
}

Manuel entegrasyon

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

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

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili 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.

Unity Ads, 2.0.0 SDK sürümünde gizlilik ayarlarını desteklemek için bir API ekledi. Aşağıdaki örnek kodda, bu izin bilgilerinin Unity Ads SDK'sına nasıl iletileceği gösterilmektedir. İzin bilgilerini Unity Ads SDK'sına manuel olarak iletmeyi seçerseniz bu kodun Google Mobile Ads SDK'sı üzerinden 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()

Daha fazla ayrıntı ve her yöntemde sağlanabilecek değerler için Unity Ads'in Gizlilik İzni ve Veri API'leri ile GDPR'ye Uygunluk kılavuzlarına bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları, kullanıcılara "kişisel bilgilerinin" "satışının" (bu terimlerin yasalardaki tanımlarına uygun şekilde) kapsamı dışında kalma hakkı sunmayı zorunlu kılar. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" gibi bir bağlantı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.

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()

Daha fazla ayrıntı ve her yöntemde sağlanabilecek değerler için Unity Ads'in Gizlilik İzni ve Veri API'leri ile CCPA'ya Uygunluk kılavuzlarına bakın.

5. adım: Gerekli kodu ekleyin

Unity Ads entegrasyonları için ek kod gerekmez.

6. adım: Uygulamanızı test edin

Test reklamlarını etkinleştirme

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 Ads'den test reklamları aldığınızı doğrulamak için Unity Ads (Teklifli Sistem) ve Unity Ads (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

Hata kodları

Adaptör Unity Ads'den reklam alamıyorsa yayıncılar aşağıdaki sınıflar altında ResponseInfo.getAdapterResponses() kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

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

Bir reklam yüklenemezse UnityAds bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar şunlardır:

Hata kodu	Neden
0-10	UnityAds SDK'sı bir hata döndürdü. Daha fazla bilgi için kod bölümüne bakın.
101	Ad Manager kullanıcı arayüzünde yapılandırılan UnityAds sunucu parametreleri eksik/geçersiz.
102	UnityAds, NO_FILL durumuyla bir yerleşim döndürmüştür.
103	UnityAds, DISABLED durumunda bir yerleşim döndürmüştür.
104	UnityAds, null bağlamı olan 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	UnityAds cihazda desteklenmiyor.
108	UnityAds, yerleşim başına tek seferde yalnızca 1 reklam yükleyebilir.
109	UnityAds, ERROR durumunda tamamlandı.
200-204	UnityAds banner'a özgü hata. Daha fazla bilgi için kod bölümüne bakın.