跳到主要内容

根据邮箱设置用户偏好选项

AddPreferencesByEmail：根据邮箱设置用户偏好选项。需在 SmartLink > 联系人 > 偏好 先创建好偏好选项，您可以根据用户偏好设置，为其推送用户感兴趣的内容。

POST /api/v3/userinfo/add_preferences_by_email

请求参数​

了解关于查询参数的更多信息，请参见 查询参数。

属性数据类型备注描述
emailstring必填邮箱
modify_tsbigint必填最后更新时间戳（以毫秒为单位）
preferences[]string必填用于标识联系人的订阅偏好，能够按兴趣和偏好等对订阅者进行分类。
用于用户分层，将邮件定向发送给具有特定偏好的用户：
  • 需在 SmartLink > 联系人 > 偏好 先创建好偏好选项，若导入不存在的偏好选项则会更新失败。
  • 以联系人最后更新的偏好为准，不受用户订阅状态影响。
  • 每个用户最多选择20个偏好选项。
  • 偏好只能增加，不会覆盖原来数据。

请求示例​

curl --request POST "https://openapi.smartlink.intlgame.com/api/v3/userinfo/add_preferences_by_email?gameid=${GAME_ID}&seq=${YOUR_RANDOM_STRING}&sig=${SIGNATURE}&ts=${TS}" \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "545058834@qq.com",
    "modify_ts": 1691225447577,
    "preferences": [
        "option1",
        "option2"
    ]
}'

响应参数​

属性数据类型描述
codeint返回码
msgstring返回消息

响应示例​

{
  "code": 0,
  "msg": "Success",
  "seq": "{YOUR_RANDOM_STRING}"
}