API 工具允许您在分析系统中获取原始数据，从而帮助您更好地分析用户并改进他们的客户旅程地图（CJM）。该选项有助于测试新功能、产品性能分析以及对应用程序的财务状况进行预测。

API 密钥

要查找 API 密钥列表，请访问 "属性">"API 工具"。在此页面，您可以看到以下内容：

可以添加、删除和重新生成的 API 密钥列表：

您最多可以添加 3 个 API 密钥。

演示 API 密钥：
- 尝试安装
- 尝试事件
- 尝试对话

您可以使用其中任何一个 API 密钥来获取安装、事件和转换数据。每个请求都有自己的条件。

获取安装

URL: https://restapi.affattr.com/v1/report/raw/installs

标题：API-KEY

参数

pagination.limit (uint) - 限制。
pagination.offset (uint) - 偏移量。
time_window.from_rfc3339 (string) - 示例：2022-01-01T12:00:27.87+00:20。
time_window.from.seconds (uint) - 时间戳 - 优先级高于 from_rfc3339。
time_window.from_not_include bool - 如果选中则 "时间 > from"，否则 "时间 >= from"。
time_window.to_rfc3339（字符串）- 例如：2022-01-01T12:00:27.87+00:20。
time_window.to.seconds (uint) - 时间戳 - 优先级高于 to_rfc3339。
non_organic_only（布尔）。

所有字段均为可选字段。始终按创建日期升序排列。不能添加创建时间较短的新事件。

API 响应示例：

 { "info"：[ { "device"：{ "affise_device_id"："310d8335-80b1-4849-8925-ef54126004af", "random_user_id"："b2080f39-f9e1-4f7e-bc42-8863dfe028d5", "first_open_time"：{ "seconds"：1696156153 }, "app_id"：1, "affise_pkg_app_name"："com.itbxp.surf", "partner_id"：10, "device_parameters"：{ "platform"："android", "device_name"："5058", "device_type"："smartphone", "os_name"："Nougat", "os_version"："7.0", "android_id"："421a9e99321086d6", "gaid_adid"："d8313cad-070f-4c0e-824f-bb58d7be5acf", "referrer"："referrer=4107abce-890d-4098-b83b-01d9bdc195d4&clickid=651949b9660c680001ef66c8&pid=10" }, "click_affise"：{ "click_id"："4317abce-990d-4098-b83b-01d9bdc195d4", "created_at"：{ "seconds"：1696156090 }, "subs"：{}, "geo"：{ "country"："ID", "region"："Jawa Timur", "city"："Tamansari", "isp"："?"                   }, "ip"："2001:448a:5139:1985:5d62:4fe6:118d:9c12", "user_agent"："Mozilla/5.0 (Linux; Android 7.0; 5058 Build/NRD90M; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/117.0.0 Mobile Safari/537.36 agentweb/4.0.2 UCBrowser/11.6.4.950", "pub_click_id"："652949b9660c680001ef66c8" }           }, "uuid"："924ee319-6e6d-44f3-9449-08d4b4dd1300", "timestamp"：{ "seconds"：1696156248 }, "geo"：{ "country"："ID", "region"："ID", "isp"："ind telkomsel"           }, "ip"："2001:448a:2130:1985:5d62:4fe6:118d:9c12", "created_at"：{ "seconds"：1696156279 }       }

获取事件

URL: https://restapi.affattr.com/v1/report/raw/events

标头：API-KEY

参数：

pagination.limit (uint) - 限制。
pagination.offset (uint) - 偏移量。
time_window.from_rfc3339 (string) - 示例：2022-01-01T12:00:27.87+00:20。
time_window.from.seconds (uint) - 时间戳 - 优先级高于 from_rfc3339。
time_window.from_not_include bool - 如果选中则 "时间 > from"，否则 "时间 >= from"。
time_window.to_rfc3339（字符串）- 例如：2022-01-01T12:00:27.87+00:20。
time_window.to.seconds (uint) - 时间戳 - 优先级高于 to_rfc3339。
non_organic_only（布尔）。

所有字段均为可选字段。始终按创建日期升序排列。不能添加创建时间较短的新事件。

API 响应示例：

{ "events"：[ { "info"：{ "device"：{ "affise_device_id"："8f29848f-ecfa-49f2-93a7-d2d484a13515", "random_user_id"："071dcb20-1826-47ff-a310-e84ab4a673a1", "first_open_time"：{ "seconds"：1696122018 }, "app_id"：1, "affise_pkg_app_name"："com.itbxp.surf", "is_organic": true, "device_parameters"：{ "platform"："android", "device_name"："i55C", "device_type"："smartphone", "os_name"："Nougat", "os_version"："7.0", "android_id"："e627c254f84cd9a9", "gaid_adid"："0ed20689-2435-4816-ab58-e2bc03639ecb", "referrer"："referrer=8ba10af2-4cc9-4cda-806f-47181d47fcef&clickid=65176bfb55c3260001bad183&pid=10" }.               }, "uuid"："0f8e8e41-3b1e-4981-b36d-f919dc15f7ca", "timestamp"：{ "seconds"：1696122034 }, "geo"：{ "country"："ID", "region"："ID", "isp"："Indosat Ooredoo" }, "ip"："2001:448a:3041:2d33:b900:e218:be45:ae55", "created_at"：{ "seconds"：1696122079 }           }, "created_at"：{ "seconds"：1696122079 }, "id"："afbcac17-4a0a-4df8-9acd-d0b7706185b9", "name"："ContentItemsView", "category"："native", "timestamp"：{ "seconds"：1696122019 }, "user_data"："shortcuts", "data":"{\"affise_event_content_items_view\":{\"title\":\"News\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32107\"},{\"title\":\"Kids\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32102\"},{\"title\":\"Goods\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32100\"},{\"title\":\"Utilities\",\"url\":\"https://track.g2afse.com/click?pid=127\&offer_id=32110\"},{\"title\":\"Fun\",\"url\":\"https://appspress.g2afse.com/click?pid=127\&offer_id=32098\"},{\"title\":\"Food\",\"url\":\"https://appspress.g2afse.com/click?pid=127\&offer_id=32097\"}]}"       }

获取转换

URL: https://restapi.affattr.com/v1/report/raw/conversions

Headers：API-KEY

参数：

pagination.limit (uint) - 限制。
pagination.offset (uint) - 偏移量。
time_window.from_rfc3339 (string) - 示例：2022-01-01T12:00:27.87+00:20。
time_window.from.seconds (uint) - 时间戳 - 优先级高于 from_rfc3339。
time_window.from_not_include bool - 如果选中则 "时间 > from"，否则 "时间 >= from"。
time_window.to_rfc3339（字符串）- 例如：2022-01-01T12:00:27.87+00:20。
time_window.to.seconds (uint) - 时间戳 - 优先级高于 to_rfc3339。
non_organic_only（布尔）。

所有字段均为可选字段。始终按创建日期升序排列。不能添加创建时间较短的新事件。

⚠️ 示例中包含了通过引用源传递的附加值。

{ "转换"：[ { "事件"：{ "info"：{ "device"：{ "affise_device_id"："6f9491d3-000a-1000-0f45-58674f4c7485", "random_user_id"："6f9000ee-018a-1000-8c19-58a34e8a8d72", "first_open_time"：{ "seconds"：1694089122, "nanos": 256000000 }, "app_id"：129, "affise_pkg_app_name"："com.affise.app", "device_parameters"：{ "platform"："android", "device_name"："sdk_gphone_x86_64", "device_type"："smartphone", "os_name"："Android11", "os_version"："11", "android_id"："b6ea55ccaee29142", "referrer"："referrer=4c5a6cff-4a76-4518-b2b7-a9d21abbd8ca&clickid=640f91362bc1a20001646bd7&pid=85" }, "click_affise"：{ "click_id"："4c9a6cff-4a76-4518-b2b7-a9d90abbd0ca", "created_at"：{ "seconds"：1694089122 }, "subs"：{ "sub1"："s1", "sub2"："s2", "sub3"："s3", "sub4"："s4", "sub5"："s5" }, "geo"：{ "country"："UK" }, "ip"："127.0.0.1", "user_agent"："Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.51 Safari/537.36", "campaign_id"："123", "campaign_name"："cname", "network_id"："123", "network_name"："nname", "tracker_id"："123", "tracker_name"："tname", "creative_id"："123", "pub_click_id"："640f91362bc1a20001646bd7", "partner_name"："pname" }         }, "uuid"："f5a01792-018a-1000-bd27-633c0f2d5839", "timestamp"：{ "seconds"：1696338024 }, "geo"：{ "country"："US", "region"："US" }, "ip"："188.17.96.239", "user_agent"："Dalvik/2.1.0 (Linux; U; Android 11; sdk_gphone_x86_64 Build/RSR1.201211.001)", "created_at"：{ "seconds"：1696338042, "nanos"：67913469 }       }     }, "created_at"：{ "秒"：1696338026 }, "id"："5c8791a4-3a4f-41aa-9319-225a30f847e5", "conversion_type"："install", "currency"："USD" (美元)   } ]}{

尝试 API 密钥

要试用 API 密钥，请执行以下操作：

选择 "尝试安装"、"尝试事件 "或 "尝试转换"。
在API-KEY下拉列表中，选择某个 API-Key。
在周期过滤器中，指定周期。
如果只想获取非有机事件，请单击 "只获取非有机事件 "复选框。
单击请求。

您可能会收到以下响应：

回传错误

在 " 回传错误"选项卡上，您可以检查广告商发送的回传日志。

如有任何问题，请通过电子邮件联系 Affise 客户支持团队：[email protected]。