Install Marketo App on Zuddl
Prerequisites
Auth Objects
- API Endpoint
- Client Id
- Client Secret
- On the top navigation menu, click Admin.
- Now on the left navigation menu, go to Integration > Web Services.
- In the REST API section, copy the Endpoint value (leave out “/rest” from the API) and store it to be used at a later point.
- Now, go to LaunchPoint (under Integration). This displays all the LaunchPoint services as Installed Services.
Click New > New Service.
- On the New Service creation form, enter the following:
- Display Name: Enter a suitable display name.
- Service: Choose Custom from the dropdown.
- In Settings section, enter a suitable Description.
Choose a user for API Only User.
If no user shows up in the dropdown, you need to create a new user with API-only Role permission). Learn how to invite a new user with specific roles.
Tip: While creating a new user, you may enter any email address as a valid email address is not required.
- After you’ve entered all the details, click Create.
- Once the new service is created, from the list view, click View Details for the new service.
From the Details screen, copy the Client Id and Client Secret and store it securely along with the API Endpoint (already stored from a previous step) to be used for authenticating your Marketo account on Zuddl.
Others
- If you wish to pass attendee activity data, you need to create or map existing custom activities (so keep them handy). To create a custom activity, go to Admin > Data Management > Marketo Custom Activity > New Custom Activity.
- If you wish to pass magic link data, you need the magic link field ready in the program members section.
Installing the App
- On the Zuddl dashboard, go to the event listing page > Integration.
- On the Marketo card, click View details.
On the Marketo integrations page, click Install app.
- On the Marketo authentication screen, click Add a new account in the dropdown option. This takes you through the login process.
- Create a new authentication. On the Create a new authentication screen, paste the stored values in their respective fields.
- Enter an authentication name
- Paste the copied API endpoint domain
- Paste the Client ID
Paste the Client Secret
You can obtain these data from your Marketo instance by following the prerequisite instructions.
After you’ve entered all the fields, click Create. This successfully creates an authentication for your Marketo account on Zuddl. Your connected account appears selected in the dropdown, as shown in the screenshot below:
This completes the authentication process to connect to your Marketo account.
- Custom Activity Mapping. Custom Activity Mapping is done to receive the registration and attendee activity data captured by Zuddl. There are two Zuddl activities:
- Zuddl Event User Profile: to pass the “Registered” and “Attended” activity for a registrant.
Zuddl Event User Activity: to pass activity data of an attendee inside an event, such as polls answered, questions upvoted, room duration, and more.
You need to map these Zuddl Activities to corresponding Marketo activities, and the captured data is stored in the Lead Activity Log.
If you don’t have a suitable activity to map Zuddl activities, you have to create a custom activity manually from Admin > Data Management > Marketo Custom Activity > New Custom Activity.
Ensure that you approve the activity on Marketo to be able to view it on Zuddl. You can also delete the mapping by clicking the Bin icon and add a new mapping by clicking the Add a new mapping button.
If no activity type is mapped, Zuddl event activities won’t flow into Marketo - Optional step. In the Person Source field, enter “Event” or a suitable input to imply the source of the lead is a Zuddl event.
- Click Next.
- In the next step, if a custom field for Magic Link is created in your program member object, enter the API name of the field on the Enter field name (API name) to pass the attendee magic link. This is used for sending emails with magic link through Marketo for attendees to join the event/webinar.
On your Marketo instance, you can find the custom field in Admin > Field Management. Search for the field on the right-side navigation bar. Click on the field to view the details. Now, you can copy the API name as shown below: - Select the “Pass registration data updates (attendee profile data & organizer data) to Marketo based on field update policies” checkbox. This allows Zuddl to update both new and existing leads with any changes in Zuddl registration data based on field update policies.
- Click Next.
Workflow URLs. On the Workflow URLs screen copy the Marketo > Zuddl Registration Public URL (using the copy to clipboard button) and store it securely. This URL is required to set up a webhook in the Marketo to Zuddl flow.
This completes the installation. Now you need to perform field mapping.
Mapping Marketo field with Zuddl
- Select a suitable Zuddl registration field from the dropdown. Zuddl registration fields consist of all Zuddl standard fields along with UTM (UTM Source, UTM Campaign, UTM Id, etc.) and IP fields (Ip City and Ip Country).
Select a corresponding Marketo Lead fields.
Note: The mandatory fields, namely, First Name, Last Name, and Email, are auto-mapped to their respective counterparts in Marketo. These mandatory fields are used for creating a new lead in your Marketo account.
- Choose a field update policy from the dropdown.
Do not update: This option does not pass the Zuddl field value to the mapped Marketo 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 Marketo 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 Marketo field.
Only update if target is empty: If the Marketo lead field value is empty, this option passes the Zuddl field value only in this case.
Optional. You can add new mapping by clicking the + Add field button. You can also delete a mapping by clicking the bin icon.
Click Finish. Then click on Confirm on the confirmation popup.
This saves the current mapping and redirects the user to the integration details page.
Set up Marketo Base Program
This is an optional step. If you do not wish to create a base program, you can skip this step.
Program member status mapping
The standard status fields are:
Zuddl status | Description |
---|---|
No Show | When no attendee has joined your Zuddl event even after the event start time. |
Entered | When an attendee joins the event after in check-in start time. Once the event has started, it will moves to 'Attended' |
Registered | When someone registers for your event through Marketo or Zuddl. |
Attended | When a registrant joins your event at the event start time. |
To map other statuses:
- Click +Add status button.
- Select a Zuddl status you want to map.
- In the Marketo program member status column, choose an suitable status from the dropdown. The status fields are auto-populated from your base program.
- Click Split categories
- The Attended status will be as shown below:You can click on Merge categories, if you wish to view the Attended status as one.
- After you've finished mapping, click Finish. On the confirmation prompt click Confirm.
Create activity fields
Now click on Create activity fields to create filters for your custom activities. This is a one-time activity that creates fields where Zuddl will pass relevant event activity information.
You can click on the Edit button to change/review any settings.
This completes the field mapping.