转化归因

在 Postman 中运行 ❯

GET conversion_attribution¶

查询 Twitter 以检查转化归因，且无需编写转化事件。响应会指明 Twitter 归因。

这涉及 POST conversion_event 端点。

将在响应中声明 Twitter、TAP 或无归因。没有 Twitter 归因时，将始终出现值为 null 的 twitter_attribution 节点，该节点将被如下所示的的响应示例填充。如果已声明 TAP 归因，将出现 tpn_attribution 节点并进行相应填充。参阅 TAP 概述了解更多信息。

资源 URL¶

https://ads-api.twitter.com/10/conversion_attribution

参数¶

名称	说明
app_id 必需	相应应用商店的唯一标识符。类型：int、string 示例：`333903271`、`com.vine.android`
conversion_time 必需	转化事件的时间采用 ISO-8601 时间戳格式，后面附加毫秒数。类型：string 示例：`2014-05-22T02:38:28.103Z`
conversion_type 必需	转化事件的类型。类型：enum 可能值：`ACHIEVEMENT_UNLOCKED`、`ADDED_PAYMENT_INFO`、`ADD_TO_CART`、`ADD_TO_WISHLIST`、`CHECKOUT_INITIATED`、`CONTENT_VIEW`、`INSTALL`、`INVITE`、`LEVEL_ACHIEVED`、`LOGIN`、`PURCHASE`、`RATED`、`RESERVATION`、`RE_ENGAGE`、`SEARCH`、`SHARE`、`SIGN_UP`、`SPENT_CREDITS`、`TUTORIAL_COMPLETE`、`UPDATE`
hashed_device_id 必需	使用 HMAC_SHA-256 哈希处理的 IDFA 或 AdID。类型：string 示例：`ABCD1234XYZ`
os_type 必需	应用的 OS 类型。类型：enum 可能值：`IOS`、`ANDROID`
click_window 可选	此事件的点击窗口（以天为单位）。类型：int 默认值：`14` 可能值：`1`、`7`、`14`、`30`
extra_device_ids 可选	`hashed_device_id` 中传入的设备 ID 的 SHA1 的 SHA256，以及任何其他经过哈希处理的设备 ID。类型：string 示例：`ABCD1234XYZ`、`DCBA4321XYZ`
non_twitter_engagement_time 可选	转化前最后一次非 Twitter 互动的时间。类型：string 示例：`2014-05-22T02:38:28.103Z`
non_twitter_engagement_type 可选	转化事件前非 Twitter 互动的类型。类型：enum 可能值：`CLICK`、`VIEW`
view_through_window 可选	通过窗口查看此事件（以天为单位）。类型：int 默认值：`1` 可能值：`0`、`1`、`7`、`14`、`30`

请求示例¶

GET https://ads-api.twitter.com/10/conversion_attribution?app_id=333903271&os_type=IOS&hashed_device_id=ABCD1234XYZ&conversion_type=INSTALL&conversion_time=2013-04-16T07:00:00.123Z&click_window=14&view_through_window=0

响应示例¶

{
  data:{
    "app_id":"333903271",
    "os_type":"IOS",
    "hashed_device_id":"ABCD1234XYZ",
    "conversion_type":"INSTALL",
    "partner_client_id":"123abc",
    "conversion_time":"2013-04-16T07:00:00.123Z",
    "click_window":14,
    "view_through_window":0,
    "extra_device_ids":null,
    "twitter_attribution":{
      "engagement_type":"VIEW",
      "engagement_time":"2013-04-16T07:00:00.123Z",
      "country_code":"US",
      "tweet_id":"383034667764441088",
      "attribution_type":"PROMOTED",
      "promoted_properties":{
        "campaign_id”: “54a21",
        "campaign_name":"Vine_Contest",
        "line_item_id":"23ab2d4"
      }
    }
  },
  "data_type":"conversion_attribution",
  "request":{
    "params":{
      "app_id":"333903271",
      "os_type":"IOS",
      "hashed_device_id":"ABCD1234XYZ",
      "conversion_time":"2013-04-16T07:00:00.123Z",
      "conversion_type":"INSTALL",
      "click_window":14,
      "view_through_window":0
    }
  }
}