EventTags: list

Retrieves a list of event tags, possibly filtered. Try it now.


HTTP request

GET https://www.googleapis.com/dfareporting/v3.3/userprofiles/profileId/eventTags


Parameter name Value Description
Path parameters
profileId long User profile ID associated with this request.
Optional query parameters
adId long Select only event tags that belong to this ad.
advertiserId long Select only event tags that belong to this advertiser.
campaignId long Select only event tags that belong to this campaign.
definitionsOnly boolean Examine only the specified campaign or advertiser's event tags for matching selector criteria. When set to false, the parent advertiser and parent campaign of the specified ad or campaign is examined as well. In addition, when set to false, the status field is examined as well, along with the enabledByDefault field. This parameter can not be set to true when adId is specified as ads do not define their own even tags.
enabled boolean Select only enabled event tags. What is considered enabled or disabled depends on the definitionsOnly parameter. When definitionsOnly is set to true, only the specified advertiser or campaign's event tags' enabledByDefault field is examined. When definitionsOnly is set to false, the specified ad or specified campaign's parent advertiser's or parent campaign's event tags' enabledByDefault and status fields are examined as well.
eventTagTypes string Select only event tags with the specified event tag types. Event tag types can be used to specify whether to use a third-party pixel, a third-party JavaScript URL, or a third-party click-through URL for either impression or click tracking.

Acceptable values are:
ids long Select only event tags with these IDs.
searchString string Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "eventtag*2015" will return objects with names like "eventtag June 2015", "eventtag April 2015", or simply "eventtag 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "eventtag" will match objects with name "my eventtag", "eventtag 2015", or simply "eventtag".
sortField string Field by which to sort the list.

Acceptable values are:
  • "ID" (default)
  • "NAME"
sortOrder string Order of sorted results.

Acceptable values are:
  • "ASCENDING" (default)


This request requires authorization with the following scope:


For more information, see the authentication and authorization page.

Request body

Do not supply a request body with this method.


If successful, this method returns a response body with the following structure:

  "kind": "dfareporting#eventTagsListResponse",
  "eventTags": [
    eventTags Resource
Property name Value Description Notes
kind string Identifies what kind of resource this is. Value: the fixed string "dfareporting#eventTagsListResponse".
eventTags[] list Event tag collection.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.