Bu kılavuzda, şelale entegrasyonlarını ele alan uyumlulaştırma özelliğini 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 kılavuzda, Unity Ads'in reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Unity Ads SDK'sı ile bağdaştırıcısının bir uygulamaya nasıl entegre edileceği Flutter ele alınmıştır.
Desteklenen entegrasyonlar ve reklam biçimleri
Unity Ads için AdMob uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:
| Entegrasyon | |
|---|---|
| Teklif | |
| Şelale | |
| Formatlar | |
| Banner | |
| Geçişli | |
| Ödül olarak verildi | |
Koşullar
- En yeni Google Mobile Ads SDK'sı
- Flutter 3.7.0 veya sonraki sürümler
- Android'de dağıtmak için
- Android API düzeyi 21 veya üstü
- iOS'te dağıtmak için
- 12.0 veya üstü 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şlarken 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 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.
Android
iOS
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.
Android
iOS
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.AdMob
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.
Her bir platformun düzenle düğmesini tıklayıp İstemci test modunu geçersiz kıl'ı işaretleyerek ve Tüm cihazlar için test modunu AÇIK (test reklamları kullan) kullan'ı seçerek uygulamanız için test modunu zorunlu kılabilirsiniz.
Android
iOS
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 talebi oluşturma AdMob
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 ekle
GDPR ayarları ve ABD eyalet düzenlemeleri ayarları bölümündeki adımları uygulayarak AdMob 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ıyı içe aktarın
pub.dev üzerinden entegrasyon
Aşağıdaki bağımlılığı paketinizin pubspec.yaml dosyasınaUnity Ads SDK ve bağdaştırıcının en son sürümleriyle ekleyin:
dependencies:
gma_mediation_unity: ^1.0.0
Manuel Entegrasyon
Unity Ads için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı çıkarın ve ayıklanan eklenti klasörünü (ve içeriğini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml dosyanızdaki eklentiye başvurun:
dependencies:
gma_mediation_unity:
path: path/to/local/package
4. Adım: Unity Ads SDK'sında gizlilik ayarlarını uygulayın
AB İzni ve GDPR
Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara cihaz tanımlayıcılarının ve kişisel verilerin kullanımıyla ilgili belirli açıklamalar yapılması ve bu kullanıcılardan izin alınması gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) gereksinimlerini yansıtmaktadır. İzin isterken, uyumlulaştırma zincirinizde kişisel verileri toplayabilen, alabilen veya kullanabilen ve her bir ağın kullanımı hakkında bilgi verebilecek her bir reklam ağını tanımlamanız gerekir. 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
için
GmaMediationUnity.setGDPRConsent()
yöntemi bulunur. Aşağıdaki örnek kod, izin bilgilerinin Unity Ads SDK'ya nasıl iletileceğini göstermektedir. Bu yöntemi çağırmayı seçerseniz bunu, Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce yapmanız önerilir.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setGDPRConsent(true);
Daha fazla ayrıntı ve her bir yöntemle sağlanabilecek değerler için Unity Ads'in Gizlilik İzni ve Veri API'leri ile GDPR'ye Uyum kılavuzlarına göz atın.
ABD eyalet gizlilik yasaları
ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerini" "satma" (yasaların bu terimleri tanımladığı şekilde) özelliğinin kapsamı dışında kalma hakkı sunmayı zorunlu kılıyor. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Satma" bağlantısıyla sunuluyor. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam yayını 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 bilgi satışına dahil olabilecek tüm reklam ağlarını belirlemeniz ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.
Unity Ads için Google Mobile Ads uyumlulaştırma eklentisi
için
GmaMediationUnity.setCCPAConsent()
yöntemi bulunur. Aşağıdaki örnek kod, izin bilgilerinin Unity Ads SDK'ya nasıl iletileceğini göstermektedir. Bu yöntemi çağırmayı seçerseniz bunu, Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce yapmanız önerilir.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setCCPAConsent(true);
5. Adım: Gerekli kodu ekleyin
Android
Unity Reklamları 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 Reklamları belgelerindeki adımları uygulayın.
6. Adım: Uygulamanızı test etme
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.
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ındaki temel hatayı kontrol edebilir:
Android
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
iOS
GADMAdapterUnity
GADMediationAdapterUnity
Bir reklam yüklenemediğinde UnityAds bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajları burada bulabilirsiniz:
Android
| Hata kodu | Neden |
|---|---|
| 0-10 | UnityAds SDK'sı bir hata döndürdü. Daha fazla bilgi için kodu inceleyin. |
| 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 durumuna sahip bir yerleşim döndürdü. |
| 104 | UnityAds boş bağlam içeren 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 yerleşim başına aynı anda yalnızca 1 reklam yükleyebilir. |
| 109 | UnityAds işlemi HATA durumuyla tamamlandı. |
| 200-204 | UnityAds Banner'da belirli bir hata. Daha fazla bilgi için kodu inceleyin. |
iOS
| 0-9 | UnityAds SDK'sı bir hata döndürdü. Daha fazla bilgi için Unity belgelerini 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ıyı çağırdıktan sonra boş. |
| 105 | Reklam hazır olmadığı için Unity Reklamları gösterilemedi. |
| 106 | UnityAds, geri çağırmayı kUnityAdsYerleşimStateNoFill yerleşim durumuyla değiştirdi. |
| 107 | UnityAds bir yerleşimi çağırırken geri çağırmayı kUnityAdsYerleşimStateDisabled yerleşim durumuyla değiştirdi. |
| 108 | Bu yerleşim için zaten bir reklam yüklendi. UnityAds SDK'sı aynı yerleşim için birden fazla reklam yüklemeyi desteklemez. |
Unity Reklamları Flutter Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü
Sürüm 1.0.0
- İlk sürüm.
- Unity Android bağdaştırıcısı 4.10.0.0 sürümüyle uyumlu olduğu doğrulandı
- Unity iOS bağdaştırıcısı 4.10.0.0 sürümüyle uyumluluk doğrulandı