Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.segmentstream.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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 Twitter (X Ads)

Choose Twitter (X Ads) from the list.
3

Authenticate

Click Authenticate with Twitter (X Ads) 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

Since X Ads do not support dynamic UTM parameters, you must manually input the campaign and ad group names as tracking parameters in the website URL of your promoted post. This manual entry is essential for SegmentStream to accurately attribute ad platform clicks to sessions on your website.
1

Go to Legacy Ads Manager

Go to your Ads Manager, and click Go to Legacy.
2

Open Ad groups tab

Select the Ad groups tab and click on Metrics: Summary > Customise metrics.
3

Select metrics

Select the Ad Group ID and Campaign ID metrics and click Apply.
4

Note the IDs

Find the ad group you want to track and note the Ad Group ID and Campaign ID values (for example, 47604328 and 36868108).
5

Edit ad group

Click on the more options icon next to your ad group name and click Edit ad group.
6

Edit website URL

Edit the Website URL field for each ad within the ad group.
7

Add utm_id parameter

Add the utm_id parameter to the URL, combining the Campaign ID and Ad Group ID with an underscore. For example:
text
https://segmentstream.com?utm_source=x&utm_medium=paid-social&utm_campaign=Offers&utm_id=36868108_47604328
Once the parameters are implemented, sessions will be linked with costs down to the ad group level, and SegmentStream reports will display the X Ads campaign name and ad group name accordingly.