デバイスAPIを使ってデバイス情報を確認し、テスト用にAdjustからデバイス履歴を消去します。
要件
デバイスデータの削除は、 やり直すことができない 設定です。Forget deviceエンドポイントを使用するには、アカウントに以下の いずれか のアクセス権限が付与されていることが必要です。
- 管理者 。
- 編集者 。
- 対象とするアプリにアクセスできる カスタム編集者 。
認証
デバイスAPIは認証にベアラートークンを使用します。デバイスAPIにリクエストを行う度に、Adjust APIトークンをAuthorization
ヘッダーに含める必要があります。
自社でシングルサインオン(SSO)を有効にしている場合は、 Adjustの担当者またはsupport@adjust.comにお問い合わせください。APIトークンの取得方法についてサポートいたします。
SSO以外のアカウントの場合、APIガイドはユーザーの プロフィール に表示されます。トークンを確認するには、以下の手順に従ってください。
- アカウント(ユーザー)アイコンを選択します。
- アカウント設定(Account Settings) を選択します。
- マイプロフィール(My Profile) を選択します。
- APIトークン が ユーザー情報(User details) に表示されます。コピーボタンを選択して、トークンをクリップボードにコピーします。
Adjust APIトークンをリセットする
Adjust APIトークンはいつでもリセットできます。トークンをリセットすると、古いトークンは無効になります。Adjust APIトークンをリセットした場合、使用中の古いトークンを新しいトークンに置き換える必要があります。無効になったトークンを使用したリクエストは、Adjustによって拒否されます。
Adjust APIトークンをリセットする方法:
- アカウント(ユーザー)アイコンを選択します。
- アカウント設定(Account Settings) を選択します。
- マイプロフィール(My Profile) を選択します。
- APIトークン が ユーザー情報(User details) に表示されます。
- APIトークンをリセットする(Reset API token) を選択します。
- 表示されたモーダルにアカウントのパスワードを入力し、 リセット(Reset) を選択してAPIトークンをリセットします。画面の右上に確認メッセージが表示されます。
- APIトークン の横にあるコピーボタンを選択して、トークンをクリップボードにコピーします。
デバイスの検査
GET https://api.adjust.com/device_service/api/v2/inspect_device
GET https://api.adjust.com/device_service/api/v1/inspect_device
Inspect deviceエンドポイントを使用して、アプリに関連するデバイスとリンク情報を取得します。
パラメーター
以下のパラメーターを クエリパラメーター として追加する必要があります。
app_token
(String
)-
アプリを識別する英数字のトークン。12文字で設定してください。
advertising_id
(String
)-
デバイスに関連付けられた一意の広告ID。
以下の広告IDが利用可能です:
idfa
: 広告ID。iOSデバイスでのみ利用可能です。gps_adid
: Google広告ID。GooglePlayストアを使用するAndroidデバイスでのみ利用可能です。android_id
: AndroidデバイスID。Androidデバイスでのみ利用可能です。fire_adid
: Amazon Fire広告ID。Amazon Fireストアを使用しているAndroidデバイスでのみ利用可能です。win_adid
: Windowsの広告ID。Windowsデバイスでのみ利用可能です。
レスポンスの形式
{ "Adid": "string", "AdvertisingId": "string", "Tracker": "string", "TrackerName": "string", "Environment": "string", "ClickTime": "date-time", "InstallTime": "date-time", "LastSessionTime": "date-time", "LastEventsInfo": { "{event_id}": { "name": "string", "time": "date-time" }, "{event_id}": { "name": "string", "time": "date-time" }, "{event_id}": { "name": "string", "time": "date-time" } }, "LastSdkVersion": "ios4.37.2", "State": "string"}
{ "Adid": "string", "AdvertisingId": "string", "Tracker": "string", "TrackerName": "string", "ClickTime": "date-time", "InstallTime": "date-time", "LastSessionTime": "date-time", "LastEventTimes": { "string": "date-time", "string": "date-time", "string": "date-time", "string": "date-time" }, "State": "string"}
例
$ curl \--header "Authorization: Bearer ask43jskdp2tg2hg87" \-L -X GET "https://api.adjust.com/device_service/api/v2/inspect_device?advertising_id=1234-5678-9012-3456&app_token=gwzpeepw8uf8"
{ "Adid": "acf8534f2f052395e617a38730682ccc", "AdvertisingId": "1234-5678-9012-3456", "Tracker": "abc123", "TrackerName": "Organic", "FirstTracker": "zr5vueb", "FirstTrackerName": "Organic", "Environment": "sandbox", "ClickTime": "0001-01-01T00:00:00Z", "InstallTime": "2015-08-19T03:42:03Z", "LastSessionTime": "2017-07-29T17:29:17Z", "LastEventsInfo": { "kgfcul": { "name": "Copy IDFA", "time": "2024-07-18T10:01:16Z" }, "wz9qqz": { "name": "Accept Terms", "time": "2024-07-01T14:13:47Z" }, "z3f773": { "name": "Copy IDFV", "time": "2024-07-01T19:01:39Z" } }, "LastSdkVersion": "ios4.37.2", "State": "installed"}
$ curl \--header "Authorization: Bearer ask43jskdp2tg2hg87" \-L -X GET "https://api.adjust.com/device_service/api/v1/inspect_device?advertising_id=1234-5678-9012-3456&app_token=gwzpeepw8uf8"
{ "Adid": "acf8534f2f052395e617a38730682ccc", "AdvertisingId": "1234-5678-9012-3456", "Tracker": "abc123", "TrackerName": "Organic", "ClickTime": "0001-01-01T00:00:00Z", "InstallTime": "2015-08-19T03:42:03Z", "LastSessionTime": "2017-07-29T17:29:17Z", "LastEventTimes": { "a1a1a1": "2017-07-29T17:29:55Z", "b2b2b2": "2017-07-29T17:29:21Z", "c3c3c3": "2017-07-29T17:29:38Z", "4d4d4d": "2017-07-29T17:29:58Z" }, "State": "installed"}
デバイスデータを削除する
POST https://api.adjust.com/device_service/api/v1/forget_device
Adjustのサーバーからデバイス情報を削除するには、forget deviceエンドポイントを使用します。これを使用して、デバイスへのインストールを何度もテストできます。
パラメーター
以下のパラメーターを リクエストデータ として追加する必要があります。
app_token
(String
)-
アプリを識別する英数字のトークン。12文字で設定してください。
adid
(String
)-
デバイス固有のAdjust識別子。Inspect deviceエンドポイントを使用して、デバイスのADIDを確認できます。
例
$ curl \--header "Authorization: Token token=ask43jskdp2tg2hg87" \--location --request POST "https://api.adjust.com/device_service/api/v1/forget_device" \--data "adid=acf8534f2f052395e617a38730682ccc&app_token=gwzpeepw8uf8"
200: Forgot device