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

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ü
. 1 Teklif entegrasyonu kapalı beta sürümü kullanıyorsanız erişim isteğinde bulunmak 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ğı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

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