{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/pt/api/liveops/index.yaml","sidebar":"sidebar-@l10n/pt/liveops-en.sidebars.yaml"},"props":{"definitionId":"@l10n/pt/api/liveops/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/pt/api/liveops","seo":{"title":"Visão geral","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"Cadeias de recompensas encorajam usuários a fazerem compras na loja usando moedas reais. Para cada compra, os usuários ganham pontos de valor e progridem pela cadeia de recompensas. Se os usuários fizerem partes de clãs, suas compras contribuem pontos de valor ao clã inteiro. Para informações detalhadas na configuração de cadeias de recompensas, consulte a seção [Sistema de Recompensas](https://developers.xsolla.com/pt/liveops/promotion-tools/reward-system/).\n\nPara configurar cadeias de recompensas, use chamadas de API da subseção **Admin**. Para exibir cadeias e resgatar recompensas, use chamadas de API da subseção **Cliente**. Para trabalhar com cadeias de recompensas com o clã, use chamadas de API da subseção **Cliente de Clãs**.\n\n<b>Exemplo de fluxo de configuração de cadeia de recompensas:</b>\n\n1. Crie itens usando chamadas de API da subseção **Admin** dos grupos [Itens e moedas virtuais](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-overview) ou [Conjuntos](https://developers.xsolla.com/pt/api/catalog/bundles-admin).\n2. Crie pontos de valor usando a chamada de API [Criar ponto de valor](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-create-value-points).\n3. Atribua pontos de valor a itens usando a chamada de API [Definir pontos de valor para os itens](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-set-items-value-point-reward). Os usuários recebem pontos de valor depois de comprarem esses itens.\n4. Crie uma cadeia usando a chamada de API [Criar cadeia de recompensas](https://developers.xsolla.com/pt/api/liveops/reward-chain-value-points-admin/admin-create-reward-chain). Para ativar a cadeia, passe o parâmetro `is_enabled: true`.\n5. Implemente a exibição de cadeia de recompensas. Para fazer isso, solicite a lista de cadeias disponíveis usando a chamada de API [Obter cadeias de recompensa do usuário atual](https://developers.xsolla.com/pt/api/liveops/reward-chain-client/get-reward-chains-list). A resposta contém todas as cadeias ativas com seus passos e status.\n6. Implemente a exibição do saldo de pontos de valor. Para fazer isso, use a chamada de API [Obter saldo de pontos de valor do usuário atual](https://developers.xsolla.com/pt/api/liveops/reward-chain-client/get-user-reward-chain-balance).\n7. Implemente o resgate de recompensa de etapa. Para fazer isso, use a chamada de API [Resgatar recompensa de etapa](https://developers.xsolla.com/pt/api/liveops/reward-chain-client/claim-user-reward-chain-step-reward).\n8. Configure o rastreamento de status do pedido, ex.: usando [webhooks](https://developers.xsolla.com/pt/webhooks/section/overview), para prontamente receber dados nas recompensas resgatadas e conceder eles ao usuário.\n\n![Fluxo de configuração da cadeia de recompensas](https://cdn.xsolla.net/developers/current/images/api_docs/reward-chains-and-value-points-overview.svg)"},"itemId":"reward-chain-value-points-overview","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"185.30.21.18"},"lang":"pt","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/pt/api/liveops/reward-chain-value-points-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}