应用终端 | Adjust Developer Hub

应用终端

使用 /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_hash`	`String`	正文 (Body)	从 keystore 文件中生成的 SHA1 哈希，用来创建 SDK 签名。
`channel_setup`	`Object`	正文 (Body)	应用合作伙伴模块设置所必需。请参阅渠道源设置一文，了解更多信息。
`editors`	`String`	正文 (Body)	应拥有应用访问权限的用户邮箱列表。
`template_app_token`	`String`	正文 (Body)	作为模板的 Adjust 应用识别码。如果您不使用模板，则该识别码为必需。
`force_update`	`Boolean`	正文 (Body)	发送该值为 true，以更新现有应用设置。

响应参数

参数	数据类型	描述
`adjust_app_token`	`String`	Adjust 应用识别码，用于 SDK 集成和其他 API 请求。
`name`	`String`	应用的名称。
`sk_app_id`	`Integer`	iOS 应用的 StoreKit 应用 ID。
`store_id`	`String`	Bundle ID (安卓) \| Store ID (Apple)
`bundle_id`	`String`	安卓或 iOS 应用的 Bundle ID
`ticket_token`	`String<uuid>`	Ticket ID，用来查看当前工作状态。请参阅状态终端文档，了解更多信息。

示例

$ 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`

响应参数

名称	类型	描述
`name`	`String`	应用名称
`platform`	`String`	`android` \| `ios`
`store_id`	`String`	Bundle ID (安卓) \| Store ID (Apple)
`adjust_app_token`	`String`	被请求应用的识别码。
`additional_info`	`Object`	终端此前接收的全部应用详情。
`channel_setup`	`Object`	合作伙伴特定参数，请参考渠道源设置
`cross_promo_token`	`String`	将被用于 CrossPromotion 的 Adjust 跟踪码 (可用后)。
`android_signature_hash`	`String`	从 keystore 文件中生成的 SHA1 哈希，用来创建 SDK 签名。

示例

$ 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 响应中找到。

响应参数

名称	类型	描述
`name`	`String`	应用名称
`platform`	`String`	`android` 或 `ios`
`store_id`	`String`	Bundle ID (安卓) \| Store ID (Apple)
`adjust_app_token`	`String`	被请求应用的识别码。
`additional_info`	`Object`	终端此前接收的全部应用详情。
`channel_setup`	`Object`	合作伙伴特定参数，请参考渠道源设置
`cross_promo_token`	`String`	将被用于 CrossPromotion 的 Adjust 跟踪码 (可用后)。
`android_signature_hash`	`String`	从 keystore 文件中生成的 SHA1 哈希，用来创建 SDK 签名。

示例

$ 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 响应中找到。

响应参数

参数	数据类型	描述
`channels`	`Array <string>`	该应用活跃途径的渠道 slug。

示例

$ 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"
]