Publish additional fields for Acoustic Exchange
The option to publish additional fields with Exchange gives you control over sending additional information as part of an Exchange event, without marking it as lookup key. You have better behavioral reporting with additional contact information as part of each recipient event. And this feature reduces incidents of Exchange identity store confusion as users can stop selecting random database fields as lookup fields just to receive this information as part of an Exchange event.
Prerequisites
A Campaign organization with an Exchange integration enabled. A user with permission to edit fields in the database.
How is it accessed, and who has permission to access it?
Access this option through the Campaign UI. For a shared list an organization administrator, list owner, or standard users can access it. For a private list only the list owner can access it.
Procedure
- In the database summary, click to edit the field.
- Select the Publish data in Exchange events checkbox in list type Regular - Restricted, Regular - Flexible and FCI. The checkbox is available only for user-defined fields and disabled for system-defined fields for the eligible lists. Publish data in Exchange events cannot be selected if the field is marked as a lookup key.
- When the field is selected as publishable on the summary page it's indicated in the Publish data in Exchange column.
- When a field is marked as publishable then these fields appear under attribute section of events. What fields?
- The selected fields are published as attributes with name starting ‘cf_’ in all recipient events (all channels) generated for a contact in this database (and associated queries/contact lists).
Note: By default, Publish data in Exchange is not selected for database fields, to be sent as additional information in the events.
There is a limit of five fields of data.
Sample Payload of event with additional database field:
{"headers":[{"name":"authkey","value":"ae94a132-6ccc-4188-8157-2bdc4259612e:US"}],"eventbatch":[{"events":[{"channel":"Email","code":"emailSend","timestamp":"2019-07-08T06:11:57.138Z","attributes":[{"name":"eventName","value":"Mailing Sent Event","type":"string"},{"name":"description","value":"Mailing Sent Event","type":"string"},{"name":"messageId","value":"1747258","type":"number"},{"name":"reportId","value":"5190634","type":"number"},{"name":"mailingTemplateId","value":"1683325","type":"number"},{"name":"subjectLine","value":"Verification of publishable attributes to UBX","type":"string"},{"name":"messageName","value":"Verification of publishable attributes to UBX","type":"string"},{"name":"docType","value":"html","type":"string"},{"name":"sendType","value":"Regular","type":"string"},{"name":"consentDate","value":"2019-07-05T07:35:07.000Z","type":"iso8601"},{"name":"eventId","value":"j7UOToKPQqWVP9dGETOgKQ==","type":"string"},{"name":"cf_FB_CHAT_ID","value":"23089","type":"number"},{"name":"cf_Consentdate","value":"10/10/2012","type":"iso8601"},{"name":"cf_SSN","value":"305612209","type":"string"}],"identifiers":[{"name":"contactId","value":"205110776"},{"name":"email","value":"vulcan7@qatestmail.com"},{"name":"ENCODED_RECIPIENT_ID","value":"MjA1MTEwNzc2S0"},{"name":"ln_id","value":"8971"}]}]}]}