We've updated our documentation with the latest features and updates introduced by Ads Data Hub's
two new experiences.
Advertisers, agencies, and publishers, refer to the
Marketers site.
Vendors and partners, refer to the
Measurement Partners site.
Method: customers.userLists.addEventMatchers
Adds event matchers to a frequency-based user list. This call cannot delete existing event matchers or modify frequency-based constraint metadata such as window or when a user is added. The user list may already contain some event matchers. For example, this call could add: AddEventMatchersRequest { userList: "customers/1/userLists/12345" eventMatchers { matchType: GOOGLE_ADS_CAMPAIGN_ID value: "3456" } } For this call to succeed, user list 12345 should not already contain a campaign constraint of the type GOOGLE_ADS_CAMPAIGN_ID with campaign id "3456".
HTTP request
POST https://adsdatahub.googleapis.com/v1/{userList=customers/*/userLists/*}:addEventMatchers
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
userList |
string
Required. Full resource name, has the form of ‘customers/[customerId]/userLists/[userlist_id]’. UserList must have UserListType FREQUENCY_BASED.
|
Request body
The request body contains data with the following structure:
| JSON representation |
{
"eventMatchers": [
{
object (EventMatcher)
}
]
} |
| Fields |
eventMatchers[] |
object (EventMatcher)
Contain only those constraints to add to the user list. The user list specified by userList should have none of the constraints specified here at the time of the call but can have other pre-existing constraints.
|
Response body
If successful, the response body contains an instance of UserList.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/adsdatahub
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[null,null,["Last updated 2024-09-18 UTC."],[[["Adds event matchers to a frequency-based user list without deleting existing ones or modifying frequency-based constraint metadata."],["The request must specify the user list using its full resource name and include an array of event matchers to be added."],["The user list should not already contain the same constraints being added but can have other pre-existing constraints."],["A successful response returns the updated UserList object."],["Requires the `https://www.googleapis.com/auth/adsdatahub` OAuth scope for authorization."]]],["This document details the process of adding event matchers to a frequency-based user list in Ads Data Hub. The core action is adding event matchers via a `POST` request to the specified URL, using the `userList` path parameter to identify the target list. The request body, formatted in JSON, contains an array of `eventMatchers`. The `userList` must be a frequency based type and cannot already include the same constraint values. A successful response returns an updated `UserList`. Authentication requires the `adsdatahub` OAuth scope. Frequency capping is no longer supported.\n"]]
