Importación de cohortes de Treasure Data

Este artículo describe cómo importar cohortes de usuarios de Treasure Data a Braze para que puedas enviar campañas segmentadas basadas en datos que solo pueden existir en tu almacén de datos.

Importante

Esta función está actualmente en fase beta. Para más información, ponte en contacto con tus representantes de Treasure Data y Braze.

Requisitos previos

Integración de la importación de datos

Paso 1: Obtén tu clave de importación de datos de Braze

En Braze, ve a Integraciones de socios > Socios tecnológicos y selecciona Treasure Data. Aquí encontrarás tu punto de conexión REST y podrás generar tu clave de importación de datos de Braze. Una vez generada la clave, puedes crear una nueva o invalidar una existente.

Paso 2: Crea una conexión de datos

Antes de crear tu conexión de datos en Treasure Data, tendrás que autenticarte. Primero, selecciona Integrations Hub y, a continuación, Catalog.

Busca la integración de Braze en el Catalog, pasa el cursor sobre el icono y selecciona Create Authentication. Introduce tus credenciales, asigna un nombre a la autenticación y selecciona Done.

Paso 3: Define la audiencia de tu cohorte

Sincroniza tus cohortes con Braze mediante una activación en Audience Studio o ejecutando una consulta en Data Workbench.

Importante

Solo se añaden o eliminan de una cohorte los usuarios que ya existen en Braze. La importación de cohortes no creará nuevos usuarios en Braze.

• data workbench
• audience studio

Paso 3.1: Define tu consulta

Nota

Las columnas de consulta deben especificarse con los nombres de columna y el tipo de datos exactos. Las columnas de consulta deben incluir al menos una de las columnas: user_ids, device_ids, o la columna de alias de Braze que coincida con la configuración en la interfaz de usuario. Solo se añadirán a una cohorte los perfiles de usuario que existan en Braze. La importación de cohortes no creará nuevos perfiles de usuario.

1. Ve a Data Workbench > Queries.
2. Selecciona New Query.
3. Ejecuta la consulta para validar el conjunto de resultados.

Caso de uso: Sincronización de cohortes por identificador

• syncing external ids
• syncing user aliases
• syncing device ids

Aquí tienes una tabla de ejemplo en Treasure Data:

external_id	email	device_ids
TDCohort1	[email protected]	1a2b3c
TDCohort2	[email protected]	4d5f6g
TDCohort3	[email protected]	7h8j9k
TDCohort4	[email protected]	1ab2cd

Advertencia

El nombre de la columna debe ser user_ids o la sincronización fallará.

Para sincronizar cohortes utilizando el ID externo, ejecuta la siguiente consulta:

1
2
3
4
SELECT
  external_id as user_ids
FROM
  example_cohort_table

Tras ejecutar la consulta, estos alias de usuario se añadirán a la cohorte en Braze:

• TDCohort1
• TDCohort2
• TDCohort3
• TDCohort4

Aquí tienes una tabla de ejemplo en Treasure Data:

external_id	email	device_ids
TDCohort1	[email protected]	1a2b3c
TDCohort2	[email protected]	4d5f6g
TDCohort3	[email protected]	7h8j9k
TDCohort4	[email protected]	1ab2cd

Para sincronizar cohortes utilizando el alias de usuario, ejecuta la siguiente consulta:

1
2
3
4
SELECT
  email
FROM
  example_cohort_table

Tras ejecutar la consulta, estos alias de usuario se añadirán a la cohorte en Braze:

• "alias_label":"email", "alias_name":"[email protected]"
• "alias_label":"email", "alias_name":"[email protected]"
• "alias_label":"email", "alias_name":"[email protected]"
• "alias_label":"email", "alias_name":"[email protected]"

Aquí tienes una tabla de ejemplo en Treasure Data:

external_id	email	device_ids
TDCohort1	[email protected]	1a2b3c
TDCohort2	[email protected]	4d5f6g
TDCohort3	[email protected]	7h8j9k
TDCohort4	[email protected]	1ab2cd

Advertencia

El nombre de la columna debe ser device_ids o la sincronización fallará.

Para sincronizar cohortes utilizando el ID de dispositivo, ejecuta la siguiente consulta:

1
2
3
4
SELECT
  device_ids
FROM
  example_cohort_table

Tras ejecutar la consulta, estos ID de dispositivo se añadirán a la cohorte en Braze:

• 1a2b3c
• 4d5f6g
• 7h8j9k
• 1ab2cd

Paso 3.2: Especifica el destino de la exportación de resultados

Una vez creada la consulta, selecciona Export Results. Puedes seleccionar una autenticación existente, como la creada en los pasos anteriores, o crear una nueva autenticación que se utilizará para la salida.

Mapeado de resultados de exportación	Descripción
ID de cohorte	Este es el identificador de cohorte del backend que se enviará a Braze.
Nombre de la cohorte (opcional)	Este es el nombre que aparecerá dentro del filtro de cohortes en la herramienta de segmentación de Braze. Si no se configura, se utilizará Cohort ID como Cohort Name.
Operación	Se utiliza para determinar si la consulta debe añadir o eliminar perfiles de la cohorte en Braze.
Alias (opcional)	Cuando se define, el nombre de la columna correspondiente dentro de tu consulta se enviará como alias_label, y los valores de cada fila de la columna se enviarán como alias_name.
Número de hilos	Número de llamadas concurrentes a la API.

Sigue los pasos de Treasure Data para configurar tu exportación según tu caso de uso.

Paso 3.3: Ejecuta la consulta

Guarda la consulta con un nombre y ejecútala, o simplemente ejecútala. Una vez completada con éxito la consulta, el resultado se exporta automáticamente a Braze.

Paso 3.1: Crea una activación

Crea un nuevo segmento o elige un segmento existente para sincronizarlo con Braze como cohorte. Dentro del segmento, selecciona Create Activation.

Paso 3.2: Completa los detalles de tu activación

Configuración de detalles de activación	Descripción
Nombre de activación	El nombre de tu activación.
Descripción de la activación	Una breve descripción de la activación.
Autenticación	Elige la autenticación de cohorte de Braze creada en el paso 2.
ID de cohorte	Este es el identificador de cohorte del backend que se enviará a Braze.
Nombre de la cohorte (opcional)	Este es el nombre que aparecerá dentro del filtro de cohortes en la herramienta de segmentación de Braze. Si no se configura, se utilizará Cohort ID como Cohort Name.
Operación	Se utiliza para determinar si la consulta debe añadir o eliminar perfiles de la cohorte en Braze.
Alias (opcional)	Cuando se define, el nombre de la columna correspondiente dentro de tu consulta se enviará como alias_label, y los valores de cada fila de la columna se enviarán como alias_name.
Número de hilos	Número de llamadas concurrentes a la API.

Paso 3.3: Configura el mapeado de salida

Mapeado de salida de activación	Descripción
Columnas de atributos	Determina las columnas de tu base de datos de segmentos que se mapearán como identificadores al sincronizar perfiles con una cohorte de Braze.
Constructor de cadenas	El constructor de cadenas no es necesario para la integración de Braze.

Importante

• Si se utiliza device_id como identificador, el Output Column Name debe ser device_ids.
• Cuando utilices alias como identificador, el Output Column Name debe ser el nombre de la columna correspondiente dentro de tu consulta, que se enviará como alias_label, y los valores de cada fila de la columna se enviarán como alias_name.
• Si se utiliza external_id como identificador, el Output Column Name debe ser user_ids.

Se ignorarán todos los nombres de columnas no relevantes o con nombres erróneos. Puedes elegir utilizar más de un identificador en tus sincronizaciones.

Paso 3.4: Define tu calendario de activación

Define el calendario de sincronización que desees y guarda la activación.

Paso 4: Crea un segmento de Braze a partir de la exportación de Treasure Data

En Braze, ve a Segments, crea un nuevo segmento y selecciona Treasure Data Cohorts como filtro. Desde aquí, puedes elegir qué cohorte de Treasure Data deseas incluir. Una vez creado tu segmento de cohorte de Treasure Data, puedes seleccionarlo como filtro de audiencia al crear una campaña o Canvas.

Coincidencia de usuarios

Los usuarios identificados pueden coincidir por su external_id o alias. Los usuarios anónimos pueden coincidir por su device_id. Los usuarios identificados que fueron creados originalmente como usuarios anónimos no pueden ser identificados por su device_id, y deben ser identificados por su external_id o alias.