Oferta única de catálogo

Cómo funciona

Oferta única de catálogo: la capacidad de mostrar artículos ocultos en el catálogo para los usuarios que hayan introducido un código único de oferta. Si no se introduce el código, los artículos no se muestran.

Características principales:

• establecer la lista de artículos que se muestran tras introducir el código
• establecer promociones para los artículos que se muestran tras introducir el código
• establecer el número total de canjes de códigos dentro de la campaña
• establecer el número de canjes de códigos por usuario dentro de la campaña
• establecer las restricciones regionales previa solicitud

• generar múltiples códigos

• El usuario debe estar autorizado para usar el código.
• Si el código está asociado a un artículo que tiene restricciones regionales, los usuarios de las regiones en las que el artículo no esté disponible no podrán ver las ofertas únicas asociadas a ese código.
  Ejemplo: Tras introducir el código, debería visualizarse el Legendary Starter Pack. El Legendary Starter Pack tiene una restricción regional: solo está disponible en EE. UU. Si un usuario de fuera de EE. UU. introduce el código, se devuelve un error en la respuesta al método Verificar código de promoción y el usuario no puede ver ni comprar el Legendary Starter Pack.

Flujo del usuario

1. El usuario autorizado abre el catálogo de artículos y ve todos los artículos excepto las ofertas únicas.
2. El usuario introduce el código en un campo especial del catálogo y lo activa.
3. El usuario ve artículos únicos que están disponibles para su compra.
4. El usuario compra un artículo único, tras lo cual el código se considera canjeado.

Flujo de integración

1. Establecer una promoción con ofertas únicas de catálogo.
2. Implemente la visualización del catálogo para el usuario. Para ello, utilice los métodos de la subsección Catalog del grupo de métodos Virtual Items & Currency para generar el catálogo.
3. Implemente la visualización de un campo en el catálogo en el que el usuario introduzca un código.
4. Utilice el método Verificar código de promoción para validar el código.
5. Implemente la visualización del catálogo de artículos teniendo en cuenta el código. Para ello, introduzca la información del código en el parámetro promo_code al llamar a los métodos para crear el catálogo de la subsección Catalog en el grupo de métodos Virtual Items & Currency.
6. Para crear un pedido con un artículo único, utilice el método Create order with specified item. Transmita el valor del código en el parámetro promo_code en el cuerpo de la solicitud. Si desea utilizar una cesta, transmita el valor del código en el parámetro promo_code en el cuerpo de la solicitud al crear una cesta y al crear un pedido.

Cómo conseguirlo

Requisitos previos

1. Registrarse en Cuenta del editor.
2. Conecte la Tienda y establezca los módulos Virtual Items, Virtual Currency o Bundles.

Establecer una promoción con ofertas únicas de catálogo.

1. Cree una promoción con una oferta única de catálogo utilizando el método de promoción Create unique catalog offer. En la matriz items, transmita los códigos (SKU) de los artículos que se mostrarán una vez activado el código. También puede especificar:
   • El periodo de la promoción transmitiendo:
     • la fecha de inicio en el parámetro date_start.
     • la fecha de finalización en el parámetro date_end. Si no se especifica la fecha final, la promoción es indefinida.
   • Límites:
     • el número de veces que un usuario específico puede utilizar la promoción en el parámetro redeem_user_limit
     • el número de veces que se puede canjear el código en el parámetro redeem_code_limit
     • el número total de veces que se puede utilizar la promoción en el parámetro redeem_total_limit
2. Genere códigos para la promoción creada usando el método Generate unique catalog offer codes o cree un código utilizando el método Create unique catalog offer code. Puede generar códigos adicionales si es necesario. Para obtener los códigos generados, utilice el método Get unique catalog offer codes method.
3. Active la promoción utilizando el método Activate unique catalog offer promotion.

Para gestionar la promoción, utilice los siguientes métodos:

• Update unique catalog offer promotion
• Deactivate unique catalog offer promotion

Para obtener información sobre las ofertas únicas de catálogo, utilice los siguientes métodos:

• Get list of unique catalog offer promotions
• Get unique catalog offer promotion