CreateMarketingTriggers

Description

Marketing triggers are used to track any activity of the contact / public user, which have some meaning in your company sales or marketing process.

Fields Description

Field name

Example

Description

baseType

new-phone-number

url-visit

goal-achieved

mail-url-visit

mail-open

url-visit

unsubscribe

Text identification of the marketing trigger (what actually happened)

contextId

123456789000

Identification of Folder ID, Project ID or Activity ID in Atollon's context structure. It is necessary to enter context ID in case it should be displayed in context Timeline.

contactId

113456789000

Identification of contact, who caused the trigger

url

https://yourcompany.atollon.com/pub/23423432

Page that the contact visited (optional)

trackingCode

yourSuperCampaignXYZ

Any text string representing one particular campaign / marketing activity / message template

description

Contact visited URL

Any descriptive text that will be visible to Atollon users in Timeline

triggerDate

2020-08-12 12:00

When the trigger happened?

numberOfVisits

45

In case the target user is super active (or robot), we may want to avoid spamming Atollon with unnecessary records and aggregate page visits

The example below notifies Atollon about new phone number added to contact. Atollon may therefore create call task.

Example Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://atollon.com/enterprise/wsdl">
<soapenv:Header/>
<soapenv:Body>
<wsdl:CreateMarketingTriggers>
<server>acme</server>
<session>61A...DBD04</session>
<MARKETING_TRIGGER>
<baseType>new-phone-number</baseType>
<contextId>132716101</contextId>
<contactId>139663101</contactId>
<url>www.yourcompany.com/product/page</url>
<trackingCode>www.company.com/product/page</trackingCode>
<description>Extranet user added new phone number</description>
<triggerDate>2020-07-31 12:00</triggerDate>
<numberOfVisits>1</numberOfVisits>
</MARKETING_TRIGGER>
</wsdl:CreateMarketingTriggers>
</soapenv:Body>
</soapenv:Envelope>

Example Response

<ns0:Envelope xmlns:ns0="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://atollon.com/enterprise/wsdl">
<ns0:Body>
<ns1:CreateMarketingTriggersResponse>
<result>OK</result>
<time>0.22972488</time>
<newId>400097101</newId>
</ns1:CreateMarketingTriggersResponse>
</ns0:Body>
</ns0:Envelope>

WSDL Listing

web.wsdl