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 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 Flutter uygulamaya nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

¹ 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 üzeri
• Android'de dağıtmak için
  • Android API düzeyi 21 veya sonraki sürümler
• 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

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'ya gidin > Başlayın'ı ve ardından Başlayın'ı tıklayın.

Proje Kurulumu modülünde, Uyumlulaştırmayı kullanmayı planlıyorum ve Google Uyumlulaştırma İş Ortağı için AdMob'u, ardından İleri'yi tıklayın.

Reklam ayarlarınızı seçip İleri'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'ya gidin > Reklam Birimleri ve ardından 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

Unity Ads Reporting API anahtarını bulma

Test modunu etkinleştirme

Test modu şuradan etkinleştirilebilir: Unity Reklamları kontrol paneli. Projenizin Test sekmesini seçin.

Her bir İstemci testi modunu geçersiz kıl'ı kontrol edip seçme Tüm cihazlar için test modunu AÇIK hâle getirin (test reklamları kullanın).

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

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

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

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, 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ı uygulayın

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. 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 iletememektedir.

Unity Ads için Google Mobil Reklamlar uyumlulaştırma eklentisinin GmaMediationUnity.setGDPRConsent() yöntemini içerir. Aşağıdaki örnek kod, izin bilgilerinin Unity Ads SDK'sı. 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 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, 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. 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, 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 Mobil Reklamlar uyumlulaştırma eklentisinin GmaMediationUnity.setCCPAConsent() yöntemini içerir. Aşağıdaki örnek kod, izin bilgilerinin Unity Ads SDK'sı. 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

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:

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

GADMAdapterUnity
GADMediationAdapterUnity

Aşağıdakiler, Reklamın yüklenmemesi:

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.2.0 sürümü ile uyumlu olduğu doğrulandı
• Unity iOS bağdaştırıcısı sürüm 4.12.2.0 ile doğrulanmış uyumluluk
• Google Mobile Ads Flutter eklentisi 5.1.0 sürümü ile oluşturulup test edilmiştir.

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
• Google Mobile Ads Flutter eklentisi 5.0.0 sürümü ile geliştirilmiş ve test edilmiştir.