ON24 uses TIBCO Scribe as our iPaaS provider to pass data from ON24 to Salesforce. As a result, your technical resource will receive access to your ON24 TIBCO Scribe account.

After receiving the TIBCO Scribe email invitation, your technical resource will need to follow the TIBCO Scribe Connector Guide, which consists of:

• Creating a new Scribe user account and logging into Scribe.
  • The Scribe user logging in must have create, read, and update permissions for the contact and lead objects. The Marketing User setting must be enabled on the Salesforce user profile to grant campaign and campaign member permissions.
• Adding a Connection specifically for your Salesforce instance. The connection may be with your sandbox and/or production org, depending on your preference. 

• Download the attached LEGACY ON24 API Data Salesforce Sales Cloud spreadsheet and start with the Instructions worksheet. This document provides the available fields that may be passed from ON24 to Salesforce.
  • Please work with your Salesforce admin team to configure any potential custom fields directly in Salesforce.
  • Once the API Data document is completed, please send this document back to your Integration Specialist
• Reminder: If our system doesn't detect any activity on a specific token, it will be disabled after 60 days. The number of days inactive will reset when activity is detected. You can view the Last Activity date and time in Platform Tools > Integrations > API Tokens. Warning notices will be sent for tokens that have been inactive for 60 days.

In Salesforce, navigate to your Setup page to create fields for Campaign and Campaign Members.

Search for Object Manager in the Navigation on the left side of the page. 

In the Object Manager, add the fields you want information on in your Campaign Object and Campaign Member Object.  They will be located within the Object Manager List.

Click on Campaign Object > Fields & Relationships to bring up the Fields & Relationships page.

Click on New to create a new field.

Select Data Type.  This will need to match what is in the spreadsheet for that specific field.  For example, choose Number to set up an Event ID field.

 

Type out the field label name.  Click outside of the box to generate the field name.  This field will need to be added back to the ON24 Salesforce API Data Spreadsheet so the Integrations team can use it for mapping.  When you're done, click Next. 

 

Check Marketing User in the Field-Level Security for Profile section.  It should default to checked if the user creating these fields has this in their permissions.  Click Next.

If you have more fields to set up, click Save & New, then repeat the process above.  If you are done setting up fields, click Save.

Repeat these steps for Campaign Member Object (Registrant and Attendee Data).

• State Field Guidelines - ON24’s registration page includes a “state” field for USA and Canadian registrants. The state/province is spelled out (i.e., California, Florida, etc.). If your Salesforce org is setup to support 2 digits (i.e., CA, FL, etc.), then you will need to log into Webcast Elite, go to the event, add a custom field in the registration page, add a drop-down type field, and manually enter the 2 digits per state in the Choice 1, 2, 3, etc. fields. If you would like assistance with this, please contact your Customer Success Manager to explore a Professional Service team consultation engagement.
• Country State Field Validation - Remove the Country State validation in the lead object under validation rules in Salesforce. Unfortunately, Scribe has issues putting the State and Country in the correct order, which is supposed to be Country first and then State next. If you are unable to remove the Country State validation, then setup an integration user in Salesforce if one is not provided to bypass the validation rule. Follow the instructions for user exceptions in the FAQs tab.
• If you plan to use the ON24 registration form and want to create a lead from the registrant, then your Webcast Elite event’s registration form must include the required fields Email, Last Name, and Company. Inform your Integration Specialist if a workaround is needed.
• If your Email Opt-In field is a text field, provide your Integration Specialist with the API values (i.e., yes/no, true/false, etc.). If you are not familiar with the difference between an API and label value, then please contact your administrator.
• Let your Integration Specialist know if you want ON24 to create the campaign member status (i.e., registered, attended, attended on-demand).

Once the spreadsheet has been filled out with all the Field Names, this document will need to be sent to the ON24 Integrations team. You will most likely already have a case open with this team; reply to them in that case. 

After the spreadsheet is sent, the integrations team will map these fields in your Scribe org. This process can take a few days to complete pending any errors they come across, they will communicate to you if you need to make any changes on your end in order to get these errors fixed. 

Once the mapping is complete, we will test the integration to ensure all connections are working properly and that the fields match what your company expects.

In order for the test to be completed, your team will need to create a campaign in Salesforce, and during the creation process, make sure to add the event ID the integrations team provides you in your ON24 Event ID field. Commas will appear because this is a numeric field, which is expected behavior. The Event ID shown is one that ON24 created using dummy data specifically for testing purposes.

Save the campaign, then let ON24 know that the Campaign has been created. ON24 will then push the test data over to your Salesforce Campaign to populate the fields you have created and create campaign members for that campaign. 

Check the data pushed over by clicking the Campaign name.

To see the details of the Campaign and Event data, click on the Details section.  

To see the Campaign Member Details (Registrant and Attendee), you will want to be on the Related Tab and scroll to Campaign Members. Then click View All.  

This will provide a table of your Campaign Members.  

To get further details for each Registrant or Attendee, click on their name.  This allows you to see details for this Lead/Contact as they pertain to this specific Event, depending on the fields created and mapped.

For example, for attendee data, whether they attended live or on demand, how long they watched the webinar (in minutes), and whether they answered any polls during the webinar.  

After you have checked that everything has gone through with the test data, test the integration using one of your previous webinars to see how your data will be processed and sent. Note that if you are a new client, this step cannot be completed because you won’t have any previous events to select. 

• You will need to select a previous ON24 event and provide the integrations team with that event ID. You will also need to ensure a campaign has been created with that event ID in your ON24 Event ID field, as noted in step 4B.
• Once that has been provided, ON24 will change the connections within your Scribe org and then push the data. They will let you know when this has been completed.
• Once completed, you will want to check your records.