Convertr Help Centre Help Center home page
Submit a request
Sign in
  1. Convertr Help Centre
  2. New & Updated Features

Convertr Connect: Integration Follow

Sophie Brewer
  • February 07, 2022 17:41
  • Updated

Overview

If both you and your client are users of the Convertr platform, and you are sending leads directly into your client's instance, we have an integration that will simplify the delivery of your leads into their platform.

The Convertr Connect integration allows you to input your publisher API details as well as the details of the campaign your client has set up, and it will automatically pull through all of their form fields for you to then map onto your own. 

In addition, your client's instance will be able to communicate with your own - if any leads are marked as invalid or valid on their side, it will automatically update your own record of that lead, making this the easiest way to easily manage leads between yourself and the client.

Note: The Convertr Connect integration was previously called the Enterprise to Enterprise integration and provides the same functionality. 

Prerequisites

  • You must have the subdomain of your client's instance (e.g if the client's Convertr url is {enterprise}.cvtr.io, then their subdomain is {enterprise})
  • You will need publisher level access to your client's instance to retrieve the the API Key, Publisher ID and Campaign ID. 

Retrieving Your API Key

  1. In the receiving platform (your client's platform), select the appropriate campaign and select Tracking from the action buttons on the right.

    PublisherAPIKey-Tracking.png

  2. This will open the Tracking Information module. Select the API Credentials tab.

    PublisehrAPIKey-Tracking2.png

  3. Within this screen, retrieve your API Key, Publisher ID and Campaign ID. You will need to enter these details when you configure the Convertr Connect Integration in your platform campaign.

    PublisehrAPIKey-Tracking3.png

 

Setting up your Integration

  1. On your enterprise, select your campaign and navigate to the Processr > Integration. Select Add Job, and choose Convertr Connect job. Clicking Save will then open the configuration window

    blobid0.png

  2. Fill in all the prerequisite fields in the top section.
    blobid3.png

  3. If these credentials are valid, then you will get a dropdown when selecting the form ID. You can then select the form you wish to use.
    ConnectIntegration-Form.png

    The same will also occur for Link, but this is not a mandatory requirement and may not return anything if no links have been configured by your client.

  4. When you select a form, the mapping section will populate with all fields that are available on that form.
    ConnectIntegration-mapping.png

    All that you will need to do is map your corresponding field from your own form on the right hand side.
    ConnectIntegration-mapping2.png

  5. Lastly, a button will have appeared at the top of the integration called Place Sync Tags.
    blobid2.png

    This enables your client's platform to provide feedback when they update the status of your leads.

    For example, if a lead is rejected as invalid once your client receives it, we will append this to the lead in your own system along with the reason:

    blobid0.png

 

There are 4 different triggers for these tags:

  1. If your lead is valid in the client's platform, we will mark your lead as valid
  2. If your lead is invalid in the client's platform, we will mark your lead as invalid
  3. If your lead is cautioned in the client's platform, we will mark your lead as invalid
  4.  If your lead is deleted in the client's platform, we will mark your lead as invalid

These statuses will update whenever the lead is updated in your client's platform, so it's possible a lead's status could change if they manually flag the lead.

Without these tags, this communication will not occur - the button will change to indicate if the tags have already been placed:

blobid1.png

 

Once you are happy, click Save at the bottom to complete the integration configuration.

Articles in this section

  • Full Contact - Social Enrichment v3
  • Call Centre Contact Status
  • Batch Management
  • The New Dashboard!
  • Advertiser Default Value Settings Overview
  • Setting up An Advertiser
  • Batch CSV Integration
  • Marketo Duplication Email Job
  • Success String
  • Processr Job Groups
See more

Related articles

  • Deliver Leads to an External Form URL Using the HTTP Post Integration
  • Integrating with Hubspot
  • Convertr Connect: Validation List
  • Uploading Leads: Publishers
  • Publisher Certification: Study Guide
Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request
Return to top

Related articles

  • Deliver Leads to an External Form URL Using the HTTP Post Integration
  • Integrating with Hubspot
  • Convertr Connect: Validation List
  • Uploading Leads: Publishers
  • Publisher Certification: Study Guide