Listrak

Listrak is a comprehensive digital marketing automation platform.

Listrak integration replicates data using the Listrak SOAP API.

See the Schema section for a list of objects available for replication.

Preparing for authentication

To access your data, you need to authenticate the connection with your account credentials.

请确保您使用的帐户对要获取的表具有读取权限。

You must have administrative privileges to create a user in your Listrak account.

To create a user:

Log into your Listrak account.
From the home page, click Manage.
Click Accounts > User Manager.
Scroll to the bottom of the page and click Create New User.
Fill in the User Information fields.
In the Lists section, select the lists you want the Qlik Talend Cloud user to have access to.
Qlik Talend Cloud can only replicate data for lists it can access.
In the Granted Access field, select Role Based Access, then, in the section below, check the boxes for the following permissions:
- Analytics Access: Allows you to view analytics for messages, contacts, and lists within accessible lists.
- API Access: Allows you to replicate data from Listrak using the Listrak API.
Click Add User.

Listrak restricts SOAP API access by IP address. To let Qlik Talend Cloud connect, add its IP address to Listrak’s IP authorization list:

Log into your Listrak account.
Navigate to Manage > Accounts > SOAP API IP Authorization.
Add the Qlik Talend Cloud IP address that you retrieved.

Creating the connection

有关更多信息，请参阅连接到 SaaS 应用程序。

填写所需的连接属性。
在连接名称中提供连接的名称。
选择打开连接元数据以定义创建连接时的元数据。
单击创建。

Connection settings
Setting	Description
Data gateway	如果您的用例需要，请选择一个数据移动网关。信息注释此字段不适用于 Qlik Talend Cloud Starter 订阅，因为它不支持数据移动网关。如果您有另一个订阅层并且不想使用数据移动网关，请选择无。有关数据移动网关的优势和需要它的用例的信息，请参阅Qlik 数据网关 - 数据移动。
Start Date	按格式 `MM/DD/YYYY` 输入必须将数据从源复制到目标的日期。
Username	Username.
Password	Password.

Schema

Schemas and naming conventions can change from version to version. It is recommended to verify your version before continuing.

Depending on your destination, table and column names may not appear as they are outlined below.

lists

The lists table contains info about your contact lists.

Replication Method

Full Table

Primary Key

ListID

Useful links

Listrak documentation

Listrak API method

Join lists with	on
messages	lists.ListID = messages.ListID
subscribed_contacts	lists.ListID = subscribed_contacts.ListID

BounceUnsubscribeCount

INTEGER

CreateDate

DATE-TIME

DomainAliasEmail

STRING

DomainAliasLink

STRING

EnableBrowserLink

BOOLEAN

EnableDoubleOptin

BOOLEAN

EnableDynamicContent

BOOLEAN

EnableGoogleAnalytics

BOOLEAN

EnableInternationalization

BOOLEAN

EnableListHygiene

BOOLEAN

EnableListRemoveHeader

BOOLEAN

EnableRSS

BOOLEAN

EnableRemovalLink

BOOLEAN

FromEmail

STRING

FromName

STRING

GoogleTrackingDomains

ARRAY

This is a nested data structure.

ListID

INTEGER

ListName

STRING

ShowAdvancedPersonalization

BOOLEAN

ShowEmailList

BOOLEAN

Vmta

OBJECT

This is a nested data structure:

Description: STRING
VmtaID: INTEGER

bounceHandling

INTEGER

message_bounces

The message_bounces table contains info about contact bounces for a message.

Replication Method

Full Table

Primary Keys

MsgID

EmailAddress

Useful links

Listrak documentation

Listrak API method

Join message_bounces with	on
message_clicks	message_bounces.ContactID = message_clicks.ContactID message_bounces.MsgID = message_clicks.MsgID
message_opens	message_bounces.ContactID = message_opens.ContactID message_bounces.MsgID = message_opens.MsgID
message_reads	message_bounces.ContactID = message_reads.ContactID message_bounces.MsgID = message_reads.MsgID
message_unsubs	message_bounces.ContactID = message_unsubs.ContactID message_bounces.MsgID = message_unsubs.MsgID
subscribed_contacts	message_bounces.ContactID = subscribed_contacts.ContactID
message_sends	message_bounces.MsgID = message_sends.MsgID
messages	message_bounces.MsgID = messages.MsgID

BounceCount

INTEGER

BounceDate

STRING

BounceDetail

STRING

BounceReason

STRING

ContactID

STRING

EmailAddress

STRING

MsgID

INTEGER

message_clicks

The message_clicks table contains info about contact clicks for a message.

Replication Method

Full Table

Primary Keys

MsgID

EmailAddress

Useful links

Listrak documentation

Listrak API method

Join message_clicks with	on
message_bounces	message_clicks.ContactID = message_bounces.ContactID message_clicks.MsgID = message_bounces.MsgID
message_opens	message_clicks.ContactID = message_opens.ContactID message_clicks.MsgID = message_opens.MsgID
message_reads	message_clicks.ContactID = message_reads.ContactID message_clicks.MsgID = message_reads.MsgID
message_unsubs	message_clicks.ContactID = message_unsubs.ContactID message_clicks.MsgID = message_unsubs.MsgID
subscribed_contacts	message_clicks.ContactID = subscribed_contacts.ContactID
message_sends	message_clicks.MsgID = message_sends.MsgID
messages	message_clicks.MsgID = messages.MsgID

ClickDate

STRING

ContactID

STRING

EmailAddress

STRING

LinkDescription

STRING

LinkUrl

STRING

MsgID

INTEGER

message_opens

The message_opens table contains info about contact opens for a message.

Replication Method

Full Table

Primary Keys

MsgID

EmailAddress

Useful links

Listrak documentation

Listrak API method

Join message_opens with	on
message_bounces	message_opens.ContactID = message_bounces.ContactID message_opens.MsgID = message_bounces.MsgID
message_clicks	message_opens.ContactID = message_clicks.ContactID message_opens.MsgID = message_clicks.MsgID
message_reads	message_opens.ContactID = message_reads.ContactID message_opens.MsgID = message_reads.MsgID
message_unsubs	message_opens.ContactID = message_unsubs.ContactID message_opens.MsgID = message_unsubs.MsgID
subscribed_contacts	message_opens.ContactID = subscribed_contacts.ContactID
message_sends	message_opens.MsgID = message_sends.MsgID
messages	message_opens.MsgID = messages.MsgID

ContactID

STRING

EmailAddress

STRING

MsgID

INTEGER

OpenDate

STRING

message_reads

The message_reads table contains info about contact reads for a message.

Replication Method

Full Table

Primary Keys

MsgID

EmailAddress

Useful links

Listrak documentation

Listrak API method

Join message_reads with	on
message_bounces	message_reads.ContactID = message_bounces.ContactID message_reads.MsgID = message_bounces.MsgID
message_clicks	message_reads.ContactID = message_clicks.ContactID message_reads.MsgID = message_clicks.MsgID
message_opens	message_reads.ContactID = message_opens.ContactID message_reads.MsgID = message_opens.MsgID
message_unsubs	message_reads.ContactID = message_unsubs.ContactID message_reads.MsgID = message_unsubs.MsgID
subscribed_contacts	message_reads.ContactID = subscribed_contacts.ContactID
message_sends	message_reads.MsgID = message_sends.MsgID
messages	message_reads.MsgID = messages.MsgID

ContactID

STRING

EmailAddress

STRING

MsgID

INTEGER

ReadDate

STRING

message_sends

The message_sends table contains MsgID and EmailAddress pairs, allowing you to identify the messages that your contacts have been sent.

Replication Method

Full Table

Primary Keys

MsgID

EmailAddress

Useful links

Listrak documentation

Listrak API method

Join message_sends with	on
message_bounces	message_sends.MsgID = message_bounces.MsgID
message_clicks	message_sends.MsgID = message_clicks.MsgID
message_opens	message_sends.MsgID = message_opens.MsgID
message_reads	message_sends.MsgID = message_reads.MsgID
message_unsubs	message_sends.MsgID = message_unsubs.MsgID
messages	message_sends.MsgID = messages.MsgID

EmailAddress

STRING

MsgID

INTEGER

message_unsubs

The message_unsubs table contains info about contacts who requested to be removed from a list from the supplied message.

Replication Method

Full Table

Primary Keys

MsgID

EmailAddress

Useful links

Listrak documentation

Listrak API method

Join message_unsubs with	on
message_bounces	message_unsubs.ContactID = message_bounces.ContactID message_unsubs.MsgID = message_bounces.MsgID
message_clicks	message_unsubs.ContactID = message_clicks.ContactID message_unsubs.MsgID = message_clicks.MsgID
message_opens	message_unsubs.ContactID = message_opens.ContactID message_unsubs.MsgID = message_opens.MsgID
message_reads	message_unsubs.ContactID = message_reads.ContactID message_unsubs.MsgID = message_reads.MsgID
subscribed_contacts	message_unsubs.ContactID = subscribed_contacts.ContactID
message_sends	message_unsubs.MsgID = message_sends.MsgID
messages	message_unsubs.MsgID = messages.MsgID

AdditionDate

STRING

ContactID

STRING

EmailAddress

STRING

MsgID

INTEGER

RemovalDate

STRING

RemovalMethod

STRING

messages

The messages table contains info about message statistics.

Replication Method

Full Table

Primary Key

MsgID

Useful links

Listrak documentation

Listrak API method

Join messages with	on
message_bounces	messages.MsgID = message_bounces.MsgID
message_clicks	messages.MsgID = message_clicks.MsgID
message_opens	messages.MsgID = message_opens.MsgID
message_reads	messages.MsgID = message_reads.MsgID
message_sends	messages.MsgID = message_sends.MsgID
message_unsubs	messages.MsgID = message_unsubs.MsgID
lists	messages.ListID = lists.ListID
subscribed_contacts	messages.ListID = subscribed_contacts.ListID

AverageOrderValue

NUMBER

ClickCount

INTEGER

ClickerCount

INTEGER

ClickerPercent

NUMBER

ConversionCount

INTEGER

DeliverCount

INTEGER

ListID

INTEGER

MsgID

INTEGER

NewClickerCount

INTEGER

OpenCount

INTEGER

OpenPercent

NUMBER

OrderTotal

NUMBER

ReadCount

INTEGER

ReadPercent

NUMBER

RemoveCount

INTEGER

RemovePercent

NUMBER

RepeatClickerCount

INTEGER

SendDate

DATE-TIME

Subject

STRING

subscribed_contacts

The subscribed_contacts table contains info about contacts who are currently subscribed to the specified list.

Replication Method

Full Table

Primary Keys

ContactID

ListID

Useful links

Listrak documentation

Listrak API method

Join subscribed_contacts with	on
message_bounces	subscribed_contacts.ContactID = message_bounces.ContactID
message_clicks	subscribed_contacts.ContactID = message_clicks.ContactID
message_opens	subscribed_contacts.ContactID = message_opens.ContactID
message_reads	subscribed_contacts.ContactID = message_reads.ContactID
message_unsubs	subscribed_contacts.ContactID = message_unsubs.ContactID
lists	subscribed_contacts.ListID = lists.ListID
messages	subscribed_contacts.ListID = messages.ListID

AdditionDate

DATE-TIME

AdditionMethod

STRING

ContactID

STRING

EmailAddress

STRING

ListID

INTEGER

本页面有帮助吗？

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们！

在此处留下您的反馈