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
に設定します。
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, false);// ...Adjust.InitSdk(adjustConfig);
読み取り専用の設定
読み取り専用 の設定オプションは、SDKの初期化 前に AdjustConfig
インスタンスで設定されます。これらのオプションは、SDKの実行中は変更できません。Adjust.InitSdk
を実行する前に、使用したいオプションを設定する必要があります。
ログレベルを設定する
public AdjustLogLevel? LogLevel { get; set; }
Adjust SDKは、さまざまな量の情報を返すために、設定可能なログレベルを提供しています。以下のログレベルが利用可能です。
logLevel | 説明 |
---|---|
AdjustLogLevel.Verbose | ログを全て有効化する |
AdjustLogLevel.Debug | デバッグのログを有効化する |
AdjustLogLevel.Info | 情報レベルのログのみを表示する(デフォルトオプション) |
AdjustLogLevel.Warn | 情報ログを無効化する |
AdjustLogLevel.Error | 警告レベル以下のログを無効化する |
AdjustLogLevel.Assert | エラーレベル以下のログを無効化する |
AdjustLogLevel.Suppress | ログを全て無効化する |
ConfigインスタンスのAdjustConfig
プロパティにLogLevel
値を割り当てることで、ログレベルを設定できます。
AdjustConfig config = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);//...config.LogLevel = AdjustLogLevel.Error;//...Adjust.InitSdk(config);
外部デバイスIDを設定する
public string ExternalDeviceId { get; set; }
外部デバイスIDは、デバイスまたはユーザーに割り当てることができるカスタム値です。セッションやプラットフォームを横断してユーザーを認識することができます。また、ユーザーが新規インストールとして2度カウントされないように、ユーザーごとにインストールの重複を排除することも可能です。外部デバイスIDの使用を開始する際は、Adjustの担当者にお問い合わせください。
外部デバイスIDを、デバイスのカスタム識別子として使用することができます。これは、他のシステム上で継続性を保ちたい場合に役立ちます。外部デバイスIDは、AdjustConfig
インスタンスのExternalDeviceId
プロパティに割り当てることで設定できます。
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);//...adjustConfig.ExternalDeviceId = "{Your-External-Device-Id}";//...Adjust.InitSdk(adjustConfig);
外部デバイスIDをビジネスアナリティクスに使用する場合は、IDをセッションコールバックパラメーターとしてパスすることができます。
既存の外部デバイスIDをAdjustにインポートすることが可能です。これにより、Adjustサーバーが今後のデータを既存のデバイス記録と一致させることができます。この設定をご希望の場合は、Adjustの担当者にお問い合わせください。
デフォルトのリンクトークンを設定する
public string DefaultTracker { get; set; }
アプリがデバイスにプリインストールされている場合、デフォルトのリンクトークンを設定することができます。ユーザーがプリインストールされたアプリを初めて起動すると、インストールはデフォルトのリンクトークンにアトリビュートされます。デフォルトのリンクトークンを設定するには、それを AdjustConfig
インスタンスの DefaultTracker
プロパティに割り当てることで設定できます。
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);//...adjustConfig.DefaultTracker = "{TrackerToken}";//...Adjust.InitSdk(adjustConfig);
アトリビューションで広告費用データを受信
public bool? IsCostDataInAttributionEnabled { get; set; }
デフォルトでは、Adjust SDKはユーザーのアトリビューションとしてコストデータを送信しません。AdjustConfig
インスタンスのIsCostDataInAttributionEnabled
プロパティをtrue
に設定することで、この情報をリクエストするようにSDKを設定できます。
コストデータには、ユーザーのアトリビューション情報でアクセスできます。
AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);adjustConfig.LogLevel = AdjustLogLevel.Verbose;adjustConfig.IsCostDataInAttributionEnabled = true;
Adjust.InitSdk(adjustConfig);
バックグランドでの計測機能を有効化する
public bool? IsSendingInBackgroundEnabled { get; set; }
デフォルトでは、アプリがバックグラウンドで動作している間、Adjust SDKはリクエストの送信を一時停止します。AdjustConfig
インスタンスのIsSendingInBackgroundEnabled
プロパティをtrue
に設定することで、アプリがバックグラウンドで実行されている間にSDKが情報を送信するように設定することができます。
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);//...adjustConfig.IsSendingInBackgroundEnabled = true;//...Adjust.InitSdk(adjustConfig);
動的設定
動的 設定オプションは、SDKのライフサイクル中に、ユーザーによるイベントやアクションに応じて変更されることがあります。
オフラインモードを有効化する
public static void SwitchToOfflineMode();
Adjust SDKは、イベントとセッションのデータをAdjustのサーバーにリアルタイムで送信します。SDKをオフラインモードにすると、情報の送信を一時停止することができます。オフラインモードでは、SDKは全てのデータをデバイスのローカルファイルに保存します。オフラインモードを無効にすると、SDKはこの情報をAdjustのサーバーに送信します。
オフラインモードを有効化するには、 Adjust.SwitchToOfflineMode
メソッドを呼び出します。
Adjust.SwitchToOfflineMode();
オフラインモードを無効化する
public static void SwitchBackToOnlineMode();
Adjust.SwitchBackToOnlineMode
メソッドを呼び出して、SDKを再度有効化することができます。これにより、SDKは情報の送信を再開します。
Adjust.SwitchBackToOnlineMode();
Pushトークンを設定する
public static void SetPushToken(string pushToken)
Pushトークンは、Audiences機能やクライアントコールバックに使用されます。また、アンインストール・再インストール計測にも必要です。
このPushトークンは、Adjust.SetPushToken
メソッドと以下の引数を呼び出すことで、いつでも更新することが可能です:
pushToken
(string
):Push トークン
Adjust.SetPushToken("{YourPushToken}");
Adjust SDKを無効化する
public static void Disable()
Adjust SDKは、デフォルトでアプリが開いている時に実行されます。Adjust.Disable
メソッドを呼び出すと、Adjust SDKを無効にしてAdjustへの情報送信を停止できます。Adjust SDKを無効にするとデータはAdjustに送信されず、SDKは情報を記録しません。つまり、SDKが無効になっているときに呼ばれたAdjustメソッドは、何も記録しません。
Adjust.Disable();
SDKを有効化する
public static void Enable()
無効にしたSDKを再度有効にしたい場合は、Adjust.Enable
メソッドを呼び出してください。SDKが有効になると、Adjustのサーバーに情報が送信されます。
Adjust.Enable();
有効化ステータスを確認する
public static void IsEnabled(Action<bool> callback)
Adjust SDKが有効であるかどうかを確認するには、 Adjust.IsEnabled
メソッドを呼び出し、コールバック関数をパスしてください。ステータスは非同期で返され、 boolean
値としてコールバック関数にパスされます。
Adjust.IsEnabled(isEnabled =>{ // Your callback function});