Remerge 事件跟踪 API 是一款 Remerge 工具，它为其客户和合作伙伴提供了一种向 Remerge 传输各类数据的方法。因此，上述客户/合作伙伴可以向我们提供其应用内事件、归因、BI 或 SKadNetwork 数据。以下文档提供了有关将应用内事件数据转发到 Remerge 事件跟踪 API 的相关信息。如有任何疑问，请联系您的 Remerge 客户经理。
流程
Request
GET
Response
HTTP 204（默认情况下）。如有疑问请联系您的 Remerge 客户经理，以确保您请求成功。
端点
Protocol
HTTPS
频率
一般
- 实时转发所有应用内事件。
App 打开
- 每 10 分钟转发一次您的App Open事件。
参数
- 提供所有强制性 (M) 参数，以确保可正常追踪。
- 添加（optional，非必需）参数，以优化再营销效果和报表纬度。
-
正确编码包含非web-safe字符的参数。
| 名称 | 内容 | 示例 |
|---|---|---|
| app_id (M) | 谷歌应用商店/iTunes（不含“ID”前缀） | 553834731, com.king.candycrush |
| event (M) |
应用内事件名称应反映其实质（例如，应用打开或应用内购）。此外，请确保将用户的第一个应用打开事件命名为安装事件。 |
purchase, add_to_basket, level_2_reached |
| 数据 | 其他事件的相关数据。确保采用 JSON 格式和双引号。单个字符串也能接受 | {"store":1341, "keywords":["yellow","red"]} |
| ts | 事件时间戳采用 Unix Epoch格式。时区应为 UTC，长度为 10 位 | 1427976389 |
| partner (M) | 跟踪合作伙伴名称 | supergame |
| key (M) | 合作伙伴密钥（由 Remerge 提供） | x34dlx |
| idfa (M) |
Apple IDFA（确保所有字母大写） |
AEBE52E7-03EE-455A-B3C4-E57283966239 |
| aaid (M) |
Android Advertising ID（确保所有字母小写） |
38400000-8cf0-11bd-b23e-10b96e40000d |
| country | ISO alpha 2 国家/地区代码 | de |
| device_name | 设备名称 | 例如：iPhone11、iPhone7、iPhone XR、Galaxya51、Galaxya50 |
|
os_name |
操作系统名称 | android, ios |
| os_version | 操作系统版本 | 8.0.1 |
| app_version | 应用版本 | 1.2 |
| user | Customer user ID | 4838131 |
| 营收 | 以微小货币单位表示的收入（可启用sub-cent values并防止浮点数问题） | revenue=170000 (=0.17), 5750000 (=5.75$) |
| (revenue_float) | 如果您的价格不包含分值和小数分隔符 | revenue_float=0.17 或 5.75 |
| currency | ISO 4217 货币代码 | USD |
| non_app_event | 假如非应用内事件（i.e., a click postback）- true 或 false | false |
|
idfv (M) |
您的用户的 IDFV（供应商 ID，仅适用于 iOS） |
E29738C9-0556-4F49-AB98-1A33197F0FFD |
|
operator |
移动运营商/设备运营商 |
MTS%20RUS、TELCEL、Telenor AT%26T、Iliad、Viettel、LGU%2B |
|
zipcode |
地区邮编 |
15414、500064、517504、115088 |
|
city |
城市名称。使用 UN/LOCODE 以实现标准化 |
Yokohama、Yocsina、Bogota |
|
country_subdivision |
州/省名称 |
CA、PB、Sindh、Istanbul |
|
partner_device_id |
Your ID for the user |
|
|
iP |
iP 地址（iP4 或 iP6） |
178.151.153.17 |
|
language |
用户语言（可为简单版/或扩展版） |
简单：en,ja,bg 扩展：pl-SE, ru_RU |
|
sdk |
您的 SDK 版本 |
2.2 |
数据参数
数据参数可以保存多个 JSON 格式的唯一键值对，作为事件本身的一部分，用于提供有关用户操作的附加元数据。例如，对于e-Commerce，此参数用于转发产品相关的信息（例如：产品 ID、价格或数量），以显示和识别来自产品Feed的定制Banner中的其他相关产品。
结构
- JSON 数据结构举例如下：
data={"product_id":"sdf235235dfw3131","cv_type":0}
格式
- 将URL-encoded JSON Object转发到 Remerge：
data=%7B%22product_id%22%3A%22sdf235235dfw3131%22%2C%22cv_type%22%3A0%7D%20
- 确保字符串使用双引号（根据 JSON 规范，https://www.json.org/json-en.html）。
- 要向我们提供多个产品 ID，您可以执行以下操作：
data={"products":["23ef23","234fe2d","23dw334"]}，然后编码：
data=%7B%22products%22%3A%5B%2223ef23%22%2C%22234fe2d%22%2C%2223dw334%22%5D%7D%C2%A0
示例
-
含占位符的示例如下（“{PLACEHOLDER}”应包含内部占位符的名称）：
https://remerge.events/event?app_id={AppId}&event={EventName}&partner=yourname&key=yourkey&idfa={IDFA}&aaid={AAID}&country={Country}&device_name={DeviceName}&os_name={OS}&os_version={OSVersion}&ts={Timestamp}&revenue={RevenueAmount}¤cy={Currency}&non_app_event=false