Ejemplo: Generación automática de un juego de filtros de datos
Jim necesita crear un conjunto de filtros de datos según los países, las ciudades y los estados.
En Campaign, las tablas de clientes ya se han correlacionado y los niveles de audiencia se han definido.
Obtención del controlador JDBC
Jim sabe que la base de datos de clientes de su empresa es Microsoft SQL Server. Descarga el controlador tipo 4 adecuado, lo coloca en la máquina donde se ha instalado Marketing Platform y anota el nombre y la ruta del controlador.
*
Nombre de clase del controlador JDBC: com.microsoft.sqlserver.jdbc.SQLServerDriver
*
Ruta del controlador JDB: C:\tools\Java\MsJdbc\sqljdbc.jar
Obtención de información
Jim obtiene el nombre, el host y el puerto de la base de datos de clientes y las credenciales que necesita para conectarla.
*
*
*
*
*
Jim analiza los datos incluidos en la base de datos de clientes de su empresa y observa que hay clientes en todos los países, ciudades y estados para los que desea crear filtros de datos. Determina que la tabla geográfica contiene los campos que necesita para especificar campos fijos y campos de perfil para los filtros de datos.
En la siguiente tabla se ilustra la información que Jim obtiene sobre los campos de clientes y sus correlaciones de Campaign.
(Nombre en Campaign)
Jim se entera de que los nombres de audiencia utilizados en Campaign son familiares e individuales. Observa que la tabla geográfica contiene dos campos de audiencia.
*
El campo hh_id corresponde a la audiencia familiar.
*
El campo indiv_id en la tabla Geográfica corresponde a la audiencia individual.
Debido a que Jim debe crear un campo lógico para cada audiencia y uno para cada uno de los campos fijos y de perfil, sabe que necesita un total de cinco campos lógicos.
Jim también sabe que necesita agrupar los filtros de datos en una configuración de datos. Decide denominar a su configuración de datos Geográfica.
Jim está listo para crear el XML.
Creación del XML
A continuación se muestra el XML que Jim crea. Los valores basados en la información que obtuvo o decidió usar se muestran en negrita.
<?xml version="1.0" encoding="UTF-8"?>
<ExecuteBatch>
<name>SeedData</name>
<operations>
<!-- Crear la configuración de datos que agrupa Filtros de datos relacionados -->
<ExecuteBatch>
<name>DataFilters</name>
<operations>
<AddDataConfiguration>
<dataConfiguration>
<id>1</id>
<name>
Geográfica</name>
</dataConfiguration>
</AddDataConfiguration>
</operations>
</ExecuteBatch>
<!-- Añadir los campos lógicos utilizados para definir los filtros de datos -->
<AddLogicalFields>
<logicalFields>
<LogicalField>
<id>1</id>
<name>
País</name>
<type>java.lang.String</type>
</LogicalField>
<LogicalField>
<id>2</id>
<name>Ciudad</name>
<type>java.lang.String</type>
</LogicalField>
<LogicalField>
<id>3</id>
<name>Estado</name>
<type>java.lang.String</type>
</LogicalField>
<LogicalField>
<id>4</id>
<name>HouseholdID</name>
<type>java.lang.Long</type>
</LogicalField>
<LogicalField>
<id>5</id>
<name>IndividualID</name>
<type>java.lang.Long</type>
</LogicalField>
</logicalFields>
</AddLogicalFields>
<!-- Proporcionar la información necesaria para generar los filtros de datos -->
<GenerateDataFilters>
<!-- Especificar la tabla que se leerá para obtener combinaciones únicas de valores
a partir de los cuales se definirán los filtros de datos. -->
<tableName>
Geográfica</tableName>
<!-- Identificar la configuración de los datos
con los que se asociarán los filtros de datos generados. -->
<configurationName>Geográfica</configurationName>
<!-- Especificar la información de conexión del origen de los datos. -->
<jdbcUrl>jdbc:sqlserver://localhost:1433;databaseName=Clientes</jdbcUrl>
<jdbcUser>sa</jdbcUser>
<jdbcPassword>miContraseña</jdbcPassword>
<jdbcDriverClass>
com.microsoft.sqlserver.jdbc.SQLServerDriver</jdbcDriverClass>
<jdbcDriverClassPath>
<string>C:\tools\Java\MsJdbc\sqljdbc.jar</string>
</jdbcDriverClassPath>
<!-- Especificar los campos fijos. -->
<fixedFields>
<FixedField>
<expression>
USA</expression>
<logicalFieldName>País</logicalFieldName>
<physicalFieldName>país</physicalFieldName>
</FixedField>
</fixedFields>
<fixedFields>
<FixedField>
<expression>Francia</expression>
<logicalFieldName>País</logicalFieldName>
<physicalFieldName>país</physicalFieldName>
</FixedField>
</fixedFields>
<fixedFields>
<FixedField>
<expression>Gran Bretaña</expression>
<logicalFieldName>País</logicalFieldName>
<physicalFieldName>país</physicalFieldName>
</FixedField>
</fixedFields>
<!-- Especificar los campos fijos. -->
<profileFields>
<ProfileField>
<logicalFieldName>
Estado</logicalFieldName>
<physicalFieldName>estado</physicalFieldName>
</ProfileField>
<ProfileField>
<logicalFieldName>Ciudad</logicalFieldName>
<physicalFieldName>ciudad</physicalFieldName>
</ProfileField>
</profileFields>
</GenerateDataFilters>
<!-- Correlacionar campos físicos a campos lógicos -->
<ExecuteBatch>
<name>addTables</name>
<operations>
<AddDataTable>
<dataTable>
<id>1</id>
<name>
Geográfica</name>
<fields>
<TableField>
<name>país</name>
<logicalFieldId>1</logicalFieldId>
</TableField>
<TableField>
<name>ciudad</name>
<logicalFieldId>2</logicalFieldId>
</TableField>
<TableField>
<name>estado</name>
<logicalFieldId>3</logicalFieldId>
</TableField>
<TableField>
<name>hh_id</name>
<logicalFieldId>4</logicalFieldId>
</TableField>
<TableField>
<name>indiv_id</name>
<logicalFieldId>5</logicalFieldId>
</TableField>
</fields>
</dataTable>
</AddDataTable>
</operations>
</ExecuteBatch>
<!--Añadir audiencias-->
<ExecuteBatch>
<name>addAudiences</name>
<operations>
<AddAudience>
<audience>
<id>1</id>
<name>
familiar</name>
<fields>
<AudienceField>
<logicalFieldId>4</logicalFieldId>
<fieldOrder>0</fieldOrder>
</AudienceField>
</fields>
</audience>
</AddAudience>
<AddAudience>
<audience>
<id>2</id>
<name>individual</name>
<fields>
<AudienceField>
<logicalFieldId>5</logicalFieldId>
<fieldOrder>0</fieldOrder>
</AudienceField>
</fields>
</audience>
</AddAudience>
</operations>
</ExecuteBatch>
<!-- Asociar pares de tablas de audiencias con la configuración de datos) -->
<ExecuteBatch>
<name>addAudienceTableAssociations</name>
<operations>
<AddAudienceTableAssociation>
<audienceTableAssociation>
<audienceId>1</audienceId>
<tableId>1</tableId>
<configId>1</configId>
</audienceTableAssociation>
</AddAudienceTableAssociation>
<AddAudienceTableAssociation>
<audienceTableAssociation>
<audienceId>2</audienceId>
<tableId>1</tableId>
<configId>1</configId>
</audienceTableAssociation>
</AddAudienceTableAssociation>
</operations>
</ExecuteBatch>
</operations>
</ExecuteBatch>
Completar las tablas del sistema
Jim ha denominado su archivo XML de filtro de datos filtrosDatosGeográficos.xml y lo ha guardado en el directorio tools/bin en la instalación de la Marketing Platform. Abre una línea de mandatos y utiliza el programa de utilidad datafilteringScriptTool para llenar las tablas del sistema de filtros de datos.
La utilidad crea muchos filtros de datos. En cada filtro de datos, el criterio es un país (el campo fijo) y una combinación única de ciudad y estado obtenida cuando el programa de utilidad consultó la base de datos en busca de registros que contengan el valor del campo fijo. Todas las combinaciones únicas de ciudad y estado se utilizan para cada país especificado como campo fijo.
Asignación de usuarios y grupos a filtros de datos
Finalmente, Jim se registra en la Marketing Platform con una cuenta que tiene acceso Admin en la Marketing Platform.
Sabe que ya se han configurado grupos en la Marketing Platform con usuarios asignados por ciudad.
Ingresa a la sección Filtros de datos y observa que los valores de país, ciudad y estado de sus filtros de datos están disponibles en la búsqueda avanzada de filtros de datos. Realiza una búsqueda de un filtro de datos utilizando a Boston, una ciudad de los Estados Unidos, como criterio de búsqueda. Aparece el filtro de datos para Boston en los resultados de la búsqueda.
A continuación, Jim realiza una búsqueda del grupo de usuarios de Boston, que ha sido configurado en la Marketing Platform para agrupar a todos los usuarios de marketing local que sean responsables del marketing para clientes en Boston. El grupo Boston aparece en los resultados de la búsqueda.
Jim luego selecciona el grupo y el filtro de datos en los resultados de búsqueda y asigna el grupo al filtro de datos haciendo clic en el botón Asignar.
Continúa realizando búsquedas de filtros de datos y de grupos hasta que se completen todas las asignaciones.