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

Bu kılavuzda, şelale entegrasyonlarını kapsayan uyumlulaştırma özelliğini kullanarak i-mobile'dan reklam yüklemek ve göstermek için Google Mobile Ads Flutter Plugin aracını nasıl kullanacağınız 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 Flutter 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 bağdaştırıcısının özellikleri şöyledir:

Ön koşullar

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

• En yeni Google Mobile Ads Flutter Plugin sürümü.
• Flutter çerçevesi 3.7.0 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 Flutter Plugin ile yapılandırılmış çalışan bir Flutter projesi. Ayrıntılar için Google Mobile Ads Flutter Plugin hizmetini kurma başlıklı makaleyi inceleyin.

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.

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

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

広告スポット管理 (Reklam Spotu Yönetimi) sekmesine gidin ve 新規広告スポット (Yeni Reklam Spotu) düğmesini tıklayın.

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

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.

パブリッシャー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.

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 uygulamasını kullanmak istiyorsanız 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

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

pub.dev üzerinden entegrasyon

(Yalnızca Android) Projenizin android dizinindeki build.gradle dosyasına aşağıdaki depoları ekleyin:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://imobile.github.io/adnw-sdk-android")
      }
  }

Paketinizin pubspec.yaml dosyasında i-mobile SDK'sı ve bağdaştırıcısının en yeni sürümleriyle aşağıdaki bağımlılığı ekleyin:

dependencies:
  gma_mediation_imobile: ^1.0.6

Manuel Entegrasyon

i-mobile için Google Mobil Reklamlar Uyumlulaştırma Eklentisi'nin en yeni sürümünü indirin, indirilen dosyayı ayıklayın ve ayıklanan eklenti klasörünü (ve içeriğini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml dosyanızda eklentiye referans verin:

dependencies:
  gma_mediation_imobile:
    path: path/to/local/package

4. adım: Ek kod gerekli

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 test amaçlı Spot Kimliği, Medya Kimliği ve Yayıncı Kimliği sağlar. Bunları 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:

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

i-mobile Flutter Uyumlulaştırma Adaptörü Değişiklik Günlüğü

Sürüm 1.0.6

• 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 Mobil Reklam Flutter Eklentisi'nin 9.1.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 1.0.5

• Google Mobil Reklam Flutter Eklentisi'nin 9.1.0 sürümünü destekleyecek şekilde güncellendi.
• Swift Package Manager desteği ekleyin.
• 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 Mobil Reklam Flutter Eklentisi'nin 9.1.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 1.0.4

• 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 Mobil Reklam Flutter Eklentisi'nin 8.0.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 1.0.3

• Minimum Flutter sürümü 3.38.1'e güncellendi.
• Google Mobil Reklam Flutter Eklentisi 8.0.0 sürümünü destekleyecek şekilde güncellendi
• 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 Mobil Reklam Flutter Eklentisi'nin 8.0.0 sürümüyle oluşturulmuş ve test edilmiştir.

Sürüm 1.0.2

• 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 Mobil Reklam Flutter Eklentisi'nin 6.0.0 sürümüyle geliştirilip test edilmiştir.

Sürüm 1.0.1

• 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 Mobil Reklam Flutter Eklentisi'nin 6.0.0 sürümüyle geliştirilip test edilmiştir.

Sürüm 1.0.0

• İlk 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 Mobil Reklam Flutter Eklentisi'nin 5.3.1 sürümüyle oluşturulmuş ve test edilmiştir.