Integraciones

Shopify

Inicio de sesión con la tienda, reglas de recompensa por compras, pedidos generados por compras en la aplicación y FanBase en tu escaparate.

Conectar Shopify hace tres cosas independientes: los fans inician sesión con su cuenta de la tienda, las compras en tu tienda dan XP, moneda u objetos coleccionables en la aplicación, y los artículos comprados con puntos en la aplicación se convierten en pedidos reales en tu tienda.

Inicio de sesión

Un fan pulsa Iniciar sesión con Shopify. Va a tu tienda a través de una URL de proxy de aplicación, que tiene el aspecto https://yourstore.com/apps/proxy-redirect. Se autentica con la cuenta que ya tiene, o crea una, y vuelve con la sesión iniciada.

Funciona con las cuentas estándar de Shopify y con Shop, el inicio de sesión propio de Shopify. En ambos casos el fan llega con una sola identidad: sus compras y sus puntos son de la misma persona.

Un detalle que conviene conocer antes de informar a tu equipo de soporte. Cuando un fan crea una cuenta de Shopify completamente nueva durante este flujo, Shopify no lo devuelve después a tu aplicación. Vuelve a tu tienda, inicia sesión una vez más, y a partir de ahí todo funciona. Los fans que ya tienen cuenta nunca ven esto.

Qué cuenta recibe un cliente

La primera vez que un cliente inicia sesión de esta forma, se le asocia a un fan por su correo electrónico. Un cliente cuyo correo ya pertenece a un fan recibe la cuenta de ese fan, con sus puntos y su historial. Cualquier otro recibe una cuenta nueva, con ese correo.

Que Shopify aparezca junto a Google, Discord, X y Twitch, o que los sustituya por completo, es un ajuste de cada comunidad. Algunos socios usan Shopify como única forma de entrar, de modo que una cuenta de fan y una cuenta de cliente son la misma cosa por diseño.

Instalación

La instalación es una aplicación personalizada de Shopify para tu tienda, lo que significa que se resuelve con unos pocos mensajes y no con una ficha que buscas en un catálogo.

Envíanos tu dominio .myshopify.com

El original, el que termina en .myshopify.com.

Lo encuentras en tu panel de control de Shopify, en Settings y después Domains. La dirección .myshopify.com aparece ahí incluso cuando tu dominio principal es uno personalizado.

Tu dominio personalizado no funcionará. La instalación está ligada al dominio original de Shopify, y equivocarse de dominio cuesta una semana en vez de una tarde.

El enlace es exclusivo de tu tienda y caduca en una semana aproximadamente. Si caduca, pide otro.

Inicia sesión en el panel de administración antes de hacer clic en él

Abre admin.gamerbase.gg/admin e inicia sesión primero, en el mismo navegador. La instalación termina devolviéndote al panel de administración, y no puede hacerlo si no estás ya autenticado allí.

Aprueba los permisos en Shopify

El enlace te lleva a la pantalla de autorización de Shopify. Lee lo que pide la aplicación y después instálala.

Vuelve al panel de administración

Se te redirige de vuelta y la instalación se completa sola. No hay nada más que rellenar.

Verifícalo

En el panel de administración, ve a Settings y después a Automations. Shopify debería aparecer como conectado. Si no es así, la instalación no terminó, y la causa habitual es el paso tres.

El entorno de pruebas (sandbox) y producción son aplicaciones separadas, y no se cruzan. Una aplicación de sandbox se conecta solo a una tienda de desarrollo de Shopify, y la aplicación de producción se conecta solo a tu tienda real. Crea una tienda de desarrollo para las pruebas en lugar de apuntar el sandbox a tu tienda de verdad. Es gratis y ya está en modo de prueba.

Reglas de recompensa

Una regla de recompensa vigila tu tienda y entrega la recompensa cuando un pedido coincide con ella. Créalas en la sección de Shopify del panel de administración. Cada regla lleva un nombre, una descripción y una recurrencia.

CampoQué hace
NombreCómo llamas a la regla internamente.
DescripciónPara qué sirve la regla, pensando en quien la herede.
RecurrenciaOne time (una vez) recompensa a un fan determinado una sola vez, para siempre. Recurring (recurrente) recompensa cada vez que un pedido coincide.
RecompensaLo que recibe el fan. Mira la nota sobre los tipos de recompensa más abajo.

Hay tres tipos de regla.

Compra con etiqueta

Recompensa un pedido que contiene productos con una etiqueta que tú eliges. Eliges las etiquetas, y eliges si un pedido tiene que coincidir con alguna de ellas, con any, o con todas, con all.

Así recompensas una categoría sin enumerar productos. Etiqueta las camisetas, escribe una regla, y cada camiseta que añadas más adelante queda cubierta.

Cualquier compra

Recompensa todos los pedidos, se haya comprado lo que se haya comprado. Es la más sencilla de las tres, y la adecuada para «comprar en nuestra tienda, sea lo que sea, da puntos».

Importe gastado

La recompensa crece con el total del pedido. Fijas una tasa por unidad de la moneda de tu tienda, y la recompensa es la tasa multiplicada por el total del pedido, redondeada hacia abajo. Hoy no hay tope para un solo pedido, así que elige la tasa pensando en un pedido grande.

Tipos de recompensa

XP, tu moneda gastable y objetos coleccionables. Un premio o una caja de botín por una compra es de momento una recompensa manual. Recompensas explica la diferencia entre los tipos.

Cuando una compra no da nada

Un fan dice que compró algo y no recibió nada. Para cada pedido se comprueban siete cosas, en orden, y la primera que falla es la respuesta.

¿Por qué esta compra no ha dado nada?Pruébalo
  1. OK
  2. OK
  3. Se detiene aquí
  4. No alcanzado
  5. No alcanzado
  6. No alcanzado
  7. No alcanzado
Sin recompensa. Se detuvo en el paso 3. Quién lo arregla: El fan: comprar con el correo con el que juega.
Pulsa un paso para romperlo o arreglarlo. Solo cuenta el primer fallo: después de él no se comprueba nada.

Dos de ellas explican casi todos los casos. O la regla se creó después del pedido, y los pedidos anteriores a una regla nunca se recompensan. O el fan compró con un correo distinto del de su cuenta de fan, y el correo es lo único que conecta las dos cosas.

Un reembolso o un pedido cancelado no retira la recompensa.

Si tu propio sitio está construido con el SDK, mostrarle a un fan los puntos que le dio una compra es la única pieza que escriben tus desarrolladores. Recompensas por compras en la documentación del SDK lo explica, con las mismas siete comprobaciones vistas desde su lado.

Dos cosas que hay que prever

Los pedidos creados por canjes dentro de la aplicación se omiten. Cuando un fan compra un artículo de la tienda con puntos y la plataforma hace el pedido en tu tienda de Shopify, ninguna regla se activa con él. Sin eso, un fan podría gastar puntos para comprar algo, ganar puntos por la compra y repetirlo sin fin.

No hay notificación dentro de la aplicación cuando una compra da una recompensa. El saldo del fan sube y nada en la aplicación dice de dónde viene. Los socios lo resuelven mencionando la recompensa en el correo de confirmación de pedido de Shopify que ya envían. La notificación dentro de la aplicación está en la lista.

En tu escaparate

En desarrollo

Las funciones de FanBase estarán disponibles como bloques que añades a tu tema de Shopify en el editor de temas, sin código: las misiones, el perfil y el avatar de un fan, y un pequeño indicador de cuenta para tu cabecera. Un cliente que haya iniciado sesión en tu tienda entrará automáticamente en tu comunidad, en tus propias páginas, sin un segundo inicio de sesión.

La primera versión cubre las misiones, el perfil, el avatar y el indicador. Después llegan los bloques para la clasificación, la tienda, el battlepass, los eventos y el feed de noticias.

Con ella llega un cambio en el inicio de sesión. Asociar a un cliente con un fan existente por correo electrónico se aplicará solo en las tiendas que usan las new customer accounts (nuevas cuentas de cliente) de Shopify, en las que un cliente demuestra su dirección con un código. Con las classic customer accounts (cuentas de cliente clásicas), en las que un cliente elige una contraseña y nada demuestra la dirección, cada cliente recibirá su propia cuenta de fan. Si usas las cuentas clásicas y quieres que los clientes de la tienda y los fans existentes coincidan, merece la pena pasar a las nuevas cuentas de cliente en la configuración de Shopify, en Settings y después Customer accounts, antes de que los bloques lleguen a tu tienda.

Se está desplegando tienda por tienda, empezando por las comunidades piloto. Se instala desde un enlace, como la conexión de arriba, y no pide ningún permiso sobre tu tienda. La configuración, los ajustes de cada bloque y cómo darles el estilo de tu tema están en Bloques para el escaparate. Pregunta a tu contacto de FanBase en qué punto del despliegue está tu tienda.

Gastar puntos en Shopify

Un fan compra un artículo de la tienda con puntos dentro de la aplicación, y aparece un pedido real en tu Shopify, asociado a su ficha de cliente, listo para que lo tramites igual que cualquier otro pedido. Disponible desde el 7 de octubre de 2026.

Al fan nunca se le cobra dinero. El pedido llega a Shopify ya marcado como pagado, porque pagó con puntos.

Activarlo para un artículo

Autoriza tu tienda para los pedidos

Crear pedidos necesita un permiso que la instalación original no pedía. El panel de administración muestra un aviso en la sección de Shopify cuando hay que volver a autorizar tu tienda. Es una sola aprobación en Shopify, que se hace una vez.

Activa Fulfil via Shopify

En el artículo, activa Fulfil via Shopify (tramitar el pedido con Shopify). El interruptor sigue desactivado hasta que haya una tienda conectada, y así lo indica.

Elige el producto y la variante

Elige el producto de tu catálogo de Shopify y después la variante. El panel rellena el título del producto y el SKU para que puedas comprobar que has elegido el correcto.

Guarda

Activar la tramitación con Shopify añade un correo electrónico y una dirección de envío a lo que el artículo pide al fan al finalizar la compra. No tienes que añadirlos tú.

Qué hace el fan

Compra el artículo con puntos, como haría con cualquier otro. Antes de que la compra se complete se le pide un correo electrónico y una dirección de entrega, con un nombre para el paquete. Si ya los dio antes, aparecen rellenados.

Qué llega a Shopify

En el pedidoValor
ClienteEl fan, encontrado o creado a partir de su correo
Dirección de envíoLa dirección que introdujo
Estado del pagoPagado
Etiquetafanbase-redemption

La etiqueta es la forma de distinguir estos pedidos en tu panel de control de Shopify, y la forma en que FanBase sabe que no debe aplicarles las reglas de recompensa.

Seguir un pedido

Cada compra en la pestaña de distribución de la tienda muestra su pedido de Shopify y en qué punto está. Si falla la creación de un pedido, por ejemplo porque Shopify no estaba accesible, FanBase lo vuelve a intentar por su cuenta, y tú puedes reintentarlo desde la misma pestaña. Un fan que ha pagado con puntos no pierde el artículo por un intento fallido.

Tres límites que hay que tener en cuenta

  • Un artículo es una sola variante. Una talla M y una talla L son dos artículos, cada uno asociado a su propia variante. Las variantes en un mismo artículo están en desarrollo.
  • Solo compras en la tienda. Un premio físico ganado en una misión, un evento o una caja de botín no se envía a Shopify. Esos los gestionas a mano, como antes. Consulta Recompensas personalizadas.
  • El artículo tiene su propio stock. La cantidad que fijas en el artículo es lo que limita las ventas en la aplicación. Ponla en lo que de verdad puedes enviar.

Combínalo con un límite de compra en todo lo que sea escaso, para que un fan con un saldo grande no pueda llevárselo todo.

Distribución de códigos

En desarrollo

Códigos de descuento y códigos de regalo que se entregan como recompensa. Consulta Recompensas.

En esta página