使用OneLink API通过自有媒体进行推广

高阶付费

概要:OneLink API可以生成大量的个性化链接,用于大规模的广告投放,帮助您提高自有媒体的利用率,有效吸引终端用户。该解决方案需要市场人员和开发人员共同实施。

OneLink API

OneLink API的用途如下:

 示例

一个名为Feed Me的生鲜配送服务平台希望通过短信向现有用户发送个性化链接,引导他们下载其应用并在应用中购买香蕉。Feed Me通过OneLink REST API根据用户所在的国家配置了自定义OneLink链接,其中包含用户所在国家、用户身份和香蕉特卖的详细信息。

OneLink API的调用频次上限取决于您的账户类型。您可以在OneLink API面板中查看您已经使用的次数以及剩余额度。

如需提高API调用频次上限,请联系您的CSM。

设置

请按以下方式设置OneLink API:

  1. 创建一个OneLink模板
  2. 复制OneLink模板ID。 

  3. 复制OneLink API token。为了保障数据安全,必须由管理员用户来提取这个API key,因为账户下的其他用户没有API key的访问权限。
  4. 将OneLink ID和OneLink API token发送给开发人员。
  5. 请让开发人员按照开发者资源中心中的指南进行操作

面板

OneLink API面板会显示日度、月度和季度的API使用情况。

OneLink API面板的查看方式如下

从AppsFlyer后台的侧边栏中选择互动 > OneLink API

特点与局限性

特点

说明

API调用频次限制

  • 使用OneLink API创建、编辑或删除OneLink链接的频次限制为每个账户每月(以UTC时间为准)750万次。
  • 超过该限额的所有请求AF皆不会响应,也不会创建相应的链接;调用API后会返回错误状态码429,报错消息为“Monthly quota exceeded”(超过月度限额)。
  • 如需了解限额使用情况以及剩余额度,请在OneLink API面板中查看。

频次限制

  • 账户层级的API请求频次为每秒500次(每分钟3万次)。
  • 超过每秒500个请求(每分钟3万次)的限额后,AF就不会响应任何请求,也不会创建相应的链接;调用API后会返回错误状态码429,报错消息为“Monthly quota exceeded”(超过月度限额)。

链接可见性

  • 通过该API创建的链接不会出现在AppsFlyer面板的OneLink自定义链接列表中。
  • 推荐方式:将通过API创建的链接保存到本地图表,便于后续查看使用。

TTL 

  • 通过OneLink API的OneLink短链默认有效期(TTL)为31天。每次有用户点击该链接时,有效期就会自动延长31天。若有用户在TTL过期后点击链接,该链接仍可根据您设定的OneLink基础配置进行跳转,但无法再进行归因。
    • OneLink短链会在TTL过期后的48小时内完成删除。
  • TTL的上限为31天。即使您设置了超过31天的TTL值,这个值仍会自动还原到默认的31天。
  • 如需更改默认TTL,可以添加参数ttl={value},指定TTL的天数、小时数或分钟数。比如ttl=7dttl=12httl=10m
  • 您可以通过发送更新请求来设定TTL。发送更新请求后,AF会将现有链接的TTL重置为请求主体(request body)中指定的值。
    • 也就是说发送该请求后,TTL会被替换为您指定的值。举例来说,假设目前您现有链接的TTL值为29d,这时您发送了一个TTL值为2d的更新请求,那么这些链接的TTL值就会变成TTL=2d(而非31d)。
    • 发送更新请求可以延长归因链接的效期。举例来说,假设您目前的链接TTL为20d,且距该链接上线已有5天,这时您发送一个TTL为31d的更新请求,那么该链接的TTL会从更新发生的时间开始重新计算这31天。
  • 如果您不想让TTL自动延期,请在链接中添加renew_ttl=false参数。该参数的值为布尔值,即true(默认值)或false。
  • renew_ttl参数不会出现在实际链接中。

特殊字符

使用API创建链接时,若使用以下字符,须对其编码:;、*、!、@、#、?、$、^、:、&、~、`、=、+、'、>、<、/
若未编码,这些字符会变成空格,且相关链接及其功能可能无法正常生效。


请注意: 用户点击链接后,下列3个参数仍会保持编码后的状态,不会被解码:

  • af_dp
  • deep_link_value
  • deep_link_sub1

有效信息

有效信息(payload)中的查询参数字符串不能超过2048个字符。

URL ID

您可以更改URL ID(即短链ID),以凸显您的推广内容,如:https://myapp.onelink.me/abc123/apples。URL ID不能超过50个字符,可以同时包含字母和数字。默认长度为8个字符。

请注意:

  • 您仅可更改当前未被使用的URL ID。
  • 如果相关的URL ID已经在使用中,则调用API后无法创建链接,并返回错误响应码(400)。发生这种情况时,您需要与您的开发人员共同决定后续如何配置。
  • 即使调用失败,仍会从您的月度API限额中扣除相应的次数。