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

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

Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl uyumlulaştırma, ele alacağız. Burada, Unity Reklamlarını bir reklam birimine uyumlulaştırma yapılandırması ve Unity Ads SDK'sı ile bağdaştırıcısının Android uygulama.

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

Şartlar

Android API düzeyi 21 veya üstü

En son Google Mobile Ads SDK'sı
Arabuluculuğu 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 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 talebini Ad Manager 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ü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 ekleyin

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ısını içe aktarın

Android Studio entegrasyonu (önerilir)

Uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulamayı ekleyin ve yapılandırmaları içerir. Unity Ads SDK'sının en yeni sürümlerini kullanın ve adaptör:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.unity3d.ads:unity-ads:4.12.1")
    implementation("com.google.ads.mediation:unity:4.12.2.0")
}

Manuel entegrasyon

En yeni Unity Ads SDK'sını (unity-ads.aar) GitHub deposu ve projenize ekleyin.
Şuraya gidin: Unity Ads bağdaştırıcı yapıları Google'ın Maven deposunda. En son sürümü seçin ve Unity'yi indirin. Reklam bağdaştırıcısının .aar dosyasını tıklayıp projenize ekleyin.

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

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı İzni kapsamında Politika uyarınca, belirli bilgilerin ifşa edildiğinden emin olmalısınız. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcıların cihaz tanımlayıcılarının ve kişisel verilerin kullanımı. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma şartları Düzenleme (GDPR). Rıza isterken her reklam ağını tanımlamanız gerekir kişisel verileri toplayabilecek, alabilecek veya kullanabilen uyumlulaştırma zincirinizde her ağın kullanımıyla ilgili bilgi sağlar. Google şu anda Kullanıcının izin seçimini bu tür ağlara otomatik olarak iletmelidir.

Unity Ads SDK'nın 2.0.0 sürümünde, gizlilik ayarlarını desteklemek için bir API ekledi. İlgili içeriği oluşturmak için kullanılan aşağıdaki örnek kod, bu izin bilgilerinin Unity'ye nasıl iletileceğini gösterir Ads SDK'sı. İzin bilgilerini Unity Ads SDK'sına iletmeyi seçmeniz gerekir mi? manuel olarak, bu kodun reklam isteğinde bulunmadan önce çağrılması önerilir. Google Mobile Ads SDK'sı aracılığıyla yükleyebilirsiniz.

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'i göster Gizlilik İzni ve veri API'leri ve GDPR'ye uygunluk kılavuzlarını inceleyebilirsiniz.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, doğru zamanda "indirimi" devre dışı bırakmak "kişisel bilgilerinin” (kanunların bu konudaki hariç tutmanın, öne çıkan bir "Do Not Sell My Personal My Personal (Kişisel Bilgilerimi Kesinlikle Satmayın) Bilgiler" bağlantısını ile başlar. İlgili içeriği oluşturmak için kullanılan ABD eyalet gizliliği yasalara uygunluk rehberi, yasalarca belirlenen kısıtlanmış veri işleme kullanılabilir ancak Google, bu ayarı her reklama uygulayamaz. ağda yer alır. Bu nedenle, reklam ağlarının her birini kişisel satışlarına katılabilecek uyumlulaştırma zincirinizde ağlarla ilgili bilgileri takip edin ve bu ağların yönlendirmelerini izleyerek uygunluk açısından önemlidir.

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'i göster Gizlilik İzni ve veri API'leri ve CCPA'ya uygunluk kılavuzlarını inceleyebilirsiniz.

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ş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 reklam yanıtındaki temel hatayı . ResponseInfo.getAdapterResponses() şu sınıflarda:

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

Aşağıdakiler, Reklamın yüklenmemesi:

Hata kodu	Neden
0-10	UnityAds SDK'sı hata döndürdü. Kodu inceleyin inceleyebilirsiniz.
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 durumda olan bir yerleşim döndürdü.
104	UnityAds boş bağlama sahip bir reklam göstermeye çalıştı.
105	Unity Ads reklamlarını 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 aynı anda yerleşim başına yalnızca 1 reklam yükleyebilir.
109	UnityAds HATA durumuyla tamamlandı.
200-204	UnityAds Banner'ına özel hata. Kodu inceleyin inceleyebilirsiniz.
0-9	UnityAds SDK'sı hata döndürdü. Unity'nin belgelerini inceleyin inceleyebilirsiniz.
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 sunumu tamamladı.
104	Unity reklam nesnesi, başlatıcısı çağrıldıktan sonra boş oldu.
105	Reklam hazır olmadığı için Unity Reklamları gösterilemedi.
106	Yerleşim olarak adlandırılan UnityAds, kUnityAdsPLACEMENTStateNoFill yerleşim durumuyla değişti.
107	Yerleşim olarak adlandırılan UnityAds, kUnityAdsYerleşimStateDisabled yerleşim durumu ile geri çağırma değiştirdi.
108	Bu yerleşim için zaten bir reklam yüklenmiş. UnityAds SDK'sı aynı yerleşim için birden fazla reklam yüklemeyi desteklemiyor.