Posting conversion details to Bing Ads

  • Unlike most traffic sources that use a Postback URL (Server-2-Server pixel) to receive conversion details, Bing Ads uses a JavaScript tracking pixel which cannot be fired unless placed directly in the Confirmation or Thank You page.

    • This will work if you run your own offers and have access to the page HTML code, but it won’t work if you run offers from Affiliate Networks.
  • In order to overcome this limitation and to be able to see your conversions in Bing Ads even when using an Affiliate Network, we have introduced an automatic process of uploading conversion data to Bing Ads, without using the Bing tracking pixel.

    • This method doesn’t use the Bing API either, so we will NOT ask for your Bing Ads account credentials.
    • You only need to make a few configuration settings once, then the process will run automatically for you.

Process overview

The process works like this:

  • Bing Ads sends a unique code (External ID) for each visitor to CPV Lab Pro in the msclkid parameter;

  • You have some new code in CPV Lab Pro that will return the unique codes for converting visitors in a format accepted by Bing Ads;

  • Bing Ads calls this code periodically and imports conversions into the Bing Ads interface!

  • The process is fully automated, once you perform the initial configuration there is no need to do anything else and conversions will be sent from CPV Lab Pro to Bing Ads.

Initial configuration

Here is what you need to do in order to install and make the initial configuration:

1. Make sure that you are running CPV Lab Pro 8.0 because this feature was introduced in version 8.0.
  • If you run an older version of CPV Lab Pro, then you can upgrade from the User Area.
2. Use the Configuration Editor page from the Settings menu in CPV Lab Pro and define a Bing Conversion Key.
  • This should be a random string that you define (10-20 characters) which will be used to authenticate Bing requests and prevent un-authorized access to your data.
  • It can look like in the image below:

Configuration Editor

3. Enable auto-tagging in your Bing Ads account.

  • This is a global setting and it will automatically append the 'msclkid' parameter with a unique code in the Final URL for each visitor.
  • This unique code is needed in order to identify the converting visitor.

In your Bing Ads account from the main menu on the left, click All campaigns -> Settings -> then Account settings and look for Auto-tagging (see attached).

  • Make sure that you check this checkbox in order to enable Auto-tagging.

Bing Ads Autotagging

4. Create a conversion action in your Bing Ads account:

  • go to Tools -> Conversions, then click on the + sign to add a new conversion action

Bing Ads add new conversion

  • select Import as the type and then select 'Track conversions from clicks'

Bing Ads create 2

  • name the conversion action ‘ImportConversion’, choose Purchase/Sale as Category, then SAVE the conversion action.

Bing Ads create 3

Bing Ads create 4

5. In your Bing campaigns from CPV Lab Pro, define 'msclkid' as the Parameter for the External ID token and leave the Placeholder blank (see attached).

  • This will make CPV Lab Pro capture the unique codes for visitors coming from Bing Ads.

Bing Ads external id

6. You should also edit the Bing Ads Traffic Source from the Traffic Sources page under the Sources menu and enter 'msclkid' as the Parameter for the External ID token in order to have it prefilled in future campaigns.

  • You can also re-import the Bing Ads traffic source from the Catalog in the Traffic Sources page and you will have the External ID set to ‘msclkid’ by default for new campaigns.

7. Now you can test the page that reports conversions by calling the following URL in a browser:

https://your-cpvlabpro-domain/api/bing-conversions/?key=bing-conversion-key&camp=bing

  • where bing-conversion-key should be replaced by the random key that you defined at Step 2 above.
  • The result should be a page that looks as follows:

Bing Ads empty result page

  • If you get the above, it means that the new page works well (it doesn’t show any conversion data yet, but it will show data once you get some conversions).
  • If you get an error message, then please check that the Bing conversion key is the same in the Configuration Editor page (Step 2) and in the URL (Step 7).

8. Create the Upload Schedule in Bing Ads

  • Go to your Bing Ads account and navigate to Tools -> Conversions, then select Uploads on the left:

Bing Ads conversion upload

  • Now select SCHEDULES from the top and then the + sign to create a new scheduled conversion upload:

Bing Ads conversion upload schedule

  • Here you need to:
    • enter the URL above for your new page as the Source URL
    • choose ‘Every 6 hours’ as the Frequency
    • choose any time that you want conversions to be retrieved from CPV Lab Pro

Bing Ads conversion create schedule

  • Save the current settings and you have created the Schedule that will import conversions periodically from CPV Lab Pro to Bing Ads.
    • You will see a record each time the upload executes in the ‘UPLOADS’ section from the same page.
    • Once conversions are uploaded you will also see them appearing in your Bing Ads reports.

Optional parameters

There are several optional parameters that you can use in the URL that you submit to Bing Ads:

Parameter Default Value Details
name ImportConversion The name of the Conversion Action that you defined in Bing Ads
currency USD The currency to use for revenues reported to Bing Ads
cstrev If you prefer to hide the actual revenues and not pass them to Bing Ads, then enter a custom value that will be reported for each conversion in this parameter. For example, if you add ‘&cstrev=0’ to the URL, then all conversions will be reported with 0 as revenue
days 7 The number of days to return conversion for. By default, conversions from the past 7 days are returned.
camp bing The campaigns to return data for. Possible values:
- bing – all your campaigns that use Bing as traffic source;
- a numeric Campaign ID – only the campaign with this ID;
- a list of numeric IDs separated by comma (,) – only the campaigns with the IDs specified

FAQ

1. What if I have multiple Bing Ads accounts?

  • Then you need to perform the process described above in all you Bing Ads accounts.
  • Define the Conversion Action and schedule the daily import from Bing Ads for all your accounts.
  • Conversions belonging to other accounts will simply be skipped during the import by Bing.

2. How to hide the actual revenues of my conversions from Bing?

  • You can define a custom revenue to be reported to Bing instead of the real revenue if you want to hide those from Bing.
    • In order to do this, you need to include the ‘cstrev’ parameter followed by the desired revenue in the URL submitted to Bing.

Example:

3. I get an error message on the uploaded file in Bing Ads saying “This conversion action was created too recently”

  • This error appears sometimes immediately after you create the Conversion Action.
  • The solution is to wait a few hours, then try to upload the file again and it will be processed correctly. No need to change anything else, just wait for a few hours.

4. I get an error message on the uploaded file in Bing Ads saying “We cannot find an import conversion type with this name in the target account”

  • Make sure that you have created in the Conversion Action and that you named it ImportConversion as described at Step 4 above

5. I get an error message on the uploaded file in Bing Ads saying “This msclkid belongs to an account that you are not authorized to access”

  • This error may appear when you have multiple Bing Ads accounts since the CPV Lab Pro page will return the msclkid values (unique codes) for all conversions from all accounts.
  • There is no problem when this error is received and conversions associated to each Bing Ads account will be imported correctly, while conversions from other accounts will simply be ignored.