Data Source: User Lists

You can set up ads to be seen only by customers who have already contacted your business. To do this, create a customer contact list and use it as a data source.

As contacts, you can use the email and phone numbers of customers that they left when they bought, or the id of users that you collected on your website or in the application.

To collect data for a new audience segment, you can use a counter Top.Mail.Ru. Learn more about how to do this
List requirements
General file requirements:
  • File format: txt or csv
  • List size: from 2 000 to 5 000 000 unique items.
  • One item per line.
  • Separator: line feed.
  • Encoding: UTF-8.
  • File size: up to 128 MB.

Additional requirements for csv files:

For csv files, the header must contain "id".
If you are loading a list based on a counter or dmp, then the "id" line must place after the counter id or dmp prefix. For example:


File content:
  • Phones and emails can be downloaded in encrypted form or in the open: myTarget will encrypt the data automatically.
  • Phones must be in the format [country code][region code] [number] without spaces or other characters: 79011234567
  • Emails should be specified in the format
  • IDFA for iOS devices must be specified in the format: 317F5B7E-E95F-4831-9F60-EC371146CAD3
  • Google Advertising ID (GAID) for Android devices must be specified in the format: 38400000-8cf0-11bd-b23e-10b96e40000d
  • IDs in social networks VK and OK must be specified in the format of a number without prefixes: 138232696 Aliases with letters or symbols are not allowed
  • The First Party Data and DMP lists must contain the IDs that were specified as the user in the counter
Please note that the list must contain the same type of IDs: for example, only phones or only IDS in Odnoklassniki.
List encryption
You can upload lists of phones and emails in encrypted form. To do this, convert them using the MD5 hash function (for example with MD5 Hash Generator), and then load the lists with hashes into myTarget.

You can also download phones and emails in clear form, and the system will encrypt them automatically. The data will be stored in the system in encrypted form.

How to download list
To load the list, open the "Audiences" tab → "User Lists". Specify:
  • Action. By default, creating a new list is selected. You can also add or remove users from an existing list, as described below.
  • List type. Select the type of list you are uploading from the drop-down menu. The list must contain the same type of IDs (for example, only phone numbers). If there are several types of IDs in the list, or if you select the list incorrectly, the system will return an error.
  • Title. Enter the name of the list of users so that you can easily find it in the table.
Then select the file and click "Upload".
Select list type
How to edit the list
You can edit the downloaded list: add or remove users. For this:

  1. Create a file with list of users you want to add or remove. The file must have at least 25 items, txt format, separator — line feed. UTF-8 encoding, file weight up to 128 MB.
  2. Click the "Audience" → "User Lists". Select the action: add or remove users from the list.
  3. Then select the type of list you want to edit.
Edit the list
4. Enter the name of the list you want to edit.
5. Then download the file with the list of users you want to add or remove from the main list.
6. Click "Save". The changes will take effect within 24 hours.
Table with lists
The loaded list of users will appear on the page.
Table of lists
    • id - identifier of the loaded list in the system.
    • Name - The name of the list that you specified. The name can be changed - to do this, click on the pencil next to the name.
    • Status - the status of the download list. Hover over the status to see more information on the list: the number of identifiers loaded and the number of matches found.
    • Coverage - the coverage of the list for a calendar week. Read about coverage status below. Click on the icon next to reach to request and view the source audience profile. More about profiles
    • Source Type — the type of identifiers loaded.
    • Owner - "own" for the lists that you downloaded, "third-party" - segments and sources that third-party owners shared with you.
    • Created - the date the list was created.
    • Updated - the date of the last changes in the list.
    • Segments - the number of segments in which the list is used.
    Please note that lists that you have not been using for more than 60 days will be deleted, and segments based on these lists become inaccessible.
    Statuses of coverage
    The table on the "User list" page displays the list coverage — the number of users covered by the list for the full calendar week.

    In the "Coverage" can have value:

    • number — the number of users covered during the full calendar week;
    • yellow number means that this is not the final data — coverage is still being calculated;
    • processing — at the moment there is a calculation of the size of the segment. This may take some time;
    • less than 1000 — lists where 0 to 1000 users were found last week. Please note these lists: it is likely that the downloaded data are out of date;
    • dash — the list has already been deleted.
    How to use a list in a campaign
    To use your list in a campaign, create a segment based on the list. For this:
    • open the tab "Audiences" → "Segments List",
    • click "Add Audience Segments" and select "User Lists",
    • configure the segment.
    To show ads only to users from your list, select the list you need, select "On the list" and click "Add segment".
    Segment Settings
    Then name the segment and click "Create Segment".
    Segment creation
    Use the new segment when setting up your campaign. To do this, on the campaign creation page, in the "Segments" section, mark the created segment. The campaign will be broadcast to users from your list.

    Similarly, you can configure the campaign so as NOT to show ads to users from your list: in the "Add segments" step, select "Not in the list".
    Was this article helpful?