Impression Pixel
Last updated
Was this helpful?
Last updated
Was this helpful?
The Freshpaint Impression Pixel is a custom tracking pixel you can serve across the web and use to match ad impressions to conversion events to support view-through conversions on supported destinations on the Freshpaint platform.
Matching events from impression pixels is supported on Demand Side Platform destinations including , , , , and .
The impression pixel can be used to match events with earlier views of the pixel and add information from that impression to the event. This can be used to track view-through conversions on advertising platforms by matching the impression and conversion events within Freshpaint and sharing with the advertisement platform that a conversion happened for an ad impression.
From the perspective of a conversion, the impression pixel works like this:
A user views the impression pixel served to them anywhere on the web, such as alongside an advertisement.
The same user later converts on a website with Freshpaint installed and sends an event to Freshpaint and the Destination.
The site user and impression are matched based on IP address if the impression occurred within the configured number of days.
Freshpaint forwards the event on to your destination alongside information captured with the impression.
For HIPAA mode customers, note that any properties on the impression still need to be allowlisted to be forwarded to the destination.
Using the impression pixel with a destination is a two step process:
Configure the destination you want to use the impression pixel with to match impressions
Set up a macro in your advertising platform to serve the impression pixel
In the configuration settings for a destination that supports the impression pixel, click "Configure" next to Freshpaint Impression Pixel.
Enable at least one form of matching and set a conversion window between 1 and 30 days. The conversion window controls how old an impression can be while still being matched. For instance, a conversion window of 7 days means that only impressions that occurred within 7 days of an event will be matched to that event.
The impression pixel currently supports two matching modes:
IP Matching matches impressions on events which originate from the same IP (v4) address as the impression.
Cookie Matching matches impressions based on a cookie which is set at the time of the impression and read at the time of the event.
Note that these matching methods are internal to the Freshpaint platform; enabling a matching mode does not change what data is forwarded to destinations. The data from the most recent matching impression will be used if multiple matches exist within the conversion window.
The impression pixel is a 1x1 transparent pixel served from https://freshpaint-impression.com/pixel.png. Query parameters defined on the impression pixel are used to match impressions to events in your platform.
In the configuration for your destination, you will find a "configuration URL" that you can copy. This will contain the correct env_id and dest_id, as well as any known required destination-specific parameters, such as an advertising auction ID.
If you want, you can define custom query parameters to store on impressions. At a minimum, for an impression to match the following query parameters must be defined:
env_id — The Freshpaint environment ID
dest_id — The Freshpaint destination ID
Any views of the impression pixel that do not provide an environment ID and destination ID will not be able to be logged or matched. These are present on the copied snippet, but if configuring this manually ensure that these parameters are not removed.
Any additional parameters passed to the impression pixel will be added to matched events before they are sent to the destination. HIPAA mode customers will need to allowlist properties that are captured via the impression pixel.
Generally, you will want to serve the impression pixel via an ad platform, using a macro to add unique identification about the impression alongside an advertisement.
