使用第三方系统存储应用程序中发生的事件(注册、购买、定金等)的数据是一种常见情况。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_id
或affise
_
random_
id,则可以传递gaid_adid
或adid
作为唯一的用户标识符。
例如
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
}
}'
事件示例
购买事件
🔎adid和gaid_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]。