連携

このページでは、AppLovin React Nativeモジュールをダウンロード、インポート、および設定する方法について説明します。

React Nativeモジュールのバージョン5には、Promiseとコールバックをサポートするためのメジャーアップグレードが含まれます。このアップグレードにより、下位互換性が失われます。変更の概要については、以下のReact Native v5移行ガイドをご覧ください。

React Nativeモジュールのバージョン6には、TypeScriptとモジュールをサポートするためのメジャーアップデートが含まれます。 React Nativeバージョン0.71以降は、TypeScriptがReact Nativeのデフォルトのアプリケーションプログラミング言語になります。このモジュールアップグレードにより、下位互換性が失われます。変更の概要については、以下のReact Native v6移行ガイドをご覧ください。

Version 9 of the React Native module introduces support for the new architecture in React Native. It preserves existing APIs and functionalities. Due to certain limitations in the new architecture, it modifies some capabilities. For a summary of these changes, see React Native v9 Migration Guide below.

Ad Reviewを有効化

MAX Ad Reviewサービスを有効にするには、以下の手順に従ってください。

Androidの手順

以下をbuild.gradleファイルの最後に追加します。

buildscript {
  repositories {
    maven { url 'https://artifacts.applovin.com/android' }
  }
  dependencies {
    classpath "com.applovin.quality:AppLovinQualityServiceGradlePlugin:+"
  }
}

buildscript {
  repositories {
    maven { url = uri("https://artifacts.applovin.com/android") }
  }
  dependencies {
    classpath ("com.applovin.quality:AppLovinQualityServiceGradlePlugin:+")
  }
}

アプリレベルの`build.gradle`ファイルへの追加

Groovy
Kotlin

apply plugin: 'applovin-quality-service'
applovin {
  apiKey "«your-ad-review-key»"
}

plugins {
  id("applovin-quality-service")
}
applovin {
  apiKey = "«your-ad-review-key»"
}

Ad Review Keyは、AppLovinダッシュボードのAccount > General > Keys セクションでご確認ください。

iOSの手順

AppLovinQualityServiceSetup-ios.rbをダウンロードして、プロジェクトフォルダにこれを移動します。ターミナルウィンドウを開き、cdでプロジェクトディレクトリに移動し、以下を実行します。

ruby AppLovinQualityServiceSetup-ios.rb

SDKを初期化

アプリのホーム画面に以下のコードスニペットを追加します。

import AppLovinMAX, { Configuration } from "react-native-applovin-max";

⋮

AppLovinMAX.initialize("«your-SDK-key»").then((conf: Configuration) => {
  // SDK is initialized, start loading ads
}).catch(error => {
  // Failed to initialize SDK
});

SDK KeyはAppLovinダッシュボードのAccount > General > Keys のセクションにてご確認ください。

完全にキャッシュされた広告アセットは、ユーザー体験の向上につながります。このため、常に起動時にAppLovin SDKを初期化してください。これにより、メディエーションネットワークには広告をキャッシュするための最長時間が付与されます。これは特に動画広告において重要です。

iOS 14サポート

iOS 14では、Appleはグローバルなプライバシーポリシーの変更を導入しました。 Appleは、アプリがこれらの新しいポリシーに準拠することを求めています。遵守していない場合、収益を失う可能性があります。このセクションでは、準拠する方法について説明します。

SKAdNetwork

アプリの Info.plist をネットワーク固有の識別子で更新してください。手順については、SKAdNetwork documentationを参照してください。

同意とデータAPI

AppLovinのマネタイズパートナーに代わって、特定の法域でユーザーから同意を得る必要があります。また、同意値をAppLovinに正しく渡す必要があります。これらの設定方法については、Privacy–Consent, Age-Related Flags, and Data APIsのドキュメントをご覧ください。

React Native v5移行ガイド

React Nativeモジュールのバージョン5には、Promiseとコールバックをサポートするためのメジャーアップデートが含まれています。これにより、下位互換性が失われます。このセクションでは、これらのアップデートについて説明します。

ネイティブUIコンポーネント（AppLovinMAX.AdViewおよびAppLovinMAX.NativeAdView）は、コンポーネント内で直接コールバックを宣言することができます。

Type-specific event listeners take the type as an argument. These replace generic event listeners. For example there is now AppLovinMAX.addInterstitialLoadedEventListener(listener) instead of AppLovinMAX.addEventListener(type, listener).

Twelve formerly synchronous methods with return values now use the Promises architecture. You can use chaining via then/catch or async/await when you access the value passed by the Promise. The following table shows the updated methods.

メソッド	`resolve` 戻り値の型	`reject` 戻り値の型
`AppLovinMAX.getAdaptiveBannerHeightForWidth(width)`	高さ（`float`）	⸺
`AppLovinMAX.hasUserConsent()`	`boolean`	⸺
`AppLovinMAX.initialize(sdkKey)`	設定オブジェクト	`error`
`AppLovinMAX.isAgeRestrictedUser()`	`boolean`	⸺
`AppLovinMAX.isAppOpenAdReady(adunitId)`	`boolean`	`error`
`AppLovinMAX.isDoNotSell()`	`boolean`	⸺
`AppLovinMAX.isInitialized()`	`boolean`	⸺
`AppLovinMAX.isInterstitialReady(adUnitId)`	`boolean`	`error`
`AppLovinMAX.isMuted()`	`boolean`	⸺
`AppLovinMAX.isRewardedAdReady(adunitId)`	`boolean`	`error`
`AppLovinMAX.isTablet()`	`boolean`	⸺
`AppLovinMAX.showConsentDialog()`	`null`	`error`

また、デモアプリのコミットでは、移行によってこれらの新しいメソッドをどのように使用するのかを参照できます。

React Native v6移行ガイド

React Nativeモジュールのバージョン6には、TypeScriptとモジュールをサポートするためのメジャーアップデートが含まれています。これにより、下位互換性が失われます。このセクションでは、これらのアップデートについて説明します。

TypeScript

React Nativeバージョン0.71より、TypeScriptがReact Nativeのデフォルトのアプリケーションプログラミング言語になりました。 React Nativeモジュールのバージョン6では、コードベースをTypeScriptに移行します。

モジュール

Previous versions exported a single module, AppLovinMAX, which encompassed all the functions of MAX. Version 6 categorizes these functions into a set of modules. The architecture of version 6 resembles that of version 5, but updates function signatures to adapt to this introduction of modules. The major new modules are as follows:

モジュール	function
`AppLovinMAX`（デフォルト）	連携（初期化および汎用機能）
`プライバシー`	プライバシー、利用規約フロー
`AppOpenAd`	アプリ起動時広告
`BannerAd`	バナー広告
`InterstitialAd`	インタースティシャル広告
`MRecAd`	ミディアムレクタングル（MREC）広告
`NativeAdView`	ネイティブ広告
`RewardedAd`	リワード広告
`AdView`	バナーおよびMREC（UIコンポーネント）

移行の例

バージョン5
バージョン6

import AppLovinMAX from 'react-native-applovin-max';

AppLovinMAX.addInterstitialLoadedEventListener((adInfo) => {
    const isInterstitialReady = await AppLovinMAX.isInterstitialReady(«ad-unit-ID»);
    if (isInterstitialReady) {
        AppLovinMAX.showInterstitial(«ad-unit-ID»);
    }
});

AppLovinMAX.loadInterstitial(«ad-unit-ID»);

import { InterstitialAd, type AdInfo } from 'react-native-applovin-max';

InterstitialAd.addAdLoadedEventListener((adInfo: AdInfo) => {
    const isInterstitialReady = await InterstitialAd.isAdReady(«ad-unit-ID»);
    if (isInterstitialReady) {
        InterstitialAd.showAd(«ad-unit-ID»);
    }
});

InterstitialAd.loadAd(«ad-unit-ID»);

React Native v9移行ガイド

Version 9 of the React Native module introduces support for the new architecture in React Native while preserving the existing APIs and functionalities. Due to certain limitations in the new architecture, it modifies some capabilities.

主な変更点

**AdInfoでのWaterfall Information APIサポートの廃止: AdInfoオブジェクトは、Waterfall Information APIのサポートを終了しました。
AdViewおよびNativeAdViewにおけるextraParametersとlocalExtraParametersへの変更点: これらのパラメーターは文字列とブーリアン値のみをサポートしています。以前nullに設定していた値を、空文字列""に設定してください。

ご利用規約 | プライバシー | EULA | DMCA | Cookie設定