初回セッションの遅延

初回セッションの遅延機能を使用すると、初回のSDKセッションでのみSDKの初期化を遅延させることができます。この遅延モードでは、Adjust SDKは全てのアクティビティ（インストールやイベントなど）をメモリ上に記録しますが、Adjustサーバーへはデータを送信しません。

これにより、アプリは起動時に利用できない可能性のある追加データを取得したり、必要に応じてデータ送信前にSDK設定を変更することができます。遅延が終了すると、SDKはその間に構成された全ての設定内容を適用し、インストールのトラッキングを開始します。

初回セッションの遅延を使用するタイミングと理由

以下を行う必要がある場合にこの機能を使用します。

ユーザーのCOPPA準拠を設定する。
外部デバイスIDを割り当てる。

専用の初回セッション遅延APIでサポートされる機能に加え、遅延中に以下の操作も実行できます。

App Tracking Transparency（ATT）ダイアログを表示し、ユーザーの応答に対して処理を行う。
サードパーティーとの共有設定を行う。
DMAの同意パラメーターを設定する。
特定のユーザーの同意計測を設定する。
グローバルパートナーまたはコールバックパラメーターを設定する。

初回セッションの遅延を有効化

SDKを遅延モードで初期化するには、以下の設定を行います。

Swift
Objective-C

let yourAppToken = "{YourAppToken}"
let environment = ADJEnvironmentSandbox
let adjustConfig = ADJConfig(appToken: yourAppToken,
                          environment: environment)
adjustConfig?.enableFirstSessionDelay()
// ...
Adjust.initSdk(adjustConfig)

NSString *yourAppToken = @"{YourAppToken}";
NSString *environment = ADJEnvironmentSandbox;
ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:yourAppToken
                                                    environment:environment];
[adjustConfig enableFirstSessionDelay];
// ...
[Adjust initSdk:adjustConfig];

この処理の後、SDKはメモリ上で初期化されますが、以下を明示的に呼び出すまでは一切処理を行いません。

Swift
Objective-C

1
Adjust.endFirstSessionDelay()

1
[Adjust endFirstSessionDelay];

注意

この遅延は、SDKのインストールセッション（すなわち一番最初のSDK初期化）中にのみ発生します。
カスタムプロンプトのタイミングとは異なり、初回セッションの遅延はタイマーの使用を意味しません。
遅延は、 endFirstSessionDelay が呼び出された時にのみ終了します。アプリの実行中にこれが呼び出されない場合、遅延された呼び出しはアプリの再起動時に失われます。次回のSDK初期化は再び初回セッションとして処理され、SDKは遅延モードで再度初期化されます。
遅延が終了するか、それ以上適用されなくなると（例：次に続くセッションなどで）、 enableFirstSessionDelay または endFirstSessionDelay への呼び出しはすべて無視されます。

遅延中に設定を変更

COPPAコンプライアンスを設定

SDKが初回セッション遅延モード中であれば、initSdkにConfigで設定するのと同様に、COPPAコンプライアンスの有効化/無効化を切り替えることができます。

COPPAコンプライアンスを有効化：

Swift
Objective-C

1
Adjust.enableCoppaComplianceInDelay()

1
[Adjust enableCoppaComplianceInDelay];

COPPAコンプライアンスを無効化：

Swift
Objective-C

1
Adjust.disableCoppaComplianceInDelay()

1
[Adjust disableCoppaComplianceInDelay];

外部デバイスIDを設定する

SDKが初回セッション遅延モードになっている間は、initSdk中に設定されたかのように、外部デバイスIDを設定することができます。

外部デバイスIDを設定：

Swift
Objective-C

1
Adjust.setExternalDeviceIdInDelay("YourExternalDeviceId")

1
[Adjust setExternalDeviceIdInDelay:@"YourExternalDeviceId"];