Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 8 Current »

Platform URL

https://[enterprise].cvtr.io/v2/advertisers/[advertiserId]/validation-lists

API Endpoints

Retrieves Suppression/Validation Lists:

GET https://{enterprise}.cvtr.io/api/v4/suppression-lists

Creates Suppression/Validation Lists:

POST https://{enterprise}.cvtr.io/api/v4/suppression-lists

Retrieves Suppression/Validation Values:

GET https://{enterprise}.cvtr.io/api/v4/suppression-list-values

Creates Suppression/Validation Values:

POST https://{enterprise}.cvtr.io/api/v4/suppression-list-values

Downloads Suppression/Validation Values:

POST https://{enterprise}.cvtr.io/api/v4/suppression-list-download

Upload CSV file containing Suppression/Validation Values:

https://{enterprise}.cvtr.io/api/v4/files/csv

Import Suppression/Validation Values:

https://{enterprise}.cvtr.io/api/v4/suppression-list-values/import

Retrieves/Removes/Replaces a Suppression/Validation Values:

GET/DELETE/PUT https://{enterprise}.cvtr.io/api/v4/suppression-lists/{id}

Epic

DAS-14 - Getting issue details... STATUS

Document status

REVIEWED

Document owner

Adam Carter

Technical Writers

Anu Kalangi Muge Budak Arunima Kurup Prasad

Related Content

https://convertr.atlassian.net/l/cp/aGdPsUqe

🏠 Feature Overview

Validation Lists

Validation lists allow users to check the leads against the list of values to either target or suppress and pass/reject a lead based on the condition selected. For example, if the user is targeting a list of specific companies in a campaign, the user can set up a validation list to ensure that the lead data contains only the exact values required.

Validation Lists can be set up in two areas:

  1. System Level: Lists applied at this level will be accessible across all campaigns in your enterprise. Please refer the documentation mentioned in ‘Related Content’ above

  2. Advertiser Level: Lists applied at this level will only be available to campaigns set up under this advertiser.

Setting Up Validation Lists At An Advertiser Level

By clicking on the ‘View’ button or on the ‘Company Name’ hyperlink on the Advertiser listing page, the user will be able to see the Validation Lists menu, based on their user role.

The page lists validation lists configured for the advertiser. Users have the option to perform search on some of the columns. There is also a ‘download’ icon at the bottom of the table which will download the contents of the table as a CSV file.

The Add button opens a modal as shown below. Here the user must provide a name for the validation list and specify if it should be a private list.

Name

Required

Notes

Name

(tick)

Enter the validation list name

Privatise

(tick)

Privatise toggle affects the view of the list for any Agency type users on your platform. If set to Private, Agency users will not be able to see the values that are added to the list, or make any changes to it. The role of private validation lists is to allow the advertiser to upload potentially sensitive information without exposing it to Agency or Publisher user types.

Admin + Super Admin users should still be able to see private validations lists.

Clicking on Save will open a modal called ‘Add Validation List’. Here, the user can either add values or import values into the list.

Add Values

User can add values by entering the details in ‘New Value’ and clicking on ‘Add’.

Import Values

If the user chooses to import values to the list, they can do so by selecting the ‘Import Values’ tab which will allow the user to upload a CSV file containing the values. Sample CSV file for reference can be downloaded by clicking on the link in the blue banner.

Values added/imported will be listed as shown below.

Users can remove individual values from the list by checking the corresponding checkbox and clicking on ‘Remove’ button. Alternately, the user can remove all values from the list by clicking on the ‘Remove All’ button.

Add/Edit

Existing validation lists may be edited using the Add/Edit button available on the the listing table.

Download

Clicking on the Download button will make the validation list available under Exports option. User can then download the list to their environment.

\uD83D\uDDD2 User Permissions

Admin users, agency users and advertiser users associated with the advertiser can access this tab.

https://docs.google.com/spreadsheets/d/1i4qTTKkC3rF3EyEOh2585ktDDGge0L0IMVDNCwriFR0/edit#gid=1710197291 Connect to preview

  • No labels