Best Practices for API Connections best-practices-for-api-connections
Overview overview
Marketo Measure offers API connections with Google AdWords, Microsoft Bing Ads, Facebook Ads, and LinkedIn. These API connections enable Marketo Measure to pull a variety of data from your ad platforms that can then be reported on in your Buyer Touchpoint data. A key feature to these API connections is their ability to pull spend data automatically, saving you and your team the time and effort it takes to manually upload data for ROI reporting. Setting up these API connections is not mandatory for Marketo Measure to track those channels, but they do provide valuable granular details that enhance your reporting.
The Marketo Measure API connections are an invaluable aspect of your account and our best practice recommendations will help you and your team utilize our connections to the fullest extent.
Best Practice best-practice
Regardless of the ad platform you are connecting, the following guidelines are important to keep in mind!
- Use an admin to connect
- You can connect multiple ads accounts for one platform
- Connect all possible ad accounts to automate your spend reporting as much as possible
- If available, always implement a tracking template. The template ensures that even if the ad account becomes disconnected, Marketo Measure is still able to pull in granular ad details
To optimize each Marketo Measure API, abide by the following best practices.
Facebook: Connect with auto-tagging
Prior to enabling auto-tagging, export your ad history to a csv. Enabling auto-tagging will reset the conversion history and social proof of all of the ads tagged by Marketo Measure.
By following our best practice recommendation, the Marketo Measure Facebook API will be able to:
- Auto-tag all Facebook Ads with the necessary Marketo Measure parameter
_bf ={creative} - Download ad cost information across all active Facebook ads
AdWords: Implement a tracking template at the account level and enable auto-tagging
Marketo Measure recommends using an Account-Level, Campaign-Level, or Ad Group-Level Tracking template, as it allows for the addition and subtraction of parameters for all ads without the risk of Ad History interruptions or deletion.
By following our best practice recommendation, the Marketo Measure AdWords API will be able to:
- Auto-tag all AdWords Ads with the Marketo Measure parameters of
_bk={keyword}, _bt={creative}, _bm={matchtype}, _bn={network}, _bg={adgroupID} - Download ad cost information across all active AdWords ads
Bing: Implement a tracking template at the account level and enable auto-tagging
There is no risk of losing ad history when setting up your Bing API connection, unlike some of our other API connections.
By following our best practice recommendation, the Marketo Measure Bing API will be able to:
- Auto-tag all Bing Ads with the following parameters of
_bt={adid}, utm_medium=cpc, utm_source=bing, utm_term={keyword} - Download ad cost information across all active Bing ads
LinkedIn: Connect with auto-tagging
Enabling auto-tagging recreates a Share and places it in a new Creative, the old Creative gets archived.
By following our best practice recommendation, the Marketo Measure LinkedIn API will be able to:
- Auto-tag all LinkedIn ads which are ad type Sponsored Content with the necessary Marketo Measure parameter _bl={creativeId}. This parameter pull in the creative ID allowing Marketo Measure to resolve the campaign and creative information.
- Download ad cost information across all active and supported LinkedIn ads
Best Practice for Maintenance best-practice-for-maintenance
While following our best practices will protect you from losing data if disconnected, we still recommend that you review your connection on a regular basis, monthly if possible. This is a simple visual check of the Connections section in your Marketo Measure app to make sure there are no red key icons present, signaling a disconnected account.
When an API connected account is disconnected, Marketo Measure is not able to pull spend data in or tag new ads. This is why we always recommend implementing a tracking template if possible. The template ensures that even if the ad account becomes disconnected, Marketo Measure is still able to tag the ads and pull in granular ad details. Once reconnected, the spend data will back fill and the disruption to your Paid Channel reporting is minimal.
Reasons for disconnection and reauthorization include…
- Change in password to the person account who is connected
- That person is no longer at the company
- Updates to the APIs
If your team has experienced any of the above scenarios, check your API connections in the Marketo Measure app to make sure they do not need to be reauthorized.