El model de dades de Pleasepoint.

En aquest article et descrivim l'arquitectura de dades necessària per començar a utilitzar la intel·ligència artificial de Pleasepoint. Aquí trobaràs tota la informació sobre les entitats inicials de dades, els seus atributs i el format en què les has d'extreure per a una primera càrrega amb fitxers CSV.

Aquest és el contingut de l'article:

1. Entitats de dades.
2. Taula de clients.
3. Taula de productes.
4. Taula de botigues (opcional).
5. Taula de tickets.
6. Taula de línies de ticket.

Pleasepoint també treballa amb les dades d'interacció, però no són imprescindibles per a una primera càrrega de dades. En aquest enllaç trobaràs el detall de com utilitzar les dades d'interacció.

Entitats de dades.

Pleasepoint utilitza l'històric de les dades transaccionals per entendre els patrons de compra i la propensió de compra de cadascun dels clients. Per fer-ho utilitza 5 entitats de dades:

1. Customers/Clients: Taula amb tota la informació disponible del client.
2. Products/Productes: Taula amb tota la informació disponible dels productes. En aquest cas es requereix tot l'històric de productes, estiguin actius o no en aquest moment.
3. Shops/Botigues: Aquesta taula és opcional, fa referència al canal de venda o a les botigues/establiments. En el cas de ser només el canal eCommerce no es requereix aquesta entitat.
4. Orders/Tickets: Tota la informació dels tickets de compra. El ticket es relaciona amb l'identificador del client i l'identificador de la botiga.
5. Line orders/Línies de ticket: Tota la informació del contingut dels tickets. La línia de ticket es relaciona amb l'identificador del ticket i l'identificador del producte.

Aquest és el diagrama de classes de les diferents entitats:

Taula de clients.

Aquesta és l'estructura de la taula de clients que s'ha d'extreure. El fitxer resultant ha de ser un CSV en UTF8.

Aquests són els atributs principals de la taula de clients:

• reference_id (Obligatori, primary key, text): Identificador únic del client. Aquest identificador s'utilitzarà per relacionar els tickets i els clients.
• contact_id (Opcional, unique, text): Identificador únic del client. Aquest identificador normalment s'utilitza per relacionar el client en altres sistemes, com per exemple el CRM.
• name (Opcional, text): Nom del client. Aquest camp pot estar anonimitzat.
• surname (Opcional, text): Cognoms del client. Aquest camp pot estar anonimitzat.
• email (Opcional, Unique, text): Email electrònic del client. Aquest camp pot estar anonimitzat.
• email_validated (Opcional, booleà): Email validat correctament.
• email_communications (Opcional, booleà): Nom del client.
• phone (Opcional, text): Telèfon del client.
• address (Opcional, text): Adreça del client.
• postal_code (Opcional, text): Codi postal del client.
• city (Opcional, text): Ciutat del client.
• gender (Opcional, nombre enter): Gènere del client, amb els valors: 1 per a dona, 2 per a home i 0 per a altres o desconegut.
• birth_date (Opcional, data): Data d'aniversari.

La taula de clients, i la de qualsevol entitat, accepta qualsevol altre atribut, i permet així afegir tota la informació que tinguis recopilada del client.

Aquest seria un exemple d'exportació de dades:

Taula de productes.

Aquesta és l'estructura de la taula de productes que s'ha d'extreure. El fitxer resultant ha de ser un CSV en UTF8.

Aquests són els atributs principals de la taula de productes:

• reference_id (Obligatori, primary key, text): Identificador únic del producte. Aquest identificador s'utilitzarà per relacionar els productes i les línies de ticket.
• name (Obligatori, text): Nom del producte.
• price (Obligatori, nombre): Preu del producte
• margin (Opcional, nombre): Marge del producte
• description (Obligatori, text): Descripció del producte.
• category_n1 (Obligatori, text): Primer nivell de categories de producte.
• category_n2 (Opcional, text): Segon nivell de categories de producte.
• category_n3 (Opcional, text): Tercer nivell de categories de producte.
• category_n4 (Opcional, text): Quart nivell de categories de producte.
• category_n5 (Opcional, text): Cinquè nivell de categories de producte.
• category_nX (Opcional, text): Nivell X de categories de producte.
• total_stock (Obligatori, nombre enter): Stock del producte. Pots utilitzar 0 per a productes no disponibles i 1 per a productes actius.
• url (Opcional, text): Url per accedir a la pàgina de producte (PDP).
• image_url (Opcional, text): Url de la imatge principal del producte. Aquesta imatge serà la que utilitzarà el SDK de Pleasepoint per mostrar la recomanació.

La taula de productes, i la de qualsevol entitat, accepta qualsevol altre atribut, i permet així afegir tota la informació que permeti etiquetar el producte, com ara marca, estil, col·lecció, temporada, ús, ingredient principal...

Aquest seria un exemple d'exportació de dades:

Taula de botigues.

Aquesta és l'estructura de la taula de botigues que s'ha d'extreure. El fitxer resultant ha de ser un CSV en UTF8. Quan només existeix un canal de venda aquesta taula no és necessària.

Aquests són els atributs principals de la taula de botigues:

• reference_id (Obligatori, primary key, text): Identificador únic de la botiga. Aquest identificador s'utilitzarà per relacionar les botigues i els tickets.
• name (Obligatori, text): Nom de la botiga.
• description (opcional, text): Descripció de la botiga.
• type (opcional, text): Tipus de la botiga.
• location (opcional, text): Tipus de localització de la botiga. Centre comercial, centre ciutat, online, outlet...
• city (opcional, text): Ciutat de la botiga.
• country (opcional, text): País de la botiga.

La taula de botigues, i la de qualsevol entitat, accepta qualsevol altre atribut, i permet així afegir informació addicional a cadascuna de les botigues.

Aquest seria un exemple d'exportació de dades:

Taula de tickets.

Aquesta és l'estructura de la taula de tickets que s'ha d'extreure. El fitxer resultant ha de ser un CSV en UTF8.

Aquests són els atributs principals de la taula de tickets:

• reference_id (Obligatori, primary key, text): Identificador únic del ticket. Aquest identificador s'utilitzarà per relacionar els tickets i les línies de ticket.
• reference_date (Obligatori, data): Data de realització del ticket, el moment en què el client fa la compra.
• user_reference_id (Obligatori, foreign key, data): Identificador del client. Aquesta columna es relaciona amb el reference_id del client.
• shop_reference_id (Obligatori, foreign key, data): Identificador de la botiga. Aquesta columna es relaciona amb el reference_id de la botiga.
• total_amount (Obligatori, nombre): Valor total del ticket.
• total_discount (Opcional, nombre): Valor total del descompte aplicat.
• discount_code (Opcional, text): Codi de descompte aplicat.
• discount_type (Opcional, text): Tipus de descompte aplicat.

La taula de tickets, i la de qualsevol entitat, accepta qualsevol altre atribut, i permet així afegir informació addicional a cadascun dels tickets.

Aquest seria un exemple d'exportació de dades:

Taula de línies de tickets.

Aquesta és l'estructura de la taula de línies de tickets que s'ha d'extreure. El fitxer resultant ha de ser un CSV en UTF8.

Aquests són els atributs principals de la taula de línies de tickets:

• ticket_reference_id (Obligatori, primary key, text): Identificador únic del ticket. Aquest identificador s'utilitzarà per relacionar els tickets i les línies de ticket.
• product_reference_id (Obligatori, foreign key, data): Identificador del client. Aquesta columna es relaciona amb el reference_id del client.
• quantity (Obligatori, nombre): Valor total d'unitats del producte al ticket.
• price (Obligatori, nombre): Valor total del producte al ticket.
• discount_code (Opcional, text): Codi de descompte aplicat.
• discount_value (Opcional, text): Valor de descompte aplicat al preu total (price).
• variation_id (Opcional, text): Identificador de la variació del producte.

La taula de línies de tickets, i la de qualsevol entitat, accepta qualsevol altre atribut, i permet així afegir informació addicional a cadascuna de les línies de ticket.

Aquest seria un exemple d'exportació de dades: