Esempio di impostazione manuale dei filtri di dati

Giorgio ha la necessità di creare un insieme di filtri di dati sulla base delle aree di vendita.

In Campaign, le tabelle clienti sono già state mappate e sono stati definiti i livelli destinatari.

Ottenere informazioni

Giorgio determina che la tabella Territory contiene i campi di cui necessita per specificare i vincoli di campo per i filtri di dati.

Nella tabella seguente sono illustrate le informazioni che Giorgio ottiene sui campi clienti e le loro mappature in Campaign.

Campi della tabella Territory

Campi (nome fisico)	Campi (nome in Campaign)	Dati	Tipo di dati
cust_region	CustomerRegion	Africa Africa Asia Europa Medio Oriente Nord America	java.lang.String
hh_id	HouseholdID	N/A	java.lang.Long
indiv_id	IndividualID	N/A	java.lang.Long

Giorgio osserva che i nomi dei destinatari utilizzati in Campaign sono relativi a unità familiari e individui. Nota che la tabella Territory contiene due campi per i destinatari. Il campo hh_id corrisponde ai destinatari costituiti da unità familiari. Il campo indiv_id della tabella Territory corrisponde ai destinatari costituiti da individui.

Dato che Giorgio deve creare un campo logico per ogni tipo di destinatari e uno per quello dei vincoli di campo, deduce di dover disporre in totale di tre campi logici.

Sa anche che deve raggruppare i filtri di dati in una configurazione dati. Decide quindi di attribuire alla sua configurazione dati il nome di Territory.

A questo punto può passare alla creazione del codice XML.

Creazione del codice XML

Di seguito è riportato il codice XML scritto da Giorgio. I valori basati sulle informazioni che ha ottenuto sono riportati in bold.

<?xml version="1.0" encoding="UTF-8"?>
<ExecuteBatch>
<name>SeedData</name>
<operations>

<!-- Create the data configuration that groups related Data Filters -->
<ExecuteBatch>
<name>DataFilters</name>
<operations>
<AddDataConfiguration>
<dataConfiguration>
<id>1</id>
<name>Territory</name>
</dataConfiguration>
</AddDataConfiguration>
</operations>
</ExecuteBatch>

<!-- Add logical fields used to define data filters -->
<AddLogicalFields>
<logicalFields>
<LogicalField>
<id>1</id>
<name>
CustomerRegion</name>
<type>
java.lang.String</type>
</LogicalField>
<LogicalField>
<id>2</id>
<name>
HouseholdID</name>
<type>
java.lang.Long</type>
</LogicalField>
<LogicalField>
<id>3</id>
<name>
IndividualID</name>
<type>
java.lang.Long</type>
</LogicalField>
</logicalFields>
</AddLogicalFields>

<!-- Add the Territory field constraints -->
<AddDataFilters>
<dataFilters>
<DataFilter>
<configId>1</configId>
<id>1</id>
<fieldConstraints>
<FieldConstraint>
<logicalFieldId>1</logicalFieldId>
<expression>
Africa</expression>
</FieldConstraint>
</fieldConstraints>
</DataFilter>
<DataFilter>
<configId>1</configId>
<id>2</id>
<fieldConstraints>
<FieldConstraint>
<logicalFieldId>1</logicalFieldId>
<expression>
Asia</expression>
</FieldConstraint>
</fieldConstraints>
</DataFilter>
<DataFilter>
<configId>1</configId>
<id>3</id>
<fieldConstraints>
<FieldConstraint>
<logicalFieldId>1</logicalFieldId>
<expression>
Europe</expression>
</FieldConstraint>
</fieldConstraints>
</DataFilter>
<DataFilter>
<configId>1</configId>
<id>4</id>
<fieldConstraints>
<FieldConstraint>
<logicalFieldId>1</logicalFieldId>
<expression>
Middle East</expression>
</FieldConstraint>
</fieldConstraints>
</DataFilter>
<DataFilter>
<configId>1</configId>
<id>5</id>
<fieldConstraints>
<FieldConstraint>
<logicalFieldId>1</logicalFieldId>
<expression>
North America</expression>
</FieldConstraint>
</fieldConstraints>
</DataFilter>
</dataFilters>
</AddDataFilters>

<!-- Map physical to logical fields -->
<ExecuteBatch>
<name>addTables</name>
<operations>
<AddDataTable>
<dataTable>
<id>1</id>
<name>
Territory</name>
<fields>
<TableField>
<name>
cust_region</name>
<logicalFieldId>1</logicalFieldId>
</TableField>
<TableField>
<name>
hh_id</name>
<logicalFieldId>2</logicalFieldId>
</TableField>
<TableField>
<name>
indiv_id</name>
<logicalFieldId>3</logicalFieldId>
</TableField>
</fields>
</dataTable>
</AddDataTable>
</operations>
</ExecuteBatch>

<!--Add Audiences-->
<ExecuteBatch>
<name>addAudiences</name>
<operations>
<AddAudience>
<audience>
<id>1</id>
<name>
household</name>
<fields>
<AudienceField>
<logicalFieldId>2</logicalFieldId>
<fieldOrder>0</fieldOrder>
</AudienceField>
</fields>
</audience>
</AddAudience>
<AddAudience>
<audience>
<id>2</id>
<name>
individual</name>
<fields>
<AudienceField>
<logicalFieldId>3</logicalFieldId>
<fieldOrder>0</fieldOrder>
</AudienceField>
</fields>
</audience>
</AddAudience>
</operations>
</ExecuteBatch>

<!-- Associate table-audience pairs with data configuration) -->
<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>

Popolamento delle tabelle di sistema

Giorgio ha attribuito al file XML del filtro di dati il nome di regionDataFilters.xml e l'ha salvato nella directory tools/bin dell'installazione di Marketing Platform utilizzata. Apre un prompt dei comandi e si serve dell'utility datafilteringScriptTool per popolare le tabelle di sistema dei filtri di dati.

Assegnazione di utenti e gruppi ai filtri di dati

Infine Giorgio accede a IBM Unica Marketing con un account che dispone delle autorizzazioni amministrative in Marketing Platform.

Sa che in IBM Unica Marketing i gruppi sono già stati impostati e sono stati loro assegnati gli utenti in base all'area geografica.

Passa alla sezione dei filtri di dati e vede che i vincoli di campo stabiliti dai suoi filtri risultano disponibili nella ricerca avanzata dei filtri. Cerca un filtro di dati utilizzando Africa come criterio. Nei risultati della ricerca viene visualizzato il filtro di dati che ha impostato per l'area Africa.

Giorgio cerca quindi il gruppo di utenti di Africa, impostato in IBM Unica Marketing e contenente tutti i field marketer che si occupano di commercializzare i prodotti ai clienti in Africa. Nei risultati della ricerca viene visualizzato il gruppo Africa.

Giorgio seleziona il gruppo e il filtro di dati nei risultati della ricerca e assegna il gruppo al filtro di dati facendo clic sul pulsante Assegna.

Continua quindi a cercare i filtri di dati e i gruppi fino a completare tutte le assegnazioni.