Skip to main content

​
Getting started

1

Navigate to Data Sources

Inside the admin panel navigate to the Data Sources page and click + NEW on the top right corner.
2

Select Microsoft Advertising

Choose Microsoft Advertising from the list.
3

Authenticate

Click Authenticate with Microsoft and go through the authentication flow.
4

Select account

Select the advertising account you would like to connect.
5

Save

Click Save.

​
UTM tagging best practices

Adding a utm_id parameter to your ads URLs will guarantee improved stitching quality of costs to sessions without altering the rest of your existing UTM tags.
1

Open account-level options

In the left side menu, select Campaigns > Settings > Account level options.
2

Add the utm_id parameter

Add utm_id={CampaignId}_{AdGroupId}_{AdId} in the Final URL suffix field.
3

Test

Click Test to check if the URL contains the utm_id parameter.
4

Save

Click Save.
Once the utm_id parameter is implemented, sessions will be stitched with costs at the ad level. The Campaign, Ad Group, and Ad Name dimensions of the SegmentStream reports will display the Microsoft Advertising campaign name, ad group name, and ad name, respectively.

​
Supported dynamic URL parameters

By default Microsoft Advertising allows the use of dynamic URL tracking parameters to track campaigns. SegmentStream supports the following parameters:
If you use unsupported parameters in UTM tags, you will see the parameter names in SegmentStream reports instead of their values (for example, {OrderItemId} instead of 1234567890). For better stitching quality, move unsupported parameters from UTM tags to additional custom GET parameters.