Monetize | SDK 連動ガイド | Unreal | メディエーションネットワークの準備 | AppLovin

warning

Caution

サードパーティSDKをモバイルプロパティに統合する場合、その統合に関する責任はすべてお客様が負うものとします。お客様およびサードパーティSDKプロバイダーは、ユーザーベースまたはデバイスベースのプライバシーの選択肢やフラグに準拠したデータ処理および取り扱いを確実に行う必要があります。

Android

MAX mediation adaptersをダウンロードしてアプリに統合する方法は2つあります。

Gradle: AppLovinはこの方法での統合を推奨しています。 AppLovinのadaptersのPOMファイルは、仲介ネットワークのSDKとその依存関係を自動的に統合します。
オープンソースadapters: 統合においてより高い柔軟性が必要な場合は、AppLovinのオープンソースadaptersを統合できます。仲介SDKとその依存関係の統合はお客様の責任となります。これらのadaptersは、AppLovin-MAX-SDK-Android GitHubリポジトリにあります。

warning

Caution

adapterの名前やパッケージ名は変更しないでください。変更すると、MAX SDKがadapterを認識できなくなり、広告がロードされなくなります。

Gradle

統合したい仲介広告ネットワークを以下のチェックボックスで選択してください。チェックボックスをオンにすると、このページにそれらのネットワークに特化した手順が表示されます。

また、このページではカスタマイズされたUPLも作成されます。以下のカスタマイズされたUPLを AppLovinMAX_UPL_Android.xml にコピーしてください。

<AARImports>
    <insertValue value="com.applovin.mediation,bidmachine-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,bigoads-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,chartboost-adapter,+" /> <insertNewline/>
    <insertValue value="com.google.android.gms,play-services-base,16.1.0" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,fyber-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,google-ad-manager-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,google-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,hyprmx-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,inmobi-adapter,+" /> <insertNewline/>
    <insertValue value="com.squareup.picasso,picasso,2.8" /> <insertNewline/>
    <insertValue value="androidx.recyclerview,recyclerview,1.1.0" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,ironsource-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,vungle-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,line-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,maio-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,facebook-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,mintegral-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,mobilefuse-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,moloco-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,ogury-presage-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,bytedance-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,pubmatic-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,smaato-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,unityads-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,verve-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,mytarget-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,yandex-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,yso-network-adapter,+" /> <insertNewline/>

</AARImports>

<buildGradleAdditions>
    <insert>
        allprojects {
            // You may add any additional repositories for other ad networks here
            repositories {
                maven { url "https://artifactory.bidmachine.io/bidmachine" }
                maven { url "https://cboost.jfrog.io/artifactory/chartboost-ads/" }
                maven { url "https://imobile-maio.github.io/maven" }
                maven { url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea" }
                maven { url "https://maven.ogury.co" }
                maven { url "https://artifact.bytedance.com/repository/pangle" }
                maven { url "https://repo.pubmatic.com/artifactory/public-repos" }
                maven { url "https://s3.amazonaws.com/smaato-sdk-releases/" }
                maven { url "https://verve.jfrog.io/artifactory/verve-gradle-release" }
                maven { url "https://ysonetwork.s3.eu-west-3.amazonaws.com/sdk/android" }

            }
        }
    </insert>
</buildGradleAdditions>

info

Note

Google AdSense、AdManager、またはAdMobを使用するデベロッパーおよびパブリッシャーは、Googleが認定した同意管理プラットフォーム（CMP）を使用する必要があります。欧州経済領域（EEA）または英国のユーザーに広告を配信する場合、CMPはIABのTransparency and Consent Framework（TCF）と統合されている必要があります。詳細については、プライバシー：「TCF v2同意」を参照してください。

Google biddingおよびGoogle AdMob / Google Ad ManagerのアプリIDの追加

AppLovin MAX Unrealプラグインの AppLovinMAX_UPL_Android.xml 内にある androidManifestUpdates タグの下に、Google biddingおよびGoogle AdMobのアプリIDを追加します。以下の例の «your-admob-app-id» を、お客様 of Google biddingおよびGoogle AdMobのアプリIDに置き換えてください。

<androidManifestUpdates>
⋮
    <addElements tag="application">
        <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="«your-admob-app-id»" />
    </addElements>
⋮
</androidManifestUpdates>

`compileSdkVersion`

Google Mobile Ads SDKバージョン23.1.0以降では、compileSdkVersion が34以上である必要があります。

Project Settings > Android SDK > SDK API Level で compileSdkVersion を android-34 以上に設定してください。

最新の compileSdkVersion 要件については、Google Mobile Ads SDKリリースノートを参照してください。

Gradleエラー

Google AdMobには、Android Gradleプラグインバージョン4.2.0以降およびGradleバージョン6.7.1以降が必要です。以下のエラーが表示される場合は、Android GradleプラグインおよびGradleのバージョンをアップデートしてください。

AAPT: error: unexpected element <property> found in <manifest><application>.

Android manifestのマージエラー

一部のネットワークSDKには、バンドルされているAndroid Manifestファイルに <queries> 要素が含まれています。互換性のないバージョンのAndroid Gradleプラグインを使用している場合、これが原因で以下のいずれかのビルドエラーが発生します。

com.android.builder.internal.aapt.v2.Aapt2Exception: Android resource linking failed
error: unexpected element <queries> found in <manifest>.

Missing 'package' key attribute on element package at [:com.my.target.mytarget-sdk-5.11.3:]
AndroidManifest Validation failed

このエラーを修正するには、以下のいずれかのバージョンのAndroid Gradleプラグインにアップグレードしてください。これらのバージョンは <queries> 要素をサポートしています。

warning

Caution

Gradle Build Toolsではなく、Android Gradleプラグインをアップグレードしてください。

現在のAndroid Gradleプラグインのバージョン	`<queries>` 要素をサポートするバージョン
4.1.*	すべて
4.0.*	4.0.1+
3.6.*	3.6.4+
3.5.*	3.5.4+
3.4.*	3.4.3+
3.3.*	3.3.3+

Android Gradleプラグインをアップグレードするには、以下の手順に従ってください。

お使いのUnreal Engineのバージョンのディレクトリに移動します。たとえば、macOSにおけるUnreal Engine 5.2のデフォルトのインストールパスは /Users/Shared/Epic Games/UE_5.2/ です。
Engine/Source/Programs/UnrealBuildTool/Platform/Android/UEDeployAndroid.cs で、ANDROID_TOOLS_BUILD_GRADLE_VERSION の値を更新します（«X.X.X»を適切なバージョン番号に置き換えてください）。
```
private const string ANDROID_TOOLS_BUILD_GRADLE_VERSION = "com.android.tools.build:gradle:«X.X.X»";
```

Engine/Build/Android/Java/gradle/build.gradle で、次の行を更新します（«X.X.X»を適切なバージョン番号に置き換えてください）。

classpath project.hasProperty('ANDROID_TOOLS_BUILD_GRADLE_VERSION') ? project.property('ANDROID_TOOLS_BUILD_GRADLE_VERSION') : 'com.android.tools.build:gradle:«X.X.X»'

Meta Audience Networkのデータ処理オプション

Limited Data Use（LDU）モードを有効にしたくない場合は、SetDataProcessingOptions() に空の文字列配列を渡します。

⋮
<gameActivityImportAdditions>
  ⋮
  import com.facebook.ads.AdSettings;
</gameActivityImportAdditions>

<gameActivityOnCreateAdditions>
  <insert>
    AdSettings.setDataProcessingOptions( new String[] {} );
  </insert>
</gameActivityOnCreateAdditions>

ユーザーに対してLDUを有効にし、ユーザーの地域を指定するには、以下のような形式で SetDataProcessingOptions() を呼び出します。

<gameActivityOnCreateAdditions>
  <insert>
    AdSettings.setDataProcessingOptions( new String[] {"LDU"}, «country», «state» );
  </insert>
</gameActivityOnCreateAdditions>

カリフォルニア州のユーザー向けのMeta Audience Networkデータ処理オプション

カリフォルニア州におけるMeta Audience Networkの「Limited Data Use」フラグの実装方法については、Meta for Developersのドキュメントを参照してください。

Adapter network information

読み込み中...

iOS

Unreal Engineでは、iOS用のサードパーティフレームワークを手動で統合する必要があります。 CocoaPodsのような依存関係マネージャーはサポートされていません。 MAX Unreal GitHubリポジトリには、Podfileからの依存関係の自動インストールを支援するPythonスクリプト — install_pods.py — が含まれています。このスクリプトは、AppLovinのadaptersとサードパーティの依存関係をダウンロードし、それらをリンクするためのビルド設定をプロジェクトに構成します。

info

Note

このスクリプトは、特定のネットワークのサードパーティSDKを自動的に構成できない場合があります。その場合は、手動で統合する必要があります。

要件

Python 3.6+
CocoaPods

info

Tip

最新バージョンのCocoaPodsを使用していることを確認してください。次のコマンドを実行して、バージョンを確認できます。

pod --version

CocoaPodsをアップデートするには、次のいずれかのコマンドを実行します。

brew upgrade cocoapods

sudo gem install cocoapods

手順

AppLovinのMAX Unreal GitHubリポジトリから install_pods.py をダウンロードします。
このスクリプトを、AppLovin MAX Unrealプラグインの Source/ThirdParty/IOS/ ディレクトリにコピーします。
統合したいadapters用に、そのディレクトリに Podfileを作成します。
install_pods.py を実行して、adaptersと依存関係をダウンロードします。スクリプトの指示に従ってインストールを完了します。
メディエーションネットワークの準備（iOS）の手順に従います。 AppLovinMAX_UPL_IOS.xml 内の Info.plist に必要な変更を加えます。

メディエーションネットワークの準備

Android

Gradle

Google biddingおよびGoogle AdMob / Google Ad ManagerのアプリIDの追加

compileSdkVersion

Gradleエラー

Android manifestのマージエラー

Meta Audience Networkのデータ処理オプション

カリフォルニア州のユーザー向けのMeta Audience Networkデータ処理オプション

難読化

Adapter network information

iOS

要件

手順

`compileSdkVersion`