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 Facebook

Choose Facebook from the list.
3

Authenticate

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

Select accounts

Select the accounts you would like to connect.
5

Save

Click Save.

​
UTM tagging best practices

Adding a utm_id parameter to your tagging template will guarantee improved stitching quality of costs to sessions without altering the rest of your existing UTM tags. We suggest using the following format for the utm_id parameter in Facebook ads:
text
utm_id={{campaign.id}}_{{adset.id}}_{{ad.id}}
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 Facebook campaign name, ad set name, and ad name, respectively.

​
Supported dynamic URL parameters

By default Facebook allows the use of dynamic URL tagging parameters to track campaigns. SegmentStream supports the following parameters:
NameDescription
{{ad.id}}The unique ID of the ad.
{{adset.id}}The unique ID of the ad set. An ad set is a group of ads that share the same budget, schedule, delivery optimisation and targeting.
{{campaign.id}}The unique ID number of the ad campaign. A campaign contains ad sets and ads.
{{ad.name}}The name of the ad.
{{adset.name}}The name of the ad set. An ad set is a group of ads that share the same budget, schedule, delivery optimisation and targeting.
{{campaign.name}}The name of the ad campaign. A campaign contains ad sets and ads.
{{site_source_name}}Depending on where the ad appeared this parameter has four possible values: fb (Facebook), ig (Instagram), msg (Messenger), an (Audience Network).
{{placement}}Depending on where the ad appeared this parameter has possible values: Facebook_Mobile_Feed, Facebook_Right_Column, Facebook_Instant_Articles, Facebook_Instream_Video, Facebook_Marketplace, Instagram_Stories, Instagram_Feed, Instagram_Explore, Messenger_Inbox, Messenger_Stories, Facebook_Desktop_Feed, an (for Audience Network), Others (for all other placements).

​
Sharing access with SegmentStream

To help SegmentStream perform quality checks and validate data, you can share view-only access to your Facebook Ads account.
1

Open Business Manager

Open Facebook Business Manager and go to Accounts > Ad accounts.
2

Assign Partner

Select the ad account you want to share and click Assign Partner.
3

Enter SegmentStream business ID

Enter SegmentStream’s business ID: 843884825767231.
4

Set permissions

Select View Performance for view-only access, then click Assign.
Your Facebook Ad Account is now shared with SegmentStream.