連携

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

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

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

このSDKを使用するには、iOSの最低デプロイターゲットがiOS 12.0以降、Xcodeはバージョン15以降であることが必須です。

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

Swiftとの互換性

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

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

CocoaPods

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

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

Ad Reviewを有効にする

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

ruby AppLovinQualityServiceSetup-ios.rb

SDKを初期化する

SDKの初期化構成を作成

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

This configuration object allows you to configure the properties that the SDK will initialize with. These initialization properties are immutable, except ALSdkSettings which contains mutable properties that can change during the lifetime of the app.

Objective-C
Swift

// Create the initialization configuration
ALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey: @"«SDK-key»" builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {

  builder.mediationProvider = ALMediationProviderMAX;

  // Perform any additional configuration/setting changes
}];

// Create the initialization configuration
let initConfig = ALSdkInitializationConfiguration(sdkKey: "«SDK-key»") { builder in

  builder.mediationProvider = ALMediationProviderMAX

  // Perform any additional configuration/setting changes
}

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

SDKを初期化する

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

Objective-C
Swift

- (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
  }];
  ⋮

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool
{
  let initConfig = ALSdkInitializationConfiguration(sdkKey: "«SDK-key»") { builder in
    builder.mediationProvider = ALMediationProviderMAX
  }

  // Initialize the SDK with the configuration
  ALSdk.shared().initialize(with: initConfig) { sdkConfig in
    // Start loading ads
  }
  ⋮

例

以下は実装の例です。

Objective-C
Swift

// 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
}];

// Create the initialization configuration
let initConfig = ALSdkInitializationConfiguration(sdkKey: "«SDK-key»") { builder in
  builder.mediationProvider = ALMediationProviderMAX
  builder.segmentCollection = MASegmentCollection { segmentCollectionBuilder in
    segmentCollectionBuilder.add(MASegment(key: 849, values: [1, 3]))
  }
}

// Configure the SDK settings if needed before or after SDK initialization.
let 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.isEnabled = true
settings.termsAndPrivacyPolicyFlowSettings.termsOfServiceURL = URL(string: "«https://your-company-name.com/terms-of-service»")
settings.termsAndPrivacyPolicyFlowSettings.privacyPolicyURL = URL(string: "«https://your-company-name.com/privacy-policy»")

// Initialize the SDK with the configuration
ALSdk.shared().initialize(with: initConfig) { sdkConfig in
  // 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のドキュメントをご覧ください。

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