Exemplo: Especificar filtros de dados manualmente

Jim precisa criar um conjunto de filtros de dados com base em territórios de vendas.

No Campaign, as tabelas de cliente já foram mapeadas e os níveis de audiência foram definidos.

Obter informações

Jim determina que a tabela Territory contém os campos necessários para especificar restrições de campo para os filtros de dados.

A tabela a seguir ilustra as informações que Jim obteve sobre os campos de cliente e seus mapeamentos do Campaign.

Campos da tabela Territory

Campos (nome físico)	Campos (nome no Campaign)	Dados	Tipo de dados
cust_region	CustomerRegion	África África Ásia Europa Oriente Médio América do Norte	java.lang.String
hh_id	HouseholdID	N/D	java.lang.Long
indiv_id	IndividualID	N/D	java.lang.Long

Jim aprendeu que os nomes de audiência usados no Campaign são household (familiar) e individual. Ele percebe que a tabela Territory contém dois campos de audiência. O campo e hh_id corresponde à audiência familiar. O campo indiv_id na tabela Territory corresponde à audiência individual.

Como Jim deve criar um campo lógico para cada audiência, e um para o campo de restrição, ele sabe que precisa de um total de três campos lógicos.

Jim também sabe que precisa agrupar os filtros de dados em uma configuração de dados. Ele decide nomear esta configuração de dados de Territory.

Jim agora está pronto para criar o XML.

Criar o XML

Aqui está o XML criado por Jim. Valores baseados nas informações obtidas por ele são mostradas em 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>

Popular as tabelas de sistema

Jim nomeou seu arquivo XML de fltro de dados como regionDataFilters.xml e o salvou no diretório tools/bin na sua instalação do Marketing Platform. Ele abre uma janela de comando e usa o utilitário datafilteringScriptTool para popular as tabelas de sistema do filtro de dados.

Atribuir usuários e grupos aos filtros de dados

Finalmente, Jim efetua login no IBM Unica Marketing com uma conta que tem acesso de Admin no Marketing Platform.

Ele sabe que grupos já foram definidos no IBM Unica Marketing com usuários atribuídos por região.

Ele vai até a seção Filtro de Dados e vê que as restrições de campo de seus filtros de dados estão disponíveis na pesquisa avançada para filtros de dados. Ele executa uma pesquisa por filtro de dados usando Africa como critério de pesquisa. O filtro de dados definido para a região Africa aparece nos resultados da pesquisa.

Em seguida, Jim executa uma pesquisa pelo grupo de usuários Africa, que foi definido no IBM Unica Marketing para guardar todos os profissionais de marketing de campo responsáveis pelo marketing de clientes na África. O grupo Africa aparece nos resultados da pesquisa.

Jim, então, seleciona o grupo e o filtro de dados no resultado da pesquisa, e atribui o grupo ao filtro de dados clicando no botão Assign.

Ele continua a executar pesquisas por filtro de dados e grupos até concluir todas as atribuições.