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トークン の横にあるコピーボタンを選択して、トークンをクリップボードにコピーします。

デバイスの検査

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デバイスでのみ利用可能です。

レスポンスの形式

例

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

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