Como configurar o programa com a tag de criador

Como funciona

A tag de criador é um código exclusivo que o jogador pode receber ao assistir transmissões no YouTube ou Twitch ou em outros formatos/serviços. O jogador (apoiador) pode usar essa tag durante as compras no jogo para apoiar seu criador favorito. A solução permite que você construa confiança e relacionamentos com criadores e aumente sua renda por meio da atribuição (rastreamento) de todas as compras no jogo.

Fluxo do jogador

1. O jogador copia a tag de criador ou segue o link para conectá-la a partir do serviço onde o criador compartilhou o código. O criador pode usar os seguintes serviços:
   • Twitch
   • YouTube
   • Facebook Gaming
   • outras redes sociais
2. O jogador insere a tag de criador no campo da página onde você implementou a conexão. Se o jogador clicar no link, a de criador será aplicada automaticamente.

Monetização

Você obtém renda de todas as compras no jogo. Uma parte do lucro do criador é deduzida de cada compra em que a tag de criador foi aplicada.

Quem pode usar

Parceiros que têm um jogo com:

• renda mensal esperada de pelo menos US $ 20.000
• bens disponíveis para compra apenas dentro do jogo

Como obtê-lo

Configuração de programa com a tag de criador

Para configurar um programa com uma tag de criador:

1. Envie uma inscrição para csm@xsolla.com (ou para bizdev@xsolla.com, se estiver integrando um produto Xsolla pela primeira vez) e aguarde o envio. Especifique as seguintes informações no aplicativo:
   • Nome do jogo.
   • Gênero.
   • Desenvolvedor (opcional).
   • Distribuidor (opcional).
   • Site oficial do jogo.
   • Descrição do jogo.
   • Steam App ID (opcional).
   • Data de lançamento, se o jogo ainda não tiver sido lançado (opcional).
   • Link para materiais promocionais (opcional).
   • Modelo de negócio:
     • premium
     • free-to-play
   • Plataforma:
     • PC
     • Steam
     • mobile
     • web
   • Período de participação do programa.
   • Porcentam de divisão de receita.
   • Fim da divisão de receita. O dia em que os criadores participantes deixarem de receber uma fatia da receita.
   • Lista de criadores. Para cada criador, especifique e-mail, canal de rede social e tag de criador. Considere as seguintes limitações ao escolher criadores:
     • O saque de fundos do saldo está disponível apenas para criadores com mais de 18 anos.
     • A Xsolla não trabalha com criadores cujas contas bancárias estão registradas em países sujeitos a sanções dos EUA.

2. Implemente o mecanismo de conexão da tag de criador pelo jogador de uma das seguintes maneiras:
   • Link. Nesse caso, o valor da tag de criador será carregado no campo de entrada específico automaticamente.
   • Usando Manual.

3. Determine onde estará a página com a tag de criador:
   • na interface do jogo
   • no site jogo de publicidade
   • na interface de pagamento toda vez que o jogador pagar por uma compra

4. Envie a csm@xsolla.com um link para a página na qual a tag de criador está conectada (se o mecanismo for implementado na interface ou no site do jogo).
5. No jogo, implemente mecanismos para vincular a tag de criador às compras dos apoiadores e rastrear essas compras.

Gerenciamento do programa com a tag de criador

Para gerenciar efetivamente um programa com a tag de criador:

1. Envie suas compras para o Xsolla regularmente usando o método de Criação de transações. A frequência recomendada para o envio desses dados é uma vez por dia.

2. Adição de novos criadores ao programa (opcional).

3. Usando o método de Envio de estatísticas por tag de criador, transfira para o Xsolla as informações sobre estatísticas dos apoiadores (opcional).

Adicionar criadores ao programa

Você pode adicionar criadores ao seu programa de uma das seguintes maneiras:

• por conta própria
• via Xsolla

Adicionar por conta própria

1. Chame os métodos Criação de tag de criador do criador e Adição de criador ao programa sequencialmente.
2. Para convidar um criador para o programa, envie uma mensagem para influencer@xsolla.com com e-mail, canal de rede social e tag de criador do criador usado no método Criação de tag de criador para criador.

Adicionar via Xsolla

Métodos de API para trabalhar com a tag de criador

Obtenção de criadores com a tag de criador

Obtém uma lista de criadores no programa com tags de criador.

Exemplo de solicitação:

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

Exemplo de resposta:

 1{
 2  "items": [
 3    {
 4      "creator_tag": "creatorOne",
 5      "revenue_share_percent": 5
 6    },
 7    {
 8      "creator_tag": "creatorTwo",
 9      "revenue_share_percent": 10
10    },
11    {
12      "creator_tag": "creatorThree",
13      "revenue_share_percent": 50
14    }
15  ],
16  "total_count": 32
17}

Criação de transações

Cria/atualiza transações às quais a tag de criador foi aplicada. Uma matriz dos seguintes objetos é passada no corpo da solicitação:

Exemplo de solicitação:

 1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6[
 7  {
 8    "transaction_id": "123456789",
 9    "creator_tag": "creatorOne",
10    "platform_id": "steam",
11    "user_id": "0123456",
12    "transaction_date": "2020-04-10T06:06:24.830Z",
13    "item_id": "GAME_sku_1",
14    "item_name": "hk416",
15    "transaction_currency_code": "USD",
16    "transaction_value": 5
17  },
18  {
19    "transaction_id": "123456788",
20    "creator_tag": "creatorOne",
21    "platform_id": "steam",
22    "transaction_date": "2020-04-10T06:06:24.830Z",
23    "item_id": "GAME_sku_2",
24    "item_name": "hk416",
25    "transaction_currency_code": "EUR",
26    "transaction_value": 10
27  },
28  {
29    "transaction_id": "123456781",
30    "creator_tag": "creatorOne",
31    "platform_id": "xbox",
32    "transaction_date": "2020-04-10T06:06:24.830Z",
33    "item_id": "GAME_sku_1",
34    "item_name": "hk416",
35    "transaction_currency_code": "USD",
36    "transaction_value": 3
37  }
38]

Cancelamento de transações

Cancela transações às quais a tag de criador foi aplicada. Uma matriz dos seguintes objetos é passada no corpo da solicitação:

Exemplo de solicitação:

 1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6[
 7  {
 8    "transaction_id": "123456789",
 9    "creator_tag": "creatorOne",
10    "platform_id": "steam",
11    "user_id": "0123456",
12    "transaction_date": "2020-04-10T06:06:24.830Z",
13    "item_id": "GAME_sku_1",
14    "item_name": "hk416",
15    "transaction_currency_code": "USD",
16    "transaction_value": 5
17  },
18  {
19    "transaction_id": "123456788",
20    "creator_tag": "creatorOne",
21    "platform_id": "steam",
22    "transaction_date": "2020-04-10T06:06:24.830Z",
23    "item_id": "GAME_sku_2",
24    "item_name": "hk416",
25    "transaction_currency_code": "EUR",
26    "transaction_value": 10
27  },
28  {
29    "transaction_id": "123456781",
30    "creator_tag": "creatorOne",
31    "platform_id": "xbox",
32    "transaction_date": "2020-04-10T06:06:24.830Z",
33    "item_id": "GAME_sku_1",
34    "item_name": "hk416",
35    "transaction_currency_code": "USD",
36    "transaction_value": 3
37  }
38]

Envio de estatísticas por tag de criador

Permite o envio de estatísticas sobre a conexão da tag de criador do criador (por dias). Essas informações serão publicadas na seção Statistics da Conta de Criador. Uma matriz dos seguintes objetos é passada no corpo da solicitação:

Exemplo de solicitação:

 1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/supporters HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6[
 7  {
 8    "date": "2020-04-10",
 9    "creator_tag": "creatorOne",
10    "new_supporters": 125,
11    "total_supporters": 35900
12  },
13  {
14    "date": "2020-04-10",
15    "creator_tag": "creatorTwo",
16    "new_supporters": 123,
17    "total_supporters": 34567
18  }
19]

Criação de tag de criador para criador

Permite criar tags de criador para novos criadores no programa. Uma matriz dos seguintes objetos é passada no corpo da solicitação:

Exemplo de solicitação:

 1PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6{
 7  "creator_tag": "creatorOne",
 8  "creator_email": "influencer@example.com",
 9  "creator_channels": [
10    "https://www.twitch.tv/creatorOne"
11  ]
12}

Adição de criador ao programa

Permite a adição de um novo criador ao programa. Uma matriz dos seguintes objetos é passada no corpo da solicitação:

Exemplo de solicitação:

1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals HTTP/1.1
2X-API-key: {YOUR_API_KEY}
3
4Content-Type: application/json
5
6{
7  "creator_tag": "creatorOne",
8  "revenue_share": 30
9}