{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/ru/api/liveops/index.yaml","sidebar":"sidebar-@l10n/ru/liveops-en.sidebars.yaml"},"props":{"definitionId":"@l10n/ru/api/liveops/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/ru/api/liveops","seo":{"title":"Основная информация","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"Цепочка предложений — это последовательность шагов, каждый из которых содержит товар, который пользователь получает бесплатно или покупает в рамках действующего предложения. Цепочка предложений может содержать уникальные товары, доступные только в рамках цепочки, а также товары по более выгодным ценам, чем в магазине. Подробная информация о настройке этого маркетингового инструмента приведена в разделе [Цепочки предложений](https://developers.xsolla.com/ru/liveops/promotion-tools/offer-chains/).\n\nЦепочки настраиваются через методы подраздела **Admin**. Для настройки отображения цепочек и реализации логики работы с товарами, которые получает пользователь, используйте методы подраздела **Клиент**.\n\n<b>Пример сценария настройки цепочки предложений:</b>\n\n1. Создайте товары с помощью методов API из подраздела **Admin** групп методов [Виртуальные предметы и валюта](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-overview) или [Бандлы](https://developers.xsolla.com/ru/api/catalog/bundles-admin).\n\n2. Создайте цепочку с помощью метода API [Создание цепочки предложений](https://developers.xsolla.com/ru/api/liveops/offer-chain-admin/admin-create-offer-chain). Чтобы активировать цепочку, передайте параметр `is_enabled: true`.\n\n3. Реализуйте отображение цепочек предложений. Для этого запросите список доступных пользователю цепочек с помощью метода API [Получение цепочек предложений для текущего пользователя](https://developers.xsolla.com/ru/api/liveops/offer-chain-client/get-offer-chains-list). В ответе возвращаются все активные цепочки с шагами и их статусами.\n\n4. Реализуйте логику работы с товарами, которые получает пользователь:\n\n    - Если товар на шаге бесплатный, вызовите метод API [Получение награды за шаг цепочки предложений](https://developers.xsolla.com/ru/api/liveops/offer-chain-client/claim-user-offer-chain-step-reward). В запросе передайте `offer_chain_id` и `step_number`.\n\n    - Если товар на шаге платный, вызовите метод API [Создание заказа на награду за шаг цепочки предложений](https://developers.xsolla.com/ru/api/liveops/offer-chain-client/order-user-offer-chain-step-reward). В запросе передайте `offer_chain_id` и `step_number`. В ответе возвращается `order_id` и токен для открытия платежного интерфейса.\n\n5. Настройте отслеживание статуса заказа, например, с помощью [вебхуков](https://developers.xsolla.com/ru/webhooks/section/overview), чтобы своевременно получать данные о запрошенных или оплаченных товарах и начислять их пользователю.\n\n![Reward chain configuration flow](https://cdn.xsolla.net/developers/current/images/api_docs/offer-chains-overview.svg)"},"itemId":"offer-chains-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":"ru","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/ru/api/liveops/offer-chains-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}