adjust-icon

デバイスAPI

デバイスAPIを使ってデバイス情報を確認し、テスト用にAdjustからデバイス履歴を消去します。

要件

デバイスデータの削除は、 やり直すことができない 設定です。Forget deviceエンドポイントを使用するには、アカウントに以下の いずれか のアクセス権限が付与されていることが必要です。

  • 管理者 。
  • 編集者 。
  • 対象とするアプリにアクセスできる カスタム編集者 。

認証

デバイスAPIは認証にベアラートークンを使用します。デバイスAPIにリクエストを行う度に、Adjust APIトークンをAuthorizationヘッダーに含める必要があります。

自社でシングルサインオン（SSO）を有効にしている場合は、 Adjustの担当者またはsupport@adjust.comにお問い合わせください。APIトークンの取得方法についてサポートいたします。

SSO以外のアカウントの場合、APIガイドはユーザーの プロフィール に表示されます。トークンを確認するには、以下の手順に従ってください。

  1. アカウント（ユーザー）アイコンを選択します。
  2. アカウント設定（Account Settings） を選択します。
  3. マイプロフィール（My Profile） を選択します。
  4. APIトークン が ユーザー情報（User details） に表示されます。コピーボタンを選択して、トークンをクリップボードにコピーします。

Adjust APIトークンをリセットする

Adjust APIトークンはいつでもリセットできます。トークンをリセットすると、古いトークンは無効になります。Adjust APIトークンをリセットした場合、使用中の古いトークンを新しいトークンに置き換える必要があります。無効になったトークンを使用したリクエストは、Adjustによって拒否されます。

Adjust APIトークンをリセットする方法：

  1. アカウント（ユーザー）アイコンを選択します。
  2. アカウント設定（Account Settings） を選択します。
  3. マイプロフィール（My Profile） を選択します。
  4. APIトークン が ユーザー情報（User details） に表示されます。
  5. APIトークンをリセットする（Reset API token） を選択します。
  6. 表示されたモーダルにアカウントのパスワードを入力し、 リセット（Reset） を選択してAPIトークンをリセットします。画面の右上に確認メッセージが表示されます。
  7. APIトークン の横にあるコピーボタンを選択して、トークンをクリップボードにコピーします。

デバイスの検査

エンドポイント
GET https://api.adjust.com/device_service/api/v2/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"
}

例

cURL
$ 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"
}

デバイスデータを削除する

エンドポイント
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
$ 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