コンテンツにスキップ

連携

このページでは、AppLovin MAX SDKのダウンロード、インポート、および設定方法を説明します。

最新SDKをダウンロードする

SDKは、CocoaPodsから依存関係としてSDKをダウンロードすることができます。 手動で統合する場合は、こちらの手順に従ってください。 Swift Package Managerを使用して統合する場合は、こちらの手順に従ってください。

SDKでは、iOSのデプロイメントターゲットがiOS 11.0以上であることを要件としています。 また、Xcodeバージョン15以降にアップデートする必要があります。

リリースアップデートを受け取るには、AppLovin iOS MAX SDK GitHub repository をサブスクライブしてください。

Swiftとの互換性

ビルドがSwiftを含むアーティファクトとの互換性があることを確認するには、Build Settings > Always Embed Swift Standard LibrariesYESに設定してください。

Swiftを使用し、iOS 12.2.0以前向けにビルドを行う場合は、/usr/lib/swiftBuild Settings > Runpath Search Pathsに追加します。 これにより、libswiftCore.dylib の問題を回避できます。

CocoaPods

CocoaPodsでAppLovin SDKを統合させる方法:

  1. Podfileに以下のラインを追加します。
    pod 'AppLovinSDK'
  2. コマンドラインで以下を実行します:
    Terminal window
    pod install --repo-update

カスタムSDKアダプターを実装する

AppLovin Exchange(ALX)はLinkedInのカスタムアダプターをサポートしています。 連携手順については以下を、詳細情報はこちらをご覧ください。

アダプターをインストールする方法:

  1. Podfileに以下のラインを追加します。
    pod 'AppLovinDSPLinkedInAdapter'
  2. コマンドラインで以下を実行します:
    Terminal window
    pod install --repo-update

Ad Reviewを有効にする

MAX Ad Reviewサービスを有効にするには、まずAppLovinアカウントにログインします。 次に、AppLovinQualityServiceSetup-ios.rbをダウンロードし、プロジェクトフォルダに移動します。 ターミナルウィンドウを開き、cd でプロジェクトフォルダに移動して、以下を実行してください。

Terminal window
ruby AppLovinQualityServiceSetup-ios.rb

SDKを初期化する

SDKの初期化構成を作成する

SDKを初期化する前に、アプリデリゲートのapplication:applicationDidFinishLaunching:メソッドで、SDKの初期化構成オブジェクトを作成します。

この設定オブジェクトでは、SDKが初期化時に使用するプロパティを設定できます。 これらの初期化プロパティは不変ですが、ALSdkSettings はアプリのライフサイクル中に変更可能なプロパティを含んでいます。

// Create the initialization configuration
ALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey: @"«SDK-key»" builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {
builder.mediationProvider = ALMediationProviderMAX;
// Perform any additional configuration/setting changes
}];

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

SDKを初期化する

初期化構成オブジェクトを使用してAppLovin SDKを初期化します。 これをスタートアップ時に行ってください。 これにより、SDKがメディエーションネットワークの広告をキャッシュする時間を最大化し、ユーザー体験の向上につながります。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
// Create the initialization configuration
ALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey: @"«SDK-key»" builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {
builder.mediationProvider = ALMediationProviderMAX;
}];
// Initialize the SDK with the configuration
[[ALSdk shared] initializeWithConfiguration: initConfig completionHandler:^(ALSdkConfiguration *sdkConfig) {
// Start loading ads
}];

以下は実装の例です。

// Create the initialization configuration
ALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey: @"«SDK-key»" builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {
builder.mediationProvider = ALMediationProviderMAX;
builder.segmentCollection = [MASegmentCollection segmentCollectionWithBuilderBlock:^(MASegmentCollectionBuilder *builder) {
[builder addSegment: [[MASegment alloc] initWithKey: @(849) values: @[@(1), @(3)]]];
}];
}];
// Configure the SDK settings if needed before or after SDK initialization.
ALSdkSettings *settings = [ALSdk shared].settings;
settings.userIdentifier = @"«user-ID»";
[settings setExtraParameterForKey: @"uid2_token" value: @"«token-value»"];
// Note: you may also set these values in your Info.plist
settings.termsAndPrivacyPolicyFlowSettings.enabled = YES;
settings.termsAndPrivacyPolicyFlowSettings.termsOfServiceURL = [NSURL URLWithString: @"«https://your-company-name.com/terms-of-service»"];
settings.termsAndPrivacyPolicyFlowSettings.privacyPolicyURL = [NSURL URLWithString: @"«https://your-company-name.com/privacy-policy»"];
// Initialize the SDK with the configuration
[[ALSdk shared] initializeWithConfiguration: initConfig completionHandler:^(ALSdkConfiguration *sdkConfig) {
// Start loading ads
}];

iOS 14サポート

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

SKAdNetwork

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

同意とデータAPI

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

iOS 15グローバルSKAdNetworkレポート

iOS 15より、Appleは開発者がSKAdNetworkインストールポストバックのコピーを任意のエンドポイントに送信できるようにしています。 MAXにはGlobal SKAdNetworkレポートが含まれます (MAX > Mediation > Analyze > Global SKA Report)。 これを使用すると、すべてのネットワークパートナーのSKAdNetworkデータに1ヶ所でアクセスできます。