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

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 Flutter 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 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ı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:

Ö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ümlerin 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/Application Management) sekmesini ve uygulamanızın platformuna ait düğmeyi tıklayarak uygulamanızı i-mobile kontrol paneline ekleyin.

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

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

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

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.

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

パブリッシャーID (Yayıncı Kimliği), メディアID (Medya Kimliği) ve スポットID (Nokta Kimliği) değerlerini 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.

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) Aşağıdaki depoları projenizin android dizinindeki build.gradle dosyasına 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 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 Eklentisinin 8.0.0 sürümünü destekleyecek şekilde güncellendi
• 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.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 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ı sürüm 2.3.4.2'yi 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 Eklentisinin 5.3.1 sürümüyle oluşturulmuş ve test edilmiştir.