API reference contents

应用事件提供商配置

应用事件标签

Web 事件标签

应用列表

转化归因

转化事件

应用事件提供商配置

在 Postman 中运行 ❯

GET accounts/:account_id/app_event_provider_configurations¶

检索与当前账号关联的部分或所有应用事件提供商配置（移动应用程序转化跟踪的核心配置）的详细信息。

资源 URL¶

https://ads-api.twitter.com/10/accounts/:account_id/app_event_provider_configurations

参数¶

名称	说明
account_id 必需	所使用账号的标识符。出现在资源路径中，通常是所有广告商 API 请求的必要参数，不包含 GET accounts。指定账号必须与已验证的用户关联。类型：string 示例：`18ce54d4x5t`
count 可选	指定每个不同请求尝试检索的记录数量。类型：int 默认值：`200` 最小值、最大值：`1`、`1000`
cursor 可选	指定光标以获取下一页结果。参阅分页了解更多信息。类型：string 示例：`8x7v00oow`
ids 可选	通过指定逗号分隔的标识符列表，将响应范围限定为所需的配置。最多可提供 200 个 ID。类型：string 示例：`25n`
sort_by 可选	根据支持的属性，按升序或降序排序。参阅排序了解更多信息。类型：string 示例：`created_at-asc`
with_deleted 可选	在请求中包含已删除的结果。类型：boolean 默认值：`false` 可能值：`true`、`false`
with_total_count 可选	包含 `total_count` 响应属性。注意：不包含此参数和 `cursor`。注意：包含 `total_count` 的请求速率限制较低，目前设置为每 15 分钟 200 次。类型：boolean 默认值：`false` 可能值：`true`、`false`

请求示例¶

GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/app_event_provider_configurations?ids=25n

响应示例¶

{
  "data": [
    {
      "provider_name": "Answers powered by Fabric",
      "id": "25n",
      "provider_advertiser_id": "54ac2766f0de9e1f7a00001a",
      "created_at": "2016-12-08T07:49:58Z",
      "provider_advertiser_identifier": "54ac2766f0de9e1f7a00001a",
      "updated_at": "2017-05-12T21:37:15Z",
      "deleted": false
    }
  ],
  "next_cursor": null,
  "request": {
    "params": {
      "ids": [
        "25n"
      ],
      "account_id": "18ce54d4x5t"
    }
  }
}

GET accounts/:account_id/app_event_provider_configurations/:id¶

检索与当前账号关联的事件提供商配置（移动应用程序转化跟踪的核心配置）的具体 ID。

资源 URL¶

https://ads-api.twitter.com/10/accounts/:account_id/app_event_provider_configurations/:id

参数¶

名称说明

account_id
必需

所使用账号的标识符。出现在资源路径中，通常是所有广告商 API 请求的必要参数，不包含 GET accounts。指定账号必须与已验证的用户关联。

类型：string

示例：18ce54d4x5t

id
必需

请求中对正在操作的应用事件提供商配置的引用。

类型：string

示例：25n

with_deleted
可选

在请求中包含已删除的结果。

类型：boolean

默认值：false
可能值：true、false

请求示例¶

GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/app_event_provider_configurations/25n

响应示例¶

{
  "data_type": "app_event_provider_configuration",
  "data": {
    "provider_name": "API McTestface",
    "id": "25n",
    "provider_advertiser_id": "123",
    "created_at": "2017-03-24T22:24:56Z",
    "provider_advertiser_identifier": "123",
    "updated_at": "2017-03-24T22:24:56Z",
    "deleted": false
  },
  "request": {
    "params": {
      "id": "25n",
      "account_id": "18ce54d4x5t"
    }
  }
}

POST accounts/:account_id/app_event_provider_configurations¶

创建与当前账号关联的新应用事件提供商配置。只有一个 MACT 提供商可以与特定的广告账号相关联。

资源 URL¶

https://ads-api.twitter.com/10/accounts/:account_id/app_event_provider_configurations

参数¶

名称说明

account_id
必需

所使用账号的标识符。出现在资源路径中，通常是所有广告商 API 请求的必要参数，不包含 GET accounts。指定账号必须与已验证的用户关联。

类型：string

示例：18ce54d4x5t

provider_advertiser_id
必需

来自提供商网站的广告商标识符

类型：string

示例：client1

请求示例¶

POST https://ads-api.twitter.com/10/accounts/18ce54d4x5t/app_event_provider_configurations?provider_advertiser_id=client1

响应示例¶

{
  "data": {
    "provider_name": "InternalTestProvider",
    "id": "e5g",
    "provider_advertiser_id": "client1",
    "created_at": "2017-08-30T05:40:07Z",
    "provider_advertiser_identifier": "client1",
    "updated_at": "2017-09-06T06:39:03Z",
    "deleted": false
  },
  "request": {
    "params": {
      "provider_advertiser_id": "client1",
      "account_id": "18ce54d4x5t"
    }
  }
}

DELETE accounts/:account_id/app_event_provider_configurations/:id¶

删除属于当前账号的指定应用事件提供商配置。

资源 URL¶

https://ads-api.twitter.com/10/accounts/:account_id/app_event_provider_configurations/:id

参数¶

名称说明

account_id
必需

所使用账号的标识符。出现在资源路径中，通常是所有广告商 API 请求的必要参数，不包含 GET accounts。指定账号必须与已验证的用户关联。

类型：string

示例：18ce54d4x5t

id
必需

请求中对正在操作的应用事件提供商配置的引用。

类型：string

示例：e5g

请求示例¶

DELETE https://ads-api.twitter.com/10/accounts/18ce54d4x5t/app_event_provider_configurations/e5g

响应示例¶

{
  "data": {
    "provider_name": "InternalTestProvider",
    "id": "e5g",
    "provider_advertiser_id": "client1",
    "created_at": "2017-08-30T05:40:07Z",
    "provider_advertiser_identifier": "client1",
    "updated_at": "2017-08-30T05:40:26Z",
    "deleted": true
  },
  "request": {
    "params": {
      "id": "e5g",
      "account_id": "18ce54d4x5t"
    }
  }
}