Articles in this section
Category / Section

Install Marketo App on Zuddl

Published:
21 mins read
Updated:



Prerequisites

Auth Objects

To authorize Zuddl to access your Marketo account you need the following:
  • API Endpoint
  • Client Id
  • Client Secret
Refer to the following instructions to obtain the above information from your Marketo dashboard.
  1. On the top navigation menu, click Admin.
  2. Now on the left navigation menu, go to Integration > Web Services.
  3. 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.
  4. Now, go to LaunchPoint (under Integration). This displays all the LaunchPoint services as Installed Services.
  5. Click New > New Service.

    image.png

  6. On the New Service creation form, enter the following:
    1. Display Name: Enter a suitable display name.
    2. Service: Choose Custom from the dropdown.
    3. In Settings section, enter a suitable Description.
    4. Choose a user for API Only User.

      image.png


      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.

  7. After you’ve entered all the details, click Create.
  8. Once the new service is created, from the list view, click View Details for the new service.

  9. 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.

    6.png

Once you have stored these keys, you can start the installation.


Others

Ensure that you add these before installing the app on Zuddl.
  • 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

To install the Marketo app:
  1. On the Zuddl dashboard, go to the event listing page > Integration.
  2. On the Marketo card, click View details.
  3. On the Marketo integrations page, click Install app.

    image.png

  4. On the Marketo authentication screen, click Add a new account in the dropdown option. This takes you through the login process.
  5. 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


      10.png



      You can obtain these data from your Marketo instance by following the prerequisite instructions.

  6. 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:

    image.png


    This completes the authentication process to connect to your Marketo account.

  7. 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.

      image.png

  8. 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.

    image.png


    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
  9. Optional step. In the Person Source field, enter “Event” or a suitable input to imply the source of the lead is a Zuddl event.
  10. Click Next.
  11. 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.
    image.png
    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:
    image.png
  12. The integration does not accept the field name as a valid input and only requires the API name for this mapping.
  13. 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.
    registration data updates.png
  14. Click Next.
  15. 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

Field mapping at the organization level integration setup is the mapping of Zuddl standard registration fields with Marketo Lead fields. Field mapping is a one-time activity done so that all events with Marketo integration follow the exact same mapping and field update policy.

org-level data mapping.png

To map fields
  1. 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).
  2. 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.

    org-level data mapping.png


  3. 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.

      image.png

  4. Optional. You can add new mapping by clicking the + Add field button. You can also delete a mapping by clicking the bin icon.

    image.png

  5. Click Finish. Then click on Confirm on the confirmation popup.

    image.png

This saves the current mapping and redirects the user to the integration details page.

Set up Marketo Base Program

The Marketo Base Program lets you enter a program Id that you can use as a template to create new program with similar properties on the Zuddl itself. This way you don’t have to create new programs every time for each event. Learn more about 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

Marketo program member status is fetched based on your Marketo base program. The Marketo program member statuses are same for programs with same channel type. This can be utilized at the time of event-level status mapping.
 
On the Marketo program member status mapping page, map the Zuddl status fields to the corresponding Marketo program member status.

The standard status fields are:
Zuddl statusDescription
No ShowWhen no attendee has joined your Zuddl event even after the event start time.
EnteredWhen an attendee joins the event after in check-in start time. Once the event has started, it will moves to 'Attended'
RegisteredWhen someone registers for your event through Marketo or Zuddl.
AttendedWhen a registrant joins your event at the event start time.

Out of these, Registered and Attended status are auto-mapped to their respective counterparts in Marketo by default

To map other statuses:
  1. Click +Add status button.

  2. Select a Zuddl status you want to map.
  3. In the Marketo program member status column, choose an suitable status from the dropdown. The status fields are auto-populated from your base program. 


Capture attendance type 
To capture attendance status separately for in-person and virtual for a hybrid event:
  1. Click Split categories

  2. The Attended status will be as shown below:

    You can click on Merge categories, if you wish to view the Attended status as one.

  3. 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.

Once created, go back to your Marketo account and approve these changes in the custom activities.



You can click on the Edit button to change/review any settings.

image.png


This completes the field mapping. 

Was this article useful?
Yes
No
Help us improve this page
Please provide feedback or comments
Comments (0)
Please  to leave a comment
Access denied
Access denied