Adform Segments Connector Setup Guide

Adform is the only global, independent, and fully integrated advertising platform built for modern marketing. Its unique enterprise technology – Adform Flow – harnesses superior user experience and a scalable, modular, and open architecture to enable seamless management of the whole campaign life cycle. Adform provides a variety of solutions for tracking website, mobile app, or server-side activities. This service allows you to manage your audiences - groups of internet visitors who share the same categories, behaviors, and attributes (age, gender, and geographic location).

This article describes how to set up the Adform Segments connector.

API Information

This connector uses the following vendor API:

  • API Name: Adform API
  • API Version: v1
  • API Endpoint: https://api.adform.com/v1/dmp
  • Documentation: Adform API

Connector Actions

Action Name AudienceStream EventStream
Add User to Audience Segment
Remove User from Audience Segment

Configure Settings

Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.

After adding the connector, configure the following settings:

  • Client ID
    Required. Provide your Client ID.
  • Client Secret
    Required. Provide your Client Secret.

Click Done when you are finished configuring the connector.

Audience Segment

Segments can be created and deleted, and you can add or remove users to audience segments. AudienceStream utilizes an API endpoint to retrieve, create, and delete segments within your Tealium AudienceStream instance.

By default, the ability to dynamically create audiences is not available. To use this feature, ask your Adform administrator to make this feature available.

Only account administrators can make dynamic audience generation available or adjust the default settings for all dynamically-generated audiences. Administrators can set the price, indicate the to live (TTL) in days, and specify a data type.

To create a segment, click Create Segment for the following parameters:

Parameters

Parameter Description
Audience Name (required) Name of the audience to appear in Adform.
Adform Partner ID (required) The Adform Partner ID for your account.
Category ID (required) A category ID to which the audience should belong.
Owner ID (required) Audience Owner ID value.
Price (required) The price to set per audience.
Data Type Set the data type according to your data sharing plans:
  • 1st Party: Only you will be using the data.
  • 2nd Party: You plan to share the data with your partner or partners.
  • 3rd Party: You plan to share this data with everyone as a branded data provider.
Time to Live (TTL) (required) The lifetime of data under an audience segment.
Frequency (required) The number of times an identifier must be qualified before the defined criteria will be added to the audience list.

To delete a segment, click Delete Audience and select the audience segment to be deleted.

Additionally, the status of the segment appears in parentheses next to the audience segment name.

For example: Cart Abandoners (active)

Action Settings — Parameters and Options

Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu.

The following section describes how to set up parameters and options for each action.

Action — Add User to Audience Segment

Parameters

Parameter Description
Audience Segment (sg) Select Audience Segment or type Owner ID.
Adform Partner ID (Required) The Adform Partner ID of your account.
UID (uid) Adform ID Visitor Attribute
GAID (gaid) Google Advertiser Visitor ID attribute
IDFA (idfa) Apple Identifier for Advertisers
First Party Data Source Text for the source or technology provider responsible for the included IDs. This should be a top-level domain. For example, netid.de
First Party Agent Type An integer that identifies the type of user agent that the user identifier is from. Possible agent type values:
  • 1 - Collected from a desktop device in a browser.
  • 2 - Collected from an app (in-app) on a mobile device (for example, IDFA or AAID).
  • 3 - A user-based ID, which is the same across multiple devices and applications.
  • 500+ - Vendor-specific context and ID, vendor-specific codes.
First Party ID An identifier for the first-party ID from the source provider. This might be a long string or a GUID.

Action — Remove User from Audience Segment

Parameters

Parameter Description
Audience Segment (sg) Select Audience Segment or type Owner ID.
Adform Partner ID (Required) The Adform Partner ID of your account.
UID (uid) Adform ID Visitor Attribute
GAID (gaid) Google Advertiser Visitor ID attribute
IDFA (idfa) Apple Identifier for Advertisers
First Party Data Source Text for the source or technology provider responsible for the included IDs. This should be a top-level domain. For example, netid.de
First Party Agent Type An integer that identifies the type of user agent that the user identifier is from. Possible agent type values:
  • 1 - Collected from a desktop device in a browser.
  • 2 - Collected from an app (in-app) on a mobile device (for example, IDFA or AAID).
  • 3 - A user-based ID, which is the same across multiple devices and applications.
  • 500+ - Vendor-specific context and ID, vendor-specific codes.
First Party ID An identifier for the first-party ID from the source provider. This might be a long string or a GUID.

First Party ID

Adform accepts all currently-available first-party ID solutions. First-party IDs are assigned to the audiences provided in the call.

The following first party IDs are supported:

Provider Name Source Name
NetID netid.de
Britepool britepool.com
Liveramp (IdentityLink) liveramp.com
PubCommonID id5-sync.com
Lotame (Panorama ID) crwdcntrl.net
Unified ID 2.0 uidapi.com
Prebid Shared ID sharedid.org
Your Proprietary ID your-top-level-domain.com This value could potentially map the Tealium Visitor ID used for visitor stitching to send to Adform.

Was this page helpful?

This page was last updated: August 25, 2022