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_tokenString

アプリを識別する英数字のトークン。12文字で設定してください。

advertising_idString

デバイスに関連付けられた一意の広告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_tokenString

アプリを識別する英数字のトークン。12文字で設定してください。

adidString

デバイス固有の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