Implementation
  • 15 Sep 2023
  • 7 Minutes to read
  • Dark
    Light

Implementation

  • Dark
    Light

Article summary

This page details every step you need to take to implement the G2 + Marketo integration.

Video documentation

Before getting started

You must repeat the implementation steps for each of your G2-listed products. If your my.G2 user account cannot access all of your organization’s products that receive Buyer Intent, please use a different account, or ask a user in your organization with access to the missing product to invite you.

To verify the products you can access:

  1. Go to my.G2.
  2. Open the product dropdown at the top of the page to reveal your my.G2 product access.

access products

  1. Confirm that your user account can access the necessary G2-listed products. To access products that are not listed in the dropdown, please ask a user in your organization with access to the missing product to invite you, or contact your G2 representative.

1. Create Marketo custom fields for G2 Buyer Intent data

You must create eleven custom fields in Marketo to receive Buyer Intent data in your Marketo instance.

For more information on creating custom fields, refer to Marketo’s Create a Custom Field documentation.

To create custom fields:

  1. Go to Marketo, then Admin > Database Management > Field Management.
  2. Select New Custom Field, then select Person from the Object dropdown.
  3. Fill in the remaining parameters according to the first row in the following table, then select Create. Repeat steps 2 and 3 for each of the remaining rows in the following table until all eleven custom fields have been created.

The API Name auto-populates based on your Name entry. You must overwrite the auto-populated API Name to match the API Name value in the following table.

TypeNameAPI name
IntegerG2 Category Pageviewsg2_category_pageviews
StringG2 Company Nameg2_company_name
IntegerG2 Comparison Pageviewsg2_comparison_pageviews
StringG2 Domaing2_domain
IntegerG2 Market Scoreg2_market_score
Text areaG2 Pages Viewedg2_pages_viewed
IntegerG2 Product Profile Pageviewsg2_product_profile_pageviews
IntegerG2 Sponsored Content Pageviewsg2_sponsored_content_pageviews
IntegerG2 Total Pageviewsg2_total_pageviews
StringG2 Buying Stageg2_buying_stage
StringG2 Activity Levelg2_activity_level

MarketoImplementation_NewCustomField

You must create all 11 G2 custom fields to receive Buyer Intent data in Marketo, even if you do not subscribe to certain Buyer Intent signals with your current G2 plan. For more information on which Buyer Intent signals are included in your subscription, refer to G2’s Seller Solutions Plans.

2. Populate the G2 Domain field

G2 Buyer Intent signals are automatically mapped (auto-mapped) to Marketo by matching the organization’s Buyer Intent website domain with the website domain in the custom G2 Domain Marketo field for each Marketo person. For this reason, you must create a Smart Campaign to populate the G2 Domain field with the company website information associated with each Marketo person.

To populate the G2 Domain field for your Marketo people:

  1. Go to Marketo, then Marketing Activities > New Smart Campaign.
  2. From the Campaign Folder dropdown, select the folder containing the Marketo people you want to populate with Buyer Intent data. Enter a descriptive Campaign Name for the smart campaign, such as Populate G2 Domain, then select Create.
  3. Select the Smart List tab.
  4. Search for the G2 Domain filter using the right sidebar. Select and drag the filter to the smart list canvas, then choose is empty in the G2 Domain dropdown.

g2 domain filter

  1. Select the Flow tab.
  2. Search for the Change Data Value action using the right sidebar. Select and drag the action to the flow canvas.
  3. Choose G2 Domain from the Attribute dropdown, then search for and select {{company.Website}} in the New Value dropdown.

MarketoImplementation_G2DomainWebsite

  1. Select the Schedule tab and choose how often this smart campaign should run.

Because the first smart campaign run populates the G2 domain field for all of your Marketo people, G2 recommends scheduling the first run during a weekend time slot to avoid performance impacts to your Marketo instance during work hours. Subsequent runs should be scheduled multiple times per week to help ensure that new Marketo people receive G2 Buyer Intent signals.

3. Generate authentication credentials

You must create access credentials for G2 to send data to your Marketo environment.

Create a Marketo Client ID and Client Secret

To create access credentials for G2:

  1. Go to Marketo, then Admin > LaunchPoint.
  2. Select New Service, then enter a Display Name, such as "G2 Access Token".
  3. Set the Service dropdown to Custom, then enter a description for your new service.
  4. Select an API Only User from the dropdown.

If you don't have any API-only users, refer to Marketo's Create an API Only User Role documentation.

  1. Select Create to generate your access credentials.
  2. Select View Details for the service you just created to access your Client ID and Client Secret. You will use these credentials to activate the integration.

MarketoImplementation_ClientIdSecret

Obtain your Marketo Endpoint and Identity URLs

To find your REST Endpoint and Identity URLs:

  1. Go to Marketo, then Admin > Web Services.
  2. Copy the Endpoint and Identity URLs from the REST API section.

Do not use the information in the SOAP API section.

MarketoImplementation_EndpointIdentityURLs

4. Activate the integration

After preparing your Marketo environment to accept G2 data, you are to ready activate the integration using the credentials you obtained in the Generate authentication credentials section.

To authenticate your product:

  1. Go to my.G2, then Integrations > Integration Hub.
  2. Select the Adobe Marketo Engage tile.
  3. Enter your Client ID, Client Secret, Endpoint URL and Identity URL into the corresponding fields.

marketo implementation

  1. Select Save.
  2. Set the Buyer Intent Integration Status slider to Active.

Highlighted Integration Status slider in my.G2.

  1. To send Buying Stage and Activity Level data to Marketo, select Activate Data, then set the Buying Stage and Activity Level slider to Active.

For more information on Buying Stage and Activity Level, refer to the Buyer Intent documentation.

Highlighted Buying Stage and Activity Level slider in my.G2.

Buyer Intent data will begin flowing to Marketo within 24-48 hours of activation.

Once data is flowing into your Marketo environment, G2 recommends building a list with Buyer Intent data to get a better understanding of how you can leverage this integration to segment Marketo people.

5. (Optional) Enable leads data

G2 leads are generated when buyers commit certain actions on your G2 product profile page, including watching videos, downloading your content, and requesting custom quotes.

To view all leads generated from your G2 product profile, log in to my.G2, then go to Buyer Activity > Leads > Leads Activity.

To send leads data to Marketo:

  1. Go to my.G2, then Integrations > Integration Hub.
  2. Select the Marketo Engage tile.
  3. In the Leads Integration section, set the Integration Status slider to Active.
  4. In the Configure Leads field, select Edit Configuration.
  5. Select Add a Field to add rows. Use the dropdowns in the G2 field and Marketo field columns to map the G2 leads data to your Marketo fields.

marketo configure leads fields

For more information on choosing lead form fields, refer to the Tagging leads with additional data section.

  1. When finished mapping, select Save. G2 leads will begin flowing to Marketo within 24-48 hours.

If a lead generated from your G2 product profile already exists as a Marketo person, G2 overwrites the lead’s information in Marketo with the most recent data.

Tagging leads with additional data

Any field on your G2 lead form can be mapped to Marketo, including custom and hidden fields. To view all form fields available for mapping, select Add a Field, then scroll through the options in the G2 field dropdown.

find leads options

G2 collects robust interaction data when buyers submit your lead form, which you can also map to fields in Marketo. For example, use the user_action or action_id fields to include the specific action that triggered the lead form submission.

The user_action field provides a short, human-readable version of the interaction, such as Downloaded a document.

The action_id field provides full details for the interaction. If the lead was generated by a document being downloaded, the name of the document is also included, such as document_download: Pricing List.

If you want to tag your leads with data that G2 does not capture by default, refer to the Leads documentation for more information on adding custom fields to your lead form.

For example, if you have multiple products listed on G2, you might want to tag leads with the name of the specific product profile that captured the lead. To accomplish this, you can create a hidden product name field on the lead form for each of your products, which can then be mapped to Marketo.

add product name field to marketo

company_size field mapping

To make creating workflows using company size data easier, G2 converts company size ranges into a single integer before sending to Marketo.

The following table shows the possible selections for the Company Size field on the G2 lead form and the corresponding number sent to Marketo.

G2 Lead form optionNumber sent to Marketo
Myself Only

1

2-10 employees

2

11-50 employees

10

51-200 employees

50

201-500 employees

200

501-1000 employees

500

1001-5000 employees

1000

5001-10000 employees

5000

10001+ employees

10000

Confirming leads activity

After enabling leads data, confirm that leads are flowing to your Marketo instance by reviewing the Leads Activity section in the my.G2 Marketo Engage tile, which contains all leads sent to Marketo.

A green checkmark in the Status column indicates that the lead was successfully created in Marketo, while a red X indicates that lead data could not be synced.

To determine why a lead did not sync, select the dropdown arrow, then review the Response message at the bottom of the sync data.

MarketoImplementation_LeadDateExample