連携
このページでは、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 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
カスタムSDKアダプターを実装する
AppLovin Exchange(ALX)はLinkedInのカスタムアダプターをサポートしています。 連携手順については以下を、詳細情報はこちらをご覧ください。
アダプターをインストールする方法:
- Podfileに以下のラインを追加します。
pod 'AppLovinDSPLinkedInAdapter'
- コマンドラインで以下を実行します:
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の初期化構成オブジェクトを作成します。
この設定オブジェクトでは、SDKが初期化時に使用するプロパティを設定できます。
これらの初期化プロパティは不変ですが、ALSdkSettings
はアプリのライフサイクル中に変更可能なプロパティを含んでいます。
// Create the initialization configurationALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey: @"«SDK-key»" builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {
builder.mediationProvider = ALMediationProviderMAX;
// Perform any additional configuration/setting changes}];
// Create the initialization configurationlet 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がメディエーションネットワークの広告をキャッシュする時間を最大化し、ユーザー体験の向上につながります。
- (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 configurationALSdkInitializationConfiguration *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.plistsettings.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 configurationlet 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().settingssettings.userIdentifier = "«user-ID»"settings.setExtraParameterForKey("uid2_token", value: "«token-value»")
// Note: you may also set these values in your Info.plistsettings.termsAndPrivacyPolicyFlowSettings.isEnabled = truesettings.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 configurationALSdk.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のドキュメントをご覧ください。
iOS 15グローバルSKAdNetworkレポート
iOS 15より、Appleは開発者がSKAdNetworkインストールポストバックのコピーを任意のエンドポイントに送信できるようにしています。 MAXにはGlobal SKAdNetworkレポートが含まれます (MAX > Mediation > Analyze > Global SKA Report)。 これを使用すると、すべてのネットワークパートナーのSKAdNetworkデータに1ヶ所でアクセスできます。