Marketo

For a downloadable version of this article to share with other people on your team, click here.

How does Marketo for Fuel Cycle work?

Sync your customer data seamlessly between Marketo and Fuel Cycle in a few simple steps. You can choose to push data from Marketo to Fuel Cycle and pull Fuel Cycle profile map data into Marketo. Once setup, the data is synced every 24 hours.

Push Data

When push data is enabled, an additional option will be available in Profile Maps for “Push to CRMs.” All profile maps set to Push to CRMs will be pushed to a Custom Object you create called “FC_IMPORT.” The data can be synced to users in Marketo based on matching email address.

Pull Data

When pull data is enabled, any Marketo data added to the Custom Object “FC_EXPORT” will be pulled into Fuel Cycle where it will be synced to members based on matching email address. The data can used as a source in profile points where they can then be added to member exports and used for segmentation in dynamic groups.

Please Note

We are only able to match users based on email address at this time. If you have users inside Marketo without an email address, we cannot match those users inside Fuel Cycle.

Marketo Configuration Steps

The following steps are done inside your Marketo account. Please provide this information to your internal Marketo team to perform these tasks.

  1. Login to Marketo with an admin account
  2. Create a Rest API User
    1. Go to “Admin,” then to “Users and Roles” and click the “Roles” tab
    2. Click “New Role”
    3. Give the role a name, such as Fuel Cycle API
    4. Under Permissions, select the following:

      1. Access Admin
      2. Access API
      3. Access Lead Database
      4. Access Marketing Activities
    5. Save new role
    6. Return to the “Users” tab and select “Invite New User”
    7. Step 1: Info

      1. Enter an email address for the user
      2. Give the user a descriptive name, such as “Fuel Cycle API User”
      3. Reason is optional, but is useful to description user to other account members
      4. Leave Access Expires blank and the click Next
    8. Step 2: Permissions

      1. Select the API Role you just created, then click “API Only” and click Next.
    9. Step 3: Message

      1. Click “Send” to complete user creation. Note: Invitation is not required for an API only user.
  3. Create a New Service
    1. Go to the Admin menu, then to LaunchPoint.
    2. Click on the New menu and select New Service.

      1. Give your service a descriptive name
      2. Select “Custom” from the Service dropdown menu.
      3. Under Settings, enter a description
      4. Select your new user you created above from the API Only User dropdown menu and click on Create.
    3. Click “View Details,” then copy and save the Client ID and Client Secret, which will need to be given to the person who will enter the information inside Fuel Cycle.
  4. Find REST API Endpoint
    1. Go to the Admin menu, then to Web Services
    2. Under REST API, locate the Endpoint value then copy and save. This will need to be given to the person who will enter the information inside Fuel Cycle.
    3. You are done with this portion of the setup. Please give the Client ID, Client Secret, and REST API Endpoint to your internal Fuel Cycle team member.
      Please Note

      You will need to work with your Fuel Cycle team after the setup is complete inside Fuel Cycle to determine the data that should be pushed from Marketo to Fuel Cycle (details outlined below). Your Fuel Cycle team will work with you when that step is ready.

Fuel Cycle Configuration Steps

The following steps are done inside your Fuel Cycle account. Please provide this information to your internal Fuel Cycle team to perform these tasks.

  1. Create connection to Marketo inside Fuel Cycle
    1. Login to the Fuel Cycle Admin
    2. Navigate to Exchange and click the “Configure” button on the Marketo card
    3. From the settings page, enter the following details that you saved from the Marketo steps outlined above:
      1. Account Nickname: This is for internal use only and can be any name you want to give it
      2. Client ID
      3. Client Secret
      4. REST API Endpoint
        IMPORTANT

        Use only the first part of the REST API Endpoint that ends with .com (remove the /rest part at the end).Example:
        The full REST API is http://831-SSl-993.mktorest.com/rest but only enter the following: http://831-SSl-993.mktorest.com

    4. You can then choose what type of data sync options you want to enable for the community:
      1. Pull Data from Marketo: When this option is selected, you need to create a Custom Object called FC_EXPORT then add all profile data you want pulled from Marketo to Fuel Cycle as fields to this custom object.
      2. Push Data to Marketo: When this option is selected, you need to create a Custom Object called FC_IMPORT then create a field for each Fuel Cycle profile point that you want to push into Marketo.
    5. Click the “Test Connection” button to verify the connection between Fuel Cycle and Marketo works.
    6. Once the test is successful, you can Save the configuration.
    7. The configuration is now done, but additional steps are needed to choose the data to include in the sync (see below).

Setting up Profile Data to Sync

Pull Data

  1. Steps 2-14 are done inside your Marketo account. Please provide this information to your internal Marketo team to perform these tasks.
  2. Once the connection is saved in Fuel Cycle, you must create a Custom Object in Marketo and place Marketo profile data you want to pull into Fuel Cycle.
  3. Login into Marketo with an admin account.
  4. Go to “Admin,” then “Marketo Custom Objects”
  5. Click “New Custom Object”
  6. Give the fields the following values. Please note: These must be exactly as outlined below.

    1. Display Name: FC_EXPORT
    2. API NAME: FC_EXPORT_c
    3. Plural Name: FC_EXPORTs
    4. Description (ok to leave blank)
    5. Show in Lead Detail: Show
  7. Click “Save” and you’ll see your new custom object.
  8. Now to go to “Field” and click “New Field” making sure “FC_EXPORT” is selected on the right
  9. Enter the following exactly as shown below:

    1. Display Name: emailAddress
    2. API Name: emailAddress
    3. Description (ok to leave blank)
    4. Data Type: Link
    5. Link Object: Lead
    6. Link Field: Email Address
    7. Dedupe Field: Yes
  10. Click “Save” to create the field. This field will be used to match leads in Marketo to members in Fuel Cycle.
  11. You can now add additional fields that you want to export (pull) into Fuel Cycle.
    1. Work with your Fuel Cycle team to determine the profile data you want to pull not Fuel Cycle.
    2. For additional fields added to this custom object, set the Data Type as “Text”
  12. When done adding fields, you need to approve the custom object. Return to the “Marketo Custom Objects” tab and make sure the FC_EXPORT object is selected in the right column.
  13. Click the “Custom Object Actions” dropdown and select “Approve Object”
  14. Your custom object is now ready to export data into Fuel Cycle.
  15. Every 24 hours, Fuel Cycle will pull all data from FC_EXPORT into Fuel Cycle. The sync will occur every 24 hours at midnight Pacific.
  16. You can return to Exchange > Marketo to view the date and time the most recent pull sync occurred.
  17. In addition, you can click the “Available Fields” link to view all of the fields that have been pulled from Marketo.
  18. All data that comes from Marketo will be imported as qualitative data, which may not be useful inside Fuel Cycle for all fields.
    1. When you click the “Available Fields” link, you’ll be taken to a page where you can view all imported fields including the total number of values imported from each field.
    2. You can click the # of Values link to view a list of all values.
    3. If you have a field that you want to convert into a Quantitative data source, click the “Convert to Quantitative” link and the field will be converted so that you can use it as a source for quantitative profile points. This is valuable because you can then use the data for dynamic grouping.
      1. EXAMPLE USE CASE:
        1. You have a field called “Loyalty Tier” from Marketo with only 3 possible values for “Platinum,” “Gold,” and “Silver.”
        2. You want to be able to create a dynamic group of all members in the Platinum tier.
        3. To achieve this, convert the field to Quantitative and then create a new profile point with Loyalty Tier as the source (since the field has been converted, you can map it like a survey question).
        4. You can then create a dynamic group of all members with the loyalty tier as Platinum.
          IMPORTANT

          Once a field has been converted to Quantitative, it cannot be changed back to Qualitative. Make sure you want to convert the field before clicking the link.

  19. All imported data (as either qualitative and quantitative) can be used as a source in profile points. By adding it as a source to profile points, the data can then be added to member exports, pushed as embedded data to Alchemer or Qualtrics and can be used in dynamic grouping logic.

Push Data

  1. You will need to select the Fuel Cycle profile point data that you want to push to Marketo.
  2. To do this, go to Members > P2 Engine and click to edit a profile point you want to push to Marketo.
  3. You’ll see a new option for “Push to CRMS” in the first tab. Simply select this option and click the Save button to enable the push for that profile point.
    1. Continue to enable the option for all profile points you want to push to Marketo.
  4. When done, make sure to click the “Refresh Data” button to save all changes to the Profile Points.
  5. Now, you need to create a Custom Object and Fields in Marketo where the Fuel Cycle data will be pushed.
  6. First, return to Exchange > Marketo and locate the “Profile Points” link next to the Push status:

    1. When you click the link, a file will download listing all profile points. You will need to use this when creating fields in Marketo as outlined below.
  7. The following steps are done inside your Marketo account. Please provide this information to your internal Marketo team to perform these tasks.
  8. Login into Marketo with an admin account.
  9. Go to “Admin,” then “Marketo Custom Objects”
  10. Click “New Custom Object”
  11. Give the fields the following values. Please note: These must be exactly as outlined below.

    1. Display Name: FC_IMPORT
    2. API NAME: FC_IMPORT_c
    3. Plural Name: FC_IMPORTs
    4. Description (ok to leave blank)
    5. Show in Lead Detail: Show
  12. Click “Save” and you’ll see your new custom object.
  13. Now to go to “Field” and click “New Field” making sure “FC_IMPORT” is selected on the right
  14. Enter the following exactly as shown below:

    1. Display Name: emailAddress
    2. API Name: emailAddress
    3. Description (ok to leave blank)
    4. Data Type: Link
    5. Link Object: Lead
    6. Link Field: Email Address
    7. Dedupe Field: Yes
  15. Click “Save” to create the field. This field will be used to match leads in Marketo to members in Fuel Cycle.
  16. You must now create a field for each Profile Point you want to push into Marketo from Fuel Cycle with the Data Type “text”.
    1. Open the profile point file you downloaded from Fuel Cycle to use as a reference for each field to create.
      1. IMPORTANT

        You must create a field for EVERY profile point listed in the CSV file from Fuel Cycle. If you do not have a corresponding field for each profile point in the CSV, the job will fail and no data will import into Marketo.

    2. You will need to use the exact same naming convention and enter the value in the “API Name” column in the CSV file.
    3. Example: If the API NAME in the document is “maritalStatus” enter as follows:

      1. Display Name: maritalStatus (this is case sensitive)
      2. API Name: maritalStatus
      3. Data Type: text
    4. Continue to create a new field for each profile point in the CSV file.
    5. When done adding fields, you need to approve the custom object for the changes to take effect. Return to the “Marketo Custom Objects” tab and make sure the FC_IMPORT object is selected in the right column.
    6. Click the “Custom Object Actions” dropdown and select “Approve Object”
    7. Your custom object is now ready to accept data pushed from Fuel Cycle.
    8. Every 24 hours, Fuel Cycle will push all profile point data into FC_IMPORT. The sync will occur every 24 hours at midnight Pacific.
    9. You can return to Fuel Cycle Exchange > Marketo to view the date and time the most recent push sync occurred.

Troubleshooting Issues

Failed Sync Job

If a sync job has failed, you’ll see a red warning icon and the date and time when the sync failed in red. There are many reasons a sync might fail and there are often no details available as to why. We will continue to attempt to run the sync job every 24 hours. In many cases, if there is a failure, it will work the next time the job runs. Once it runs successfully, the warning icon will no longer display to let you know it’s working properly.

In the case of the job continuing to fail, please check all settings to verify the connection is still working. Use the Test Connection button to verify the connection is working properly.

Missing Profile Point Data in FC_IMPORT

When new profile points are added to Fuel Cycle that you want to use in Marketo, you MUST add a new field into FC_IMPORT custom object with the reference name of the profile point. Please check the following:

  1. Go to Fuel Cycle > Exchange > Marketo and click to download the latest profile point CSV.
  2. Return to Marketo and go to the FC_IMPORT custom object.
  3. Click on the Fields and verify all API Names in the CSV file have a corresponding field in the custom object.
  4. If you make any changes or add new fields, make sure to approve the changes to the custom object.
  5. The next time the job runs, the data will be pushed correct.
IMPORTANT

If you change the Question Reference of a profile point in Fuel Cycle, you will also need to change the API Name in Marketo to match the new reference. It’s recommended you don’t edit references of profile points after they are created to ensure the link between Marketo and Fuel Cycle doesn’t break.

Updated on October 5, 2021

Was this article helpful?

Related Articles