Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

i-mobile'ı uyumlulaştırma ile entegre edin

Platform seçin: Android iOS Unity Flutter Android (Eski)

Bu kılavuzda, şelale entegrasyonlarını kapsayan uyumlulaştırma özelliğini kullanarak i-mobile'dan reklam yüklemek ve görüntülemek için Google Mobile Ads Unity Plugin ürününün nasıl kullanılacağı gösterilmektedir. Bu açıklamalar, i-mobile'ın bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve i-mobile SDK'sının ve bağdaştırıcısının bir Unity uygulamasına nasıl entegre edileceğini kapsar.

i-mobile'ın kontrol paneli arayüzündeki etiketler, düğmeler ve açıklamalar Japonca metinler içerir. Bu kılavuzdaki ekran görüntüleri çevrilmemiştir. Ancak bu kılavuzun açıklamalarında ve talimatlarında, etiketler ve düğmeler parantez içinde İngilizce karşılıklarıyla çevrilmiştir.

Desteklenen entegrasyonlar ve reklam biçimleri

i-mobile için Ad Manager uyumlulaştırma adaptörünün özellikleri şöyledir:

Entegrasyon
Teklifli sistem
Şelale
Formatlar
Uygulama Açma
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı
Yerel biçim

Ön koşullar

Devam etmeden önce aşağıdakileri doğrulayın:

En yeni Google Mobile Ads Unity Plugin sürümü.
Unity Editor 5.6 veya sonraki sürümler
Android'de dağıtmak için
- Android API düzeyi 24 veya sonraki sürümler
iOS'te dağıtmak için
- iOS 13.0 veya sonraki sürüm dağıtım hedefi
Google Mobile Ads Unity Plugin ile yapılandırılmış çalışan bir Unity projesi. Ayrıntılar için Google Mobile Ads Unity Plugin hizmetini kurma başlıklı makaleyi inceleyin.

Uyumlulaştırmayı ayarlayın.

1. adım: i-mobile kullanıcı arayüzünde yapılandırmaları ayarlayın

i-mobile hesabınıza kaydolun veya giriş yapın.

サイト／アプリ管理 (Site/Uygulama Yönetimi) sekmesini ve uygulamanızın platformuna ait düğmeyi tıklayarak uygulamanızı i-mobile kontrol paneline ekleyin.

Android

iOS

Formu doldurun ve 新規登録 (Kaydol) düğmesini tıklayın.

Android

iOS

Yeni bir reklam alanı oluşturmak için サイト／アプリ管理 (Site/Uygulama Yönetimi) sekmesinde uygulamanızı seçin.

Android

iOS

広告スポット管理 (Ad Spot Management) sekmesine gidin ve 新規広告スポット (New Ad Spot) düğmesini tıklayın.

create_ad_spot

Ardından, 広告スポット名 (Reklam Alanı adı), 広告スポットサイズ (Reklam Alanı boyutu) ve diğer ayrıntıları girerek formu doldurun. Ardından, 新規登録 (Sign up) düğmesini tıklayın.

new_ad_spot_form

Yeni reklam spotunuz hazır. Entegrasyon ayrıntılarını görüntülemek için アプリ設定取得 (Uygulama ayarlarını al) düğmesini tıklayın.

ad_spot_list

パブリッシャーID (Yayıncı Kimliği), メディアID (Medya Kimliği) ve スポットID (Nokta Kimliği) değerlerini not edin. Ad Manager kullanıcı arayüzünde i-mobile'ı uyumlulaştırma için yapılandırırken bu parametrelere ihtiyacınız olacaktır.

Android

iOS

app-ads.txt dosyanızı güncelleme

Uygulamalar İçin Yetkili Satıcılar app-ads.txt, uygulama reklamı envanterinizin yalnızca yetkili olarak tanımladığınız kanallar üzerinden satılmasını sağlamaya yardımcı olan bir IAB Tech Lab girişimidir. Reklam gelirinde önemli ölçüde kayıp yaşanmasını önlemek için bir app-ads.txt dosyası uygulamanız gerekir. Bunu henüz yapmadıysanız Ad Manager için bir app-ads.txt dosyası oluşturun.

i-mobile için app-ads.txt uygulamak üzere Sık Sorulan Sorular bölümüne bakın.

2. adım: Ad Manager kullanıcı arayüzünde i-mobile talebini ayarlayın

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

Android

Talimatlar için Android kılavuzundaki 2. adıma bakın.

iOS

Talimatlar için iOS kılavuzundaki 2. adıma bakın.

3. adım: i-mobile SDK'sını ve bağdaştırıcısını içe aktarın

OpenUPM-CLI

OpenUPM-CLI yüklüyse projenizin kök dizininden aşağıdaki komutu çalıştırarak Unity için Google Mobil Reklamlar i-mobile Uyumlulaştırma Eklentisi'ni projenize yükleyebilirsiniz:

openupm add com.google.ads.mobile.mediation.imobile

OpenUPM

Unity proje düzenleyicinizde Edit (Düzenle) > Project Settings (Proje Ayarları) > Package Manager'ı (Paket Yöneticisi) seçerek Unity Package Manager Settings'i (Unity Paket Yöneticisi Ayarları) açın.

Scoped Registries (Kapsamlı Kayıt Defterleri) sekmesinde, OpenUPM'yi aşağıdaki ayrıntılarla kapsamlı kayıt defteri olarak ekleyin:

Ad: OpenUPM
URL: https://package.openupm.com
Kapsamlar: com.google

OpenUPM Ayrıntıları

Ardından, Pencere > Paket Yöneticisi'ne giderek Unity Paket Yöneticisi'ni açın ve açılır menüden Kayıtlarım'ı seçin.

Unity Registries

Google Mobile Ads IMobile Mediation paketini seçip Install'u (Yükle) tıklayın.

OpenUPM'den yükleme

Unity Paketi

Google Mobile Ads uyumlulaştırma eklentisinin i-mobile için en yeni sürümünü Değişiklik Günlüğü'ndeki indirme bağlantısından indirin ve zip dosyasından GoogleMobileAdsIMobileMediation.unitypackage dosyasını çıkarın.

Unity proje düzenleyicinizde Assets (Öğeler) > Import Package (Paketi İçe Aktar) > Custom Package'ı (Özel Paket) seçin ve indirdiğiniz GoogleMobileAdsIMobileMediation.unitypackage dosyasını bulun. Tüm dosyaların seçildiğinden emin olun ve İçe aktar'ı tıklayın.

Unity'den içe aktarma

Ardından Assets (Öğeler) > External Dependency Manager (Harici Bağımlılık Yöneticisi) > Android Resolver (Android Çözücü) > Force Resolve'u (Çözümü Zorla) seçin. External Dependency Manager kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

Çözüme Zorla

4. adım: Ek kod gerekli

Android

i-mobile entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için i-mobile'ın dokümanlarını inceleyin.

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

Test reklamlarını etkinleştirme

Ad Manager için test cihazınızı kaydettiğinizden emin olun. i-mobile, test için Spot ID, Media ID ve Publisher ID sağlar. Bu kimlikleri burada bulabilirsiniz.

Test reklamlarını doğrulama

i-mobile'dan test reklamları aldığınızı doğrulamak için i-mobile (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

Hata kodları

Adaptör i-mobile'dan reklam alamıyorsa yayıncılar aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Android

Biçim	Sınıf adı
Banner	com.google.ads.mediation.imobile.IMobileAdapter
Geçiş reklamı	com.google.ads.mediation.imobile.IMobileAdapter
Yerel biçim	com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

Biçim	Sınıf adı
Banner	IMobileAdapter
Geçiş reklamı	IMobileAdapter
Yerel biçim	GADMediationAdapterIMobile

Bir reklam yüklenemediğinde i-mobile bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:

Android

Hata kodu	Neden
0-99	i-mobile SDK'sı hata döndürdü. Daha fazla bilgi için kodu inceleyin.
101	i-mobile, reklam yüklemek için `Activity` bağlamı gerektirir.
102	Ad Manager kullanıcı arayüzünde yapılandırılan i-mobile sunucu parametreleri eksik veya geçersiz.
103	İstenen reklam boyutu, i-mobile tarafından desteklenen bir banner boyutuyla eşleşmiyor.
104	i-mobile'ın doğal reklam yükleme başarılı geri çağırma işlevi boş bir doğal reklam listesi döndürdü.

iOS

Hata kodu	Neden
0-10	i-mobile SDK'sı hata döndürdü. Daha fazla bilgi için koda bakın.
101	Ad Manager kullanıcı arayüzünde yapılandırılan i-mobile sunucu parametreleri eksik veya geçersiz.
102	İstenen reklam boyutu, i-mobile tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103	i-mobile bir reklam sunamadı.
104	i-mobile, boş bir doğal reklam dizisi döndürdü.
105	i-mobile, doğal reklam öğelerini indiremedi.
106	i-mobile, aynı nokta kimliğini kullanarak birden fazla geçiş reklamı isteğinde bulunmayı desteklemez.

i-mobile Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

Sürüm 1.3.13

i-mobile Android bağdaştırıcısı 2.3.2.4 sürümünü destekler.
i-mobile iOS bağdaştırıcısı 2.3.4.7 sürümünü destekler.
Google Mobile Ads Unity eklentisi 11.1.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 1.3.12

i-mobile Android bağdaştırıcı sürüm 2.3.2.3'ü destekler.
i-mobile iOS bağdaştırıcısı 2.3.4.7 sürümünü destekler.
Google Mobile Ads Unity eklentisi 11.1.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 1.3.11

i-mobile Android bağdaştırıcısı 2.3.2.3 sürümünü destekler.
i-mobile iOS bağdaştırıcısı 2.3.4.6 sürümünü destekler.
Google Mobile Ads Unity eklentisi 11.0.0 sürümüyle geliştirilip test edilmiştir.

Sürüm 1.3.10

i-mobile Android bağdaştırıcısı 2.3.2.2 sürümünü destekler.
i-mobile iOS adaptör sürümü 2.3.4.5'i destekler.
Google Mobile Ads Unity eklentisi 11.0.0 sürümüyle geliştirilip test edilmiştir.

Sürüm 1.3.9

i-mobile Android bağdaştırıcısı 2.3.2.1 sürümünü destekler.
i-mobile iOS bağdaştırıcısı 2.3.4.5 sürümünü destekler.
Google Mobile Ads Unity eklentisi 11.0.0 sürümüyle geliştirilip test edilmiştir.

Sürüm 1.3.8

i-mobile Android bağdaştırıcısı 2.3.2.1 sürümünü destekler.
i-mobile iOS bağdaştırıcısı 2.3.4.3 sürümünü destekler.
Google Mobile Ads Unity eklentisi 10.6.0 sürümüyle geliştirilip test edilmiştir.

Sürüm 1.3.7

i-mobile Android bağdaştırıcısı 2.3.2.1 sürümünü destekler.
i-mobile iOS bağdaştırıcısı 2.3.4.2 sürümünü destekler.
Google Mobile Ads Unity eklentisi 10.0.0 sürümüyle geliştirilip test edilmiştir.

1.3.6 sürümü

i-mobile Android bağdaştırıcısı 2.3.2.0 sürümünü destekler.
i-mobile iOS bağdaştırıcısı 2.3.4.1 sürümünü destekler.
Google Mobile Ads Unity eklentisinin 9.3.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 1.3.5

i-mobile Android bağdaştırıcısı 2.3.2.0 sürümünü destekler.
i-mobile iOS bağdaştırıcısı 2.3.4.0 sürümünü destekler.
Google Mobile Ads Unity eklentisi 9.1.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 1.3.4

i-mobile Android bağdaştırıcısı sürüm 2.3.1.2'yi destekler.
i-mobile iOS bağdaştırıcısı 2.3.4.0 sürümünü destekler.
Google Mobile Ads Unity eklentisi 9.0.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 1.3.3

i-mobile Android bağdaştırıcısı 2.3.1.1 sürümünü destekler.
i-mobile iOS bağdaştırıcısı 2.3.3.0 sürümünü destekler.
Google Mobile Ads Unity eklentisi 9.0.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 1.3.2

Adaptör içeriği GoogleMobileAds/Mediation/IMobile/ konumuna taşındı.
i-mobile Android bağdaştırıcısı 2.3.1.1 sürümünü destekler.
i-mobile iOS bağdaştırıcısı 2.3.2.0 sürümünü destekler.
Google Mobile Ads Unity eklentisinin 8.1.0 sürümüyle oluşturulmuş ve test edilmiştir.