Export Attendee Engagement Data from Zuddl to Salesforce for an Event in Zuddl
Salesforce is a CRM that equips sales, marketing, service, and admin teams with the customer information required to administer interactions with them. The Zuddl—Salesforce integration enables organizers to pass attendee information seamlessly from Zuddl to Salesforce.
Currently, the following attendee activities are passed on to Salesforce:
Captured Activities - Webinar/Events
The registrant activities the integration captures are shown below:
Activity Name | Events | Webinar | Sync time |
---|---|---|---|
New user registration | ✔️ | ✔️ | Immediate |
Attended | ✔️ | ✔️ | 1 hour (after event ends) |
Event Polls answered | ✔️ | ✔️ | 1 hour (after event ends) |
Event Questions Asked | ✔️ | ✔️ | 1 hour (after event ends) |
Event Questions Upvoted | ✔️ | ✔️ | 1 hour (after event ends) |
Event CTAs clicked | ✔️ | ✔️ | 1 hour (after event ends) |
Event VOD Views | ✔️ | Every day at 12:10 AM and 12:10 PM (UTC) + 1 hour (after event ends) | |
Event Survey Answered | ✔️ | 1 hour (after event ends) | |
Attended Session Live | ✔️ | ✔️ | 1 hour (after event ends) |
Attended Discussion Room | ✔️ | ❌ | 1 hour (after event ends) |
Attended Booth | ✔️ | ❌ | 1 hour (after event ends) |
Event Engagement Time | ✔️ | ✔️ | 1 hour (after event ends) |
Event Discussion Room Engagement Time | ✔️ | ❌ | 1 hour (after event ends) |
Event Session Engagement Time | ✔️ | ✔️ | 1 hour (after event ends) |
Event Booth Engagement Time | ✔️ | ❌ | 1 hour (after event ends) |
Integration
The Salesforce integration can be split into two main steps
- Global-level integration
- Event-level integration
If your organization requires you to create a special user with required permissions for integration purposes, create an API-only user profile in your Salesforce with Modify All Data or Modify All permissions. Learn how to create an API-only user profile.
Event-level integration — Turn on Salesforce for an event /webinar
In Salesforce, you can leverage the Campaigns object to track event-level data from Zuddl. Each Zuddl event/webinar must be tied to a campaign on Salesforce to track attendee activities and event/ /webinar statuses, namely:
- “Registered”: When an attendee registers a Zuddl event/webinar
- “Attended”: When a registered attendee enters a Zuddl event/webinar
Each new campaign must add these statuses to connect with a Zuddl event/webinar. A campaign ID links a Zuddl event/webinar with a Salesforce campaign, helping us track the campaign member for a specific event/webinar.
Create a Campaign
To create a campaign,
- Go to your Salesforce dashboard and click Campaign on the main menu
- Click New.
- Under the New Campaign form, enter the following details:
- Campaign Name: Enter your event/webinar name.
- Select the Active checkbox as per the requirements.
- Optional. Fill in the rest of the fields.
- Click Save. This creates your new campaign. You will be redirected to the campaign detail view. The created campaign must be linked to a particular event/webinar on Zuddl to track the campaign members for a specific Zuddl event/webinar. The page URL contains the campaign ID, which can be copied and pasted into Zuddl.
Copy the campaign ID from the URL as shown below:
Click New to create a new status to capture Zuddl-specific data on the Campaign Member Statuses table.
- On the Campaign Member Status field, enter
- “Registered”: When a user registers for an event/webinar.
“Attended”: When a registered user joins the event/webinar, the “Registered” state gets updated to “Attended.”
Warning:
The Member Status value should exactly match the Zuddl keywords “Registered” and “Attended.” Minor spelling errors would obstruct the data sync.
Click Save. The newly added statuses appear here.
If you don't want to create Campaign member fields and status fields manually, you can use the Salesforce package installer which creates these fields automatically. - Inside the Zuddl dashboard, inside the event/webinar setup, go to Integrations.
On the Salesforce card, click Customize on the Export section to configure the event-level settings. The Export section shows a Disabled status before turning on the integration.
Toggle on the Salesforce export integration. This enables the integration settings.
- Under the Campaign ID tab, paste the campaign ID copied from the Salesforce URL in Step 6. This establishes the connection to your Salesforce account.
- Click Save & next.
Map lead custom fields
Any new registrant in Zuddl is added as a Lead in Salesforce. Under the Lead custom fields tab, map any custom fields added to your registration form to suitable Lead fields in Salesforce.
- Select a custom field in the Zuddl registration fields dropdown.
Choose a suitable Lead field from the Lead fields dropdown.
You can map multiple Zuddl registration fields to a single Salesforce Lead field. This is useful if your event has multiple registration flows. - Choose a Field update policy
- Do not update: This option does not pass the Zuddl field value to the mapped Salesforce field. Note: Only updates made to the field won’t be passed. Leads will still be created.
- Always update: This option always passes the Zuddl field value to the mapped Salesforce field.
- Do not update if source is empty: If the Zuddl field value is empty, this option does not pass the value of the Zuddl field to the mapped Salesforce field.
Only update if target is empty: If the Salesforce lead field value is empty, this option passes the Zuddl field value only in this case.
- To map more fields, click the + Add field button and follow the same steps as discussed above.
- Click Save & next.
Map lead capture fields at the lead-level
- Under the Lead capture fields tab, map the fields that you have configured for your lead capture app. Learn how to add fields to the lead capture app.
- Under the Lead capture fields dropdown, select the required Zuddl field to map.
- Similarly, choose a suitable Salesforce Lead fields.
- Select a Field update policy.
- Click Save & next. This saves the mapping. Similarly, add more fields as required using +Add field button.
You can also click on the booth name to directly go to the booth settings under Venue Setup.
Map contact custom fields
For Contacts already in Salesforce, it is crucial to map the custom fields of your Zuddl event/webinar’s registration form to the Salesforce Contact fields to ensure updated field values are passed to your event/webinar. Under the Contact custom fields tab, map any custom fields added to your registration form to suitable Contact fields in Salesforce.
- Select a custom field in the Zuddl registration fields dropdown.
Choose a suitable Contact field from the Contact fields dropdown.
You can map multiple Zuddl registration fields to a single Salesforce contact field. This is useful if your event has multiple registration flows. - You can control the sync action for each field by choosing a Field update policy.
- Do not update: This option does not pass the Zuddl field value to the mapped Salesforce field.
- Always update: This option always passes the Zuddl field value to the mapped Salesforce field.
- Do not update if source is empty: This option does not pass the value of the Zuddl field to the mapped Salesforce field if the Zuddl field value is empty.
- Only update if target is empty: This option passes the Zuddl field value if the Salesforce Contact field value is empty.
- To map more fields, click the + Add field button and follow the same steps as discussed above.
- Click Save & next.
Map lead capture fields at the contact-level
- Under the Lead capture fields tab, map the fields that you have configured for your lead capture app. Learn how to add fields to the lead capture app.
- Under the Lead capture fields dropdown, select the required Zuddl field to map.
- Similarly, choose a suitable Salesforce Contact fields.
- Select a Field update policy.
- Click Save & next. This saves the mapping. Similarly, add more fields as required using +Add field button.
You can also click on the booth name to directly go to the booth settings under Venue Setup.
Map campaign member custom fields
Prerequisite:
A Zuddl registration form with all the required fields must be created to map the fields.
- Select a custom field in the Zuddl registration fields dropdown.
- Choose a suitable Campaign member field from the Campaign member fields dropdown
The integration allows passing the following fields for all registration at the program member level apart from registration fields
- Ticket type: The name of the ticket tier created in Zuddl for ticketed events.
- UTM Parameters: Urchin Tracking Module data(UTM Source, UTM Medium, UTM Campaign, UTM Term, UTM Content, and UTM Id)
- Ip data (Ip City and Ip Country): Ip details
- Attendee Type: This field is useful for onsite events to distinguish between Virtual and In-person attendance.
- Amount Paid:
- Add on Details:
- Once all the fields are mapped, click Save.
Optional. Suppose your event/webinar registration has started, and you wish to sync the registrations created in Zuddl before the integration was set up. In that case, you can click the Sync button next to the integration toggle.
Notes:
This is a one-time option to sync already existing data for your event/webinar. Once used, this option does not show up again.
Map lead capture fields at the campaign member-level
- Under the Lead capture fields tab, map the fields that you have configured for your lead capture app. Learn how to add fields to the lead capture app.
- Under the Lead capture fields dropdown, select the required Zuddl field to map.
- Similarly, choose a suitable Salesforce Campaign fields.
- Select a Field update policy.
- Click Save. This saves the mapping. Similarly, add more fields as required using +Add field button.
You can also click on the booth name to directly go to the booth settings under Venue Setup.
Notes:
- Ensure that Zuddl and Salesforce object fields have compatible data types. If fields with incorrect data types are mapped, data could be lost.
- Once the integration is turned on, its status changes to Active in the Export section, as shown below.
The integration also manages duplicate emails (contacts/ leads) in Salesforce, prioritizing leads/contacts with the latest ‘last activity.'
Adding members to campaigns
A single attendee may be invited to other events/webinars from your Zuddl account. For instance, Mary (a prospect) is invited to two events (event A and event B), and respective Salesforce campaigns are linked to each event. Now, out of the two, Mary registered for event A, because of which the integration automatically creates a lead and adds her to the respective campaign.
For event B, the integration checks if Mary’s email address exists in your Salesforce instance to avoid duplicate entries for Mary. The integration searches in the relevant Salesforce objects in the following order:
- Campaigns: If present, it does nothing.
- Contacts: If present, the email is automatically added to the campaign
- Leads: If present, the email is automatically added to the campaign
Suppose a registrant does not exist in Salesforce, just like in Mary's case for event A. In this case, the integration automatically creates a lead and adds it to the respective campaign.
Configure Salesforce objects for activities
The integration also captures attendees' actions during the event/webinar and passes them onto Salesforce. All attendee activities (except Attended and Registered) are synced one hour after the event/webinar's end time.
Registered attendee data is synced in real-time and Attended about 1 minute after the attendee joins the event/webinar.
To create a new field,
- go to Setup > Object Manager on your Salesforce instance and search for Campaign Member.
Go to Fields & Relationships and click the New button.
- Under Step 1. Choose the field type section, select the Text Area (Long) data type, and click the Next button. This creates a new custom field.
- Under Step 2. In the details section, enter the Field Label and click Next. Enter the below field names with the exact keyword match:
- “Zuddl Polls Answered”: Lists the poll questions that the attendee has responded to.
- “Zuddl Questions Asked”: Lists the questions asked by the attendee
- “Zuddl Question Upvoted”: Lists the questions the attendee has upvoted
- “Zuddl Session Attended”: Lists the names of the sessions that the attendee has attended.
- “Zuddl Breakout Room”: Indicates whether an attendee has joined the breakout room. This is only for events.
- “Zuddl Event Duration”: Shows the total time spent in an event, both for events and webinars.
- “Zuddl Discussion Room Duration”: Shows the total time spent in a room. This is only for events.
- “Zuddl Booth Duration”: Shows the total time spent in a booth. This is only for events.
- “Zuddl CTA Clicked”: Shows the comma-separated list of button texts the attendee has clicked. The buttons with links are also shown with the link in the report.
“Webinar Session Engagement Time”: Shows the total time spent in a webinar session. This is only for webinars.
Warning
The Field Label value should match the Zuddl keywords listed above. Minor spelling errors would obstruct the data sync.
Under Step 3. Establish field-level security section, select the Visible header checkbox in the table to grant edit access to this field for all profiles in your Salesforce instance. Then click Next.
This selection depends entirely on the user.
- On the Step 4. Add to page layouts section, keep the default settings and click Save.
This creates a new field, say “Polls Answered,” visible to the campaign members as per the selection in Step 3. Similarly, you can create other field labels as listed above.
Passing any duration-specific data to Salesforce requires a minimum of 1 minute of attendee activity in a Zuddl event/webinar.
Field creation is a one-time activity. This means that if you’ve already created it for an older event or webinar, you need not create it again for a new one.
Campaign member status view
To enable the campaign member view on Salesforce:
- Go to Setup > Object Manager.
- Find or search for ‘Campaign.’
- Find ‘Page Layouts’ in the sidebar and click to edit the ‘Campaign Layout.’
- Scroll down the list to find “Related Lists.” Drag the “Campaign Member Status” related list onto the page and click the Save button.
- Go to Campaign and find Campaign Member Statuses.
Click the New Button and add “Registered” and “Attended.”
Warning
The Member Status value should exactly match the Zuddl keywords “Registered” and “Attended.” Minor spelling errors would obstruct the data sync.
1 hour (after event ends)