プライバシー機能の設定

Adjust SDKには、アプリ内でのユーザープライバシーの処理に使用できる機能が含まれています。

消去リクエストを送信する

gdprForgetMe(): void

EUの一般データ保護規則（GDPR）および類似する世界的なプライバシー法（CCPA、LGPDなど）は、個人データの処理に関する包括的な権利をデータ主体に付与しています。これらの権利には、消去権（GDPR第17条を参照）（1）が含まれます。データ処理者として、Adjustは、（アプリ）ユーザー（データ管理者）からのそのようなリクエストの処理をサポートする義務があります。

gdprForgetMeメソッドを呼び出すことで、ユーザーの消去リクエストをAdjustに送信することができます。Adjustが通知を受けると、以下の対応をします。

• Adjustはその内部システムおよびデータベースから、履歴として保管されているユーザーの全ての個人データを完全に削除します。
• Adjustは、Adjust SDKを介して、このユーザー/デバイスからデータを受信しなくなります。（2）

1
Adjust.gdprForgetMe();

特定のユーザーの情報をサードパーティと共有する

Adjust SDKを使用して、ユーザーがサードパーティとの共有設定を変更した時にそれを記録することができます。サードパーティの共有設定は、AdjustThirdPartySharingクラスを使用して構成されます。

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

constructor(isEnabled: boolean | null)

Adjust SDKでサードパーティ共有を有効化または無効化するには、AdjustThirdPartySharingオブジェクトをインスタンス化する必要があります。このオブジェクトには、Adjustでサードパーティ共有をどのように扱うかをコントロールする変数が含まれています。

サードパーティ共有オブジェクトをインスタンス化するには、新しいAdjustThirdPartySharingインスタンスを作成して以下のパラメーターをパスしてください：

• isEnabled (boolean または null)：サードパーティとの共有が有効かどうかを指定します。サードパーティとの共有を有効にするには true を、無効にするには false をパスします。現在の isEnabled トグルの状態に基づいてパートナー共有設定を調整したい場合は、null をパスしてください。

1
var adjustThirdPartySharing = new AdjustThirdPartySharing(true);
2

3
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

AdjustThirdPartySharingオブジェクトをインスタンス化したら、AdjustThirdPartySharingインスタンスを引数としてAdjust.trackThirdPartySharingメソッドを呼び出すことで、Adjustに情報を送信することができます。

1
var adjustThirdPartySharing = new AdjustThirdPartySharing(false);
2

3
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

粒度の高い情報を送信する

addGranularOption(partnerName: string, key: string, value: string): void

ユーザーがサードパーティとの共有設定を変更する時に、詳細な情報を添付できます。この情報を使用して、ユーザーの選択に関するよりきめ細かい情報を伝えられます。これを行うには、以下のパラメーターを使用してaddGranularOptionメソッドを呼び出します：

• partnerName （string）：granular optionが適用されるパートナーの名前
• key （string）：オプションのキー
• value （string）：オプションの値

1
var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
2

3
adjustThirdPartySharing.addGranularOption("PartnerA", "key", "value");
4

5
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

Facebookのデータ使用制限に対応する

Facebookは、カリフォルニア州消費者プライバシー法（CCPA）に準拠するために、データ使用制限（LDU）と呼ばれる機能を提供しています。この機能を使うと、カリフォルニア州のユーザーがデータ販売をオプトアウトしたときに、Facebookに通知できます。デフォルトで全てのユーザーをオプトアウトしたい場合も、この機能を使用できます。

Facebook LDUのステータスは、addGranularOptionメソッドに引数を渡すことで更新できます。

var adjustThirdPartySharing = new AdjustThirdPartySharing(null);

adjustThirdPartySharing.addGranularOption(
   "facebook",
   "data_processing_options_country",
   "1",
);
adjustThirdPartySharing.addGranularOption(
   "facebook",
   "data_processing_options_state",
   "1000",
);

Adjust.trackThirdPartySharing(adjustThirdPartySharing);

Googleに同意データを提供する（デジタル市情法へのコンプライアンス）

EUのデジタル市場法（DMA）に準拠するため、Google 広告およびGoogle マーケティング プラットフォームは、AdjustからAPIへのアトリビューションリクエストを受信することに明示的な同意を必要とします。 この同意を通知するには、パートナーgoogle_dmaのAdjustサードパーティ共有オブジェクトに、以下の詳細オプションを追加してください。

1
var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
2
adjustThirdPartySharing.addGranularOption("google_dma", "eea", "1");
3
adjustThirdPartySharing.addGranularOption(
4
   "google_dma",
5
   "ad_personalization",
6
   "1",
7
);
8
adjustThirdPartySharing.addGranularOption("google_dma", "ad_user_data", "1");
9
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

Amazon広告に同意データを提供する（デジタル市場法へのコンプライアンス）

EUのデジタル市場法（DMA）に準拠するため、Amazon広告は、AdjustからAPIへのアトリビューションリクエストを受信することに明示的な同意を必要とします。この同意を通知するには、パートナーamazon_dmaのサードパーティ共有インスタンスに、以下の詳細なオプションを追加してください。

1
var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
2
adjustThirdPartySharing.addGranularOption("amazon_dma", "ad_user_data", "1");
3
adjustThirdPartySharing.addGranularOption("amazon_dma", "ad_storage", "1");
4
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

パートナー共有設定を更新する

addPartnerSharingSetting(partnerName: string, key: string, value: boolean): void

デフォルトでは、Adjustは全ての指標をアプリ設定で設定したパートナーと共有します。Adjust SDKを使用して、パートナーごとにサードパーティーとの共有設定を更新することができます。これを行うには、次の引数を使用してaddPartnerSharingSettingメソッドを呼び出します：

partnerName引数を使用して、メトリック共有設定を無効化または再有効化するパートナースコープを選択します。

• SANパートナー、モジュールパートナー、ダイナミックコールバックを含む全てのパートナーの共有を更新するには、allを渡します。
• 特定のパートナーの共有設定を更新するには、パートナーIDを渡します。 パートナーIDはSANパートナーおよび非SANパートナーでサポートされており、設定が推奨されます。
• ダイナミックコールバックの共有を更新するには、dynamic_callbacksを渡します。

keyを使用すると、無効化または再有効化する指標を指定できます。全ての指標の共有を有効化/無効化するには、 allキーを使用します。利用可能な指標のリストは以下をご覧ください。

指標グループ

パートナーの指標に対してfalse値を設定すると、Adjustはパートナーに対し、その指標と、そのグループ内の全ての子指標の共有を停止します。これらのネストされたグループは以下の通り

• セッション

  • インストール

    • rejected_installs

  • 再インストール

  • リアトリビューション

  • rejected_reattribution

  • reattribution_reinstall

• sessionの共有を無効化すると、その全ての子指標も無効になります。

• sessionの共有を無効化し、reattributionを有効化すると、reattributionを除く全ての子指標が無効になります。

• sessionの共有を無効化し、installを有効化すると、installを除くsessionの全ての子指標が無効になります。installの子指標は有効なままです。

• sessionの共有を有効化し、installを無効化すると、installを除くsessionの全ての子指標が無効になります。installの子指標は無効なままです。

例

特定のパートナーとの全ての指標の共有を停止する場合は、 false値を含むallキーをパスします。

1
var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
2
adjustThirdPartySharing.addPartnerSharingSetting("partner_id", "all", false);
3
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

特定のパートナーとの共有を再度有効化するには、true値を含むallキーを渡します。

1
var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
2
adjustThirdPartySharing.addPartnerSharingSetting("partner_id", "all", true);
3
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

データをpartner_idのみと共有したい場合：

• all false値を含むallパートナーのキーを渡して、全てのパートナーのあらゆる情報の共有を無効化します。
• all true値を含むpartner_idのキーを渡して、そのパートナーのあらゆる情報の共有を明示的に有効化します。

1
var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
2
adjustThirdPartySharing.addPartnerSharingSetting("all", "all", false);
3
adjustThirdPartySharing.addPartnerSharingSetting("partner_id", "all", true);
4
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

sessionデータのみをallパートナーと共有したい場合：

• all false値を含むallパートナーのキーを渡して、全てのパートナーのあらゆる情報の共有を無効化します。
• session true値を含むallパートナーのキーを渡して、sessionデータとallパートナーの関連する「子」指標の共有を有効化します。

1
var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
2
adjustThirdPartySharing.addPartnerSharingSetting("all", "all", false);
3
adjustThirdPartySharing.addPartnerSharingSetting("all", "session", true);
4
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

sessionデータのみをpartner_idと共有したい場合：

• all false値を含むallパートナーのキーを渡して、全てのパートナーのあらゆる情報の共有を無効化します。
• session true値を含むpartner_idのキーを渡して、そのパートナーのsessionデータおよび関連するすべての「子」メトリックの共有を有効化します。

1
var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
2
adjustThirdPartySharing.addPartnerSharingSetting("all", "all", false);
3
adjustThirdPartySharing.addPartnerSharingSetting("partner_id", "session", true);
4
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

dynamic_callbacksを無効化したい場合は、false値を持つallキーを渡します。

1
var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
2
adjustThirdPartySharing.addPartnerSharingSetting(
3
   "dynamic_callbacks",
4
   "all",
5
   false,
6
);
7
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

異なるキーでaddPartnerSharingSettingメソッドを複数回呼び出すことで、特定の指標の共有を停止または開始できます。例えば、イベント情報のみをパートナーと共有したい場合は、以下をパスすることができます。

• all にfalse値を指定して、全ての情報の共有を無効化する。
• event にtrue値を指定して、イベントの共有を有効化する。

1
var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
2
adjustThirdPartySharing.addPartnerSharingSetting("partner_id", "all", false);
3
adjustThirdPartySharing.addPartnerSharingSetting("partner_id", "event", true);
4
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

現在のサードパーティ共有設定を取得

サードパーティ共有の設定をAdjustに送信すると、レスポンスにはAdjustのバックエンドからの現在の全体設定が含まれます。この情報には、ゲッターメソッドを呼び出すか、変更コールバックを設定することでアクセスできます。

タイムアウトのあるサードパーティ共有設定のゲッターメソッド

getThirdPartySharingSettingsWithTimeout(timeoutInMilliseconds: number, callback: (thirdPartySharingSettingsJson: string | null) => void): void

Adjust.getThirdPartySharingSettingsWithTimeoutを呼び出し、タイムアウト（ミリ秒単位）とコールバック機能を指定して、タイムアウト付きで現在のサードパーティ共有設定をリクエストできます。SDKで設定が利用可能であるか、指定されたタイムアウト内に受け取った場合、サードパーティ共有設定を含むJSON文字列をコールバックに渡します。そうでなければ、nullを渡します。

1
Adjust.getThirdPartySharingSettingsWithTimeout(
2
   timeoutInMilliseconds,
3
   function (thirdPartySharingSettingsJson) {
4
      // read thirdPartySharingSettingsJson
5
   },
6
);

サードパーティ共有設定が変更された時に機能をトリガー

setThirdPartySharingSettingsChangedCallback(callback: (thirdPartySharingSettings: AdjustThirdPartySharingSettings) => void): void

SDKは、サードパーティの共有設定の更新を監視し、バックエンドから変更された設定を受け取ったときに機能を呼び出すことができます。受信した設定がキャッシュされた最新の設定と異なる場合にコールバックがトリガーされます。

これを設定するには、SDKを初期化する前にAdjustConfigインスタンスでコールバック機能を設定してください。

1
var adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5

6
adjustConfig.setThirdPartySharingSettingsChangedCallback(
7
   function (thirdPartySharingSettings) {
8
      // read thirdPartySharingSettings.thirdPartySharingSettingsJson
9
   },
10
);
11

12
Adjust.initSdk(adjustConfig);

データレジデンシー

setUrlStrategy(urlStrategyDomains: string[], useSubdomains: boolean, isDataResidency: boolean): void

URL戦略機能では、以下のいずれかを設定することができます：

• Adjustがお客様のデータを保管する国（データレジデンシー）。
• Adjust SDKがトラフィックを送信するエンドポイント（URL戦略）。

これは、プライバシー要件が厳しい国で事業を展開している場合に便利です。URL戦略を設定すると、Adjustは選択したデータレジデンシー地域にデータを保管したり、選択したドメインにトラフィックを送信したりします。

データレジデンシーの国を設定するには、次のパラメーターのいずれかを指定してAdjustConfigインスタンスからsetUrlStrategyメソッドを呼び出します：

• urlStrategyDomains （string[] ）：SDKのトラフィック送信先となるエンドポイントの配列。
• useSubdomains （boolean）：ドメインをAdjustドメインとして扱うかどうか。trueの場合、SDKはAdjust固有のサブドメインをドメインにプレフィックスとします。falseの場合、SDKはプレフィックスを追加せずに、指定されたドメインをそのまま使用します。
• isDataResidency （boolean）：ドメインをデータレジデンシーに使用するかどうか。

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);
adjustConfig.setUrlStrategy(["eu.adjust.com"], true, true);
Adjust.initSdk(adjustConfig);

特定のユーザーの同意を計測する

trackMeasurementConsent(measurementConsent: boolean): void

Adjustダッシュボードでデータプライバシー設定を使用している場合、Adjust SDKを動作させるための設定を行う必要があります。これには、同意有効期間やユーザーデータ保持期間などの設定が含まれます。

この機能を切り替えるには、次の引数を使用してtrackMeasurementConsentメソッドを呼び出します：

• consentMeasurement （boolean）：同意計測が有効化されている（true）か無効化されている（false）か。

有効化されている場合、SDKはデータプライバシー設定をAdjustサーバーに通信します。Adjustサーバーは、お客様のデータプライバシーのルールをユーザーに適用させます。Adjust SDKは引き続き通常通り動作します。

1
Adjust.trackMeasurementConsent(true);

児童オンラインプライバシー保護法（COPPA）コンプライアンス

enableCoppaCompliance(): void

アプリが児童オンラインプライバシー保護法（COPPA）に準拠する必要がある場合は、enableCoppaComplianceメソッドを呼び出します。このメソッドは、以下の動作を実行します。

1. ユーザーが最初のsessionを行う 前に サードパーティとのデータ情報共有を無効にする。
2. SDKがデバイスIDと広告ID（例：gps_adid、android_id）を読み取るのを防ぐ。

1
const adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5

6
adjustConfig.enableCoppaCompliance();
7
Adjust.initSdk(adjustConfig);

Playストアの子供向けアプリ（Androidのみ）

enablePlayStoreKidsCompliance(): void

アプリが13歳未満のユーザーをターゲットとしており、インストールの地域が米国 ではない 場合は、子供向けアプリとして登録してください。これにより、SDKがデバイスIDと広告ID（例：gps_adid、android_id）を読み取るのを防ぐことができます。

アプリを子供向けアプリとして表示するには、enablePlayStoreKidsComplianceメソッドを呼び出します。

1
const adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5

6
adjustConfig.enablePlayStoreKidsCompliance();
7

8
Adjust.initSdk(adjustConfig);

デバイスIDの読み取りを無効化する

SDKは、さまざまなデバイスIDの読み取りとトラッキングを制限する複数のメソッドを提供します。これらのメソッドを使用して、プライバシー規制に準拠できます。

アプリセットIDの読み取りを無効化する

disableAppSetIdReading(): void

デフォルトでは、Adjust SDKはGoogle Play 開発者サービスAPI が利用可能な場合に、アプリセットID（App Set ID）を読み取ります。SDKの設定でこれを無効にすることも可能です。アプリセットIDの読み取りを無効にするには、AdjustConfigインスタンスでdisableAppSetIdReadingメソッドを呼び出してください。

1
var adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5
adjustConfig.disableAppSetIdReading();
6
Adjust.initSdk(adjustConfig);

Google広告IDの読み取りを無効化する

disableGoogleAdIdReading(): void

デフォルトでは、Adjust SDKはGoogle Play 開発者サービスAPIが利用可能な場合に、Google広告IDを読み取ります。SDKを設定して、Google広告IDの読み取りを無効にすることができます。Google広告IDの読み取りを無効にするには、AdjustConfigインスタンスでdisableGoogleAdIdReadingメソッドを呼び出します。

1
var adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5
adjustConfig.disableGoogleAdIdReading();
6
Adjust.initSdk(adjustConfig);

Android IDの読み取りを無効化する

disableAndroidIdReading(): void

デフォルトでは、Adjust SDKは必要に応じてAndroid IDを読み取ります。SDKを設定して、Android IDの読み取りを無効にすることができます。Android IDの読み取りを無効にするには、AdjustConfigインスタンスでdisableAndroidIdReadingメソッドを呼び出してください。

1
var adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5
adjustConfig.disableAndroidIdReading();
6
Adjust.initSdk(adjustConfig);

Facebook IDの読み取りを無効化する

disableFbIdReading(): void

デフォルトでは、Adjust SDKは利用可能な場合にFacebook IDを読み取ります。SDKを設定して、Facebook IDの読み取りを無効にできます。Facebook IDの読み取りを無効にするには、AdjustConfigインスタンスでdisableFbIdReadingメソッドを呼び出してください。

1
var adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5
adjustConfig.disableFbIdReading();
6
Adjust.initSdk(adjustConfig);

Fire広告IDの読み取りを無効にする

disableFireAdIdReading(): void

デフォルトでは、Adjust SDKは利用可能な場合にFire広告IDを読み取ります。SDKを設定して、Fire広告IDの読み取りを無効にできます。Fire広告IDの読み取りを無効にするには、AdjustConfigインスタンスでdisableFireAdIdReadingメソッドを呼び出してください。

1
var adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5
adjustConfig.disableFireAdIdReading();
6
Adjust.initSdk(adjustConfig);

プラグインからのデバイスIDの読み取りを無効化する

disableDeviceIdsFromPluginsReading(): void

デフォルトでは、Adjust SDKは利用可能な場合に、プラグインを使用してデバイスIDを読み取ります。プラグインからのデバイスIDの読み取りを無効にするようにSDKを設定できます。プラグインからのデバイスIDの読み取りを無効にするには、AdjustConfigインスタンスでdisableDeviceIdsFromPluginsReadingメソッドを呼び出してください。

1
var adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5
adjustConfig.disableDeviceIdsFromPluginsReading();
6
Adjust.initSdk(adjustConfig);

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

disableIdfaReading(): void

AdjustConfigインスタンスでdisableIdfaReadingメソッドを呼び出すことで、Adjust SDKがデバイスのIDFAを読み取らないようにできます。このメソッドを呼び出すと、Adjust SDKはデバイスのIDFAを読み取ってAdjustに送信することができなくなります。

1
var adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5
adjustConfig.disableIdfaReading();
6
Adjust.initSdk(adjustConfig);

IDFVの読み取りを無効化する

disableIdfvReading(): void

AdjustConfigインスタンスでdisableIdfvReadingメソッドを呼び出すことで、Adjust SDKがデバイスのIDFVを読み取らないようにできます。このメソッドを呼び出すと、Adjust SDKはデバイスのIDFVを読み取ってAdjustに送信することができなくなります。

1
var adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5
adjustConfig.disableIdfvReading();
6
Adjust.initSdk(adjustConfig);

全てのデバイスIDの読み取りを無効化する

disableDeviceIdsReading(): void

また、全てのデバイスIDの読み取りを一度に無効にするようにSDKを設定することもできます。全てのデバイスIDの読み取りを無効にするには、AdjustConfigインスタンスでdisableDeviceIdsReadingメソッドを呼び出してください。

これにより、iOSとAndroidの両方ですべてのデバイスIDの読み取りが無効化されます。

1
var adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5
adjustConfig.disableDeviceIdsReading();
6
Adjust.initSdk(adjustConfig);