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
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.
[[["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 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 a user list with `UserListType` FREQUENCY_BASED and include the event matchers to be added."],["The user list should not already contain the same constraints being added in the request."],["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. It uses a `POST` HTTP request to the specified endpoint, including the user list resource name in the URL as a path parameter. The request body, in JSON format, contains an array of `eventMatchers` to be added, with the constraint that they must not already exist on the specified user list. A successful request returns the updated `UserList`, and it is necessary that the userList type is FREQUENCY_BASED. The action requires the OAuth scope.\n"]]