Usted está aquí:
Noticias en tiempo real de datos de ETL de transacciones
Utilice las noticias en tiempo real de datos de Transaction ETL para cargar transacciones de forma masiva para asociar compras de artículos con perfiles de usuario individuales.
Acerca de la introducción de datos de transacciones
Estas noticias en tiempo real de datos de ETL importan transacciones en Personalización y las asocian con perfiles de usuario asignando a un perfil de usuario existente o creando un perfil de usuario cuando no hay uno coincidente.
Cada transacción consta de una lista de registros consecutivos para partidas individuales que tienen todas el mismo transactionId. Todos los registros de una transacción deben tener los mismos valores userId y purchaseDate. Cada registro en una transacción debe tener un productId, un precio y una cantidad.
Ordene el archivo por Id. de transacción. Puede ordenar el archivo usted mismo antes de cargarlo, o puede activar la clasificación en la página Configuración de engranaje seleccionando la opción Ordenar antes de agrupación de ETL de transacción. Si el archivo no está ordenado, Personalización no lo carga, de modo que debe ordenar y volver a enviar el archivo para procesarlo.
Al actualizar una transacción con nueva información, todo el contenido de la transacción debe estar presente en el archivo, incluso si no están cambiando. La personalización sobrescribe cualquier registro almacenado previamente para la transacción si un archivo contiene un transactionId para una transacción registrada anteriormente. Las actualizaciones en pedidos existentes no actualizan estadísticas derivadas del pedido original, como Valor de vida o estadísticas de compra diaria.
Requisitos
- Los archivos ETL deben estar en un formato de archivo CSV que se adhiera al esquema para las noticias en tiempo real de datos. Los archivos que no siguen las convenciones de nomenclatura de archivos o el esquema apropiado dan como resultado errores y no se procesan.
- Los nombres de campo que comiencen por
attribute:deben coincidir con los nombres de atributo personalizados de la ficha Atributos de usuario de la página Configuración > Atributos.
Formato de nombre de archivo
transaction-YYYY-MM-DD_HH-MM-SS.csv
Esquema
| Nombre del campo | Descripción | Valores de ejemplo | Longitud máxima | Tipo de datos |
|---|---|---|---|---|
|
Obligatorio. Solo se pueden incluir y actualizar identidades exclusivas a través de noticias en tiempo real de ETL. Si no está utilizando el sistema de identidades múltiples de Personalización, se debe incluir un Id. de usuario. Este Id. debe ser de seguimiento dentro del sistema de modo que los eventos puedan vincularse al perfil de usuario específico. Si está utilizando el sistema de identidades múltiples de Personalización, no se hace referencia a userId en archivos ETL. Se requiere al menos un atributo de identidad. Se pueden incluir múltiples atributos de identidad para un único usuario incluyendo múltiples columnas en el archivo. Existe un límite de cinco atributos de identidad para el ETL de transacciones. El formato de encabezado correcto para atributos de identidad es |
user168515262 jdoe@test.com attribute:emailAddress attribute:sfmcContactKey atributo:customerId attribute:sfcrmContactId attribute:sfcrmLeadId |
120 |
Cadena |
transactionId
|
Obligatorio. Representa un identificador exclusivo para una compra individual. Todas las partidas de una transacción deben tener el mismo Id. de transacción. |
860340254 |
255 |
Cadena |
purchaseDate
|
Obligatorio. Una cadena de fecha y hora ISO 8601 para cuando se produjo la transacción. El primer registro para una transacción define la fecha para el pedido general. Todas las fechas se almacenan en la hora UTC. No se admiten las compensaciones de zona horaria. |
2022-04-12 2022-04-12T11:24:59Z |
1023 |
Cadena |
productId
|
Obligatorio. Representa el producto de su catálogo que se adquirió en la transacción. Si el Id. no coincide con un producto existente en su catálogo, Personalización crea un elemento con el productId en el catálogo. |
prod001 |
255 |
Cadena |
price
|
Obligatorio. Precio unitario cargado al usuario. Este campo se multiplica por la cantidad para determinar el valor total de esta partida. Por ejemplo, si el precio es 1,10 $ y la cantidad es 3, el valor total de la partida es 3,30 $. Utilice un punto como separador decimal. No utilice separadores de miles. |
150 63.25 10 |
1023 |
Decimal |
quantity
|
Obligatorio. Representa la cantidad neta adquirida. Este campo se multiplica por el precio para determinar el coste total de esa partida en la transacción. A continuación, se agregan todas las partidas para determinar el valor total del pedido. |
1 50 100 |
1023 |
Entero |
attribute:currency
|
Un código de divisa ISO 4217 de tres letras mayúsculas para la transacción. La divisa debe ser coherente en todos los registros de una transacción. Si no se proporciona divisa, la divisa toma como valor predeterminado la divisa para ese conjunto de datos. |
USD CAD EUR |
3 |
Cadena |
attribute:shipStatus
|
Representa el estado del pedido. Los valores posibles son los siguientes: enviado, entregado, procesamiento |
enviado delivered procesamiento |
1023 |
Cadena |
attribute:quantityReturned
|
Representa el número de artículos devueltos. |
0 25 100 |
1023 |
Cadena |
Estructura de archivo de ejemplo: No utilizar el sistema de múltiples identidades
| transactionId | userId | purchaseDate | productId | price | quantity | atributo:divisa | attribute:emailAddress | atributo:shipStatus | attribute:quantityReturned |
139502841 |
user103925 |
2022-04-12 |
prod001 |
100.12 |
2 |
USD |
test@test.com |
procesamiento |
0 |
139502841 |
user103925 |
2022-04-12 |
prod001923 |
15.09 |
1 |
USD |
test@test.com |
procesamiento |
0 |
139502841 |
user103925 |
2022-04-12 |
prod005 |
44 |
1 |
USD |
test@test.com |
procesamiento |
0 |
492481058 |
user049245 |
2022-04-12T10:23:37Z |
prod999 |
1.00 |
50 |
EUR |
user04925@test.com |
enviado |
10 |
860340254 |
user01499 |
2022-01-30 |
prod002244 |
15.15 |
3 |
AUD |
delivered |
||
860340255 |
user2201 |
2022-03-15 |
prod1101 |
22.99 |
2 |
CAD |
delivered |
Estructura de archivo de ejemplo: Uso del sistema de múltiples identidades
| transactionId | attribute:emailAddress | attribute:sfcrmLeadId | purchaseDate | productId | price | quantity | atributo:divisa | atributo:shipStatus | attribute:quantityReturned |
139502841 |
test@test.com |
2022-04-12 |
prod001 |
100.12 |
2 |
USD |
procesamiento |
0 |
|
139502841 |
test@test.com |
2022-04-12 |
prod001923 |
15.09 |
1 |
USD |
procesamiento |
0 |
|
139502841 |
test@test.com |
2022-04-12 |
prod005 |
44 |
1 |
USD |
procesamiento |
0 |
|
492481058 |
user04925@test.com |
02941850249856 |
2022-04-12T10:23:37Z |
prod999 |
1.00 |
50 |
EUR |
enviado |
10 |
860340254 |
561716831115090 |
2022-01-30 |
prod002244 |
15.15 |
3 |
AUD |
delivered |
||
860340255 |
981361079810570 |
2022-03-15 |
prod1101 |
22.99 |
2 |
CAD |
delivered |
