統合

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

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

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

SDKの最小iOSデプロイターゲットはiOS 12.0以上である必要があります。また、Xcodeバージョン15以上が必要です。

リリースのアップデート情報を受け取るには、AppLovin iOS MAX SDK GitHubリポジトリを購読してください。

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'
```
コマンドラインで以下を実行します：
```
pod install --repo-update
```

Swift Package Manager

SPM経由でAppLovin SDKを統合するには：

Xcodeで、**File > Add Package Dependencies…**をクリックします。
検索バーに、こちらにあるAppLovin iOS MAX Swift PackageのGitHubリポジトリURLを入力し、パッケージが表示されたら選択します。
Dependency Ruleを選択し、Add to Projectをアプリのターゲットに設定します。
Add PackageをクリックしてAppLovinSDKを統合します。

Ad Reviewを有効にする

MAX Ad Reviewサービスを有効にするには、AppLovinアカウントにログインする必要があります。その後、AppLovinQualityServiceSetup-ios.rbをダウンロードし、プロジェクトフォルダに移動します。ターミナルウィンドウを開き、プロジェクトフォルダにcdして以下を実行します：

ruby AppLovinQualityServiceSetup-ios.rb

SDKの初期化

SDK初期化設定の作成

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

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

// 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キーは、AppLovinダッシュボードのAccount > General > Keysセクションで確認できます。

SDKの初期化

初期化設定オブジェクトを使用してAppLovin SDKを初期化します。これはアプリの起動時に行ってください。これにより、SDKがmediationネットワーク広告をキャッシュする時間を最大化でき、結果としてユーザーエクスペリエンスが向上します。

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

実装例

以下は統合の実装例です：

// 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 ドキュメントを参照してください。

同意とデータAPI

特定の法域においては、AppLovinのマネタイズパートナーに代わって、ユーザーから同意を取得する必要があります。また、同意の値をAppLovinに渡す必要があります。方法については、プライバシー：同意、年齢関連フラグ、およびデータAPIのドキュメントを確認してください。

Changelog

利用規約とプライバシーポリシーのフロー

ポリシーセンター利用規約パブリッシャーポリシーデマンドパートナーポリシープラットフォームによる規制プライバシー Your Privacy Choices

Cookieの設定