We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

開発者向け

ADJConfigクラス

ADJConfigクラスを使って、Adjust SDKで使用される設定を保存できます。

重要:

Adjust SDKを初期化する前に ADJConfig クラスを設定する必要があります。これは、SDKが実行時にこのクラスからプロパティをコピーするためです。

クラスのメソッド

ADJConfigクラスを使用してSDKを設定する

重要:

このメソッドを呼び出してSDKを設定してください。

SDKを設定するには、アプリに関する情報をConfigオブジェクトに渡す必要があります。アプリトークン、環境、ログレベルを指定する必要があります。

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

Objective-C

Swift

Javascript

NSString *yourAppToken = @"{YourAppToken}";
NSString *environment = ADJEnvironmentSandbox;
ADJConfig *adjustConfig = [ADJConfig configWithAppToken:yourAppToken environment:environment allowSuppressLogLevel:YES];

パラメーター

パラメーター	データタイプ	説明	必須
`configWithAppToken`	文字列	アプリのアプリトークン。管理画面で確認できる一意の識別子で、常に12文字でなければなりません。	はい
`environment`	文字列	アプリの現在の環境。Adjustはこの環境設定を使用して、実際のトラフィックとテストトラフィックの違いを区別します。この値の設定には常に注意が必要です。特に、収益をトラッキングする場合に重要です。	はい
`allowSuppressLogLevel`	ブーリアン	trueに設定されている場合、 `ADJLogLevelSuppress` を使用できるようになり、本番環境のデフォルト値を置き換えます。	いいえ

値

パラメーター	値	説明
`environment`	`AdjEnvironmentProduction`	本番環境で使用されているアプリを示します。データはライブデータとして扱われます。
`environment`	`AdjEnvironmentSandbox`	アプリがテストされていることを示します。管理画面ではライブデータとして表示されません。

返り値

インスタンスのメソッド

SKAdNetworkとの通信を防止する

デフォルトでは、Adjust SDKはAppleのSKAdNetworkと情報を共有します。この情報をAppleと共有する予定がない場合は、この動作を無効にすることができます。

- (void) deactivateSKAdNetworkHandling

Objective-C

Swift

[adjustConfig.deactivateSKAdNetworkHandling];

プロパティ

AdServices frameworkデータの読み取りを有効化/無効化する

AdServices.frameworkをアプリに追加した場合、Adjust SDKからAdServicesの情報にアクセスできるようになります。これを防止するには、allowAdServicesInfoReadingプロパティを切り替えます。

注意:

このプロパティは、デフォルトで true に設定されています。

- (BOOL) allowAdServicesInfoReading

Objective-C

Swift

[adjustConfig setAllowAdServicesInfoReading:NO];

iAd frameworkデータの読み取りを有効化/無効化する

デフォルトでは、Adjust SDKはiAdフレームワークから情報を読み込み、ASAトラッキングに使用します。無効にするには、allowiAdInfoReadingプロパティを切り替えます。

重要:

iAdフレームワークは、2023年2月7日にAppleによって廃止（sunset）されました。このプロパティは現在機能していません。

- (BOOL) allowiAdInfoReading

Objective-C

Swift

[adjustConfig setAllowiAdInfoReading:NO];

IDFAの読み取りを有効化/無効化する

Adjust SDKでは、デバイスから広告主ID（IDFA）を読み取ることでアトリビューションの精度を向上させます。これを防止するには、allowIdfaReadingプロパティを切り替えます。

注意:

このプロパティは、デフォルトで true に設定されています。

- (BOOL) allowIdfaReading

Objective-C

Swift

[adjustConfig allowIdfaReading:NO];

オーガニックインストールのデフォルトトラッカーを設定する

アプリのデフォルトトラッカーを設定できます。Adjust SDKでは、その他に読み取るトラッカー情報がない場合に、このトラッカーを使用します。

- (NSString *) defaultTracker

Objective-C

Swift

Javascript

[adjustConfig setDefaultTracker:@"{TrackerToken}"];

パラメーター

パラメーター	データタイプ	説明
`defaultTracker`	文字列	デフォルトとして設定するトラッカーのトラッカートークン。

SDKの起動を遅らせる

一部の情報は、アプリが起動するまで入手できない場合があります。データが利用可能になるまで待つ必要がある場合は、SDKの初回起動を遅らせることができます。起動を遅らせる秒数を指定することも可能です。

重要:

この遅延は、ユーザーが初めてアプリを開いた後のセッションにのみ適用されます。このセッションの後は、アプリの起動時に遅延なしでSDKが初期化されるようになります。

- (double) delayStart

Objective-C

Swift

Javascript

[adjustConfig setDelayStart:5.5];

パラメーター

パラメーター	データタイプ	説明
`delayStart`	数値（double）	実装する遅延（秒）。使用可能な最大値は10秒です。

アトリビューションの変更を記録するためのデリゲートを設定する

Adjust SDKでは、ユーザーアトリビューションの変更を通知できます。有効にするには、そのような変更を記録するデリゲートを登録します。この情報には、JSONオブジェクトとしてアクセスできます。

注意:

Adjustではアトリビューションに多数のソースを考慮するため、この情報はリアルタイムでは提供されません。

- (NSObject< AdjustDelegate > *) delegate

Objective-C

Swift

Javascript

[adjustConfig setDelegate:self];

パラメーター

パラメーター	データタイプ	説明
`delegate`	オブジェクト	デリゲートとして設定を登録するには `self` に設定する必要があります。

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

アプリで多くのイベントをトリガーする場合は、イベントのバッファリングを有効化することをお勧めします。イベントのバッファリングにより、イベントの送信をずらすことができます。有効にすると、Adjust SDKではリアルタイムではなく1分に1回イベントを送信します。Adjust SDKがイベントをAdjustバックエンドに送信するまで、バッファにイベントが保持されます。

- (BOOL) eventBufferingEnabled

Objective-C

Swift

Javascript

[adjustConfig setEventBufferingEnabled:YES];

ログレベルを変更する

Adjust SDKから受け取るログの取得レベルを変更するには、logLevelプロパティを変更します。一部のログレベルは、サンドボックス環境でアプリケーションを実行している場合にのみ利用できます。

- (ADJLogLevel) logLevel

Objective-C

Swift

Javascript

[adjustConfig setLogLevel:ADJLogLevelVerbose];

パラメーター

パラメーター	データタイプ	説明
`logLevel`	`ADJLogLevel` enum	返したいログのレベル

値

値	説明	ご利用の条件
`ADJLogLevelVerbose`	ログをフルで有効化します。	sandbox
`ADJLogLevelDebug`	デバッグ問題のためのより詳細なログを有効化します。	sandbox
`ADJLogLevelInfo`	情報、警告、エラー、アサートログを返します。	sandbox
`ADJLogLevelWarn`	警告、エラー、アサートログを返します。	sandbox
`ADJLogLevelError`	エラーとアサートログのみを返します。	sandbox
`ADJLogLevelAssert`	アサートログのみを返します。	sandbox
`ADJLogLevelSuppress`	全てのログを無効化します。	sandbox production

アトリビューション時にコストデータの送信を要求する

Adjust SDKでは、アトリビューションの一部としてコストデータを送信する必要があるかどうかを指定できます。

- (BOOL) needsCost

Objective-C

Swift

[adjustConfig setNeedsCost:YES];

バックグラウンドでのデータ送信を有効化する

デフォルトでは、アプリがフォアグラウンドで開かれているときに限り、Adjust SDKはイベント情報を送信します。アプリがバックグラウンドで動作しているときに、SDKからイベントを送信できます。

- (BOOL) sendInBackground

Objective-C

Swift

Javascript

[adjustConfig setSendInBackground:YES];

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

カスタムデバイスIDを追加して、BIシステムでデバイスとユーザーを計測できます。この外部デバイスIDには、任意の値を設定できます。

IDが取得されるまで、SDK初期化を遅延する必要がある場合があります。

注意:

externalDeviceId は、広告IDなど他の識別子よりも優先順位が低いため、新しいデバイスでのみ使用できます。既存のデバイスは、引き続き上位の識別子でアトリビュートされます。

- (NSString *) externalDeviceId

Objective-C

Swift

Javascript

[adjustConfig setExternalDeviceId:@"yourExternalDeviceId"];

URL戦略を設定する

Adjust SDKでは、URL戦略設定を使用して地域のエンドポイントに優先順位付けができます。この設定は、データレジデンシー機能を利用している場合に使用できます。

- (NSString *) urlStrategy

Objective-C

Swift

Javascript

[adjustConfig setUrlStrategy:ADJDataResidencyEU];

値

値	説明
`ADJDataResidencyEU`	データレジデンシーのエリアをEUに設定します。
`ADJDataResidencyTR`	データレジデンシーのエリアをTurkeyに設定します。
`ADJDataResidencyUS`	データレジデンシーのエリアをUSAに設定します。
`ADJUrlStrategyChina`	URL strageryを `app.adjust.world` ドメインに設定します。
`ADJUrlStrategyCn`	URL strageryを `app.adjust.cn` ドメインに設定します。
`ADJUrlStrategyCnOnly`	URL strategyを `app.adjust.cn` ドメインに設定しますが、リクエストが失敗した場合、別のドメインにフォールバックすることはありません。
`ADJUrlStrategyIndia`	URL strageryを `app.adjust.net.in` ドメインに設定します。