adjust-icon

应用终端

使用 /app 终端自动创建和更新新应用。

创建新应用

使用模板应用的设置创建新应用。如果您的应用已经存在，可以通过 force_update 参数更新设置。

终端
POST https://settings.adjust.com/api/app

参数

参数数据类型位置描述
store_id*String正文 (Body)Bundle ID (安卓) | Store ID (Apple)
platform*String正文 (Body)android | ios
name*String正文 (Body)应用的名称。
bundle_id*String正文 (Body)您应用的 Bundle ID。
android_signature_hashString正文 (Body)从 keystore 文件中生成的 SHA1 哈希，用来创建 SDK 签名。
channel_setupObject正文 (Body)应用合作伙伴模块设置所必需。请参阅渠道源设置一文，了解更多信息。
editorsString正文 (Body)应拥有应用访问权限的用户邮箱列表。
template_app_tokenString正文 (Body)作为模板的 Adjust 应用识别码。如果您不使用模板，则该识别码为必需。
force_updateBoolean正文 (Body)发送该值为 true，以更新现有应用设置。

响应参数

参数数据类型描述
adjust_app_tokenStringAdjust 应用识别码，用于 SDK 集成和其他 API 请求。
nameString应用的名称。
sk_app_idIntegeriOS 应用的 StoreKit 应用 ID。
store_idStringBundle ID (安卓) | Store ID (Apple)
bundle_idString安卓或 iOS 应用的 Bundle ID
ticket_tokenString<uuid>Ticket 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查询Bundle ID (安卓) | Store ID (Apple)
platform*String查询android | ios

响应参数

名称类型描述
nameString应用名称
platformStringandroid | ios
store_idStringBundle ID (安卓) | Store ID (Apple)
adjust_app_tokenString被请求应用的识别码。
additional_infoObject终端此前接收的全部应用详情。
channel_setupObject合作伙伴特定参数，请参考渠道源设置
cross_promo_tokenString将被用于 CrossPromotion 的 Adjust 跟踪码 (可用后)。
android_signature_hashString从 keystore 文件中生成的 SHA1 哈希，用来创建 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路径 (Path)Adjust 应用识别码，可以在 Adjust 控制面板或 /app POST 响应中找到。

响应参数

名称类型描述
nameString应用名称
platformStringandroid 或 ios
store_idStringBundle ID (安卓) | Store ID (Apple)
adjust_app_tokenString被请求应用的识别码。
additional_infoObject终端此前接收的全部应用详情。
channel_setupObject合作伙伴特定参数，请参考渠道源设置
cross_promo_tokenString将被用于 CrossPromotion 的 Adjust 跟踪码 (可用后)。
android_signature_hashString从 keystore 文件中生成的 SHA1 哈希，用来创建 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路径 (Path)Adjust 应用识别码，可以在 Adjust 控制面板或 /app POST 响应中找到。

响应参数

参数数据类型描述
channelsArray <string>该应用活跃途径的渠道 slug。
渠道 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 Signature 库保护应用流量，则可以使用自动化 API 来设置应用的证书指纹。

说明

  1. 发送一个 POST 请求至/app终端，包含以下信息：

    • name: ：应用的名称。
    • bundle_id: ：Bundle ID (安卓) | Store ID (Apple)
    • 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 代表启用 Signature v3 支持。

  3. 应用启用 Signature v3 支持后，发送另一个 POST 请求至 /app终端，包含以下信息：

    • android_signature_hash: 冒号分隔十六进制 格式的 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