Send your event data from RudderStack to ActiveCampaign.
7 minute read
ActiveCampaign is a popular marketing automation and CRM platform. It offers an all-in-one email marketing and growth platform to monitor your users’ product behavior and use the insights to design personalized customer experiences.
RudderStack supports ActiveCampaign as a destination to which you can seamlessly send your event data.
Find the open source transformer code for this destination in the GitHub repository.
Setup
In your RudderStack dashboard, go to Directory > Destinations > Cloud Destinations and search for ActiveCampaign.
Connect your source and click Continue.
Connection settings
Configure the following settings to set up ActiveCampaign as a destination in RudderStack:
API URL: Enter the ActiveCampaign API URL for your account.
API Key: Enter the ActiveCampaign API key.
To get the API URL and API key, log in to your ActiveCampaign account and go to the Settings page under the Developer tab.
You can use hybrid mode to send all events to ActiveCampaign from your JavaScript source.
In hybrid mode, RudderStack sends the identify, track, and screen events to ActiveCampaign via their REST API and page calls via the native ActiveCampaign SDK.
To send events via hybrid mode, use the hybrid mode option(highlighted below) while connecting your source to the ActiveCampaign destination.
Use hybrid mode to implement site tracking in ActiveCampaign.
In the above snippet, RudderStack captures relevant user information like their userId and the associated traits like email, phone, firstName, and lastName, before sending this information to ActiveCampaign.
email is a mandatory trait for mapping a user to ActiveCampaign.
Set custom tags
You can associate a user with custom tags by passing the tags trait in your identify call:
tags should contain an array of tags you want to associate with the user. If any tag is already present in ActiveCampaign, RudderStack will skip creating that tag.
Send custom fields
To send custom fields to ActiveCampaign, you will need to first create the custom fields in ActiveCampaign for each custom value that you want to send.
When you call identify with the keys matching those traits, RudderStack updates the custom fields for that contact.
You can update a contact by passing custom fields in your identify calls to ActiveCampaign.
You can use the fieldInfo trait to set values for the custom fields, as shown:
The fieldInfo trait contains the value of the custom field that you want to store for that contact. For using this feature, you need to create the custom fields from your ActiveCampaign dashboard before passing the values in the event.
To send multi-choice field values for the fields having a checkbox, or list values as an input, you need to send the values as an array. For example: "Hobbies": ["Cricket","Tennis"].
For the date field, the format should be YYYY-MM-DD. Also, the values for the datetime field should be in a ISO datetime format, that is, yyyy-MM-dd'T'HH:mm:ss. SSSXXX.
Subscribe contacts to lists
You can subscribe or unsubscribe a contact from any number of lists by passing a lists trait in your identify call. This trait should be an array with each element having an id and a status. The value of status must be either subscribe or unsubscribe.
In the above snippet, RudderStack captures the information related to the Product Purchased event along with the product’s name.
RudderStack also maps eventData present within the track event properties to ActiveCampaign’s eventdata field:
rudderanalytics.track("Product Purchased",{name:"Rubik's Cube",eventData:"Learn while having fun"});
Event name considerations
ActiveCampaign sets certain restrictions in the way you can set your track event names:
The event name must contain only alphanumeric characters. ActiveCampaign rejects any event containing special characters in the name.
The event name should not exceed 32 characters. ActiveCampaign automatically truncates event names longer than 32 characters. For example, if you send a track event with the name Product Viewed After Opening The Browser, ActiveCampaign automatically truncates it to Product Viewed After Opening The:
Page
You can use the page call to record user’s page views along with the associated properties and send this information to ActiveCampaign. You must call this method at least once per page load.
When you call page, RudderStack will send that event to ActiveCampaign as a site tracking event - this allowlists your domain for tracking purposes.
In the above sample, RudderStack captures the information related to the viewed page and the url property is used to allowlist the website in ActiveCampaign.
The page calls work only if Site Tracking is enabled in ActiveCampaign. You can enable this setting by going to the Tracking tab in your ActiveCampaign settings page.
Screen
The screen lets you record whenever your user views their mobile screen with any additional relevant information about the screen.
The screen event name must contain only alphanumeric characters.
ActiveCampaign rejects events with any special characters in the name.
FAQ
Can I use special characters in my screen and track event names?
No - your screen and track event names must contain only alphanumeric characters. ActiveCampaign prescribes that the screen and track event names must contain only alphabets and numbers and does not allow using any special characters.
How does RudderStack send events to ActiveCampaign in hybrid mode?
In hybrid mode, RudderStack sends the user-generated events (identify, track, screen) events to ActiveCampaign via cloud mode and sends the page events via device mode (using the native ActiveCampaign web SDK).
This site uses cookies to improve your experience while you navigate through the website. Out of
these
cookies, the cookies that are categorized as necessary are stored on your browser as they are as
essential
for the working of basic functionalities of the website. We also use third-party cookies that
help
us
analyze and understand how you use this website. These cookies will be stored in your browser
only
with
your
consent. You also have the option to opt-out of these cookies. But opting out of some of these
cookies
may
have an effect on your browsing experience.
Necessary
Always Enabled
Necessary cookies are absolutely essential for the website to function properly. This
category only includes cookies that ensures basic functionalities and security
features of the website. These cookies do not store any personal information.
This site uses cookies to improve your experience. If you want to
learn more about cookies and why we use them, visit our cookie
policy. We'll assume you're ok with this, but you can opt-out if you wish Cookie Settings.