The DCM/DFA Reporting and Trafficking API v3.2 is deprecated and will be sunset on August 31st, 2019. All users must migrate to a newer API version by that date.

TargetableRemarketingLists

For a list of methods for this resource, see the end of this page.

Resource representations

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.

{
  "kind": "dfareporting#targetableRemarketingList",
  "id": long,
  "accountId": long,
  "subaccountId": long,
  "advertiserId": long,
  "advertiserIdDimensionValue": dimensionValues Resource,
  "name": string,
  "description": string,
  "active": boolean,
  "listSize": long,
  "lifeSpan": long,
  "listSource": string
}
Property name Value Description Notes
accountId long Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.
active boolean Whether this targetable remarketing list is active.
advertiserId long Dimension value for the advertiser ID that owns this targetable remarketing list.
advertiserIdDimensionValue nested object Dimension value for the ID of the advertiser.
description string Targetable remarketing list description.
id long Targetable remarketing list ID.
kind string Identifies what kind of resource this is. Value: the fixed string "dfareporting#targetableRemarketingList".
lifeSpan long Number of days that a user should remain in the targetable remarketing list without an impression.
listSize long Number of users currently in the list. This is a read-only field.
listSource string Product from which this targetable remarketing list was originated.

Acceptable values are:
  • "REMARKETING_LIST_SOURCE_ADX"
  • "REMARKETING_LIST_SOURCE_DBM"
  • "REMARKETING_LIST_SOURCE_DFA"
  • "REMARKETING_LIST_SOURCE_DFP"
  • "REMARKETING_LIST_SOURCE_DMP"
  • "REMARKETING_LIST_SOURCE_GA"
  • "REMARKETING_LIST_SOURCE_GPLUS"
  • "REMARKETING_LIST_SOURCE_OTHER"
  • "REMARKETING_LIST_SOURCE_PLAY_STORE"
  • "REMARKETING_LIST_SOURCE_XFP"
  • "REMARKETING_LIST_SOURCE_YOUTUBE"
name string Name of the targetable remarketing list. Is no greater than 128 characters long.
subaccountId long Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.

Methods

get
Gets one remarketing list by ID.
list
Retrieves a list of targetable remarketing lists, possibly filtered. This method supports paging.

Send feedback about...

Campaign Manager
Campaign Manager