{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/ja/api/liveops/index.yaml","sidebar":"sidebar-@l10n/ja/liveops-en.sidebars.yaml"},"props":{"definitionId":"@l10n/ja/api/liveops/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/ja/api/liveops","seo":{"title":"概要","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"オファーチェーンとは、アクティブなオファーの一環として、ユーザーが無料、または購入によって獲得できるアイテムが含まれた一連のステップのことです。オファーチェーンには、チェーン内でのみ入手できる限定アイテムや、通常のストア価格よりも割引された価格のアイテムを含めることができます。このマーケティングツールの設定に関する詳細な情報については、[オファーチェーン](https://developers.xsolla.com/ja/liveops/promotion-tools/offer-chains/)セクションを参照してください。\n\nオファーチェーンを構成するには、**管理者**サブセクションのAPIコールを使用します。チェーンを表示し、ユーザーが獲得するアイテムを処理するためのロジックを実装するには、**クライアント**サブセクションのAPIコールを使用します。\n\n<b>オファーチェーンの設定フローの例：</b>\n\n1. [仮想アイテムと仮想通貨](https://developers.xsolla.com/ja/api/catalog/virtual-items-currency-overview)または[バンドル](https://developers.xsolla.com/ja/api/catalog/bundles-admin)グループの**管理者**サブセクションにあるAPIコールを使用して、アイテムを作成します。\n\n2. [オファーチェーンを作成する](https://developers.xsolla.com/ja/api/liveops/offer-chain-admin/admin-create-offer-chain)APIコールを使用して、チェーンを作成します。チェーンをアクティブにするには、`is_enabled: true`パラメータを渡します。\n\n3. オファーチェーンの表示を実装します。これを行うには[現在のユーザーのオファーチェーンを取得する](https://developers.xsolla.com/ja/api/liveops/offer-chain-client/get-offer-chains-list) APIコールを使用して、利用可能なチェーンのリストをリクエストします。応答には、すべてのアクティブなチェーンと、それらのステップおよびステータスが含まれています。\n\n4. ユーザーが獲得するアイテムを処理するためのロジックを実装します：\n\n    - ステップアイテムが無料の場合、[無料オファーチェーンステップを受け取る](https://developers.xsolla.com/ja/api/liveops/offer-chain-client/claim-user-offer-chain-step-reward)APIコールを使用します。リクエスト内に`offer_chain_id`と`step_number`を渡してください。\n\n    - ステップアイテムが有料の場合、[有料オファーチェーンステップの注文を作成する](https://developers.xsolla.com/ja/api/liveops/offer-chain-client/order-user-offer-chain-step-reward)APIコールを使用します。リクエスト内に`offer_chain_id`と`step_number`を渡してください。レスポンスとして、`order_id`と決済UIを開くためのトークンが返されます。\n\n5. オファーを受け取った、または購入したアイテムに関するデータを迅速に受信し、それをユーザーに付与するために、[ウェブフック](https://developers.xsolla.com/ja/webhooks/section/overview)などを使用した注文状況の追跡を設定します。\n\n![報酬チェーンの設定フロー](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":"ja","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/ja/api/liveops/offer-chains-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}