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 kullanan Unity Ads reklamları ele alacağız. Burada, Unity Reklamlarını bir reklam birimine nasıl uyumlulaştırma yapılandırması ve Unity Ads SDK'sı ile bağdaştırıcısının Flutter uygulama.
Desteklenen entegrasyonlar ve reklam biçimleri
Unity Ads için uyumlulaştırma AdMob bağdaştırıcısı şu özelliklerden yararlanabilirsiniz:
Entegrasyon | |
---|---|
Teklif verme | 1 |
Şelale | |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü |
Şartlar
- En son 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 sonraki bir iOS dağıtım hedefi
- Google ile yapılandırılmış, çalışan bir Flutter proje Mobile Ads SDK'sı. Görüntüleyin Ayrıntılı bilgi için Başlarken.
- Arabuluculuğu tamamlama Başlangıç kılavuzu
1. adım: Unity Ads kullanıcı arayüzünde yapılandırmaları ayarlayı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
.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ısını içe aktarın
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,
pubspec.yaml
dosyasını yüklemek için şu bağımlılığı ekleyin:
dependencies:
gma_mediation_unity:
path: path/to/local/package
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 için Google Mobile Ads uyumlulaştırma eklentisi
içerir
GmaMediationUnity.setGDPRConsent()
yöntemidir. Aşağıdaki örnek kod, izin bilgilerinin
Unity Ads SDK'sı. Bu yöntemi çağırmayı seçerseniz
bu nedenle, Google Mobile Ads SDK'sı üzerinden reklam isteğinde bulunmadan önce kullanmanız önerilir.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setGDPRConsent(true);
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.
Unity Ads için Google Mobile Ads uyumlulaştırma eklentisi
içerir
GmaMediationUnity.setCCPAConsent()
yöntemidir. Aşağıdaki örnek kod, izin bilgilerinin
Unity Ads SDK'sı. Bu yöntemi çağırmayı seçerseniz
bu nedenle, Google Mobile Ads SDK'sı üzerinden reklam isteğinde bulunmadan önce kullanmanız önerilir.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setCCPAConsent(true);
5. Adım: Gerekli kodu ekleyin
Android
Unity Ads Android entegrasyonları için ek kod gerekmez.
iOS
SKAdNetwork entegrasyonu
Unity Ads"i takip edin belgeleri
kullanarak projenizin Info.plist
dosyasına SKAdNetwork tanımlayıcılarını ekleyin.
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.
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
kullanarak reklam yanıtından gelen temel hata
ResponseInfo
şu sınıflarda:
Android
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
iOS
GADMAdapterUnity
GADMediationAdapterUnity
Aşağıdakiler, Reklamın yüklenmemesi:
Android
Hata kodu | Neden |
---|---|
0-10 | UnityAds SDK'sı hata döndürdü. Kodu inceleyin inceleyebilirsiniz. |
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 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'ı belirli bir hata. Kodu inceleyin inceleyebilirsiniz. |
iOS
0-9 | UnityAds SDK'sı hata döndürdü. Unity'nin belgelerini inceleyin inceleyebilirsiniz. |
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 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. |
Unity Ads 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ının 4.10.0.0 sürümü ile uyumlu olduğu doğrulandı
- Unity iOS bağdaştırıcısı sürüm 4.10.0.0 ile doğrulanmış uyumluluk