設定

Adjust SDKの動作を設定するには、このドキュメントに記載されたメソッドを使用してください。

Configオブジェクトをインスタンス化する

+ (nullable ADJConfig *)configWithAppToken:(nonnull NSString *)appToken
                               environment:(nonnull NSString *)environment
                     allowSuppressLogLevel:(BOOL)allowSuppressLogLevel;

Adjust SDKを設定するには、ADJConfigオブジェクトをインスタンス化する必要があります。このオブジェクトには、Adjust SDKにパスする必要のある 読み取り専用 の設定オプションが含まれています。

Configオブジェクトをインスタンス化するには、新しいADJConfigインスタンスを作成して以下のパラメーターをパスしてください：

appToken （NSString）：お客様のAdjustアプリトークン。
environment （NSString）：SDKを実行したい環境。テスト用のサンドボックスモードでSDKを実行するにはADJEnvironmentSandboxをパスします。リリース用の本番モードでSDKを実行するにはADJEnvironmentProductionをパスします。
allowSuppressLogLevel （BOOL）：全てのログを無効化するかどうか。ログを無効化するにはtrueに、ログを有効化するにはfalseに設定します。

1
let yourAppToken = "{YourAppToken}"
2
let environment = ADJEnvironmentSandbox as? String
3
let adjustConfig = ADJConfig(
4
   appToken: yourAppToken,
5
   environment: environment)

1
NSString *yourAppToken = @"{YourAppToken}";
2
NSString *environment = ADJEnvironmentSandbox;
3
*adjustConfig = [ADJConfig configWithAppToken:yourAppToken
4
                                  environment:environment];

1
setupWebViewJavascriptBridge(function (bridge) {
2
   var yourAppToken = yourAppToken;
3
   var environment = AdjustConfig.EnvironmentSandbox;
4
   var adjustConfig = new AdjustConfig(yourAppToken, environment);
5
});

読み取り専用の設定

読み取り専用 の設定オプションは、SDKの初期化前に ADJConfigインスタンスで設定されます。これらのオプションは、SDKの実行中は変更できません。Adjust.appDidLaunch()を実行する前に、使用したいオプションを設定する必要があります。

ログレベルを設定する

@property (nonatomic, assign) ADJLogLevel logLevel;

Adjust SDKは、さまざまな量の情報を返すために、設定可能なログレベルを提供しています。以下のログレベルが利用可能です。

ADJLogLevel	説明
`ADJLogLevelVerbose`	ログを全て有効化する
`ADJLogLevelDebug`	デバッグのログを有効化する
`ADJLogLevelInfo`	情報レベルのログのみを表示する（デフォルトオプション）
`ADJLogLevelWarn`	情報ログを無効化する
`ADJLogLevelError`	警告レベル以下のログを無効化する
`ADJLogLevelAssert`	エラーレベル以下のログを無効化する
`ADJLogLevelSuppress`	ログを全て無効化する

ConfigインスタンスのlogLevelプロパティにADJLogLevel値を割り当てることで、ログレベルを設定できます。

logLevel （ADJLogLevel）：使用したいログレベル

1
let yourAppToken = "{YourAppToken}"
2
let environment = ADJEnvironmentSandbox as? String
3
let adjustConfig = ADJConfig(
4
   appToken: yourAppToken,
5
   environment: environment)
6
// ...
7
adjustConfig?.logLevel = ADJLogLevel.verbose

1
NSString *yourAppToken = @"{YourAppToken}";
2
NSString *environment = ADJEnvironmentSandbox;
3
*adjustConfig = [ADJConfig configWithAppToken:yourAppToken
4
                                 environment:environment];
5
// ...
6
[adjustConfig setLogLevel:ADJLogLevelVerbose];

1
setupWebViewJavascriptBridge(function (bridge) {
2
   // ...
3
   var yourAppToken = yourAppToken;
4
   var environment = AdjustConfig.EnvironmentSandbox;
5
   var adjustConfig = new AdjustConfig(yourAppToken, environment);
6
   adjustConfig.setLogLevel(AdjustConfig.LogLevelVerbose);
7
});

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

@property (nonatomic, copy, nullable) NSString *externalDeviceId;

外部デバイスIDは、デバイスまたはユーザーに割り当てることができるカスタム値です。セッションやプラットフォームを横断してユーザーを認識することができます。また、ユーザーが新規インストールとして2度カウントされないように、ユーザーごとにインストールの重複を排除することも可能です。外部デバイスIDの使用を開始する際は、Adjustの担当者にお問い合わせください。

外部デバイスIDをデバイスのカスタム識別子として使用できます。これは、他のシステム上で継続性を保ちたい場合に役立ちます。ConfigインスタンスのexternalDeviceIdプロパティに外部デバイスIDを割り当てます。

externalDeviceId （NSString）：外部デバイスID。この値は 大文字と小文字を区別します 。外部デバイスIDをインポートしている場合は、パス値がインポートした値と一致することを確認してください。

1
let yourAppToken = "{YourAppToken}"
2
let environment = ADJEnvironmentSandbox as? String
3
let adjustConfig = ADJConfig(
4
   appToken: yourAppToken,
5
   environment: environment)
6
// ...
7
adjustConfig?.externalDeviceId = "yourExternalDeviceId"

1
NSString *yourAppToken = @"{YourAppToken}";
2
NSString *environment = ADJEnvironmentSandbox;
3
*adjustConfig = [ADJConfig configWithAppToken:yourAppToken
4
                                 environment:environment];
5
// ...
6
[adjustConfig setExternalDeviceId:@"yourExternalDeviceId"];

1
setupWebViewJavascriptBridge(function (bridge) {
2
   var yourAppToken = yourAppToken;
3
   var environment = AdjustConfig.EnvironmentSandbox;
4
   var adjustConfig = new AdjustConfig(yourAppToken, environment);
5
   adjustConfig.setExternalDeviceId("yourExternalDeviceId");
6
});

外部デバイスIDをビジネスアナリティクスに使用する場合は、IDをセッションコールバックパラメーターとしてパスすることができます。

既存の外部デバイスIDをAdjustにインポートすることが可能です。これにより、Adjustサーバーが今後のデータを既存のデバイス記録と一致させることができます。この設定をご希望の場合は、Adjustの担当者にお問い合わせください。

デフォルトのリンクトークンを設定する

@property (nonatomic, copy, nullable) NSString *defaultTracker;

アプリがデバイスにプリインストールされている場合、デフォルトのリンクトークンを設定できます。ユーザーがプリインストールされたアプリを初めて起動すると、インストールはデフォルトのリンクトークンにアトリビュートされます。デフォルトのリンクトークンを、configインスタンスのdefaultTrackerプロパティに割り当てます。

defaultTracker （NSString）：プリインストールを記録したいAdjustリンクトークン。

1
let yourAppToken = "{YourAppToken}"
2
let environment = ADJEnvironmentSandbox as? String
3
let adjustConfig = ADJConfig(
4
   appToken: yourAppToken,
5
   environment: environment)
6
adjustConfig?.defaultTracker = "{Token}"
7
Adjust.appDidLaunch(adjustConfig)

1
*adjustConfig = [ADJConfig configWithAppToken:@"{YourAppToken}"
2
                                 environment:ADJEnvironmentSandbox];
3
[adjustConfig setDefaultTracker:@"{Token}"];
4
[Adjust appDidLaunch:adjustConfig];

1
setupWebViewJavascriptBridge(function (bridge) {
2
   var yourAppToken = yourAppToken;
3
   var environment = AdjustConfig.EnvironmentSandbox;
4
   var adjustConfig = new AdjustConfig(yourAppToken, environment);
5
   adjustConfig.setDefaultTracker("{Token}");
6
});

コストデータの送信を有効化する

@property (nonatomic, assign) BOOL needsCost;

デフォルトでは、Adjust SDKはユーザーのアトリビューションの一環としてコストデータを送信しません。コストデータの送信を有効化することで、このデータを送信するようにSDKを設定できます。コストデータ送信を有効化するには、configインスタンスのneedsCostプロパティに ブーリアン 値を割り当てます。

needsCost （BOOL）：コストデータの送信を有効化するにはtrue、無効化するにはfalseに設定します。

コストデータには、ユーザーのアトリビューション情報でアクセスできます。

1
let yourAppToken = "{YourAppToken}"
2
let environment = ADJEnvironmentSandbox as? String
3
let adjustConfig = ADJConfig(
4
   appToken: yourAppToken,
5
   environment: environment)
6
// ...
7
adjustConfig?.needsCost = true

1
NSString *yourAppToken = @"{YourAppToken}";
2
NSString *environment = ADJEnvironmentSandbox;
3
*adjustConfig = [ADJConfig configWithAppToken:yourAppToken
4
                                 environment:environment];
5
// ...
6
[adjustConfig setNeedsCost:YES];

1
setupWebViewJavascriptBridge(function (bridge) {
2
   var yourAppToken = yourAppToken;
3
   var environment = AdjustConfig.EnvironmentSandbox;
4
   var adjustConfig = new AdjustConfig(yourAppToken, environment);
5
   adjustConfig.setNeedsCost(true);
6
});

バックグランドでの計測機能を有効化する

@property (nonatomic, assign) BOOL sendInBackground;

デフォルトでは、アプリがバックグラウンドで動作している間、Adjust SDKはリクエストの送信を一時停止します。バックグランドでの計測機能を有効化することで、SDKがバックグランドでリクエストを送信するよう設定することが可能です。バックグラウンドでの計測機能を有効化するには、configインスタンスのsendInBackgroundプロパティに Boolean 値を割り当てます。

sendInBackground （BOOL）：バックグランドでの送信を有効化するにはtrue、無効化するにはfalseに設定します。

1
let yourAppToken = "{YourAppToken}"
2
let environment = ADJEnvironmentSandbox as? String
3
let adjustConfig = ADJConfig(
4
   appToken: yourAppToken,
5
   environment: environment)
6
// ...
7
adjustConfig?.sendInBackground = true

1
NSString *yourAppToken = @"{YourAppToken}";
2
NSString *environment = ADJEnvironmentSandbox;
3
*adjustConfig = [ADJConfig configWithAppToken:yourAppToken
4
                                 environment:environment];
5
// ...
6
[adjustConfig setSendInBackground:YES];

1
setupWebViewJavascriptBridge(function (bridge) {
2
   // ...
3
   var yourAppToken = yourAppToken;
4
   var environment = AdjustConfig.EnvironmentSandbox;
5
   var adjustConfig = new AdjustConfig(yourAppToken, environment);
6
   adjustConfig.setSendInBackground(true);
7
});

イベントのバッファリングを有効化する

@property (nonatomic, assign) BOOL eventBufferingEnabled;

Adjust SDKは、ユーザーがアプリ内でイベントをトリガーすると、すぐにイベント情報を送信します。イベントバッファリングを有効にすることで、イベント情報をスケジュールに沿って送信することができます。イベントバッファリングは、デバイス上のローカルバッファにイベントを保存し、1分間に1回、全てのリクエストを送信します。

ConfigオブジェクトにはブーリアンeventBufferingEnabledプロパティが含まれており、それが動作を制御します。イベントのバッファリングを有効化するには、configインスタンスのeventBufferingEnabledプロパティに Boolean 値を割り当てます。

eventBufferingEnabled （BOOL）：イベントのバッファリングを有効化するにはtrue、無効化するにはfalseに設定します。

1
let yourAppToken = "{YourAppToken}"
2
let environment = ADJEnvironmentSandbox as? String
3
let adjustConfig = ADJConfig(
4
   appToken: yourAppToken,
5
   environment: environment)
6
adjustConfig?.eventBufferingEnabled = true
7
Adjust.appDidLaunch(adjustConfig)

1
*adjustConfig = [ADJConfig configWithAppToken:@"{YourAppToken}"
2
                                 environment:ADJEnvironmentSandbox];
3
[adjustConfig setEventBufferingEnabled:YES];
4
[Adjust appDidLaunch:adjustConfig];

1
setupWebViewJavascriptBridge(function (bridge) {
2
   var yourAppToken = yourAppToken;
3
   var environment = AdjustConfig.EnvironmentSandbox;
4
   var adjustConfig = new AdjustConfig(yourAppToken, environment);
5
   adjustConfig.setEventBufferingEnabled(true);
6
});

SDKの起動を遅らせる

@property (nonatomic, assign) double delayStart;

デフォルトでは、Adjust SDKはアプリの起動直後に動作を開始します。起動時に取得できないデータをセッションパラメーターで送信したい場合は、SDKの動作開始を遅らせることができます。これは、ユニークな識別子などの情報を送信する場合に便利です。

動作開始の遅延を設定するには、configインスタンスのdelayStartプロパティにdouble値を割り当てます。

delayStart （double）：SDKの動作開始を遅らせる時間（秒）。SDKの動作開始を遅らせることができるのは最長 10秒間 です。

1
let yourAppToken = "{YourAppToken}"
2
let environment = ADJEnvironmentSandbox as? String
3
let adjustConfig = ADJConfig(
4
   appToken: yourAppToken,
5
   environment: environment)
6
adjustConfig?.delayStart = 5.5
7
// ...
8
Adjust.appDidLaunch(adjustConfig)

1
*adjustConfig = [ADJConfig configWithAppToken:@"{YourAppToken}"
2
                                 environment:ADJEnvironmentSandbox];
3
[adjustConfig setDelayStart:5.5];
4
/// ...
5
[Adjust appDidLaunch:adjustConfig];

1
setupWebViewJavascriptBridge(function (bridge) {
2
   var yourAppToken = yourAppToken;
3
   var environment = AdjustConfig.EnvironmentSandbox;
4
   var adjustConfig = new AdjustConfig(yourAppToken, environment);
5
   adjustConfig.setDelayStart(5.5);
6
});

動的設定

動的設定オプションは、SDKのライフサイクル中に、ユーザーによるイベントやアクションに応じて変更されることがあります。

オフラインモードに切り替える

+ (void)setOfflineMode:(BOOL)enabled;

Adjust SDKは、イベントとセッションのデータをAdjustのサーバーにリアルタイムで送信します。SDKをオフラインモードにすると、情報の送信を一時停止することができます。オフラインモードでは、SDKは全てのデータをデバイスのローカルファイルに保存します。オフラインモードを無効にすると、SDKはこの情報をAdjustのサーバーに送信します。

以下の引数を使用してsetOfflineModeメソッドを呼び出すことで、いつでもオフランモードに切り替えられます：

enabled （BOOL）：オフラインモードを有効化するにはtrueに、オフラインモードを無効化するにはfalseに設定します。

1
Adjust.setOfflineMode(true);

1
[Adjust setOfflineMode:YES];

1
Adjust.setOfflineMode(true);

Pushトークンを設定する

+ (void)setDeviceToken:(nonnull NSData *)deviceToken;

Pushトークンは、Audiences機能やクライアントコールバックに使用されます。また、アンインストール・再インストール計測にも必要です。

Configオブジェクトは、 pushトークンを保管できるdeviceTokenプロパティを含みます。このプロパティは、setDeviceTokenメソッドと以下の引数を呼び出すことで、いつでも更新することが可能です：

deviceToken （NSData）：Push トークン

1
func application(_ app: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
2
    Adjust.setDeviceToken(deviceToken)
3
}

1
- (void)application:(UIApplication *)app didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
2
    [Adjust setDeviceToken:deviceToken];
3
}

1
Adjust.setDeviceToken(deviceToken);

SDKを無効化または有効化する

+ (void)setEnabled:(BOOL)enabled;

Adjust SDKは、デフォルトでアプリが開いている時に実行されます。Adjust SDKを無効化または再有効化することで、計測を一時停止したり再起動したりすることができます。Adjust SDKを無効にすると、Adjustサーバーにデータが送信されなくなります。

以下の引数を使用してsetEnabledメソッドを呼び出すことで、SDKをいつでも有効化または無効化できます：

enabled （BOOL）：SDKを有効化するにはtrueに、SDKを無効化するにはfalseに設定します。

1
Adjust.setEnabled(true)

1
[Adjust setEnabled:NO];

1
Adjust.setEnabled(false);

有効化ステータスを確認する

+ (BOOL)isEnabled;

Adjust SDKが有効であるかどうかを確認するには、isEnabledメソッドを呼び出します。このメソッドは、SDKが有効（true）か無効（false）かを示すBOOL値を返します。

1
Adjust.isEnabled()

1
[Adjust isEnabled];

1
Adjust.isEnabled();