Skip to main content

Voyado Engage

Avoid triggering export

When changes are made to your contacts (by updating, adding or deleting them) through a file import or the bulk API, some exports will be automatically triggered in Engage. If you don't want this to happen, you can use the attribute avoidTriggeringExport. Setting it to "true" will suppress both the BI and contact XML exports.

Note: this was previously know as "silent export".

Note

The default for avoidTriggeringExport is "false" which means that you only need to include it if you want it to be "true", that is, if you don't want the BI and contact XML exports to be triggered by your import.

For XML

For an XML import, this is done with an attribute in the top-level <contacts> node:

<?xml version="1.0" encoding="utf-8"?>
<contacts xmlns="http://eClub.Schemas.ImportContact" avoidTriggeringExport="true">
    <new>
        <member>
	    <contactId/>
	    <infobaleenEmailCampaign/>
	</member>
    </new>
</contacts>
For bulk API

When using the contact bulk API, avoidTriggeringExport is passed in the query string:

GET /api/v2/contacts/bulk?avoidTriggeringExport=true&contactType=Contact

Constraints

For the avoidTriggeringExport setting to work, your file can only consist of a contactType key (such as "member") and true Contact Attributes (that is, attributes that do NOT exist on the contact table).

If avoidTriggeringExport is set to "true" and your import / update contains Contact Attributes that are not keys and also exist on the contact table (ex FirstName, Email), your import will fail and an error will be written to the integration log.

If an import is done with only keys and true Contact Attributes but avoidTriggeringExport is false or missing, exports will be triggered and entries added to "changelog" and "lastmodified".

In the list below you can see the attributes that are NOT on the contact table:

  • AddressUpdateResponse

  • Age

  • AnnualBirthDay

  • BirthDate

  • BonusPoints

  • BonusPointsModifiedOn

  • CanReceiveEmail

  • CanReceivePostal

  • CanReceiveSms

  • CareOf

  • City

  • ContactPreferencesAcceptsEmail

  • ContactPreferencesAcceptsPostal

  • ContactPreferencesAcceptsSms

  • ContactTypeId

  • Country

  • CountryCode

  • CreationTime

  • CurrentStoreId

  • DeletedOn

  • DeletionReason

  • DiscoveryKey

  • Email

  • ExternalId

  • FirstName

  • Frequency

  • Fullname

  • Gender

  • Id

  • IsApproved

  • IsClearedAfterDeletion

  • IsDeleted

  • IsRegistrationCompleted

  • LastModifiedTime

  • LastName

  • LatestSyncHash

  • MemberNumber

  • MobilePhone

  • Monetary

  • PerformAddressUpdateOnline

  • Recency

  • RecruitedByStoreId

  • RegistrationDateOffset

  • Rfm

  • SecrecyMarked

  • SocialSecurityNumber

  • Source

  • SourceId

  • SourceName

  • SourceType

  • Street

  • ZipCode

Note that AvoidTriggeringExport can't be combined with the ImportSettings InsertNewContacts and ShouldDefaultSetIsApprovedAsTrue.