给我发短信

门控功能

给我发短信现在已关闭应用程序(TMTA)。如果您最近使用了此功能,则应将其列入白名单以继续使用它。如果尝试几次后仍无法发送和接收短信,请联系您的客户经理或 [受电子邮件保护] 并在主题行中包括"无法使用TMTA " 。

概述

当用户在桌面上点击您的链接时,他们可以选择给自己发送文本链接以下载您的应用程序。默认情况下,我们在每个“Branch”链接上都提供此功能,但您也可以创建自己的全品牌Text Me The App页面。

左:默认Branch。右:定制版本。

本文档将介绍如何创建自定义Text Me The App页面以及此产品的常规FAQ。

使用政策

分行保留限制您使用Text Me应用程序服务的权利,并有权自行决定收取短信费用。要了解这方面的分支机构'政策,请随时联系您的分支机构客户经理或 [受电子邮件保护] 以获得帮助。

设置

此设置将覆盖所有链接的默认桌面重定向行为

除非这是所需的行为,否则不要启用Custom Landing Page with SMS 切换。

如果你不'吨要使用科'的默认文字我的应用页面,或显示桌面deepview,按照这些指示。这将使您可以使用“Branch”来自定义“向我发送文本”应用程序页面。

设定目标网址

  1. 访问Branch仪表板上的桌面SMS 页面。
  2. 切换到On后,选择Custom Landing Page with SMS
  3. 输入目标网址。

图像

确保您可以访问此页面

因为您将对此URL进行更改,所以请确保您有权访问该页面并且可以对其HTML进行更改。

将SendSMS()代码段插入页面

在上一步中设置了目标URL后,请转到该页面并编辑HTML。将以下代码段粘贴到其中;这是一个功能齐全的网页,您可以将其用作“ Text Me The App”页面的模板。

<!DOCTYPE HTML>
<html lang="en-US">
<head>
<meta charset="UTF-8">
    <script type="text/javascript">
        (function(b,r,a,n,c,h,_,s,d,k){if(!b[n]||!b[n]._q){for(;s<_.length;)c(h,_[s++]);d=r.createElement(a);d.async=1;d.src="https://cdn.branch.io/branch-latest.min.js";k=r.getElementsByTagName(a)[0];k.parentNode.insertBefore(d,k);b[n]=h}})(window,document,"script","branch",function(b,r){b[r]=function(){b._q.push([r,arguments])}},{_q:[],_v:1},"addListener applyCode banner closeBanner creditHistory credits data deepview deepviewCta first getCode init link logout redeem referrals removeListener sendSMS setBranchViewData setIdentity track validateCode".split(" "), 0);

        branch.init('YOUR-BRANCH-KEY');
            function sendSMS(form) {
                var phone = form.phone.value;
                var linkData = {
                    tags: [],
                    channel: 'Website',
                    feature: 'TextMeTheApp',
                    data: {
                        'foo': 'bar'
                    }
                };
                var options = {};
                var callback = function(err, result) {
                    if (err) {
                        alert("Sorry, something went wrong.");
                    }
                    else {
                        alert("SMS sent!");
                    }
                };
                branch.sendSMS(phone, linkData, options, callback);
                form.phone.value = "";
            }
    </script>
</head>
<body>
        Send SMS
        <form onsubmit="sendSMS(this); return false;">
            <input id="phone" name="phone" type="tel" placeholder="(650) 123-4567" />
            <br/>
            <input type="submit"/>
        </form>
    </body>
</html>

在这里,您可以自定义HTML和CSS,Branch将负责其余的工作。如果要进一步自定义页面或SMS消息本身,请进一步阅读。

高级

使用Twilio短信服务

为了使用您的Twilio帐户进行设置,Branch需要以下信息来启用集成。

  • Branch App ID
  • 帐户SID
  • Auth Tokens
  • Twilio要发送的电话号码

请通过以上信息与您的CSM联系,以启用Twilio集成。

电话号码保留政策

电话号码是从Branch '的Twilio实例中删除的,但是如果您使用自己的SMS提供程序,则该提供程序可能会临时或无限期地存储电话号码。

使用自定义窗体与SendSMS()

如果您已有供用户输入其电话号码的表格,则可以在其后放置我们的Text Me The App。在您网站的<head></head> 标签内的某处添加以下代码。

<script type="text/javascript">
function sendSMS(form) {
  branch.sendSMS(
    phone: form.phone.text,
    {
      channel: 'Website',
      feature: 'Text-Me-The-App',
      data: {
        foo: 'bar'
      }
    },
    { make_new_link: false }, // Default: false. If set to true, sendSMS will generate a new link even if one already exists.
    function(err) { console.log(err); }
  );
}
</script>

当有人在您的表单中输入内容时,请调用sendSMS。

自定义短信内容

SMS消息的默认文本为"单击此处下载[App Name] {link} " 。

如果要自定义此消息,则“Branch”允许您为所有消息设置默认值,或为每个链接自定义消息。

自定义所有消息

您可以创建将发送自己的自定义默认消息,如果特定的链接点击的人没有按' T的定制消息本身。浏览回到 Branch仪表板上的Desktop SMS页面。您应该在下面看到以下部分。

图像

编辑此字段将修改发送的全部SMS

自定义链接特定的消息

如果你不'吨要编辑全局短信,您可以定义为每个链接一个特殊的短信。无论您是要切换其他区域的消息的语言,还是要包含设备的特定日期,都可以在链接编辑屏幕底部的 Deep Link Data 部分中指定消息。

图像

使用$custom_sms_text 参数,然后在值部分中输入您的自定义消息。确保在您的自定义消息中包含{{ link }} 标签!请阅读下面的情形,以了解实际情况。

FlowerPower的开发人员希望根据收件人所在的国家/地区自定义SMS消息。对于每个Branch链接,他们将在深度链接数据中指定不同的自定义消息。

对于法国的广告:
Cliquez pour télécharger FlowerPower ici {{ link }}

对于西班牙的广告:
Haz click aquí para descargar FlowerPower {{ link }}

对于德国的广告:
Klicken Sie auf das FlowerPower hier herunterladen {{ link }}

使用液体标签进一步自定义消息

通过使用液体标签,您几乎可以访问link ' s参数的任何值。定制选项仅受您的想象。

  • 标签{{ link }} 替换为您的“Branch”链接
  • {{ link.channel }}{{ link.campaign }} 输出渠道和广告系列(如果在创建链接时已设置)。
  • {{ link.data.key }} 将输出链接'的数据字典的参数,其中key 是参数的名称

这里以' s为例来说明这种情况。

Dmitri正在他的应用程序FlowerPower中创建Branch链接以深链接到每个不同的花朵。他将创建一个密钥/值对的密钥的每个链路flower 和花名称,例如Flower : RoseFlower : Tulip 。他想根据花朵的名称来自定义他的SMS消息,因此他将自定义链接消息设置为:

{{ link.data.flower }}在脑海中?点击此处为您的房屋购买一些! {{ link }}

图像

词汇表

SendSMS()参数

sendSMS() 方法需要一个电话号码和链接参数 。您可以选择指定配置选项和回调。

branch.sendSMS(
    phone,
    linkData,
    options,
    callback (err, data)
);

您使用用户'的电话号码填写此方法后,您的调用将类似于以下内容:

branch.sendSMS(
    phone: '9999999999',
    {
        tags: ['tag1', 'tag2'],
        channel: 'facebook',
        feature: 'dashboard',
        stage: 'new user',
        data: {
            foo: 'bar'
        }
    },
    { make_new_link: false }, // Default: false. If set to true, sendSMS will generate a new link even if one already exists.
    function(err) { console.log(err); }
});

设置液体标签的默认替换值

如果特定标记不是总是要填充的' ,则可以使用| 字符来指定默认值,以在链接字典中缺少该标记时回退。

例如 {{ link.data.author | default:"Alex" }}

如果找到link.data.author 信息为' t,则标记将仅替换为 Alex 而不是替换为空字符串。

常问问题

SMS速率限制是多少?

通过Branch发送SMS时,我们会强制执行以下速率限制:

  1. 一小时内有5条相同号码的短信。
  2. 一小时内来自同一IP的100个文本。

我可以将此服务用于国际电话号码吗?

是。 Branch使用Twilio发送SMS消息,这意味着SMS将会在世界范围内传递。但是,请注意,短信必须发送到的号码必须与发送短信的国家/地区相同。

我刚才给自己发了多条短信,但是只收到一开始的几条短信,这是为什么?

当运营商由于垃圾邮件将您的SMS过滤掉时,就会发生这种情况。我们将尽最大努力为特定用户设置速率,但是某些情况下运营商可能会阻止您的SMS。原因是如果相似并且重复发送到相同的号码,运营商将积极阻止内容。解决方案是等待24-48小时。

为什么我的(非美国)电话号码无法正常使用呢?

对于全数字,您需要使用" + "和国家/地区代码。如果您知道您的用户仅在某个国家/地区,则可以自动在" + "和国家/地区代码前面加上前缀,以便他们只需要输入常规号码即可。为此,您必须创建一个自定义“应用程序文本”页面。然后,您可以通过以下步骤在步骤2 更改代码段:

    var phone = "+91" + form.phone.value;

在上面的示例中, " +91 "是用户所在国家/地区的代码。

为什么从Text Me The App发送的SMS链接已过期?

通过“向我发送短信”应用功能生成的所有链接将在7天后失效。

大约一个月前更新

给我发短信


建议的编辑仅限于API参考页

您只能建议对Markdown正文内容进行修改,而不能建议对API规范进行修改。