跳转到主要内容
所有收藏
将事件发送至 Affise MMP (S2S)
将事件发送至 Affise MMP (S2S)
Natalya Yefimenko avatar
作者:Natalya Yefimenko
超过 7 个月前更新

使用第三方系统存储应用程序中发生的事件(注册、购买、定金等)的数据是一种常见情况。MMP 不会自动跟踪这些事件,因为它会跟踪用户来自哪个渠道。用户所做的所有事件都会在您的系统中进行跟踪。

要将事件发送到Affise MMP和MMP集成的服务(例如,Facebook,以优化广告活动),请使用下面的指南。

事件发送逻辑

事件应与事件 ID 一起发送至 Affise MMP,以便在系统中进一步注册。

事件发送方法

您需要从API 访问部分获得 API密钥,以发送以下请求:

curl --request POST

--header 'Authorization:Bearer <API-KEY>'\

--header 'Content-Type: application/json' (内容类型:应用程序/json

--data '{

"affise_device_id":"3d973489-e784-4f5d-8e51-9bee0ac16b00",

"random_user_id":"7ea344d0-643d-4670-8e57-e3b9ecb53a00",

"事件":{

"affise_event_id":"780df130-2302-4037-a628-ae087bcb2923",

"affise_event_name":"CustomId03"、

"affise_event_timestamp":1688046085325,

"affise_event_first_for_user": true、

"affise_event_user_data":"any_string"(任意字符串

"affise_event_data":{

"affise_event_custom_id_03":"any_name"、

"affise_event_custom_id_{03}_timestamp":1688046085325

}

}

}'


其中:

  • affise_device_id & random_user_id - 设备标识符。

  • affise_event_id - 每个事件的新 uuid。

  • affise_event_name - 参见其他文档中的有效值,例如 AddToCart 购买。

  • affise_event_timestamp - 发送事件的时间戳(毫秒或秒)。

  • affise_event_first_for_user - 默认为 false。

  • affise_event_user_data - 任何用户数据字符串。

  • affise_event_data - 可选,取决于 affise_event_name。

最简单的方法是

curl --request POST

--header 'Authorization:Bearer <API-KEY>'\

--data '{

"affise_device_id":"3d973489-e784-4f5d-8e51-9bee0ac16b00",

"event":{

"affise_event_name":"自定义 ID03"

}

}'

curl --request GET

--header 'Authorization:Bearer <API-KEY>'

🔎 如果用户根据 Google 的政策选择不共享 GAID,或者无法传递affse_device_idaffise _ random_id,则可以传递gaid_adidadid作为唯一的用户标识符。

例如

curl --request POST

--header 'Authorization:Bearer <API-KEY>'\

--header 'Content-Type: application/json' (内容类型:应用程序/json

--data '{

"gaid_adid":"39ae1572-055b-41c9-ba50-87d9e45f47d9",

"event":{

"affise_event_id":"780df130-2302-4037-a628-ae087bcb2923",

"affise_event_name":"CustomId07"、

"affise_event_timestamp":1688046085325,

"affise_event_first_for_user": true、

"affise_event_user_data":"any_string"(任意字符串

"affise_event_data":{

"affise_event_custom_id_07":"any_name"(任意名称

}

}

}'



curl --request POST\

--header 'Authorization:Bearer <API-KEY>'\

--header 'Content-Type: application/json' (内容类型:应用程序/json

--data '{

"adid":"D8CA4CF9-B475-4FA1-ADEB-8921D2431756",

"event":{

"affise_event_id":"780df130-2302-4037-a628-ae087bcb2923",

"affise_event_name":"StartTrial"、

"affise_event_timestamp":1688046085325,

"affise_event_first_for_user": true

}

}'

事件示例

购买事件

🔎adidgaid_adid应在安装时提前定义,以便向 Facebook (Meta)、GoogleAds (UAC)、TikTok 正确发送事件。

最大事件

curl --request POST

--header 'Authorization:Bearer <api-key>' \

--header 'Content-Type: application/json' (内容类型:应用程序/json

--data '{

"affise_device_id":"eb4cfa97-5266-4dea-b807-6a345c3ab900",

"random_user_id":"bd1f6259-3521-45dc-ac48-651b649c1598",

"gaid_adid":"GAID"、

"adid":"IDFA"、

"事件":{

"affise_event_name":"购买"、

"affise_event_timestamp":1688046085325,

"affise_parameters":{

"affise_p_content_ids":[123, 789],

"affise_p_content_id":"name"、

"affise_p_content_type":"类型"、

"affise_p_content_list":[{"key":"name"},{"value":"value"}]、

"affise_p_currency":"美元"、

"affise_p_quantity":6,

"affise_p_price":0.05,

"affise_p_revenue":0.3

}

}

}'

最小事件

curl --request POST\

--header 'Authorization:Bearer <api-key>' \

--header 'Content-Type: application/json' (内容类型:应用程序/json

--data '{

"affise_device_id":"eb4cfa97-5266-4dea-b807-6a345c3ab900",

"event":{

"affise_event_name":"购买"、

"affise_parameters":{

"affise_p_currency":"美元"、

"affise_p_quantity":6,

"affise_p_price":0.05,

"affise_p_revenue":0.3

}

}

}'

带有转换 ID 的事件

curl --request POST

--header 'Authorization:Bearer <api-key>' \

--header 'Content-Type: application/json' (内容类型:应用程序/json

--data '{

"affise_device_id":“eb4cfa97-5266-4dea-b807-6a345c3ab900",

"event":{

"affise_event_name":"贷款"、

"affise_parameters":{

"affise_p_conversion_id":"123",

"affise_p_customer_type":---,

"affise_p_customer_user_id": ---

}

}

}'

🔎 在合作伙伴回传中使用相应的宏:

  • {p_conversion_id}

  • {客户类型}

  • {p_customer_user_id}


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

这是否解答了您的问题?