Productos de comercio

Puedes catalogar y vender productos del mundo real, o productos de comercio, en tu juego de Roblox. Los usuarios pueden comprar estos productos en tu juego y, si son elegibles, puedes proporcionar incentivos digitales como un beneficio agrupado.

Para crear y gestionar artículos de catálogo y productos de comercio, debes cumplir con la elegibilidad comercial. Para añadir productos de comercio a tu juego:

1. Importa un artículo de catálogo del mundo real desde Shopify.
2. Crea un producto de comercio en el Creator Hub.
3. Implementa un aviso de compra dentro de tu juego.

Elegibilidad

Los siguientes requisitos de elegibilidad se aplican a creadores interesados en implementar productos de comercio, juegos que alojan características de comercio y usuarios que pueden comprar productos de comercio. Los artículos digitales agrupados también requieren requisitos de elegibilidad adicionales.

Estos requisitos están sujetos a cambios.

Creador

Los creadores elegibles pueden añadir productos de comercio a su juego. Para ser elegible, los creadores deben cumplir y mantener lo siguiente:

• Tener al menos 18 años de edad.
• Tener una cuenta verificada con ID y correo electrónico.
• Tener la verificación de dos pasos habilitada.
• Ser el titular de la cuenta registrada en Shopify para la tienda vinculada.

  • Alternativamente, debes tener permiso por escrito para vincular la tienda de Shopify del titular de la cuenta registrada.
• Haber enviado Información de la Empresa. Puedes acceder a este formulario de envío de las siguientes maneras:

  • Página de Elegibilidad Comercial — Al visitar la página de comercio por primera vez, aparece un formulario de elegibilidad.
  • Tablero del Creador — En Información de la Cuenta, debes completar las pestañas de Cuenta Principal y Legal. Puedes omitir la sección de Servicios Extendidos en Cuenta Principal si aparece.
  • Para enviar información comercial en nombre de un grupo, el creador debe tener habilitada la opción Configurar y gastar los ingresos del grupo.
• Si accedes a la configuración comercial en nombre de un grupo, tu rol debe tener habilitada la opción Crear y editar experiencias comunitarias.
• Estar en buena posición con respecto a los Estándares de la Comunidad de Roblox de manera continua.

Juego

Los creadores deben asegurarse de que los juegos que alojan características de comercio cumplan con los siguientes requisitos:

• El juego debe ser público.
• El juego ha recibido etiquetas de madurez de contenido después de completar el cuestionario de Madurez de Contenido.
• El juego cumple con los Estándares de la Comunidad, Estándares de Publicidad y Estándares de Comercio de Roblox de manera continua.

Usuario

En este momento, solo los usuarios basados en EE. UU. pueden comprar productos de comercio. Los usuarios participantes también deben cumplir con los siguientes requisitos:

• Deben tener al menos 13 años de edad, excepto en Texas.
• Deben tener al menos 18 años de edad en Texas.

Puedes verificar la elegibilidad del usuario utilizando PolicyService para devolver información de política sobre cada usuario.

Beneficios digitales

Ciertos creadores pueden calificar para poder agrupar un beneficio digital, como un artículo de avatar o un artículo de desarrollador, con su producto de comercio si cumplen con al menos uno de los siguientes dos requisitos:

• El juego que aloja la tienda cumple con lo siguiente:

  • Mantiene más de 100,000 usuarios activos diarios en promedio durante los últimos 90 días.
  • Mantiene más de 1,000,000 de Robux de ganancias mensuales promedio en los últimos 90 días.
  • Vende al menos un paquete dentro de los tres meses después de recibir aprobación para el agrupamiento.
• O entra en un acuerdo por escrito con Roblox para un gasto publicitario de al menos $50,000 USD en un año.

Beneficios digitales agrupados

Si calificas para agrupar un beneficio digital con tu producto de comercio, cada beneficio digital debe:

• Cumplir con los Estándares de la Comunidad y Estándares de Publicidad de Roblox, tanto como un artículo individual como en la combinación del producto y el beneficio digital agrupado en el contexto del paquete.
• No ser un artículo que estuvo disponible para compra antes de listar el paquete o hecho disponible por separado para su compra con Robux.
• No ser Robux o moneda del juego.
• Revelarse con suficiente detalle en la lista del producto en Roblox y no debe ser incierto para el comprador.
• No ser un artículo aleatorio y no debe requerir una mecánica basada en suerte para recibir el artículo subyacente.
• No requerir pasos adicionales para adquirir después de que el pago del paquete se complete.

Importar artículos de catálogo

En el Tablero del Creador, puedes conectar tu cuenta de Roblox a tu tienda de Shopify y vincular artículos de catálogo a tu juego. Debes añadir productos individuales que deseas importar a Roblox.

Importar artículos de catálogo desde Shopify

1. Navega a tu juego en el Tablero del Creador y selecciona Productos de Monetización ⟩ Comercio.
2. Haz clic en Ir al Catálogo Importado ⟩ Comenzar Importación.
3. Haz clic en Conectar.
4. Instala el canal de ventas de Roblox en tu tienda.
5. Conecta tu cuenta de Roblox. Haz clic en Siguiente.

   1. Después de conectar tu cuenta de Roblox, puedes opcionalmente conectar un grupo de Roblox para otorgar acceso a todos los miembros del grupo a tus artículos de catálogo importados. Esto se puede actualizar en cualquier momento bajo Cuenta en el canal de ventas de Roblox.
6. Haz clic en Agregar Productos y selecciona los artículos que importarás a Roblox.
7. Haz clic en Finalizar y espera a que los artículos se sincronicen con Roblox. Puedes ver tus artículos de catálogo importados en la pestaña Catálogo Importado de la página de Comercio.

Eliminar artículos de catálogo

En la página de Comercio, puedes eliminar cualquier artículo de catálogo que hayas importado en la pestaña Catálogo haciendo clic en el botón Eliminar o Quitar junto al artículo.

Cuando eliminas un artículo, todos los productos de comercio que contengan el artículo serán eliminados automáticamente. Para vender el producto de comercio nuevamente, debes re-importar el artículo y recrear el producto.

Modificar artículos de catálogo

Cuando cambias el precio de un artículo de catálogo en Shopify, todos los paquetes de productos de comercio asociados se retirarán de la venta y se re-someterán para el procesamiento de tarifas de agrupamiento.

Cuando actualizas el contenido de tu artículo en Shopify, como el nombre, la descripción o la imagen de visualización, todos los productos asociados no serán retirados de la venta, pero se volverán a someter para moderación. La lista del producto en Roblox para cada producto seguirá mostrando el contenido previamente aprobado hasta que el nuevo contenido sea aprobado por moderación. Consulta la Página de detalles del producto para más información sobre cómo se muestran y gestionan estos atributos de Shopify.

Gestionar productos de comercio

Después de importar un artículo de catálogo a la página de Comercio de tu juego, puedes comenzar a crear productos de comercio.

Crear

Una vez que hayas importado artículos de catálogo, puedes crear productos de comercio. Un producto de comercio puede ser un artículo de catálogo por sí solo, o un artículo de catálogo agrupado con un beneficio digital.

Puedes crear un máximo de 500 productos por juego.

Para crear un producto de comercio:

1. Navega a tu juego en el Tablero del Creador y selecciona Productos de Monetización ⟩ Comercio.
2. Haz clic en Comenzar a Crear o Crear Productos.
3. Selecciona qué artículos de catálogo importados deseas incluir en tus productos de comercio y haz clic en Siguiente.

   1. Si no ves un botón de Siguiente, tu juego no es elegible para crear paquetes con beneficios digitales. Salta al paso 4.
   2. En este punto, tus productos de comercio se guardan como borradores. Si abandonas esta página y quieres regresar a ellos, puedes encontrar productos de comercio borradores en Borradores en la pestaña Creaciones.

(Opcional) Agrupando beneficios digitales

Si eres elegible para agrupar un producto de comercio con beneficios digitales, puedes agrupar un beneficio digital con tu producto de comercio. Los productos agrupados requieren una tarifa de agrupamiento después de la moderación. Para agrupar un beneficio digital:

1. Haz clic en Agregar Beneficio.
2. Elige un Tipo de Beneficio Virtual:
3. Artículo de Avatar: Para ser parte de un paquete, el artículo de avatar no debe haber estado a la venta anteriormente. Debes poseer el artículo o pertenecer al grupo que posee el artículo.
4. Selecciona un artículo de avatar eligiendo un Tipo de Artículo de Avatar y utilizando los menús desplegables. Haz clic en Guardar.
5. Producto de Desarrollador: Para ser parte de un paquete, el producto de desarrollador debe ser propiedad del juego, no debe haber estado a la venta previamente y no debe tener precio.
6. Selecciona un Producto de Desarrollador existente o crea uno nuevo para usar en un paquete haciendo clic en Crear Nuevo, completando la información del producto de desarrollador, y haciendo clic en Crear. Haz clic en Guardar.

   1. Los nombres de los productos de desarrollador dentro del mismo juego deben ser únicos.
   2. Los productos de desarrollador se crean cuando envías el producto para revisión. Para reutilizar un producto de desarrollador en múltiples paquetes, envía un producto (que crea el producto de desarrollador), y luego selecciona ese beneficio en paquetes posteriores.

7. Ingresa el Tipo de Inventario del artículo de catálogo.

   1. Cantidad Fija: Hay una cantidad fija del artículo de comercio. Ingresa la cantidad bajo Cant.
   2. Merchandising a Pedido: El artículo de comercio se crea a pedido.
   3. Preorden: El artículo de comercio es para preorden.

4. Verifica los detalles de tus productos y haz clic en Vista previa para previsualizar la lista de productos para cada producto. Para detalles sobre qué contiene esta página y cómo se puebla, consulta Personalizando la Página de Detalles del Producto. Haz clic en Enviar para revisión.
5. El estado de tus nuevos productos de comercio creados es Pendiente mientras el producto espera moderación y posible procesamiento de tarifas de agrupamiento. Puedes pasar el mouse sobre el icono de información para ver qué tareas están pendientes.

   1. Moderación

      1. Si tu producto de comercio se encuentra en violación de los estándares de la comunidad de Roblox, verás que el Estado del producto de comercio cambia a Moderado.
      2. Pasa el mouse sobre el icono de información y haz clic en Ver Violación para ver la violación y enviar una apelación, o crear un nuevo producto de comercio que cumpla con los estándares de la comunidad de Roblox. Debes ser el usuario cuya cuenta está conectada a la tienda de Shopify, o el propietario del grupo para tiendas de propiedad grupal para ver la violación.
   2. Tarifa de Agrupamiento (si corresponde)

      1. Una vez que una tarifa de agrupamiento esté disponible para un producto de comercio agrupado, navega al producto de comercio para verlo bajo Tarifa de Agrupamiento.
      2. Para aceptar, selecciona el producto y haz clic en Aceptar Tarifa de Agrupamiento, o haz clic en los tres puntos al lado de la tarifa de agrupamiento y haz clic en Aceptar.
6. Una vez que estas tareas sean aprobadas para tu producto de comercio, el Estado del producto de comercio se convierte en Aprobado y está listo para ser integrado en tu juego usando CommerceService.

Obtener ID

Necesitarás el ID del producto de un producto de comercio para venderlo en tu juego.

Para obtener el ID del Producto:

1. Pasa el mouse sobre el ID del Producto.

2. Haz clic en Copiar ID para copiarlo en tu porta documentos.

   

Poner a la venta

Los productos de comercio deben estar disponibles para la venta para poder ser comprados en el juego.

Dos artículos de catálogo idénticos no pueden estar a la venta al mismo tiempo. Debes sacar un paquete que contenga un artículo de catálogo de la venta para poner otro que tenga ese mismo artículo en venta. Un máximo de 100 productos puede estar a la venta en un momento por juego.

Para cambiar el estado de venta de un producto:

1. En la página de comercio, navega al producto que deseas vender.

2. Haz clic en Poner a la Venta o Retirar de la Venta para el producto.

   

Eliminar

Para eliminar un producto de comercio:

1. Pasa el mouse sobre el producto.
2. Haz clic en Eliminar para eliminar el producto.

Implementar compras

En tu juego, implementa las compras de productos de comercio utilizando las siguientes funciones de CommerceService:

• CommerceService:PromptCommerceProductPurchase(): Solicita a un usuario específico que compre un producto de comercio utilizando el commerceProductId proporcionado. Abrirá una vista web que guiará al usuario a través del flujo de compra.
• CommerceService:PromptCommerceProductPurchaseFinished(): Utiliza esta señal para detectar cuándo un usuario ha completado el flujo de compra y la vista web se ha cerrado para reanudar el juego dentro del juego.

  • Esta señal no indica una compra exitosa y solo significa cuándo se cierra la solicitud.
  • Aunque opcional, se recomienda usar esta señal para reorientar a tus usuarios en Android, ya que el flujo de compra de comercio los habrá forzado a estar en modo retrato.

Conceder beneficios digitales

Al crear un producto de comercio, tienes la opción de agrupar el artículo de catálogo con un beneficio digital.

Artículos de avatar

Si un artículo de avatar está agrupado con un artículo de comercio, Roblox otorga automáticamente el artículo de avatar vinculado después de que un usuario compra con éxito un producto de comercio.

Si Roblox detecta una cancelación o reembolso del artículo físico, Roblox revocará automáticamente el artículo de avatar de la cuenta.

Si el artículo de avatar es moderado, el estado de cualquier producto de comercio vinculado al artículo se volverá moderado y se retirará de la venta. Después de 7 días, Roblox revocará automáticamente el artículo de avatar de todas las cuentas que compraron estos productos. Tras una apelación exitosa, el artículo de avatar será restituido.

Productos de desarrollador

Después de que un usuario compra con éxito un producto de comercio, Roblox genera un recibo de producto de desarrollador y lo envía al servidor donde se encuentra el usuario. Sigue el flujo existente de MarketplaceService.ProcessReceipt para manejar la concesión de productos de desarrollador.

En caso de un reembolso o cancelación del artículo físico, puede que quieras revocar los artículos o beneficios asociados en el juego. Roblox no revoca automáticamente los productos de desarrollador que se otorgaron a los usuarios como un beneficio digital.

Roblox proporciona integración de webhook para eventos de comercio. Cuando un pedido se paga, se cancela o se reembolsa, Roblox enviará un mensaje de webhook con el último estado del pedido y detalles del mismo. Los desarrolladores pueden usar esta información para revocar artículos o beneficios en el juego según sea necesario.

Para más información sobre notificaciones de webhook, consulta la documentación.

Usa los eventos CommerceProductOrderPaid y CommerceProductOrderRefunded para rastrear el estado del pedido del producto. El EventPayload contendrá el relevante CommerceProductOrder que tiene el siguiente esquema:

Esquema de EventPayload
{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "El recurso de la ruta del pedido del producto de comercio.\n\n Formato:\n `universes/{universe_id}/commerce-products/{commerce_product_id}/orders/{commerce_product_order_id}`",
      "x-example-values": {
        "exampleValues": [
          "universes/123/commerce-products/123/orders/123e4567-e89b-12d3-a456-426655440000"
        ]
      }
    },
    "createTime": {
      "readOnly": true,
      "type": "string",
      "description": "La marca de tiempo cuando se creó el pedido de comercio.",
      "format": "date-time",
      "x-example-values": {
        "exampleValues": [
          "2023-07-05T12:34:56Z"
        ]
      }
    },
    "updateTime": {
      "readOnly": true,
      "type": "string",
      "description": "La marca de tiempo cuando se actualizó por última vez el pedido de comercio.",
      "format": "date-time",
      "x-example-values": {
        "exampleValues": [
          "2023-07-05T12:34:56Z"
        ]
      }
    },
    "state": {
      "readOnly": true,
      "enum": [
        "STATE_UNSPECIFIED",
        "STATE_PAID",
        "STATE_REFUNDED"
      ],
      "type": "string",
      "description": "El estado actual de este pedido, es decir, PAGADO, REEMBOLSADO, CANCELED\n\nValores posibles:\n\n  | Valor | Descripción |\n  | --- | --- |\n  | STATE_UNSPECIFIED | Estado no especificado. |\n  | STATE_PAID | El pedido ha sido pagado. |\n  | STATE_REFUNDED | El pedido ha sido reembolsado. |",
      "format": "enum",
      "x-example-values": {
        "exampleValues": [
          "STATE_UNSPECIFIED"
        ]
      }
    },
    "merchantOrderId": {
      "immutable": true,
      "type": "string",
      "description": "El ID de pedido específico del comerciante que se puede usar para buscar el pedido en la\n plataforma del comerciante."
    },
    "merchant": {
      "immutable": true,
      "enum": [
        "MERCHANT_PLATFORM_UNSPECIFIED",
        "SHOPIFY",
      ],
      "type": "string",
      "description": "El comerciante que se usa para cumplir con los pedidos.\n\nValores posibles:\n\n  | Valor | Descripción |\n  | --- | --- |\n  | MERCHANT_PLATFORM_UNSPECIFIED | Tipo de comerciante no especificado. |\n  | SHOPIFY | El artículo se vende a través de Shopify. |",
      "format": "enum",
      "x-example-values": {
        "exampleValues": [
          "MERCHANT_PLATFORM_UNSPECIFIED"
        ]
      }
    },
    "user": {
      "immutable": true,
      "type": "string",
      "description": "El usuario que realizó este pedido.",
      "x-example-values": {
        "exampleValues": [
          "users/123"
        ]
      }
    }
  },
  "description": "Un pedido de producto de comercio representa una compra de un CommerceProduct por un\n usuario de Roblox. Incluye al usuario que realizó la compra y detalles del pedido del comerciante.",
}

Página de detalles del producto

La Página de detalles del producto (PDP) muestra tu producto de comercio a los usuarios dentro del juego de Roblox, por ejemplo, cuando se le solicita a través de CommerceService:PromptCommerceProductPurchase(). Puedes personalizar varios elementos de esta página para proporcionar una experiencia de compra única e informativa.

Imágenes del Producto muestra las imágenes del producto proporcionadas en tu tienda de Shopify.

Título del producto, precio e información del vendedor contiene detalles del producto y del vendedor.

Variantes y cantidad muestra diferentes opciones y cantidades disponibles.

Detalles del producto muestra la descripción del producto de Shopify.

Información adicional incluye detalles suplementarios, como "Materiales", "Instrucciones de Cuidado" o "Guía de Tallas".

Beneficio virtual con la compra detalla el artículo virtual que los usuarios recibirán con su compra.

Más de este juego sugiere otros productos de comercio ofrecidos dentro del mismo juego.

Imágenes del producto

La sección de imágenes del producto muestra todas las imágenes del producto de tu tienda de Shopify. El orden de las imágenes refleja directamente el orden establecido en Shopify.

La primera imagen, conocida como la imagen destacada en Shopify, sirve como la miniatura principal para tu producto. Esta miniatura se usa en varios lugares, como dentro del carrito de compras y en la sección de Más de.

Cuando actualizas las imágenes del producto en Shopify, estos cambios están sujetos al proceso de moderación para artículos de catálogo. La lista del producto en Roblox seguirá mostrando las imágenes previamente aprobadas hasta que las nuevas imágenes sean aprobadas.

Título del producto, precio e información del vendedor

El título del producto se toma directamente del título del producto establecido en la tienda de Shopify.

El precio mostrado se actualiza dinámicamente si el usuario selecciona variantes y cantidades de producto de precios diferentes. La información del vendedor mostrada es el nombre de tu tienda de Shopify.

Al igual que otros atributos del producto, si actualizas el título del producto en Shopify, estos cambios están sujetos al proceso de moderación para artículos de catálogo. La lista del producto en Roblox seguirá mostrando el título previamente aprobado hasta que el nuevo título sea aprobado.

Variantes y cantidad

Las variantes del producto y sus opciones, como diferentes colores o tamaños, están sincronizadas desde tu tienda de Shopify. El orden en que aparecen estas variantes y opciones coincide con el orden en Shopify, mostradas de arriba hacia abajo.

Cuando un usuario selecciona una variante específica, la imagen principal del producto se actualiza para mostrar la imagen asociada con esa variante particular en Shopify.

En este momento, el selector de cantidad en la PDP no ofrece opciones de personalización. Si la variante del producto seleccionada no está disponible, los botones "Comprar ahora" y "Agregar al carrito" se desactivan. Asegúrate de que tus variantes estén correctamente configuradas en Shopify para permitir compras.

Cualquier actualización realizada a las variantes del producto o sus imágenes en Shopify está sujeta al proceso de moderación para artículos de catálogo. La página de detalles del producto seguirá mostrando la información y las imágenes de variantes previamente aprobadas hasta que las nuevas versiones sean aprobadas.

Detalles del producto

La sección de Detalles del producto muestra el contenido directamente de tu descripción del producto de Shopify.

Esta sección admite el uso de HTML para estilizar y formatear tu información del producto. Por seguridad y consistencia, Roblox elimina automáticamente ciertos elementos HTML, incluidos enlaces, imágenes, scripts y otras etiquetas y atributos similares. Por lo demás, puedes usar HTML para estilizar y estructurar el contenido de texto, como usar encabezados, texto en negrita, listas y párrafos.

Las descripciones de los productos deben incluir descripciones precisas de la mercancía, abarcando detalles como funcionalidad, especificaciones, características, políticas de devolución o cambio y origen. Asegúrate de que todos tus productos de comercio tengan descripciones completas en Shopify para ser aprobados para la venta. Consulta los Estándares de Comercio para obtener más información.

Al igual que con otra información de productos sincronizada desde Shopify, cualquier actualización a la descripción del producto está sujeta al proceso de moderación para artículos de catálogo. Los detalles del producto seguirán mostrando la descripción previamente aprobada hasta que el nuevo contenido sea aprobado por moderación.

Información adicional

La sección de Información adicional muestra detalles suplementarios sobre tu producto utilizando acordeones colapsables. Puedes agregar hasta cinco secciones de acordeón para diferentes temas, como "Materiales", "Instrucciones de Cuidado" o "Tamaño".

Esta es una característica opcional y se puebla utilizando metafields del producto de Shopify. Para crear un acordeón de metafield en Shopify:

• Define un metafield de producto en tu tienda de Shopify con un espacio de nombres específico: Roblox.pdp_info_.

  • Puedes agregar un identificador único a este espacio de nombres, como Roblox.pdp_info_materials o Roblox.pdp_info_care_instructions.

• Establece los siguientes campos:

  • Nombre — El valor en este campo se muestra como el encabezado para ese acordeón.

  • Tipo — Solo se admite "Texto de varias líneas".

    

• Luego establece el Valor del metafield para cada producto deseado. Este valor se muestra como el contenido de ese acordeón.

Al igual que otros contenidos de productos sincronizados desde Shopify, cualquier nueva o actualizada información en estos metafields está sujeta al proceso de moderación para artículos de catálogo. Esta página mostrará contenido previamente aprobado hasta que la nueva información sea aprobada.

Beneficio virtual con la compra

Si has agrupado un beneficio digital con tu producto, esta sección muestra el artículo virtual que los usuarios reciben con su compra. Esta sección proporciona una señal visual y de información clara a los usuarios sobre el valor digital adicional que reciben, mejorando el atractivo de tu producto de comercio.

El contenido en esta sección depende del tipo de artículo virtual ofrecido:

• Artículo de avatar

  • Esta sección muestra la miniatura y el nombre del artículo de avatar.
  • Los usuarios pueden hacer clic en esta sección para ver una vista previa en 3D del artículo de avatar.
  • La descripción del artículo de avatar se muestra cuando el usuario hace clic en esta sección.

• Producto de desarrollador

  • Esta sección muestra la imagen y el nombre del producto de desarrollador.
  • La descripción del producto de desarrollador se muestra cuando el usuario hace clic en esta sección.

El artículo de avatar específico o el producto de desarrollador, incluida su nombre, descripción e imagen, se configura cuando creas el paquete del producto de comercio. Dado que estos beneficios son parte de la oferta general del producto, están sujetos a las políticas de contenido y moderación de Roblox.

Más de este juego

Esta sección muestra otros productos de comercio que ofreces que están actualmente a la venta dentro del mismo juego de Roblox. Este feed fomenta una mayor exploración de tu catálogo de productos y puede ayudar a aumentar la visibilidad de la gama completa de ofertas de productos de tu juego.

En esta sección, los usuarios pueden ver la imagen destacada del producto, el nombre y el precio.