The Campaign Manager 360 API v3.3 is deprecated and will be sunset on June 30th, 2021. All users must migrate to a newer API version by that date.

REST Resource: targetableRemarketingLists

Resource: TargetableRemarketingList

Contains properties of a targetable remarketing list. Remarketing enables you to create lists of users who have performed specific actions on a site, then target ads to members of those lists. This resource is a read-only view of a remarketing list to be used to faciliate targeting ads to specific lists. Remarketing lists that are owned by your advertisers and those that are shared to your advertisers or account are accessible via this resource. To manage remarketing lists that are owned by your advertisers, use the RemarketingLists resource.

JSON representation
{
  "id": string,
  "accountId": string,
  "subaccountId": string,
  "advertiserId": string,
  "advertiserIdDimensionValue": {
    object (DimensionValue)
  },
  "name": string,
  "description": string,
  "active": boolean,
  "listSize": string,
  "lifeSpan": string,
  "listSource": enum (ListSource),
  "kind": string
}
Fields
id

string (int64 format)

Targetable remarketing list ID.

accountId

string (int64 format)

Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in

GET

requests.

subaccountId

string (int64 format)

Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in

GET

requests.

advertiserId

string (int64 format)

Dimension value for the advertiser ID that owns this targetable remarketing list.

advertiserIdDimensionValue

object (DimensionValue)

Dimension value for the ID of the advertiser.

name

string

Name of the targetable remarketing list. Is no greater than 128 characters long.

description

string

Targetable remarketing list description.

active

boolean

Whether this targetable remarketing list is active.

listSize

string (int64 format)

Number of users currently in the list. This is a read-only field.

lifeSpan

string (int64 format)

Number of days that a user should remain in the targetable remarketing list without an impression.

listSource

enum (ListSource)

Product from which this targetable remarketing list was originated.

kind

string

Identifies what kind of resource this is. Value: the fixed string

"dfareporting#targetableRemarketingList"

.

ListSource

Enums
REMARKETING_LIST_SOURCE_OTHER
REMARKETING_LIST_SOURCE_ADX
REMARKETING_LIST_SOURCE_DFP
REMARKETING_LIST_SOURCE_XFP
REMARKETING_LIST_SOURCE_DFA
REMARKETING_LIST_SOURCE_GA
REMARKETING_LIST_SOURCE_YOUTUBE
REMARKETING_LIST_SOURCE_DBM
REMARKETING_LIST_SOURCE_GPLUS
REMARKETING_LIST_SOURCE_DMP
REMARKETING_LIST_SOURCE_PLAY_STORE

Methods

get

Gets one remarketing list by ID.

list

Retrieves a list of targetable remarketing lists, possibly filtered.