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 iOS 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

12.0 veya sonraki bir iOS dağıtım hedefi
[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.1 veya sonraki bir sürümü kullanın (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 panelinde 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 platform 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.

Apple App Store'un yanındaki düzenleme 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 etkinleştirebilirsiniz.

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

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

Şirketlere Unity Ads ekleme

Teklif verme

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

Şelale

Yönetici > Şirketler'e gidin ve ardından Tüm şirketler sekmesindeki Yeni şirket düğmesini tıklayın. Reklam ağı'nı 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.

Kullanıcı adı veya Şifre girmeniz gerekmez. İşlemi tamamladığınızda Kaydet'i tıklayın.

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

Teklif verme

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

Şelale

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

Teklif isteklerinde güvenli sinyal paylaşma

Teklif verme

Envanter > Güvenli Sinyaller'e gidin. Güvenli sinyaller bölümünde Unity Ads'i arayın ve Uygulama entegrasyonunu etkinleştir'i açın.

Kaydet'i tıklayın.

Şelale

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

SDK Teklifli Sistemi için güvenli sinyal paylaşımına izin verme

Teklif verme

Yayınlama > Talep kanalı ayarları'na gidin. Varsayılan ayarlar sekmesinde, SDK teklifli sistemi için Güvenli sinyal paylaşımına izin ver seçeneğini etkinleştirin.

Kaydet'i tıklayın.

Şelale

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

Unity Ads teklifli sistemini yapılandırma

Teklif verme

Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Sistemi'ne Git'i tıklayın.

Yeni teklif veren'i tıklayın.

Teklif veren olarak Unity Ads'i seçin.

Bu teklif veren için SDK Teklif Verme'yi etkinleştirmek üzere Devam'ı tıklayın.

Bitti'yi tıklayın.

Şelale

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

Reklam birimi eşlemesini yapılandırma

Teklif verme

Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Sistemi'ne Git'i tıklayın.

Unity Ads için şirketi seçin.

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

Belirli bir reklam birimi'ni seçin. Bir reklam birimi ve biçimi, Envanter türü olarak Mobil uygulama'yı ve Mobil uygulamanızı seçin. Ardından, önceki bölümde elde edilen Oyun Kimliği ve Yerleşim Kimliği'ni 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 Unity Ads için oluşturduğunuz şirketi seçin. Entegrasyon türü olarak Mobil SDK uyumlulaştırması'nı, Platform olarak iOS'u ve Durum olarak Etkin'i seçin.

Önceki bölümde elde edilen Oyun kimliğini ve Yerleşim kimliğini, ayrıca 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'yi doğru şekilde hesaplamadan önce veri toplaması birkaç gün sürebilir. eBGBM hesaplandığında sizin adınıza otomatik olarak güncellenir.

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

Ad Manager kullanıcı arayüzündeki Avrupa ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Unity Ads'i eklemek için Avrupa düzenlemeleri ayarlarında ve ABD eyalet düzenlemeleri ayarlarında yer alan adımları uygulayın.

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

CocoaPods'u kullanma (önerilir)

Projenizin Podfile dosyasına aşağıdaki satırı ekleyin:
```
pod 'GoogleMobileAdsMediationUnity'
```
Komut satırından şunu çalıştırın:
```
pod install --repo-update
```

Manuel entegrasyon

Unity Ads SDK'sının en son sürümünü indirin ve UnityAds.framework dosyasını projenize bağlayın.
Değişiklik Günlüğü'ndeki indirme bağlantısından Unity Ads bağdaştırıcının en son sürümünü indirin ve UnityAdapter.framework dosyasını projenize bağlayın.

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.

Swift

import UnityAds
// ...

let gdprMetaData = UADSMetaData()
gdprMetaData.set("gdpr.consent", value: true)
gdprMetaData.commit()

Objective-C

#import <UnityAds/UnityAds.h>
// ...

UADSMetaData *gdprMetaData = [[UADSMetaData alloc] init];
[gdprMetaData set:@"gdpr.consent" value:@YES];
[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 seçeneği sunmayı zorunlu kılar. Bu 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.

Swift

import UnityAds
// ...

let ccpaMetaData = UADSMetaData()
ccpaMetaData.set("privacy.consent", value: true)
ccpaMetaData.commit()

Objective-C

#import <UnityAds/UnityAds.h>
// ...

UADSMetaData *ccpaMetaData = [[UADSMetaData alloc] init];
[ccpaMetaData set:@"privacy.consent" value:@YES];
[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

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için Unity Ads'in belgelerini inceleyin.

Derleme hataları

Swift

Swift entegrasyonları için ek kod gerekmez.

Objective-C

Unity Ads bağdaştırıcısı 4.4.0.0 veya sonraki sürümler için Unity dokümanlarında yer alan entegrasyon adımlarını uygulamanız gerekir.

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 GADResponseInfo.adNetworkInfoArray kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

GADMAdapterUnity
GADMediationAdapterUnity

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-9	UnityAds SDK'sı bir hata döndürdü. Daha fazla ayrıntı için Unity'nin belgelerine bakın.
101	Ad Manager kullanıcı arayüzünde yapılandırılan UnityAds sunucu parametreleri eksik/geçersiz.
102	Cihaz, UnityAds tarafından desteklenmiyor.
103	UnityAds, kUnityAdsFinishStateError hata durumuyla sunmayı tamamladı.
104	Unity reklam nesnesi, başlatıcısı çağrıldıktan sonra nil olur.
105	Reklam hazır olmadığı için Unity Ads gösterilemedi.
106	UnityAds, yerleşim durumu kUnityAdsPlacementStateNoFill ile yerleşim değişikliği geri çağırma işlevini çağırdı.
107	UnityAds, yerleşim durumu kUnityAdsPlacementStateDisabled olan bir yerleşim değişikliği geri çağırma işlevi çağırdı.
108	Bu yerleşim için zaten bir reklam yüklenmiş. UnityAds SDK'sı, aynı yerleşim için birden fazla reklam yüklemeyi desteklemez.