設定

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

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

public AdjustConfig(string appToken, AdjustEnvironment environment, bool allowSuppressLogLevel)

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

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

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

1
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, false);
2
// ...
3
Adjust.InitSdk(adjustConfig);

読み取り専用の設定

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

ログレベルを設定する

public AdjustLogLevel? LogLevel { get; set; }

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

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

1
AdjustConfig config = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
2
//...
3
config.LogLevel = AdjustLogLevel.Error;
4
//...
5
Adjust.InitSdk(config);

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

public string ExternalDeviceId { get; set; }

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

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

1
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
2
//...
3
adjustConfig.ExternalDeviceId = "{Your-External-Device-Id}";
4
//...
5
Adjust.InitSdk(adjustConfig);

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

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

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

public string DefaultTracker { get; set; }

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

1
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);
2
//...
3
adjustConfig.DefaultTracker = "{TrackerToken}";
4
//...
5
Adjust.InitSdk(adjustConfig);

アトリビューションで広告費用データを受信する

public bool? IsCostDataInAttributionEnabled { get; set; }

デフォルトでは、Adjust SDKはユーザーのアトリビューションとしてコストデータを送信しません。AdjustConfigインスタンスのIsCostDataInAttributionEnabledプロパティをtrueに設定することで、この情報をリクエストするようにSDKを設定できます。

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

1
AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
2
adjustConfig.LogLevel = AdjustLogLevel.Verbose;
3
adjustConfig.IsCostDataInAttributionEnabled = true;
4

5
Adjust.InitSdk(adjustConfig);

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

public bool? IsSendingInBackgroundEnabled { get; set; }

デフォルトでは、アプリがバックグラウンドで動作している間、Adjust SDKはリクエストの送信を一時停止します。AdjustConfigインスタンスのIsSendingInBackgroundEnabledプロパティをtrueに設定することで、アプリがバックグラウンドで実行されている間にSDKが情報を送信するように設定することができます。

1
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);
2
//...
3
adjustConfig.IsSendingInBackgroundEnabled = true;
4
//...
5
Adjust.InitSdk(adjustConfig);

動的設定

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

オフラインモードを有効化する

public static void SwitchToOfflineMode();

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

オフラインモードを有効化するには、 Adjust.SwitchToOfflineModeメソッドを呼び出します。

1
Adjust.SwitchToOfflineMode();

オフラインモードを無効化する

public static void SwitchBackToOnlineMode();

Adjust.SwitchBackToOnlineModeメソッドを呼び出して、SDKを再度有効化することができます。これにより、SDKは情報の送信を再開します。

1
Adjust.SwitchBackToOnlineMode();

Pushトークンを設定する

public static void SetPushToken(string pushToken)

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

このPushトークンは、Adjust.SetPushTokenメソッドと以下の引数を呼び出すことで、いつでも更新することが可能です：

• pushToken （string）：Push トークン

1
Adjust.SetPushToken("{YourPushToken}");

SDKを無効化する

public static void Disable()

Adjust SDKは、デフォルトでアプリが開いている時に実行されます。Adjust.Disableメソッドを呼び出すと、Adjust SDKを無効にしてAdjustへの情報送信を停止できます。Adjust SDKを無効にするとデータはAdjustに送信されず、SDKは情報を記録しません。つまり、SDKが無効になっているときに呼ばれたAdjustメソッドは、何も記録しません。

1
Adjust.Disable();

SDKを有効化する

public static void Enable()

無効にしたSDKを再度有効にしたい場合は、Adjust.Enableメソッドを呼び出してください。SDKが有効になると、Adjustのサーバーに情報が送信されます。

1
Adjust.Enable();

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

public static void IsEnabled(Action<bool> callback)

Adjust SDKが有効であるかどうかを確認するには、 Adjust.IsEnabledメソッドを呼び出し、コールバック関数をパスしてください。ステータスは非同期で返され、 boolean値としてコールバック関数にパスされます。

1
Adjust.IsEnabled(isEnabled =>
2
{
3
   // Your callback function
4
});