> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/message-links-explained.md).

# 消息链接说明

<a href="https://pxa.impact.com/student/activity/2359755?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">参加 PXA 课程</a>

消息链接允许你的客户倡导者将预先格式化的消息分享到各种社交媒体平台。每条消息都包含你预先编写的文案，并且可以包含你倡导者的唯一分享链接。消息链接可包含在：

* 程序小组件
* 事务性电子邮件
* 你的网站或应用，作为嵌入式链接或按钮
* 外部电子邮件营销活动

<details>

<summary>调整消息链接内容</summary>

1. 在左侧导航菜单中，选择 ![](/files/209022bdb234289211a24a980f6227a8684cc439) **\[Engage] → 项目规则**.
2. 在 *程序规则* 屏幕上，选择 **分享** 选项卡。
3. 如果你正在使用一个 *托管的* Open Graph 源，则更新 **标题**, **描述**，以及 **图片** 这将显示给最终用户。
4. 在 *其他分享媒介* 部分，选择所有你想为其设置消息的相关分享媒介，并在 *分享正文* 部分。

   <div data-with-frame="true"><figure><img src="/files/9a902874c0f27b10a3c140a8eef416c7c0a0310c" alt="" width="563"><figcaption></figcaption></figure></div>
5. 选择 **保存分享消息** 以保存你的内容。

现在，你的消息链接可以包含在你的推荐计划的小组件和事务性电子邮件中，或者嵌入到你的网站、应用或电子邮件营销活动中的其他位置。

</details>

<details>

<summary>将消息链接添加到程序触点</summary>

内容编辑器允许你将消息链接添加到你的 [程序小组件](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-experiences/customize-program-widgets.md) 和 [事务性电子邮件](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/email-experiences/create-and-customize-advocate-program-emails.md) ，只需极少的额外设置——只需要你的程序 ID。要在其他地方插入消息链接，你可以嵌入一个遵循以下格式的链接。

```programlisting
https://app.referralsaasquatch.com/a/ 
{tenant_alias}/message/redirect/{share_medium}
?engagementMedium={engagement_medium}&accountId= 
{accountId}&userId={userId}&programId=
{program_ID}&rsLandingPage= {rsLandingPage}
```

花括号中的信息 **{ }** 应替换为受支持的参数值之一。

{% hint style="info" %}
**注意：** “ `accountId` 和 `userId` 值必须从你的程序数据中动态填充。如果你需要帮助提取这些数据，请联系你的开发团队。
{% endhint %}

| 参数                   | 示例                                   | 说明                                                                                                                                                                                                                                                                                                               |
| -------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tenant_alias`       | `test_bpinhag9gag`                   | <p>你的程序租户别名。要查找你的租户别名：</p><p>1. 从顶部导航栏中选择 <img src="/files/34cff7cafbbfcd416778a35b63cb058c27bcda8b" alt=""> <strong>\[用户资料] → 设置</strong>.</p><p>2. 在左侧，下面 <em>Advocate 设置</em>下，选择 <strong>常规</strong>.</p>                                                                                                    |
| `share_medium`       | `WHATSAPP`                           | <p>倡导者将通过此媒介分享此推荐。</p><p>支持的值：</p><p>• <code>EMAIL</code></p><p>• <code>FACEBOOK</code></p><p>• <code>FBMESSENGER</code></p><p>• <code>LINEMESSENGER</code></p><p>• <code>LINKEDIN</code></p><p>• <code>PINTEREST</code></p><p>• <code>SMS</code></p><p>• <code>TWITTER</code></p><p>• <code>WHATSAPP</code></p> |
| `engagement_medium`  | `EMBED`                              | <p>倡导者与推荐计划互动的媒介（例如，嵌入式小组件）。</p><p>支持的值：</p><p>• <code>EMAIL</code></p><p>• <code>EMBED</code></p><p>• <code>MOBILE</code></p><p>• <code>POPUP</code></p>                                                                                                                                                        |
| `accountId`          | \[基于电子邮件地址的哈希 ID]                    | 正在为其构建此消息链接的账户 ID。对于大多数参与者，用户 ID 和账户 ID 字段的值相同。                                                                                                                                                                                                                                                                  |
| `userId`             | \[基于电子邮件地址的哈希 ID]                    | 正在为其构建此消息链接的用户 ID。对于大多数参与者，用户 ID 和账户 ID 字段的值相同。                                                                                                                                                                                                                                                                  |
| `programId`          | `21789`                              | 你的程序 ID。可在 **程序规则** 程序名称下方的页面中找到。                                                                                                                                                                                                                                                                                |
| `rsLandingPage` （可选） | `https://example.com/driver-program` | <p>覆盖程序的落地页，将生成的分享链接重定向到其他 URL。</p><p>仅支持程序落地页 URL 上不同的路径。出于安全原因，重定向不能指向其他域。</p>                                                                                                                                                                                                                                 |

{% hint style="info" %}
**示例：** 使用上述格式，以下是拥有用户 ID 和账户 ID 的参与者的消息链接 URL 示例： `messageLink` 在 impact.com 演示程序中， `klip-referral-program`。此链接将通过电子邮件提供，以便参与者通过移动链接分享。

```programlisting
https://app.referralsaasquatch.com/a/test_aut32av0b11uc
/message/redirect/EMAIL?engagementMedium=
MOBILE&accountId=messageLink&userId=
messageLink&programId=klip-referral-program
```

{% endhint %}

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/message-links-explained.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
