Configuración de la integración estándar de Shopify

Esta página te explica cómo integrar Braze con Shopify utilizando nuestra integración estándar para usuarios con una tienda online en Shopify. Si utilizas un sitio web Shopify headless o buscas implementar soluciones más personalizadas, consulta Configuración de la integración personalizada de Shopify.

Paso 1: Conecta tu tienda Shopify

1. En Braze, ve a Integraciones de socios > Socios tecnológicos y busca “Shopify”.

2. En la página del socio de Shopify, selecciona Comenzar configuración para iniciar el proceso de integración.



3. En la tienda de aplicaciones de Shopify, instala la aplicación Braze.

4. Tras instalar la aplicación Braze, se te redirigirá a Braze para que confirmes el espacio de trabajo que deseas conectar a Shopify. Una tienda Shopify sólo puede conectarse a un espacio de trabajo. Si necesitas cambiar, selecciona el espacio de trabajo correcto.

5. Selecciona Iniciar configuración.

Paso 2: Habilitación de los SDK Web de Braze

Para las tiendas online de Shopify, puedes seleccionar la configuración estándar para implementar automáticamente el SDK Web y el SDK JavaScript de Braze.

Después de seleccionar la ruta de incorporación de la configuración estándar, tendrás que elegir cuándo Braze debe inicializarse y cargar los SDK de una de las siguientes opciones:

• En el momento de la visita, como el inicio de la sesión
  • Realiza un seguimiento tanto de los usuarios identificados como de los anónimos
• Al registrar la cuenta, como iniciar sesión en la cuenta
  • Rastrear solo a los usuarios identificados
  • Inicia el seguimiento de los datos cuando los visitantes del sitio se registran o acceden a sus cuentas

Paso 3: Configura tus datos de Shopify

Configuración de datos estándar

Ahora seleccionarás los datos de Shopify de los que quieres hacer seguimiento.

Los siguientes eventos estarán habilitados por defecto en la integración estándar.

Para más información sobre los datos que se siguen a través de la integración, consulta Características de los datos de Shopify.

Configuración histórica del relleno

A través de la configuración estándar, tienes la opción de realizar una carga inicial de tus clientes y pedidos de Shopify de los últimos 90 días antes de tu conexión de integración con Shopify. Para ello, marca la casilla de verificación para incluir la carga inicial de datos como parte de tu integración.

Esta tabla contiene los datos que se cargarán inicialmente a través del relleno.

Cuando tus registros de cliente de Shopify se carguen en Braze, el ID de cliente de Shopify se utilizará como ID externo de Braze.

(Avanzado) Configuración personalizada del seguimiento de datos

Con los SDK de Braze, puedes hacer un seguimiento de eventos personalizados o atributos personalizados que vayan más allá de los eventos estándar para esta integración. Los eventos personalizados capturan interacciones únicas en tu tienda, como:

El seguimiento de datos de clientes te ayuda a obtener información más profunda sobre el comportamiento del usuario y a personalizar aún más su experiencia. Para implementar eventos personalizados, tienes que editar el código del tema de tu tienda en el archivo theme.liquid. Puede que necesites ayuda de tus desarrolladores.

Por ejemplo, el siguiente fragmento de código de JavaScript rastrea si el usuario actual se suscribe a un boletín de noticias y lo registra como un evento personalizado en su perfil de Braze:

1
2
3
4
5
6
7
8
9
braze.logCustomEvent(
  “subscribed_to_newsletter”,
  {
    newsletterName: ‘News and Offers’,
    customerEmail: ‘customer_1@gmail.com’,
    sendOffers: true
  }
);

El SDK debe estar inicializado (a la escucha de la actividad) en el dispositivo de un usuario para registrar eventos o atributos personalizados. Para saber más sobre el registro de datos personalizados, consulta el objeto Usuario y el objeto logCustomEvent.

Paso 4: Configura cómo gestionas a los usuarios

Selecciona tu tipo de external_id en el desplegable.

Si has seleccionado un tipo de ID externo personalizado, sigue los pasos 4.1 y 4.2. De lo contrario, continúa con el paso 4.3.

Paso 4.1: Crear un personalizado external_id

Primero, ve a Shopify y crea el metacampo braze.external_id. Te recomendamos que sigas los pasos indicados en Crear descripciones de metacampos personalizadas. Para Espacio de nombres y clave, introduce braze.external_id. Para el Tipo, te recomendamos que elijas un tipo de ID.

Después de crear el metacampo, escucha los webhooks decustomer/create para que puedas escribir el metacampo cuando se cree un nuevo cliente. A continuación, utiliza la API de administración o la API de clientes para rellenar todos tus clientes creados previamente con este metacampo.

Paso 4.2: Crear un punto final

Necesitas un punto final GET público para recuperar tu ID externo. Si Shopify no puede proporcionar el metacampo, Braze llamará a ese punto final para recuperar el ID externo.

Un ejemplo de punto final es https://mystore.com/custom_id?shopify_customer_id=1234&[email protected]&shopify_storefront=dev-store.myshopify.com

Respuesta

Braze espera un código de estado 200. Cualquier otro código se considera un fallo del punto final. La respuesta debe ser:

1
{ "external_id": "my_external_id" }

Valida la dirección shopify_customer_id y la dirección de correo electrónico utilizando la API de administración o la API de cliente para confirmar que los valores de los parámetros coinciden con los valores del cliente en Shopify. Tras la validación, también podrías utilizar las API para recuperar el metacampo braze.external_id y devolver el valor del ID externo.

Paso 4.3: Recoger tus adhesiones voluntarias por correo electrónico o SMS desde Shopify (opcional)

Tienes la opción de recopilar tus adhesiones voluntarias de marketing por correo electrónico o SMS desde Shopify.

Si utilizas los canales de correo electrónico o SMS, puedes sincronizar tus estados de adhesión voluntaria por correo electrónico y marketing por SMS en Braze. Si sincronizas las adhesiones voluntarias de marketing por correo electrónico desde Shopify, Braze creará automáticamente un grupo de suscripción por correo electrónico para todos los usuarios asociados a esa tienda específica. Tienes que crear un nombre único para este grupo de suscripción.

Paso 5: Sincronizar productos (opcional)

Puedes sincronizar todos los productos de tu tienda Shopify con un catálogo Braze para una mayor personalización de la mensajería. Las actualizaciones automáticas se producen casi en tiempo real para que tu catálogo refleje siempre los detalles más recientes de los productos. Para saber más, consulta la sincronización de productos de Shopify.

Paso 6: Activar canales (opcional)

Puedes habilitar los mensajes dentro de la aplicación sin recurrir a un desarrollador configurándolos en tu configuración.

Compatibilidad con canales SDK adicionales

Los SDK de Braze habilitan varios canales de mensajería, incluidas las tarjetas de contenido.

Tarjetas de contenido y banderas de características

Para añadir tarjetas de contenido o banderas de características, tendrás que colaborar con tus desarrolladores para insertar el código SDK necesario directamente en tu archivo theme.liquid. Para obtener instrucciones detalladas, consulta Integrar el SDK de Braze.

Notificaciones push web

El push web no es compatible actualmente con la integración de Shopify. Si quieres que esto se admita en el futuro, envía una solicitud de producto a través del portal de productos Braze.

Si deseas que esto se admita en el futuro, envía una solicitud de producto a través del portal de productos Braze.

Paso 7: Configuración de acabado

1. Después de configurar tu configuración, selecciona Finalizar configuración.
2. Habilita la incrustación de la aplicación Braze en la configuración de tu tema de Shopify. Selecciona Abrir Shopify para ser redirigido a tu cuenta de Shopify y habilitar la incrustación de la aplicación en la configuración del tema de tu tienda.

3. Después de habilitar la incrustación de la aplicación, ¡la configuración está completa! Confirma que puedes ver tu configuración de integración, el estado de la sincronización inicial de datos y tus eventos de Shopify activos.