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 influenciador favorito. A solução permite que você construa confiança e relacionamentos com influenciadores 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 influenciador compartilhou o código. O influenciador 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 influenciador é deduzida de cada compra em que a tag de criador foi aplicada.

Observação
A plataforma do jogo e o sistema de pagamento podem cobrar comissão adicional sobre pagamentos.

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 orograma.
    • Porcentam de divisão de receita.
    • Fim da divisão de receita. O dia em que os influenciadores participantes deixarem de receber uma fatia da receita.
    • Lista de influenciadores. Para cada influenciador, especifique e-mail, canal de rede social e tag de criador. Considere as seguintes limitações ao escolher influenciadores:
      • O saque de fundos do saldo está disponível apenas para influenciadores com mais de 18 anos.
      • Xsolla não trabalha com influenciadores cujas contas bancárias estão registradas em países sujeitos a sanções dos EUA.

  1. 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.

  1. 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
Observação
Recomenda-se implementar a conexão da tag de criador na interface do jogo para que o código seja aplicado automaticamente à compra de cada jogador.
  1. 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).
  2. 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.
Observação
No caso de reembolso de uma compra com tag de criador, passe essas informações para a Xsolla usando o método de Cancelamento de transações.
  1. Adição de novos influenciadores ao programa (opcional).
Observação
Se você adicionar influenciadores via Xsolla, carregue a lista regularmente usando o método de Obtenção de influenciadores com a tag de criador. A frequência recomendada de aquisição de dados é uma vez ao dia.
  1. 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 influenciadores ao programa

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

Adicionar por conta própria

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

Adicionar via Xsolla

Para adicionar um influenciador ao programa via Xsolla, envie uma mensagem para influencer@xsolla.com e especifique o e-mail, o canal da rede social e a tag de criador que deseja atribuir ao influenciador.

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

Obtenção de influenciadores com a tag de criador

Obtém uma lista de influenciadores no programa com tags de criador.
ParâmetroTipoDescrição
limit
integerNúmero de influenciadores na lista (por padrão: 20, máximo: 100).
offset
integerValor do offset ao carregar influenciadores na lista (por padrão: 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

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:
ParâmetroTipoDescrição
creator_tag
stringCódigo exclusivo do influenciador no programa. Obrigatório.
transaction_id
stringID da transação. Obrigatório.
transaction_currency
stringCódigo da moeda em que a transação foi realizada. Código de três letras, conforme a ISO 4217. Obrigatório.
transaction_value
numberValor da transação. Obrigatório.
transaction_date
stringData da transação no formato YYYY-MM-DD’T’HH:MM:SS. Obrigatório.
platform_id
stringPlataforma onde a transação foi realizada. Obrigatório.
user_id
stringID do jogador. Obrigatório.
item_id
stringID do item comprado. Obrigatório.
item_name
stringNome do item comprado. Obrigatório.
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
  }
]

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:
ParâmetroTipoDescrição
transaction_id
stringID da transação a ser cancelada. Obrigatório.
refund_id
stringID externo do reembolso.
reason
stringMotivo do reembolso.
refund_date
stringData de reembolso no formato YYYY-MM-DD’T’HH:MM:SS. Obrigatório.
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
  }
]

Envio de estatísticas por tag de criador

Permite o envio de estatísticas sobre a conexão da tag de criador do influenciador (por dias). Essas informações serão publicadas na seção Statistics da Conta de Distribuidor. Uma matriz dos seguintes objetos é passada no corpo da solicitação:
ParâmetroTipoDescrição
date
stringData de transmissão das estatísticas do criador no formato YYYY-MM-DD. Obrigatório.
creator_tag
stringCódigo exclusivo do influenciador no programa. Obrigatório.
new_supporters
integerNúmero de novos jogadores que usaram a tag de criador do influenciador. Obrigatório.
total_supporters
integerNúmero de todos os jogadores que usaram a tag de criador do influenciador. Obrigatório.
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
  }
]

Criação de tag de criador para influenciador

Permite criar tags de criador para novos influenciadores no programa. Uma matriz dos seguintes objetos é passada no corpo da solicitação:
ParâmetroTipoDescrição
creator_tag
stringCódigo exclusivo do influenciador no programa. Obrigatório.
creator_email
stringE-mail do influenciador. Obrigatório.
creator_channels
array of stringsLink para o canal do influenciador na rede social. Pode haver vários canais. Obrigatório.
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"
  ]
}

Adição de influenciador ao programa

Permite a adição de um novo influenciador ao programa. Uma matriz dos seguintes objetos é passada no corpo da solicitação:
ParâmetroTipoDescrição
creator_tag
stringCódigo exclusivo do influenciador no programa. Obrigatório.
revenue_share
integerPorcentagem de lucro que o influenciador ganha por cada compra em que sua tag de criador foi aplicada. Obrigatório.
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"
  ]
}
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Última atualização: 22 de Janeiro de 2024

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!