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

Unity Ads'i uyumlulaştırma ile entegre etme

Bu kılavuzda, şelale entegrasyonlarını kapsayan AdMob Uyumlulaştırması'nı 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

iOS dağıtım hedefi 12.0 veya daha yeni bir sürüm olmalıdır.
[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 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

Teklif verme

Teklifli sistem yerleşimleri oluşturmak için Google hesap yöneticinizle iletişime geçin.

Şelale

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

AdMob 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 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: AdMob kullanıcı arayüzünde Unity Ads talebini ayarlayın

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

Reklam biriminizin uyumlulaştırma yapılandırmasına Unity Ads'i eklemeniz gerekir.

Öncelikle AdMob hesabınızda oturum açın. Ardından Uyumlulaştırma sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa düzenlemek için ilgili uyumlulaştırma grubunun adını tıklayın ve Unity Ads'i reklam kaynağı olarak ekleme bölümüne geçin.

Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma Grubu Oluştur'u seçin.

Reklam biçiminizi ve platformunuzu girip Devam'ı tıklayın.

Uyumlulaştırma grubunuza bir ad verin ve hedeflenecek konumları seçin. Ardından, uyumlulaştırma grubu durumunu Etkin olarak ayarlayın ve Reklam Birimi Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut AdMob reklam birimlerinizden bir veya daha fazlasıyla ilişkilendirin. Ardından Bitti'yi tıklayın.

Artık reklam birimleri kartının, seçtiğiniz reklam birimleriyle doldurulduğunu göreceksiniz:

Unity Ads'i reklam kaynağı olarak ekleme

Reklam Kaynakları bölümündeki Şelale kartının altında Reklam Kaynağı Ekle'yi seçin. Ardından Unity Ads'i seçin.

Unity Ads'i seçin ve Optimize anahtarını etkinleştirin. Unity Ads için reklam kaynağı optimizasyonunu ayarlamak üzere önceki bölümde elde edilen API anahtarını ve Kuruluş ana kimliğini girin. Ardından Unity Ads için bir eBGBM değeri girin ve Devam'ı tıklayın.

Unity Ads için zaten bir eşlemeniz varsa bu eşlemeyi seçebilirsiniz. Aksi takdirde Eşleme ekle'yi tıklayın.

Ardından, önceki bölümde elde edilen Oyun Kimliği ve Yerleşim Kimliği'ni girin. Ardından Bitti'yi tıklayın.

Not: Reklam kaynağı optimizasyonunun, bir uyumlulaştırma ağı için eBGBM'yi doğru şekilde hesaplayacak kadar veri toplaması birkaç gün sürer. Bu süre zarfında reklam kaynağı optimizasyon durumu PENDING olduğundan ağ için manuel olarak bir eBGBM değeri ayarlamanız gerekir. eBGBM hesaplandığında reklam kaynağı, eBGBM'yi sizin adınıza otomatik olarak güncellemeye başlar.

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

AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Unity Ads'i 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

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ılıyor. 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 dokümanlarını 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

AdMob 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 dokümanlarını inceleyin.
101	AdMob 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.