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ı kapsayarak uyumlulaştırma kullanarak i-mobile'dan reklam yüklemek ve göstermek için Google Mobile Ads Unity Plugin özelliğinin nasıl kullanılacağı açıklanmaktadır. 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ılavuzdaki açıklamalarda ve talimatlarda etiketler ve düğmeler, parantez içinde İngilizce karşılıklarıyla birlikte çevrilmiştir.

Desteklenen entegrasyonlar ve reklam biçimleri

i-mobile için Ad Manager uyumlulaştırma bağdaştırıcısı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ümlerin 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 spotu oluşturmak için サイト／アプリ管理 (Site/Uygulama Yönetimi) sekmesinde uygulamanızı seçin.

Android

iOS

広告スポット管理 (Reklam Spotu Yönetimi) sekmesine gidin ve 新規広告スポット (Yeni Reklam Spotu) 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, 新規登録 (Kaydol) 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 (Spot Kimliği)'ni not edin. Bu parametreler, daha sonra Ad Manager kullanıcı arayüzünde i-mobile'ı aracılık için yapılandırırken gereklidir.

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. 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ıtlar) sekmesinde, aşağıdaki ayrıntıları kullanarak OpenUPM'yi kapsamlı kayıt 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 Kayıtları

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

OpenUPM'den yükleme

Unity Paketi

Değişiklik günlüğü'ndeki indirme bağlantısından i-mobile için Google Mobil Reklamlar uyumlulaştırma eklentisinin en yeni sürümünü 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ümleyici) > Force Resolve'u (Zorla Çözümle) seçin. External Dependency Manager kitaplığı, bağımlılık çözümlemeyi sıfırdan gerçekleştirir ve tanımlanan bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

Çözüme Zorla

4. adım: Ek kod gerekir

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ı bir hata döndürdü. Daha fazla bilgi için koda bakın.
101	i-mobile, reklamları yüklemek için bir `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ısı geri çağırma işlevi boş bir doğal reklam listesi döndürdü.

iOS

Hata kodu	Neden
0-10	i-mobile SDK'sı bir 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 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ği kullanılarak birden fazla geçiş reklamı isteğinde bulunulmasını desteklemez.

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

Sürüm 1.3.16

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

Sürüm 1.3.15

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.8 sürümünü destekler.
Google Mobile Ads Unity eklentisi 11.5.0 sürümüyle geliştirilip test edilmiştir.

Sürüm 1.3.14

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ürümü 2.3.4.7.1'i destekler.
Google Mobile Ads Unity eklentisi 11.4.0 sürümüyle oluşturulup test edilmiştir.

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ı 2.3.2.3 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.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 oluşturulmuş ve 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ı sürüm 2.3.4.2'yi 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 eklentisi 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ı 2.3.1.2 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.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 eklentisi 8.1.0 sürümüyle oluşturulmuş ve test edilmiştir.