The Adzerk Developer Hub

Welcome to the Adzerk developer hub. You'll find comprehensive guides and documentation to help you start working with Adzerk as quickly as possible, as well as support if you get stuck. Let's jump right in!

Retargeting

Retargeting is tied to an Adzerk cookie. This cookie is dropped only if you are using JavaScript ad codes. Retargeting, as described below, will not work through the Decision API.

Retargeting requires UserDB, a data management platform that comes with the Business & Enterprise tiers.

Overview

With Retargeting, Advertisers place a pixel on THEIR site and then can target those users when they appear on YOUR website or app.

Users stay in their retargeting segment for approximately 90 days

Retargeting Steps

  1. First create the pixel (see below)
  2. Have the Advertiser put the pixel somewhere on their site. It could be on every page, just the homepage, a specific product page, checkout, etc. When a person lands on a page with the pixel, their UserDB record gets updated that they are in that segment.
  3. Create a Flight/Ad targeting this pixel via Reserved Keys

Creating Retargeting Pixel

The pixel template is: http://e-{networkId}.adzerk.net/udb/{networkId}/rt/{advertiserID}/{segment}/i.gif.

This URL is composed of three sections you will need to fill-out.

Property
Description

NetworkID
(integer)

This is your Network ID

AdvertiserID
(integer)

This is the Advertiser's specific Advertiser ID

Segment
(integer)

This is an integer you choose to denote the Retargeting segment. You could have multiple if you wanted to track multiple pages. That said, this is rare and most advertisers will just want a single pixel. In this case, you can just set segment to 1

Example pixel would be: http://e-123.adzerk.net/udb/123/rt/6700/1/i.gif.

Creating a Retargeting Flight

When you create a Flight/Ad in the UI or Create Flight/Create Ads endpoints, you'll want to use Reserved Keys to build a segment around `$user.retargetingSegments.

In the query, the string should look like this: $user.retargetingSegments.b42 = 1.

Here, b42 refers to the Advertiser ID. If the Advertiser's ID is "676", it would be $user.retargetingSegments.b676. "1" is the code of the retargeting segment.

For instance:

flight={
  "CampaignId":1234,
  "PriorityId":1325,
  "Name":"Retargeting - Homepage",
  "StartDateISO":"2017-05-01T00:00:00.00.0000000",
  "GoalType": 1,
  "CustomTargeting":"$user.retargetingSegments.b42 = 1"
}

Viewing Retargeting Segments

If you use the UserDB Read User Endpoint, you can pull and filter the resulting data by the retargetingSegments field to see all the Retargeting Segments you have created (however, it only shows the integer, not what it refers to. For instance, it'll show Segment "1" is tied to a user...but not that "1 = homepage")

Retargeting