adjust-icon

アプリエンドポイント

/appエンドポイントを使用して、新規アプリの作成と更新を自動化します。

新規アプリを作成する

テンプレートアプリの設定を使用して新規アプリを作成します。アプリがすでにある場合は、force_updateパラメーターを使用して新しい設定に更新できます。

エンドポイント
POST https://settings.adjust.com/api/app

パラメーター

パラメーターデータタイプ入力する値説明
store_id*StringボディバンドルID（Android） | ストアID（Apple）
platform*Stringボディandroid | ios
name*Stringボディアプリの名前。
bundle_id*StringボディアプリのバンドルID。
android_signature_hashStringボディSHA1 ハッシュ値。SDKシグネチャーをビルドするため生成されるキーストアファイル。
channel_setupObjectボディアプリのパートナーモジュール設定に必要です。詳細はチャネル設定に関する記事をご覧ください。
editorsStringボディアプリにアクセスできるユーザーのメールアドレスのリスト。
template_app_tokenStringボディテンプレートとして使用するAdjustのアプリトークン。テンプレートアプリを使用していない場合に必要です。
force_updateBooleanボディこの値をtrueとしてパスし、既存のアプリの設定を更新します。

レスポンスのパラメーター

パラメーターデータタイプ説明
adjust_app_tokenStringSDKの実装と他のAPIリクエストに使用するAdjustアプリトークン。
nameStringアプリの名前。
sk_app_idIntegeriOSアプリのStoreKitアプリID。
store_idStringAndroidのバンドルID | AppleのストアID
bundle_idStringAndroidまたはiOSアプリのバンドルID。
ticket_tokenString<uuid>現在のジョブステータスを確認するためのチケットID。詳細はステータスエンドポイントのドキュメントを参照してください。

例

cURL
$ curl \
--header "AdjustAuthorization: Token <adjust api token>" \
--header "Content-Type: application/json" \
--data '{ "name":"Test App Name", "bundle_id":"test.bundle.app", "store_id":"test.bundle.app", "platform":"android", "channel_setup": { "facebook": {"app_id": "123456789"} } }' \
-X POST https://settings.adjust.com/api/app
成功レスポンス
{
   "adjust_app_token": "p77yk727r18g",
   "name": "Test App Name",
   "sk_app_id": null,
   "store_id": "test.bundle.app",
   "bundle_id": "test.bundle.app",
   "ticket_token": "af7702a9-ba95-6ba2-bdac-3f83e55ed8d3"
}

アプリの詳細を取得する

アプリストアIDとプラットフォーム名を使用して、アプリに関する詳細情報を取得します。

エンドポイント
GET https://settings.adjust.com/api/app?store_id={}&platform={}

パラメーター

名前データタイプ入力する値説明
store_id*StringクエリAndroidのバンドルID | AppleのストアID
platform*Stringクエリandroid | ios

レスポンスのパラメーター

名前種類説明
nameStringアプリの名前
platformStringandroid | ios
store_idStringAndroidのバンドルID | iOSのストアID
adjust_app_tokenStringリクエストされたアプリのトークン。
additional_infoObject以前エンドポイントで受け取ったアプリ情報。
channel_setupObjectパートナー固有のパラメーター。チャネル設定をご覧ください。
cross_promo_tokenStringクロスプロモーションに使用されるAdjustリンクトークン（利用可能になり次第）
android_signature_hashStringSHA1 ハッシュ値。SDKシグネチャーをビルドするため生成されるキーストアファイル

例

cURL
$ curl \
--header "AdjustAuthorization: Token <adjust api token>" \
-L -X GET 'https://settings.adjust.com/api/app?store_id=test.bundle.app&platform=android'
成功レスポンス
{
   "name": "Test App Name",
   "platform": "android",
   "store_id": "test.bundle.app",
   "adjust_app_token": "p77yk727r18g",
   "additional_info": { "overrides": {} },
   "channel_setup": {
      "facebook": { "app_id": "123456789" },
      "snapchat": { "app_id": "test.bundle.app" }
   },
   "cross_promo_token": "hgj3li1",
   "android_signature_hash": "FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF"
}

Adjustトークンでアプリの詳細を取得する

Adjustアプリトークンを使用して、アプリに関する詳細情報を取得します。

エンドポイント
GET https://settings.adjust.com/api/app/{adjust_app_token}

パラメーター

名前データタイプ入力する値説明
adjust_app_token*StringパスAdjustアプリトークン。このトークンは、Adjustダッシュボードまたは/app POSTレスポンスで確認できます。

レスポンスのパラメーター

名前種類説明
nameStringアプリの名前
platformStringandroid または ios
store_idStringAndroidのバンドルID | iOSのストアID
adjust_app_tokenStringリクエストされたアプリのトークン。
additional_infoObject以前エンドポイントで受け取ったアプリ情報。
channel_setupObjectパートナー固有のパラメーター。チャネル設定をご覧ください。
cross_promo_tokenStringクロスプロモーションに使用されるAdjustリンクトークン（利用可能になり次第）
android_signature_hashStringSHA1 ハッシュ値。SDKシグネチャーをビルドするため生成されるキーストアファイル

例

cURL
$ curl \
--header "AdjustAuthorization: Token <adjust api token>" \
-X GET https://settings.adjust.com/api/app/p77yk727r18g/
成功レスポンス
{
   "name": "Test App Name",
   "platform": "android",
   "store_id": "test.bundle.app",
   "adjust_app_token": "p77yk727r18g",
   "additional_info": { "overrides": {} },
   "channel_setup": {
      "facebook": { "app_id": "123456789" },
      "snapchat": { "app_id": "test.bundle.app" }
   },
   "cross_promo_token": "hgj3li1",
   "android_signature_hash": "FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF"
}

アプリのチャネルを取得する

アプリのアクティブリンクを持つチャネルのリストを取得します。

エンドポイント
GET https://settings.adjust.com/api/app/{adjust_app_token}/channels

パラメーター

名前データタイプ入力する値説明
adjust_app_token*StringパスAdjustアプリトークン。このトークンは、Adjustダッシュボードまたは/app POSTレスポンスで確認できます。

レスポンスのパラメーター

パラメーターデータタイプ説明
channelsArray <string>このアプリのアクティブチャネルのネットワークslugのリスト。
ネットワークスラグ
  • apple_search_ads
  • applovin
  • chartboost
  • crossinstall
  • crosspromotion
  • digitalturbine
  • facebook
  • gameanalytics
  • google
  • ironsource
  • snapchat
  • tapjoy
  • unityads
  • vungle
  • inmobi

例

cURL
$ curl \
--header 'AdjustAuthorization: Token <adjust api token>' \
--header "SignatureAuthorization: Token <adjust signature token>" \
--X GET 'https://settings.adjust.com/api/app/927t3s86rzsw/channels'
成功レスポンス
[
   "unityads",
   "digitalturbine",
   "jetfuel_api",
   "jetfuel",
   "criteo",
   "tapjoy",
   "bytedance",
   "moloco",
   "adikteev",
   "pinsightmedia",
   "applovin",
   "aura_ironsource",
   "freakout",
   "tradedoubler"
]

シグネチャー認証を有効化する

アプリのトラフィックを保護するためにAdjust v3のシグネチャーライブラリを使用している場合、オートメーションAPIを使用してアプリの証明書フィンガープリントを設定することができます。

手順

  1. /appエンドポイントを使用して、以下の情報を含むPOSTリクエストを送信します：

    • name: アプリの名前
    • bundle_id: AndroidのバンドルID | AppleのストアID
    • store_id: ターゲットのアプリストアにおけるアプリのID
    • platform: アプリのターゲットプラットフォーム
    • channel_setup: アプリのパートナーモジュール設定に必要です。詳細はチャネル設定に関する記事をご覧ください。
    Terminal window
    curl \
    --header "AdjustAuthorization: Token <adjust api token>" \
    --header "Content-Type: application/json" \
    --data '{ "name":"Test App Name", "bundle_id":"test.bundle.app", "store_id":"test.bundle.app", "platform":"android", "channel_setup": { "facebook": {"app_id": "123456789"}, "snapchat": {"app_id": "test.bundle.app"} } }' \
    -X POST https://settings.adjust.com/api/app

  2. Adjustの担当者に連絡し、シグネチャーv3のサポートを有効にするよう依頼してください。

  3. アプリがSignature v3にサポートにサポートされていることを確認できたら、 /appエンドポイントを使用して、以下の情報を含むPOSTリクエストを送信します：

    • android_signature_hash: コロンで区切られた16進数 形式のSHA-1シグネチャーのカンマ区切りリスト。
    • Adjustシグネチャートークンの値が付与されたSignatureAuthorizationヘッダー。
    Terminal window
    curl \
    --header "AdjustAuthorization: Token <adjust api token>" \
    --header "SignatureAuthorization: Token <adjust signature token>" \
    --header "Content-Type: application/json" \
    --data '{ "name":"Test App Name", "android_signature_hash": "45:a7:2b:82:00:f1:f6:99:d7:c5:1e:6e:1f:8c:91:b5:5c:f9:98:a2,44:40:16:6e:ed:36:cc:6d:6e:62:53:92:9e:ef:45:63:a1:3c:19:0c,57:44:3a:4c:05:23:50:a4:46:38:83:5d:64:fd:66:82:2f:81:33:19", "bundle_id":"test.bundle.app", "store_id":"test.bundle.app", "platform":"android", "channel_setup": { "facebook": {"app_id": "123456789"}, "snapchat": {"app_id": "test.bundle.app"} } }' \
    -X POST https://settings.adjust.com/api/app