Unity Ads'i 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 eğitimde, reklam biriminin uyumlulaştırma yapılandırmasına Unity Reklamları ekleme ve Unity Ads SDK'sı ile bağdaştırıcısının bir uygulamaya entegre Flutter edilmesi ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

Entegrasyon
Teklif verme	^1
Şelale
Formatlar
Banner
Geçiş reklamı
Ödüllü

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

Şartlar

• En son Google Mobile Ads SDK'sı
• Flutter 3.7.0 veya sonraki sürümler
• Android'de dağıtım yapmak için
  • Android API düzeyi 21 veya sonraki sürümler
• iOS'te dağıtım yapmak için
  • 12.0 veya sonraki bir iOS dağıtım hedefi
• Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Flutter proje. Ayrıntılar için Başlayın bölümüne bakın.
• 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 oturum açın.

Proje oluşturma

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

Formu doldurun ve projenizi eklemek için Create Project'i (Proje Oluştur) tıklayın.

Para kazanma > Başlayın'a gidin ve ardından 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.

Yapay Zeka

iOS

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 ayrıntıları girin ve Yerleşim Ekle'yi tıklayın.

Yerleşim kimliğini not edin.

Yapay Zeka

iOS

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ıza ve Temel kuruluş kimliğinize de ihtiyacınız olacaktır.

Monetization (Para Kazanma) > Setup (Kurulum) > API Management (API Yönetimi) bölümü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ında Test sekmesini seçin.

Her bir platformun düzenle düğmesini tıklayıp İstemci test modunu geçersiz kıl'ı işaretleyip Tüm cihazlar için test modunu AÇIK'ı zorunlu kıl (test reklamlarını kullan) seçeneğini belirleyerek uygulamanız için test modunu zorunlu kılabilirsiniz.

Yapay Zeka

iOS

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

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

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

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

Android

Talimatlar için Android kılavuzunun 2. adımına bakın.

iOS

Talimatlar için iOS rehberinin 2. adımına göz atın.

GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Unity Ads ekleyin

Önemli: AB kullanıcı rızası, GDPR, CPRA ve Kullanıcı Mesajlaşma Platformu ile ilgili yapılandırmayı tamamlamak için Hesap Yönetimi izniniz olduğunu doğrulayın. Ayrıntılar için Kullanıcıların hesabınıza erişimini yönetme sayfasına göz atın.

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

Not: Uyumlu Unity Ads ve Google Mobile Ads SDK'sı sürümlerinin entegre edilmemesi, derleme sorunlarına neden olabilir.

pub.dev aracılığıyla entegrasyon

Aşağıdaki bağımlılığı Unity Ads Paketinizdeki SDK ve bağdaştırıcı pubspec.yaml dosyası:

dependencies:
  gma_mediation_unity: ^1.0.0

Manuel Entegrasyon

Şu hesap için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin: Unity Ads, indirilen dosyayı çıkarın ve ayıklanan eklenti klasörünü ekleyin. (ve içeriklerini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml dosyanızdaki eklentiye referans verin:

dependencies:
  gma_mediation_unity:
    path: path/to/local/package

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, cihaz tanımlayıcılarının ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara belirli açıklamaların yapıldığından ve bu kullanıcılardan alınan izinlerin alındığından emin olmanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. İzin isterken uyumlulaştırma zincirinizde kişisel verileri toplayabilecek, alabilecek veya kullanabilecek tüm reklam ağlarını tanımlamalı ve her bir ağın kullanımı hakkında bilgi sağlamalısınız. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

Unity Ads için Google Mobile Ads uyumlulaştırma eklentisi GmaMediationUnity.setGDPRConsent() yöntemini içerir. Aşağıdaki örnek kodda, izin bilgilerinin Unity Ads SDK'sına nasıl aktarılacağı gösterilmektedir. Bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sı üzerinden reklam istemeden önce yapmanız önerilir.

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setGDPRConsent(true);

Daha fazla bilgi ve her yöntemde sağlanabilecek değerler için Unity Ads Gizlilik İzni ve veri API'leri ile GDPR'ye uyma kılavuzlarına göz atı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ına 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 tüm reklam ağları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.

Unity Ads için Google Mobil Reklamlar uyumlulaştırma eklentisinin GmaMediationUnity.setCCPAConsent() yöntemini içerir. Aşağıdaki örnek kodda, izin bilgilerinin Unity Ads SDK'sına nasıl iletileceği gösterilmektedir. Bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sı üzerinden reklam istemeden önce yapmanız önerilir.

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

5. Adım: Gerekli kodu ekleyin

Yapay Zeka

Unity Ads Android entegrasyonları için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

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

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

Test reklamlarını etkinleştir

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

Önemli: Uygulamanızı yayınlamadan önce AdMob ve Unity Ads için test modunu devre dışı bırakın.

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ıflarda ResponseInfo kullanarak reklam yanıtında altta yatan hatayı kontrol edebilir:

Yapay Zeka

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

iOS

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:

Yapay Zeka

Hata kodu	Neden
0-10	UnityAds SDK'sı hata döndürdü. Daha fazla bilgi için koda bakın.
101	AdMob kullanıcı arayüzünde yapılandırılan UnityAds sunucu parametreleri 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, 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	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'ı belirli bir hata. Daha fazla bilgi için koda bakın.

iOS

0-9	UnityAds SDK'sı hata döndürdü. Daha fazla bilgi için Unity'nin belgelerine göz atın.
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 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 desteklemez.

Unity Ads Flutter Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü

Sürüm 1.1.0

• Unity Android bağdaştırıcısının 4.12.3.0 sürümü ile uyumlu olduğu doğrulandı
• Unity iOS bağdaştırıcısı sürüm 4.12.3.1 ile doğrulanmış uyumluluk
• Google Mobile Ads Flutter Eklentisi sürüm 5.2.0 ile geliştirilmiş ve test edilmiştir.

Sürüm 1.0.0

• İlk sürüm.
• Unity Android adaptörü 4.10.0.0 sürümü ile uyumluluğu doğrulandı
• Unity iOS bağdaştırıcısı sürüm 4.10.0.0 ile doğrulanmış uyumluluk
• Google Mobile Ads Flutter eklentisi 5.0.0 sürümü ile geliştirilmiş ve test edilmiştir.