## 应用信息
进入【应用设置】-【应用信息】页面，可以查看应用包名、AppKey 等详细的应用信息。

- 应用包名和 AppKey 可用于 SDK 集成， AppKey 和 Master Secret 可用于API 调用。
- 点击“编辑”可以更改应用名称或删除应用，点击“显示”可以查看 Master Secret。
- 点击“重置”可以重新生成 Master Secret，重置后需要及时更改 Rest API 的鉴权参数，否则将会调用失败，请谨慎使用“重置”功能。

![image.png](https://res.theengagelab.com/docs/yuque/0/2022/png/21780123/1670493871131-0270c439-0863-47f4-b720-285033129bb0.png)
## 集成设置
### 填写网站域名
Web 推送只支持 https 协议，域名地址请勿输入首页面地址外的其它地址，支持批量添加，最多可添加100个域名。
![alt text](https://res.engagelab.net/docs/20241017/065422513/1714.25.54.png)

### 高级推送设置

![alt text](https://res.engagelab.net/docs/20241017/065422513/1714.14.27.png)
![alt text](https://res.engagelab.net/docs/20241017/065422513/1714.24.31.png)

1. **通知点击行为控制**：提升用户体验，确保用户点击通知时能够得到合适的跳转行为，减少干扰。  

- 导航到新标签页：点击通知会始终在新标签页中打开通知内容。
- 聚焦已有标签页：如果已打开与通知内容匹配的标签页则会切换到该标签页，不刷新页面，否则会打开一个新的标签页。
- 请注意Safari浏览器的通知，无论配置何种通知点击跳转策略，都会在新的标签页打开。

2. **自定义 Service Workers**：增强网站通知稳定性，避免因错误配置导致用户流失或通知异常显示。  

⚠️ **警告：建议您在网站上线后就不要再更改该设置，以避免订阅者流失和通知异常显示问题。默认情况下，Service Worker 应该存储在网站的根目录中。除非您的网站配置有特殊要求需要更改，否则我们强烈建议保持默认设置。**

3. **Safari 推送证书支持**：为面向 Safari 15 及以下版本用户的开发者提供灵活性，并通过共享证书简化配置流程。  

- 仅当您计划面向 Safari 15 或更早版本的用户推送通知时，才需要此证书。默认情况下，如果您不上传自己的证书，我们会为您提供共享证书。

## 通知授权配置
需要用户同意  Web 端通知授权后，才可以展示通知，目前支持直接申请、引导申请、自定义三种方式。申请 Web 端推送权限，一旦被用户拒绝授权，将无法再次发起申请，强烈建议在向用户申请 Web 推送权限前，通过「引导申请」软提示告知用户通知的价值！

EngageLab提供了“引导配置提示”，这些提示会在原生授权提示框之前显示，并引导用户选择他们感兴趣的消息类别。这些提示不会替代原生提示框，也不会订阅用户的Web推送通知。这些提示非常有益，因为它们增加了用户保持订阅您的消息的可能性，并且受到浏览器的高度推荐。授权提示有三个作用：

 - 向用户介绍订阅推送通知的价值。
 - 防止用户被阻止订阅。
 - 用户表示允许通知的意愿再触发原生提示。

### 引导配置

进入【WebPush】-【基础设置】-【通知授权配置】，配置方式选择引导申请，参数配置说明如下：

#### 支持多语言文案

支持添加多种语言的文案：我们会自动检测终用户的浏览器语言,若未设置其他语言,将会给所有目标用户发送[默认]语言设置的内容。
![alt text](https://res.engagelab.net/docs/20240906/035221926/2024-09-0611.19.47.png)

#### 授权弹窗展示间隔逻辑

用户第一次关闭软提示弹窗后，如果没有完成订阅，系统将在设定的初始间隔（默认3天）后再次显示该弹窗。如果用户在再次显示的弹窗中依旧没有完成订阅，则会根据后续间隔弹窗设定时间（默认7天）循环显示，直到用户状态变成已订阅。

- 初始间隔弹窗：默认3，可输入范围为0-7天。
- 后续弹窗间隔：默认7，可输入范围为0-15。

![alt text](https://res.engagelab.net/docs/20240906/035221926/2024-09-0611.36.01.png)

#### 分类提示
通过自动为选择推送订阅的用户打上标签，您可以根据他们的兴趣进行细分和个性化消息。这意味着您可以根据用户的兴趣和偏好，将推送消息进行个性化定制，从而提高用户参与度和满意度。标签功能可以帮助您更好地了解用户，以便针对不同群体发送相关内容，增强用户体验和互动。

开发者可以为每个用户提供最多 10 个消息类别，以供选择显示对某些消息主题的兴趣。

这些类别应与特定功能、产品或话题相关。例如，可以让用户选择订阅新闻简报、接收新销售和产品的通知，或特定话题如突发新闻、财经、政治、娱乐等。

- label/标签：类别在弹出上显示的文案。
- 对应的tag key：EngageLab中的标签是什么。

#### 更新用户的类别选择

在用户订阅推送后，开发者可以根据需要多次显示类别提示，例如初始化后调用：

```
MTpushInterface.promptPushCategories();
```

授权弹窗再次显示的时候，同一个用户更新了自己选择的消息标签分类，比如「取消勾选新闻信息」、「选择勾选折扣信息」，那么系统将该用户的新闻信息对应的标签与该用户解绑，绑定折扣信息对应的标签。

- 更新说明：如果选择在用户订阅推送后再次显示类别提示，则将显示更新说明，而不是操作消息。这允许您通知用户可以更新其类别。

![alt text](https://res.engagelab.net/docs/20240906/035308533/2024-09-0611.38.57.png)

### 直接申请
直接申请即直接调起浏览器的通知授权接口，若用户同意即可展示通知，若用户拒绝授权，将无法再次发起申请。

- 延迟*秒：表示访客打开您的网站后，将根据您配置的延迟时间显示订阅请求 promt。举例：如果配置为 0 表示立即提示；如果配置为5则表示延迟5秒提示。
- 访问*次：表示您可以要求用户在重复访问您的网站时订阅 web 推送通知。举例：配置为 1 表示初次访问才提醒；配置为 3 表示前 3 次访问才提醒。

![image.png](https://res.theengagelab.com/docs/yuque/0/2022/png/21780123/1670493917195-ee951c85-a838-4a30-8bad-911bbc983d0f.png)

### 自定义
如果选择自定义方式，您需要在您的 Web 站点自定义页面弹框样式，并通过以下方式告知系统它是属于您的自定义样式。![image.png](https://res.theengagelab.com/docs/yuque/0/2022/png/21780123/1670493978246-f12452a3-d850-4ee4-b67f-cff5a6d65b4c.png)