メインコンテンツへスキップ

概要

バックフィル広告は、直接広告がない場合に代替広告を自動的に表示して収益を最大化する機能です。Adropは、AdMob、Pangleなどの主要な広告ネットワークをバックフィル広告としてサポートしています。
バックフィル広告を使用するには、追加の依存関係のインストールが必要です:io.adrop:adrop-ads-backfill

インストール

1. Gradle設定

Settings.gradle.kts

Pangle広告ネットワークリポジトリを追加します:
settings.gradle.kts
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://artifact.bytedance.com/repository/pangle") }
    }
}

Build.gradle.kts

バックフィル広告の依存関係を追加します:
dependencies {
    implementation("io.adrop:adrop-ads:1.7.2")
    implementation("io.adrop:adrop-ads-backfill:1.7.2")
}

2. ProGuard設定

ProGuardを使用している場合、以下のルールを追加します:
proguard-rules.pro
-keep class io.adrop.** { *; }
-dontwarn io.adrop.**

3. AndroidManifest.xml設定

AdMobをバックフィル広告として使用する場合、APPLICATION_IDをAndroidManifest.xmlに追加します:
AndroidManifest.xml
<manifest>
    <application>
        <!-- AdMob App ID -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>
ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyyを実際のAdMob App IDに置き換えてください。

コンソール設定

Adropコンソールでバックフィル広告を有効にします:
  1. Adropコンソールにログイン
  2. 広告ユニットメニューに移動
  3. バックフィル広告を使用する広告ユニットを選択
  4. バックフィル設定セクションでバックフィル広告を有効化
  5. 使用するバックフィル広告ネットワークを選択(AdMob、Pangleなど)
  6. 広告ネットワーク別の設定を入力(例:AdMob Ad Unit ID)

広告表示フロー

バックフィル広告は以下の順序で表示されます:

対応広告フォーマット

バックフィル広告は以下のフォーマットをサポートしています:
広告フォーマット対応状況説明
バナー(Banner)✅ 対応固定サイズのバナー広告
ネイティブ(Native)✅ 対応カスタマイズ可能なネイティブ広告
インタースティシャル(Interstitial)✅ 対応フルスクリーン広告
リワード(Rewarded)✅ 対応報酬型広告

バックフィル広告の確認

広告がバックフィル広告かどうかを確認するには、isBackfilledプロパティを使用します:
AdropBanner(context, "YOUR_UNIT_ID").apply {
    listener = object : AdropAdListener() {
        override fun onAdReceived(ad: AdropAd) {
            if (ad.isBackfilled) {
                Log.d("Adrop", "バックフィル広告が読み込まれました")
            } else {
                Log.d("Adrop", "直接広告が読み込まれました")
            }
        }
    }
    load()
}

ベストプラクティス

バックフィル広告を有効化

すべての広告ユニットでバックフィル広告を有効にして、広告表示率と収益を最大化しましょう。

適切なタイムアウト設定

直接広告とバックフィル広告に適切なタイムアウトを設定して、ユーザー体験を向上させましょう。

バックフィル広告の分析

isBackfilledプロパティを使用して、直接広告とバックフィル広告の比率を追跡・分析しましょう。

広告ネットワークの最適化

複数のバックフィル広告ネットワークをテストし、最も高い収益を提供するネットワークを選択しましょう。

注意事項

  • バックフィル広告を使用するには、必ずio.adrop:adrop-ads-backfill依存関係を追加する必要があります。
  • AdMobを使用する場合、AndroidManifest.xmlにAPPLICATION_IDを必ず追加してください。
  • バックフィル広告ネットワークのポリシーを遵守する必要があります。

関連ドキュメント