In order to start gathering data, you need to instrument the study into the assets that you want to measure. There are a few different ways to do this, which is covered on this page:
The most straight-forward way to instrument data gathering for a study is through pixels. There will be one or two pixels available, depending on the study settings and whether engagement is measured. See Measuring Reach vs Engagement.
The pixel URLs are shown in the study sidepanel for easy copy-pasting to the appropriate place.
Pixel URLs shown under ‘Instrumentation’ in the study sidepanel
You can add these Pixel URLs to the ad platform, website code or tag manager of your online asset.
The engagement URL can also be used as a link destination instead of a pixel. In that case you will want the destination to redirect the user to another URL after recording the study event. To enable that behaviour, add a destination query parameter to the URL, containing the URL encoded destination URL. For instance:
<https://data02.digiseg.net/1/{studyId}/action?destination=https%3A%2F%2Fcampaign.com>
If you’re adding a instrumentation to a website, it’s sometimes better to do it in a script rather than adding an <img> tag to the body. You can use the below snippet to your website to do that:
<!-- Digiseg measurement -->
<script>
(function() {
var d=document, g=d.createElement('img'), b=d.getElementsByTagName('body')[0]; g.alt='';
g.src='<https://data02.digiseg.net/1/{studyId}/pix.gif>'; b.appendChild(g);
})();
</script>
Just replace {studyId} with the ID of your study.
Finally, you can record study data using our REST API, for example as a server-side measurement integration. The Create study event API endpoint is the key here.
Here’s a simple request example that registers two impressions:
POST <https://api.digiseg.net/studies/{study_id}/events>
{
"event_type": "impression",
"events": [
{
"ip_address": "1.1.1.1",
"referer": "<https://digiseg.io>",
"event_time": "2025-01-24T14:15:22Z"
},
{
"ip_address": "1.1.1.2",
"user_agent": "Mozilla/5.0"
}
]
}