Using HTTP Raw

Relevant to: Demand Acceleration Platform

Use a HTTP Raw integration to create almost any kind of post out to your Marketing Automation/CRM system. This method is ideal if:

• The Demand Acceleration Platform does not offer a native integration with your system.
• You need to use a language or format that is different from URL Encode, such as XML or JSON. If you can use a URL Encode, you are advised to set-up an integration with an Outbound Form.

Adding a HTTP Raw Integration to a Campaign/Source

1. In the Demand Acceleration Platform, go to your Campaign/Source and navigate to the Integrations tab. Click the Add Integration button.

• If you can see an My HTTP tile here, the integration has already been added to the Campaign/Source. Proceed to Configure your HTTP Raw integration.

2. You will be presented with the Add Integration modal. 

Here there are two options:

• Option 1: Create a new Campaign/Source integration – Start from scratch! This will essentially create a default integration with the fields you created on the Fields tab of the Campaign or Source and their corresponding tokens will auto-populate in string format. You will need to review and manually adjust the field names and values within the Body according to your system needs. 
  • This option is most helpful when:
    • You or your team are new to the Demand Acceleration Platform.
    • You haven’t built any Campaign/Sources with a similar set up.
    • You are using very few fields or unique fields within this Source (eg. in Social or Webinar Sources, which have fewer, more specific fields).

• Option 2: Load From Existing – Start from something similar! This will make an exact copy of an existing integration from another Campaign/Source. Once loaded, changes can be made for the new Source.
  • This option is most helpful when:
    • You already have an existing integration that used similar fields and set up details (eg. existing builds from the same team, region, program).
    • You are creating multiple Sources that use the same Social or Webinar form fields.
    • You have complex routing rules that you would like to copy and manually check the Source fields and details match.

Decide which option works best for your build; instructions for both are outlined below.

Option 1: Create a new Campaign/Source integration

1. In the Add Integration pop-up modal, select My HTTP from the list.

This is now listed as an integration with a visible tile. Proceed to Configure your HTTP Raw integration.

Option 2: Load From Existing

1. In the Add Integration pop-up modal, select the Load From Existing button.

2. You will then be presented with a list of the existing Campaign template integrations to choose from. If you wish to switch to view your Source Integrations, use the Showing Campaigns button and select Source from the drop-down.

3. Click the desired Campaign/Source integration and select the integration from the dropdown in the Integration Name column. Then click the Load Integration button.

This will load a copy of your existing integration to the new Campaign/Source, which you can adjust accordingly.

Proceed to the Configuring Your HTTP Raw Integration section below for more details.

Configuring Your HTTP Raw Integration

Once an integration has been added to your Campaign/Source, you need to configure some key elements to define how lead data is sent to your Marketing Automation or CRM system.

1. To open your integration, hover over the integration tile and click the Settings icon.

2. Move through the sections below to configure your integration according to the needs of your Campaign/Source.

yourSystemFieldName={{lead.IntegrateFieldName}}

firstName={{lead.first_name}}

IntegrateID={{lead.Id}}

leadsource=Integrate

firstName={{lead.first_name}}
&lastName={{lead.last_name}}
&Email={{lead.email}}
&Company={{lead.company_name}}
&IntegrateID={{lead.Id}}
&leadsource=Integrate

Testing the Integration

It is really important to test your integration before you start collecting leads. It is advisable to work closely with your Marketing Ops team for this as you will need to check that sample data is posted into your Marketing Automation or CRM system.

For instructions on testing your integration, see Testing an Outbound Integration.

Recommended Reading

• Monitoring Your Lead Post Outs
• Testing an Outbound Integration

For more help, get in touch with our Support Team or your Customer Success Manager.