应用内消息事件
有三种event.kind
类型的应用内消息事件:
- 应用内展示 -
message.iam.impression
- 应用内点击 -
message.iam.clicked
- 应用内页面显示 -
message.iam.page_displayed
应用内展示
此事件在消息完成加载并显示在屏幕上后立即触发。 使用轮播时,您可以使用event.data.page_name
和event.data.page_id
获取显示的特定页面的名称和UUID。
应用内点击
此事件适用于任何具有点击操作的元素或块(也称为”目标”)。您可以使用event.data.target_name
和event.data.target_id
获取被点击的特定目标的名称和UUID,以及使用event.data.page_name
和event.data.page_id
获取目标所属的页面。
有关详细信息,请参阅应用内点击操作。
应用内页面显示
这是一个仅适用于轮播的事件。您可以使用event.data.page_name
和event.data.page_id
获取显示的特定页面或卡片的名称和UUID。第一张卡片的展示在文档完成加载后立即触发。后续页面展示在滑动时触发。
应用内消息事件数据
每个event.kind
可以根据您创建应用内消息的方式包含额外的事件数据。
当
event.kind
为clicked
或page_displayed
时显示的页面或卡片的名称。对于impression
事件不可用。page_name
有助于了解显示了哪个页面以及在该页面上点击了什么。页面名称默认为”Card 1”、“Card 2”等,但您可以在块编辑器中更改名称。
创建您的应用内消息事件流
设置事件流
查看事件流设置说明,以获取设置和个性化事件流的指导。以下提供了配置事件流的IAM特定步骤(第3步)。确保您要跟踪的目标设置正确
为了在事件流请求正文中利用自定义名称,您必须在块编辑器或HTML编辑器中手动指定新的自定义名称。在自定义名称功能发布之前已存在的应用内消息将无法在事件流中公开page_name
和target_name
值,直到应用内消息为每个页面或块更新自定义名称。
应用内消息更新后,从那一刻起触发的事件流请求将可以访问这些值。在任何时候,page_name
和target_name
值都将反映当时应用内消息的自定义名称状态,如果应用内消息再次更新,这些值可能会发生变化。
- 块编辑器
- HTML编辑器
所有三种事件都可以与此编辑器一起使用。使用块编辑器时,确保目标包含应用内点击操作。目标包括图像、按钮、关闭按钮和背景块。文本块目前不支持点击操作,因此不包括在内。目标自定义名称应该是唯一的,以避免在仪表板体验中造成混淆。
使用唯一ID
最佳实践:将事件流用于分析目的时,使用message.id
、page_id
和target_id
来验证唯一性。可以使用自定义名称,但它们旨在帮助以人类可读的格式区分一个IAM中的元素。如果您有多个应用内消息,请使用message.id
来区分它们。