Skip to content

网络钩子

Webhook 可让 Aimtell 在事件发生的那一刻通知您的服务器。每当您选择的事件发生时,我们都会向您控制的 URL 发送请求,并将事件的详细信息作为 URL 参数附加其中。如果您希望将推送活动存储在自己的数据库中、同步到 CRM,或在您的系统中触发某些操作,这将非常有用。

您可以为以下三种类型的事件创建 Webhook:

  • 新订阅者 - 有人订阅了您的推送通知
  • 推送通知点击 - 订阅者点击了您的某条通知
  • 推送通知展示 - 通知向订阅者展示

设置 Webhook

  1. 点击侧栏中的网站
  2. 选择要进行此设置的网站旁边的编辑
  3. 打开页面顶部的 Webhooks 选项卡
  4. 点击添加 Webhook,选择类型,输入所需的 URL,然后按保存

您可以为已设置 Web 推送的任何网站设置多个 Webhook。

Image

我们发送的内容

Webhook 以 POST 形式发送,并添加以下 URL 参数:

新订阅者

URL 参数说明
id_site网站 ID
subscriber_uid订阅者 ID
webhook_source静态文本 - aimtell.com

示例

https://yoursite.com?id_site=33&subscriber_uid=0fc77bb3-4c07-42bd-dfe9-04031f1b4d2b&webhook_source=aimtell.com

推送通知点击

URL 参数说明
id_site网站 ID
campaign_id营销活动 ID
subscriber_uid订阅者 ID
push_source静态文本 - aimtell.com

示例

https://yoursite.com?id_site=33&campaign_id=100313&subscriber_uid=0fc77bb3-4c07-42bd-dfe9-04031f1b4d2b&push_source=aimtell.com

推送通知展示

URL 参数说明
id_site网站 ID
campaign_id营销活动 ID
subscriber_uid订阅者 ID
push_source静态文本 - aimtell.com

示例

https://yoursite.com?id_site=33&campaign_id=100313&subscriber_uid=0fc77bb3-4c07-42bd-dfe9-04031f1b4d2b&push_source=aimtell.com

Webhook 变量(高级)

如果您想在推送通知点击和推送通知印象的 Webhook 中传递一些附加信息,您可以利用可用的附加 Webhook 变量。只需将下面列出的 URL 参数添加到 Webhook URL 中即可传递与其关联的数据。

Webhook 变量说明
{title}推送标题
{body}推送正文
{link}目的地链接
{push_type}推送活动的类型(RSS、手动等)
{browser}浏览器

参数名称由您自行决定,只需将每个参数的值设置为所需的变量即可。例如,以下 Webhook URL:

https://yoursite.com/hook?title={title}&body={body}&push_type={push_type}&browser={browser}

发送到您的服务器时大致如下所示:

https://yoursite.com/hook?title=Your%20order%20shipped&body=Track%20it%20here&push_type=manual&browser=chrome&id_site=33&campaign_id=100313&subscriber_uid=0fc77bb3-4c07-42bd-dfe9-04031f1b4d2b&push_source=aimtell.com

注意:上述变量仅在“通知点击”和“通知展示”Webhook 中有效。