Event tag type. 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. This is a required field.
url
string
Payload URL for this event tag. The URL on a click-through event tag should have a landing page URL appended to the end of it. This field is required on insertion.
for this event tag to fire. This is a required field.
urlEscapeLevels
integer
Number of times the landing page URL should be URL-escaped before being appended to the click-through event tag URL. Only applies to click-through event tags as specified by the event tag type.
sslCompliant
boolean
Whether this tag is SSL-compliant or not. This is a read-only field.
Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
excludeFromAdxRequests
boolean
Whether to remove this event tag from ads that are trafficked through Display & Video 360 to Ad Exchange. This may be useful if the event tag uses a pixel that is unapproved for Ad Exchange bids on one or more networks, such as the Google Display Network.
kind
string
Identifies what kind of resource this is. Value: the fixed string
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-02 UTC."],[[["\u003cp\u003eEvent tags are used for tracking impressions and clicks on ads, utilizing third-party pixels, JavaScript URLs, or click-through URLs.\u003c/p\u003e\n"],["\u003cp\u003eEvent tags can be configured with a payload URL, site filters (allowlist or blocklist), and enabled/disabled status.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eEventTag\u003c/code\u003e resource provides properties like ID, name, account/advertiser/campaign IDs, type, URL, site IDs, site filter type, enabled status, URL escape levels, SSL compliance, and more.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eEventTagType\u003c/code\u003e defines the type of event tag: impression pixel, impression JavaScript, or click-through.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eEventTagSiteFilterType\u003c/code\u003e allows filtering by site IDs using either an allowlist or blocklist.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eEventTagStatus\u003c/code\u003e indicates whether the tag is enabled or disabled.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage event tags through methods like delete, get, insert, list, patch, and update.\u003c/p\u003e\n"]]],[],null,["- [Resource: EventTag](#EventTag)\n - [JSON representation](#EventTag.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: EventTag Contains properties of an [event tag](https://support.google.com/dcm/answer/6135968).\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"name\": string, \"accountId\": string, \"subaccountId\": string, \"advertiserId\": string, \"campaignId\": string, \"type\": enum (/doubleclick-advertisers/rest/Shared.Types/EventTagType), \"url\": string, \"siteIds\": [ string ], \"siteFilterType\": enum (/doubleclick-advertisers/rest/Shared.Types/EventTagSiteFilterType), \"enabledByDefault\": boolean, \"status\": enum (/doubleclick-advertisers/rest/Shared.Types/EventTagStatus), \"urlEscapeLevels\": integer, \"sslCompliant\": boolean, \"advertiserIdDimensionValue\": { object (/doubleclick-advertisers/rest/v4/DimensionValue) }, \"campaignIdDimensionValue\": { object (/doubleclick-advertisers/rest/v4/DimensionValue) }, \"excludeFromAdxRequests\": boolean, \"kind\": string } ``` |\n\n| Fields ||\n|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` ID of this event tag. This is a read-only, auto-generated field. |\n| `name` | `string` Name of this event tag. This is a required field and must be less than 256 characters long. |\n| `accountId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Account ID of this event tag. This is a read-only field that can be left blank. |\n| `subaccountId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Subaccount ID of this event tag. This is a read-only field that can be left blank. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Advertiser ID of this event tag. This field or the `campaignId` field is required on insertion. |\n| `campaignId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Campaign ID of this event tag. This field or the `advertiserId` field is required on insertion. |\n| `type` | `enum (`[EventTagType](/doubleclick-advertisers/rest/Shared.Types/EventTagType)`)` Event tag type. 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. This is a required field. |\n| `url` | `string` Payload URL for this event tag. The URL on a click-through event tag should have a landing page URL appended to the end of it. This field is required on insertion. |\n| `siteIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Filter list of site IDs associated with this event tag. The `siteFilterType` determines whether this is a allowlist or blocklist filter. |\n| `siteFilterType` | `enum (`[EventTagSiteFilterType](/doubleclick-advertisers/rest/Shared.Types/EventTagSiteFilterType)`)` Site filter type for this event tag. If no type is specified then the event tag will be applied to all sites. |\n| `enabledByDefault` | `boolean` Whether this event tag should be automatically enabled for all of the advertiser's campaigns and ads. |\n| `status` | `enum (`[EventTagStatus](/doubleclick-advertisers/rest/Shared.Types/EventTagStatus)`)` Status of this event tag. Must be `ENABLED` for this event tag to fire. This is a required field. |\n| `urlEscapeLevels` | `integer` Number of times the landing page URL should be URL-escaped before being appended to the click-through event tag URL. Only applies to click-through event tags as specified by the event tag type. |\n| `sslCompliant` | `boolean` Whether this tag is SSL-compliant or not. This is a read-only field. |\n| `advertiserIdDimensionValue` | `object (`[DimensionValue](/doubleclick-advertisers/rest/v4/DimensionValue)`)` Dimension value for the ID of the advertiser. This is a read-only, auto-generated field. |\n| `campaignIdDimensionValue` | `object (`[DimensionValue](/doubleclick-advertisers/rest/v4/DimensionValue)`)` Dimension value for the ID of the campaign. This is a read-only, auto-generated field. |\n| `excludeFromAdxRequests` | `boolean` Whether to remove this event tag from ads that are trafficked through Display \\& Video 360 to Ad Exchange. This may be useful if the event tag uses a pixel that is unapproved for Ad Exchange bids on one or more networks, such as the Google Display Network. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"dfareporting#eventTag\"` . |\n\n| Methods ||\n|-------------------------------------------------------------|----------------------------------------------------|\n| [delete](/doubleclick-advertisers/rest/v4/eventTags/delete) | Deletes an existing event tag. |\n| [get](/doubleclick-advertisers/rest/v4/eventTags/get) | Gets one event tag by ID. |\n| [insert](/doubleclick-advertisers/rest/v4/eventTags/insert) | Inserts a new event tag. |\n| [list](/doubleclick-advertisers/rest/v4/eventTags/list) | Retrieves a list of event tags, possibly filtered. |\n| [patch](/doubleclick-advertisers/rest/v4/eventTags/patch) | Updates an existing event tag. |\n| [update](/doubleclick-advertisers/rest/v4/eventTags/update) | Updates an existing event tag. |"]]