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

运行机制

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

玩家流程

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

营收

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

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

适用对象

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

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

如何获取

设置带创作者标签的活动

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

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

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

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

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

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

管理带创作者标签的活动

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

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

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

  1. 将新圈内达人加入活动(可选)。

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

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

将圈内达人添加至活动

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

自行添加

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

  1. 按顺序调用创建圈内达人的创作者标签将圈内达人添加至活动方法。
  2. 要邀请圈内达人加入活动,请发送消息至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
响应
{
  "items": [
    {
      "creator_tag": "creatorOne",
      "revenue_share_percent": 5
    },
    {
      "creator_tag": "creatorTwo",
      "revenue_share_percent": 10
    },
    {
      "creator_tag": "creatorThree",
      "revenue_share_percent": 50
    }
  ],
  "total_count": 32
}

创建交易

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

参数类型描述
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"
  ]
}

本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
为此页面评分
为此页面评分
我们还有其他可改进之处吗?

不想回答

感谢您的反馈!
上次更新时间: 2021年7月20日

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

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!