{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/es/api/liveops/index.yaml","sidebar":"sidebar-@l10n/es/liveops-en.sidebars.yaml"},"props":{"definitionId":"@l10n/es/api/liveops/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/es/api/liveops","seo":{"title":"Descripción general","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"Las promociones son herramientas de marketing diseñadas para atraer nuevos usuarios y aumentar las ventas. Usando la API de Xsolla, puede configurar las siguientes promociones:\n\n* Descuentos: precios reducidos en artículos seleccionados.\n* Bonificaciones: artículos concedidos a los usuarios junto con su compra.\n* Cupones: códigos que permiten a los usuarios recibir uno o más artículos de bonificación al canjearlos.\n* Códigos promocionales: códigos que permiten a los usuarios recibir artículos de bonificación, un descuento en un artículo específico o un descuento en toda la cesta. A diferencia de los cupones que se canjean después de que el usuario los introduce, los códigos promocionales se canjean durante una compra (en el momento del pago).\n* Ofertas únicas: artículos ocultos que se muestran en el catálogo a los usuarios que han introducido un código de oferta única. Si no se introduce el código, los artículos no se muestran.\n\nFlujo de ejemplo para configurar una promoción de descuento:\n1. Cree artículos usando las llamadas de la subsección **Admin** de los grupos [Artículos virtuales y moneda](/es/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/), [Lotes](/es/api/catalog/bundles-admin/admin-create-bundle) o [Claves del juego](/es/api/catalog/game-keys-admin).\n2. Cree una promoción usando la llamada [Crear promoción de descuento para un artículo](/es/api/liveops/promotions-discounts/create-item-promotion/). En la matriz `items`, transmita los SKU de los artículos correspondientes.\n3. Configure los periodos de validez de la promoción. Para hacerlo, invoque los métodos [Crear promoción de descuento para un artículo](/es/api/liveops/promotions-discounts/create-item-promotion/) o [Actualizar promoción del artículo](/es/api/liveops/promotions-discounts/update-item-promotion/), y transmita el campo `promotion_periods` como una matriz de objetos en la cual `date_from` define la fecha de inicio y `date_until` define la fecha de finalización del periodo de validez.\n4. Active una promoción usando la llamada [Actualizar la promoción del artículo](/es/api/liveops/promotions-discounts/update-item-promotion/). Transmita el parámetro `\"is_enabled\": true`.\n5. Para obtener información sobre los precios de los artículos, incluidos los precios con descuento, llame a los métodos de la API del cliente para obtener un catálogo de artículos de las subsecciones [Común > Catálogo](/es/api/catalog/tag/common-catalog/), [Artículos virtuales y moneda > Catálogo](/es/api/catalog/virtual-items-currency-catalog/get-virtual-items/), y [Lotes > Catálogo](/es/api/catalog/bundles-catalog/get-bundle-list/).\n\n![Ejemplo de configuración de promoción](https://cdn.xsolla.net/developers/current/images/api_docs/promo-overview.svg)\n\nConsulte nuestra documentación para obtener información detallada sobre la configuración de promociones:\n* [Descuentos](https://developers.xsolla.com/es/liveops/promotion-tools/discounts/)\n* [Bonificaciones](https://developers.xsolla.com/es/liveops/promotion-tools/bonuses/)\n* [Cupones](https://developers.xsolla.com/es/liveops/promotion-tools/coupons/)\n* [Códigos promocionales](https://developers.xsolla.com/es/liveops/promotion-tools/promo-codes/)\n* [Ofertas exclusivas de catálogo](https://developers.xsolla.com/es/liveops/promotion-tools/unique-offer/)"},"itemId":"promotions-overview","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"216.73.216.4"},"lang":"es","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/es/api/liveops/promotions-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}