Best Practices for API Connections

Overview

Bizible offers API connections with Google AdWords, Microsoft Bing Ads, Facebook Ads, and LinkedIn. These API connections enable Bizible to pull a variety of data from your ad platforms that can then be reported on in your Bizible 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 Bizible to track those channels, but they do provide valuable granular details that enhance your reporting.

The Bizible 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

Regardless of the ad platform you’re 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, Bizible is still able to pull in granular ad details

To optimize each Bizible API, please 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 Bizible.

By following our best practice recommendation, Bizible’s Facebook API will be able to:

  • Auto-tag all Facebook Ads with the necessary Bizible parameter _bf ={creative}
  • Download ad cost information across all active Facebook ads
NOTE

There is no tracking template for Facebook, the API relies on the auto-tagged (_bf) parameter to gather the ad details.

AdWords: Implement a tracking template at the account level and enable auto-tagging

Bizible 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, Bizible’s AdWords API will be able to:

  • Auto-tag all AdWords Ads with the Bizible 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, Bizible’s 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, Bizible’s LinkedIn API will be able to:

  • Auto-tag all LinkedIn ads which are ad type Sponsored Content with the necessary Bizible parameter _bl={creativeId}. This parameter pull in the creative ID allowing Bizible to resolve the campaign and creative information.
  • Download ad cost information across all active and supported LinkedIn ads
NOTE

There is no tracking template for LinkedIn, the API relies on the auto-tagged (_bl) parameter to gather all possible ad details.

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 Bizible app to make sure there are no red key icons present, signaling a disconnected account.

When an API connected account is disconnected, Bizible 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, Bizible 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, please check your API connections in the Bizible app to make sure they do not need to be reauthorized.

On this page