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 facilitate 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 (RemarketingListSource),
  "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 (RemarketingListSource)

Product from which this targetable remarketing list was originated.

kind

string

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

"dfareporting#targetableRemarketingList"

.

Methods

get

Gets one remarketing list by ID.

list

Retrieves a list of targetable remarketing lists, possibly filtered.