はじめに

概要

Adrop Flutter SDKを使用すると、Flutterアプリでさまざまな広告フォーマットを簡単に連携できます。

サポート広告フォーマット

フォーマット	説明
バナー広告	画面の一部に表示される長方形の広告
ネイティブ広告	アプリコンテンツと自然に調和する広告
インタースティシャル広告	全画面を覆う広告
リワード広告	報酬を提供する全画面広告
ポップアップ広告	ポップアップ形式で表示される広告

要件

Flutter

Flutter SDK 3.3.0 以上
Dart SDK 2.18.0 以上

Android

API レベル 23 (Android 6.0) 以上
compileSdkVersion 34
Kotlin 2.1.0 以上
Gradle 8.7 以上
Jetpack (AndroidX) 使用

iOS

iOS 13.0 以上
Swift 5.0 以上

インストール

1. パッケージのインストール

プロジェクトディレクトリで次のコマンドを実行します。

flutter pub add adrop_ads_flutter

2. Androidの設定

android/settings.gradle.ktsにバックフィル広告リポジトリを追加します。

android/settings.gradle.kts

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://artifact.bytedance.com/repository/pangle") }
    }
}

android/app/build.gradleにバックフィル依存関係を追加します。

android/app/build.gradle

dependencies {
    implementation 'io.adrop:adrop-ads-backfill:1.7.6'
}

android/app/src/main/AndroidManifest.xmlにバックフィルApp IDを追加します。

android/app/src/main/AndroidManifest.xml

<manifest>
    <application>
        <!-- Backfill App ID -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

App IDの発行についてはAdropにお問い合わせください。

3. iOSの設定

ios/Podfileを修正します。

ios/Podfile

use_frameworks!

target 'Runner' do
  # その他の依存関係...

  # バックフィル広告SDK
  pod 'adrop-ads-backfill'
end

Podをインストールします。

cd ios && pod install --repo-update && cd ..

4. Info.plistの設定

バックフィル広告のためにios/Runner/Info.plistに以下の設定を追加します。

GADApplicationIdentifier: バックフィル広告用のApp ID
SKAdNetworkItems: iOS 14以降で広告コンバージョントラッキングに必要

Info.plist設定を表示

Info.plist

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy</string>

<key>SKAdNetworkItems</key>
<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>cstr6suwn9.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>4fzdc2evr5.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>4pfyvq9l8r.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>2fnua5tdw4.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>ydx93a7ass.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>5a6flpkh64.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>p78axxw29g.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>v72qych5uu.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>ludvb6z3bs.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>cp8zw746q7.skadnetwork</string>
    </dict>
</array>

SKAdNetworkItemsの全リストとApp IDの発行についてはAdropにお問い合わせください。

5. 設定ファイルの追加

Android

Ad Controlコンソールから adrop_service.json ファイルをダウンロードします。
ファイルをandroid/app/src/main/assets/ディレクトリにコピーします。

android/app/src/main/assets/adrop_service.json

iOS

Ad Controlコンソールから adrop_service.json ファイルをダウンロードします。
Xcodeでプロジェクトルートにファイルを追加します。
すべてのターゲットにファイルを追加するように選択します。

初期化

アプリ起動時にSDKを初期化します。通常はmain.dartで呼び出します。

main.dart

import 'package:adrop_ads_flutter/adrop_ads_flutter.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    _initializeAdrop();
  }

  Future<void> _initializeAdrop() async {
    // false: テストモード, true: プロダクションモード
    await Adrop.initialize(false);
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

初期化オプション

await Adrop.initialize(
  production,        // bool: プロダクションモードかどうか
  targetCountries: targetCountries,   // List<String>?: ターゲット国コード配列 (オプション)
  useInAppBrowser: useInAppBrowser    // bool?: iOSインアプリブラウザ使用 (オプション)
);

パラメータ

パラメータ	タイプ	必須	説明
`production`	`bool`	Y	`true`: プロダクションモード, `false`: テストモード
`targetCountries`	`List<String>`	N	広告を表示する国コード (例: `['KR', 'US']`)
`useInAppBrowser`	`bool`	N	iOSでインアプリブラウザを使用 (デフォルト: `false`)

例

// 基本初期化 (テストモード)
await Adrop.initialize(false);

// プロダクションモード + 特定国ターゲティング
await Adrop.initialize(true, targetCountries: ['KR', 'JP', 'US']);

// プロダクションモード + iOSインアプリブラウザ使用
await Adrop.initialize(true, useInAppBrowser: true);

テーマ設定

広告UIテーマを設定します。

import 'package:adrop_ads_flutter/adrop_ads_flutter.dart';

// テーマ設定
await Adrop.setTheme(AdropTheme.auto);  // システム設定に従う
await Adrop.setTheme(AdropTheme.light); // ライトモード
await Adrop.setTheme(AdropTheme.dark);  // ダークモード

テーマ	説明
`AdropTheme.auto`	システム設定に従って自動切り替え
`AdropTheme.light`	ライトモード
`AdropTheme.dark`	ダークモード

ユーザー識別子の設定

ターゲティング広告のためにユーザー識別子(UID)を設定します。

import 'package:adrop_ads_flutter/adrop_ads_flutter.dart';

// ユーザーログイン後
await Adrop.setUID('user_123');

// ログアウト時
await Adrop.setUID('');

UIDはSHA-256でハッシュ化されて送信されます。メール、電話番号などの個人情報を直接渡さないでください。

テストユニットID

開発およびテスト時に次のテストユニットIDを使用してください。

フォーマット	テストユニットID
バナー (320x50)	`PUBLIC_TEST_UNIT_ID_320_50`
バナー (320x100)	`PUBLIC_TEST_UNIT_ID_320_100`
ネイティブ	`PUBLIC_TEST_UNIT_ID_NATIVE`
インタースティシャル	`PUBLIC_TEST_UNIT_ID_INTERSTITIAL`
リワード	`PUBLIC_TEST_UNIT_ID_REWARDED`
ポップアップ (下部)	`PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM`
ポップアップ (中央)	`PUBLIC_TEST_UNIT_ID_POPUP_CENTER`
スプラッシュ	`PUBLIC_TEST_UNIT_ID_SPLASH`

プロダクション配布前に必ず実際のユニットIDに置き換えてください。

エラーコード

SDKで発生する可能性のあるエラーコードです。

エラーコード	説明
`network`	ネットワークエラー
`internal`	内部エラー
`initialize`	SDK初期化エラー
`invalidUnit`	無効なユニットID
`notTargetCountry`	ターゲット国ではない
`inactive`	無効化された広告
`adNoFill`	表示する広告がない
`adLoadDuplicate`	重複ロードリクエスト
`adLoading`	ロード進行中
`adEmpty`	空の広告
`adShown`	すでに表示された広告
`adHideForToday`	今日は非表示に設定
`adLandscapeUnsupported`	横モード未対応
`backfillNoFill`	バックフィル広告なし

import 'package:adrop_ads_flutter/adrop_ads_flutter.dart';

// エラー処理例
if (errorCode == AdropErrorCode.adNoFill) {
  debugPrint('表示する広告がありません。');
}

トラブルシューティング

iOSビルドエラー

Swiftバージョンの互換性問題が発生した場合、ios/Podfileのpost_installブロックに次を追加してください。

ios/Podfile

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
    end
  end
end

Androidビルドエラー

Kotlinバージョンが合わない場合、android/build.gradleでKotlinバージョンを確認してください。

android/build.gradle

buildscript {
    ext.kotlin_version = '2.1.0'
}

次のステップ

バナー広告

バナー広告を実装する

ネイティブ広告

ネイティブ広告を実装する

インタースティシャル広告

インタースティシャル広告を実装する

リワード広告

リワード広告を実装する

WebViewガイド

WebViewでウェブ広告を表示

UMP連携

GDPR/CCPA同意管理

SDKガイド

AI

Android

iOS

React Native

Flutter

Web

REST API

概要

サポート広告フォーマット

要件

Flutter

Android

iOS

インストール

1. パッケージのインストール

2. Androidの設定

3. iOSの設定

4. Info.plistの設定

5. 設定ファイルの追加

Android

iOS

初期化

初期化オプション

テーマ設定

ユーザー識別子の設定

テストユニットID

エラーコード

トラブルシューティング

iOSビルドエラー

Androidビルドエラー

次のステップ

バナー広告

ネイティブ広告

インタースティシャル広告

リワード広告

WebViewガイド

UMP連携

SDKガイド

AI

Android

iOS

React Native

Flutter

Web

REST API

​概要

​サポート広告フォーマット

​要件

​Flutter

​Android

​iOS

​インストール

​1. パッケージのインストール

​2. Androidの設定

​3. iOSの設定

​4. Info.plistの設定

​5. 設定ファイルの追加

​Android

​iOS

​初期化

​初期化オプション

​テーマ設定

​ユーザー識別子の設定

​テストユニットID

​エラーコード

​トラブルシューティング

​iOSビルドエラー

​Androidビルドエラー

​次のステップ

バナー広告

ネイティブ広告

インタースティシャル広告

リワード広告

WebViewガイド

UMP連携

概要

サポート広告フォーマット

要件

Flutter

Android

iOS

インストール

1. パッケージのインストール

2. Androidの設定

3. iOSの設定

4. Info.plistの設定

5. 設定ファイルの追加

Android

iOS

初期化

初期化オプション

テーマ設定

ユーザー識別子の設定

テストユニットID

エラーコード

トラブルシューティング

iOSビルドエラー

Androidビルドエラー

次のステップ