> 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) ，只需最少的额外设置——只需要您的 program 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。对于大多数参与者，user ID 和 account ID 字段的值相同。                                                                                                                                                                                                                                                          |
| `userId`             | \[基于电子邮件地址的哈希 ID]                    | 正在为其构建此消息链接的用户 ID。对于大多数参与者，user ID 和 account ID 字段的值相同。                                                                                                                                                                                                                                                          |
| `programId`          | `21789`                              | 您的 program ID。可在 **项目规则** 页面上，位于项目名称下方找到。                                                                                                                                                                                                                                                                        |
| `rsLandingPage` （可选） | `https://example.com/driver-program` | <p>覆盖项目的落地页，将生成的分享链接重定向到其他 URL。</p><p>仅支持您项目落地页 URL 上不同的路径。出于安全原因，重定向不能指向其他域名。</p>                                                                                                                                                                                                                               |

{% hint style="info" %}
**示例：** 使用上述格式，以下是一个示例，说明对于具有 user ID 和 account 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.
