Promociones de bonificación

Cómo funciona

Las promociones de bonificación son una herramienta de marketing para incentivar a los compradores de artículos virtuales ofreciéndoles artículos de bonificación.

Características principales:

• Proporcionar uno o varios artículos de bonificación al comprar un artículo promocional.
• Especificar el número de veces que una promoción está disponible para un usuario.
• Establecer promociones de bonificación personalizadas.

Ejemplos de uso:

• Bonificaciones en forma de moneda virtual que pueden gastarse en artículos virtuales.
• Promociones de bonificación en fechas significativas para su proyecto, como el aniversario del mismo, para recompensar a los usuarios por su fidelidad.
• Artículos de bonificación además de la compra de artículos a los usuarios que hayan alcanzado un determinado nivel en un juego, como recompensa por su fidelidad.

• Artículos de bonificación a los usuarios durante un tiempo limitado para motivarles a comprar artículos virtuales.

Cuando cree un catálogo de artículos utilizando métodos API, puede recuperar información sobre las promociones. En la respuesta, además de información sobre el artículo virtual, recibirá la siguiente información sobre una promoción del tipo Bonus:

• nombre
• fecha de inicio y fin
• artículo(s) de bonificación
• número total de promociones disponibles para el usuario
• número restante de promociones disponibles para el usuario

Si el número restante de promociones disponibles para el usuario es cero, la información de la promoción no se mostrará en el catálogo.

{
  "item_id": 400962,
  "sku": "test_item",
  "type": "virtual_good",
  "name": "name_test_limit",
  "description": "description_test_limit",
  "price": {
    "amount": "1.00",
    "amount_without_discount": "1.00",
    "currency": "USD"
  },
  "virtual_prices": [
    {
      "description": null,
      "item_id": 322172,
      "sku": "1234500",
      "name": "virt currency only",
      "type": "virtual_currency",
      "amount": 1,
      "amount_without_discount": 1,
      "calculated_price": {
        "amount": "1.00",
        "amount_without_discount": "1.00"
      },
      "is_default": true
    }
  ],
  "can_be_bought": true,
  "promotions": [
    {
      "name": "New Year Bonus",
      "date_start": "2022-12-30T22:00:00+03:00",
      "date_end": "2023-01-02T21:59:59+03:00",
      "discount": null,
      "bonus": [
        {
          "quantity": 3,
          "name": "mybonusitem",
          "sku": "444777",
          "type": "virtual_good"
        }
      ],
      "limits": {
        "per_user": {
          "available": 7,
          "total": 7
        }
      }
    }
  ],
  "limits": null,
  "attributes": [],
  "is_free": false,
  "groups": [
    {
      "external_id": "01022023",
      "name": "Group1"
    }
  ],
  "virtual_item_type": "consumable",
  "inventory_options": {
    "consumable": {
      "usages_count": 1
    },
    "expiration_period": null
  }
}

Cómo conseguirlo

Configurar la promoción de bonificación

• a través de Cuenta del editor
• a través de Métodos API

Configurar a través de la Cuenta del editor

• establecer el periodo de validez de la promoción
• limitar el número de veces que el usuario puede utilizar la promoción
• establecer las condiciones para que se active la promoción

• configure las promociones que se apliquen a cualquier tipo de artículos:

  • paquetes de monedas virtuales
  • artículos virtuales (incluidos artículos por tiempo limitado)
  • paquetes de
  • claves del juego

La edición de las promociones de bonificación con un estado Active no está disponible actualmente en la Cuenta del editor.

Puede utilizar métodos API para mejorar las opciones de configuración de sus promociones de bonificación.

Para configurar una promoción a través de la Cuenta del Editor:

1. Vaya a Store > Promotions and rewards en Cuenta del editor.

2. Haga clic en Create promotion.

3. Especifique los siguientes parámetros:
   1. Introduzca el título de la promoción.
   2. Escoja Bonus como Promotion type.
   3. Especifique los artículos promocionales.
   4. Especifique el artículo que se ofrece al usuario al comprar el artículo promocional.

4. Haga clic en Next.
5. Si es necesario, puede establecer el número de usos para la promoción. Para ello, en la página Conditions and limits, cambie el conmutador Limit number of times one user can use promotion a On y especifique el número.
6. Para configurar promociones personalizadas, establezca Trigger promotion only for specific users en On y especifique la(s) condición(es). Para configurar una personalización, siga estas instrucciones.
7. Haga clic en Next.
8. Especifique el periodo de la promoción.

9. Haga clic en Next.
10. Compruebe la configuración y haga clic en Save and exit.
11. Para activar una promoción:
    1. Busque la promoción en su catálogo de promociones.
    2. Haga clic en el icono ••• y, en la lista desplegable, seleccione Edit promotion o vaya a edición pulsando en la acción del catálogo de acciones.
    3. En la esquina superior derecha, abra el menú desplegable y seleccione Activate promotion.

Configuración mediante métodos API

Para trabajar con promociones de bonificación, puede utilizar los métodos de las subsecciones Common y Bonuses del grupo de métodos Promotions.

Para crear una promoción de bonificación, utilice el método Create bonus promotion y especifique los parámetros necesarios.

Para activar una promoción de bonificación, utilice el método Update bonus promotion con el parámetro “is_enabled”:true o el método Activate promotion.

Para desactivar una promoción, utilice el método Deactivate promotion.

Para editar una promoción mediante los métodos API, llame al método Update bonus promotion con los nuevos parámetros de la promoción. La edición de la promoción también está disponible para promociones con un estado Active.

Al crear o editar una promoción de bonificación a través de los métodos API, también puede:

• Para establecer la acción de la promoción para todos los elementos del proyecto, pase el parámetro “condition”:null al método Create bonus promotion o al Update bonus promotion.

“condition”: null

• Para configurar una promoción indefinida, pase el parámetro “date_end”:null al método Create bonus promotion o al Update bonus promotion.

“date_end”: null