如何设置带创作者标签的活动

运行机制

创作者标签是玩家在YouTube、Twitch或其他格式/服务平台上观看直播时收到的一个唯一代码。玩家（支持者）在进行游戏内购买时使用该代码来支持其喜欢的圈内达人。本解决方案可帮助您建立与圈内达人之间的信任与合作，并通过对所有游戏内购买进行归因（溯源）来提高收入。

玩家流程

玩家在圈内达人分享了标签的服务平台上复制创作者标签或点击链接进行关联。圈内达人可使用以下服务平台：
- Twitch
- YouTube
- Facebook Gaming
- 其他社交网络
玩家在已实现连接的页面字段中输入创作者标签。如果玩家采用点击链接的方式，则创作者标签将自动应用。

营收

您可以从所有游戏内购买中获得收入。对于购买时应用了创作者标签的交易，将扣除给圈内达人的收入分成。

游戏平台和支付系统可能对交易收取额外佣金。

适用对象

具有符合以下条件的游戏的合作伙伴：

每月预期收入在20000美元以上
商品只能在游戏中进行购买

如何获取

设置带创作者标签的活动

要设置带创作者标签的活动：

向csm@xsolla.com发送申请（如果是首次集成艾克索拉产品，请发送申请至bizdev@xsolla.com）并等待回复。在申请中指定以下信息：
- 游戏名称。
- 类型。
- 开发商（选填）。
- 发布商（选填）。
- 游戏官方网站。
- 游戏描述。
- Steam App ID（选填）。
- 发布日期（如果游戏尚未发布），选填。
- 推广材料链接（选填）。
- 业务模式：
  - 付费
  - 免费
- 游戏平台：
  - PC
  - Steam
  - 移动端
  - Web
- 活动参与有效期。
- 收入分成百分比。
- 收入分成结束时间。参与活动的圈内达人停止获得收入分成的时间。
- 圈内达人列表。指定每个圈内达人的邮箱、社交网络频道和创作者标签。选择圈内达人时请考虑以下限制条件：
  - 只有超过18岁的圈内达人才允许提现操作。
  - 艾克索拉不与银行账户注册在美国制裁国家/地区的圈内达人合作。

实现玩家与创作者标签的关联机制，可为以下方式之一：
- 通过点击链接。如采用此方式，创作者标签值将自动载入指定输入字段。
- 采用手动输入方式。

决定创作者标签所在的页面：
- 游戏界面中
- 游戏推广网站上
- 玩家每次进行购买的支付界面中

建议在游戏界面中实现创作者标签关联以便在玩家下单时自动应用标签。

向csm@xsolla.com发送连接了创作者标签的页面的链接（如果关联机制在界面或游戏网站上实现）。
在游戏中，实现创作者标签与支持者购买的关联机制以及购买跟踪机制。

管理带创作者标签的活动

要有效管理带创作者标签的活动：

使用创建交易方法定期将购买数据发送给艾克索拉。建议数据发送频率为一天一次。

如果应用了创作者标签的交易发生退款，请使用取消交易方法将该信息发送给艾克索拉。

将新圈内达人加入活动（可选）。

如果通过艾克索拉来添加圈内达人，请定期使用获取有创作者标签的圈内达人方法上传其列表。建议数据获取频率为一天一次。

使用按创作者标签发送统计数据方法将支持者的统计数据发送给艾克索拉（可选）。

将圈内达人添加至活动

可通过以下方式之一将圈内达人添加至活动：

自行添加
通过艾克索拉

自行添加

要自行将圈内达人添加至活动：

按顺序调用创建圈内达人的创作者标签和将圈内达人添加至活动方法。
要邀请圈内达人加入活动，请发送消息至 influencer@xsolla.com，并在其中包含创建圈内达人的创作者标签方法中用到的圈内达人邮箱、社交网络频道和创作者标签。

通过艾克索拉添加

要通过艾克索拉将圈内达人添加至活动，请发送消息至 influencer@xsolla.com，并指定圈内达人的邮箱、社交网络频道以及要分配给圈内达人的创作者标签。

操作创作者标签的API方法

获取有创作者标签的圈内达人

获取活动中有创作者标签的圈内达人列表。

参数	类型	描述
limit	integer	列表中的圈内达人数量（默认值：`20`，最大值：`100`）。
offset	integer	加载列表中的圈内达人时发生的偏移量值（默认值：`0`）。

Copy

Full screen

Small screen

GET https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals?limit=3&offset=0 HTTP/1.1

创建交易

创建/更新应用了创作者标签的交易。在请求正文中传入以下对象数组：

参数	类型	描述
creator_tag	string	圈内达人在活动中的唯一代码。必需。
transaction_id	string	交易ID。必需。
transaction_currency	string	交易使用的币种的代码。参照ISO 4217标准的三字母货币代码。必需。
transaction_value	number	交易金额。必需。
transaction_date	string	交易日期，格式为`YYYY-MM-DD’T’HH:MM:SS`。必需。
platform_id	string	交易发生的平台。必需。
user_id	string	玩家ID。必需。
item_id	string	所购商品ID。必需。
item_name	string	所购商品名称。必需。

Copy

Full screen

Small screen

PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {
    "transaction_id": "123456789",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "user_id": "0123456",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 5
  },
  {
    "transaction_id": "123456788",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_2",
    "item_name": "hk416",
    "transaction_currency_code": "EUR",
    "transaction_value": 10
  },
  {
    "transaction_id": "123456781",
    "creator_tag": "creatorOne",
    "platform_id": "xbox",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 3
  }
]

取消交易

取消应用了创作者标签的交易。在请求正文中传入以下对象数组：

参数	类型	描述
transaction_id	string	要取消的交易的ID。必需。
refund_id	string	退款的External ID。
reason	string	退款原因。
refund_date	string	退款日期，格式为`YYYY-MM-DD’T’HH:MM:SS`。必需。

Copy

Full screen

Small screen

PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {
    "transaction_id": "123456789",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "user_id": "0123456",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 5
  },
  {
    "transaction_id": "123456788",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_2",
    "item_name": "hk416",
    "transaction_currency_code": "EUR",
    "transaction_value": 10
  },
  {
    "transaction_id": "123456781",
    "creator_tag": "creatorOne",
    "platform_id": "xbox",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 3
  }
]

按创作者标签发送统计数据

允许发送圈内达人关联的创作者标签的统计数据（按天发送）。该信息将显示在圈内达人帐户中的统计数据部分。在正文中传入以下对象数组：

参数	类型	描述
date	string	创作者统计数据的发送日期，格式为`YYYY-MM-DD`。必需。
creator_tag	string	圈内达人在活动中的唯一代码。必需。
new_supporters	integer	使用了该圈内达人创作者标签的新玩家的数量。必需。
total_supporters	integer	使用了该圈内达人创作者标签的所有玩家的数量。必需。

Copy

Full screen

Small screen

PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/supporters HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {
    "date": "2020-04-10",
    "creator_tag": "creatorOne",
    "new_supporters": 125,
    "total_supporters": 35900
  },
  {
    "date": "2020-04-10",
    "creator_tag": "creatorTwo",
    "new_supporters": 123,
    "total_supporters": 34567
  }
]

创建圈内达人的创作者标签

允许为活动中的新圈内达人创建创作者标签。在请求正文中传入以下对象数组：

参数	类型	描述
creator_tag	string	圈内达人在活动中的唯一代码。必需。
creator_email	string	圈内达人的邮箱。必需。
creator_channels	array of strings	圈内达人在社交网络中的频道链接。可以包含多个频道。必需。

Copy

Full screen

Small screen

PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

{
  "creator_tag": "creatorOne",
  "creator_email": "influencer@example.com",
  "creator_channels": [
    "https://www.twitch.tv/creatorOne"
  ]
}

将圈内达人添加至活动

允许将新圈内达人添加至活动。在请求正文中传入以下对象数组：

参数	类型	描述
creator_tag	string	圈内达人在活动中的唯一代码。必需。
revenue_share	integer	对于应用了创作者标签的每次购买，圈内达人可从中赚取的收入百分比。必需。

Copy

Full screen

Small screen

PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

{
  "creator_tag": "creatorOne",
  "creator_email": "influencer@example.com",
  "creator_channels": [
    "https://www.twitch.tv/creatorOne"
  ]
}

感谢您的反馈！

我们会查看您的留言并运用它改进用户体验。

上次更新时间: 2024年1月22日

发现了错别字或其他内容错误？请选择文本，然后按Ctrl+Enter。

Your browser is not supported. Please try a different browser

回答基于以下来源:

向我们提供反馈（可选）

向我们提供反馈（可选）

流量联盟

如何设置带创作者标签的活动

运行机制

玩家流程

营收

适用对象

如何获取

设置带创作者标签的活动

管理带创作者标签的活动

将圈内达人添加至活动

自行添加

通过艾克索拉添加

操作创作者标签的API方法

获取有创作者标签的圈内达人

limit

offset

创建交易

creator_tag

transaction_id

transaction_currency

transaction_value

transaction_date

platform_id

user_id

item_id

item_name

取消交易

transaction_id

refund_id

reason

refund_date

按创作者标签发送统计数据

date

creator_tag

new_supporters

total_supporters

创建圈内达人的创作者标签

creator_tag

creator_email

creator_channels

将圈内达人添加至活动

creator_tag

revenue_share