There are several possible options for adding users to a previously created audit group, depending on its ID type.
Adding users in bulk
https://dmpapi.admixer.net/AudienceAPI/UploadUsersToAudienceGroupIn the POST request, use the following parameters:
| Parameter | Description |
|---|---|
| id | audience group ID |
| userIds | array of user IDs |
For example,
where
| 123456 | audience group ID |
| [‘6f70132d58ec4321845367dd94898544’, ‘3a45fe3d2f56d429e84ef781dd84ae780’] |
array of user IDs |
.png)
In response, you get JSON with an ID of the audience group in which you added users and a message about successful completion.
.png)
- Expand an example of the JSON response with with an ID of the audience group in which you added users
Adding users by URL
You can add users through a URL that leads to a file with a list of users. Only .csv files are supported.
.png)
For example,
https://dmpapi.admixer.net/AudienceAPI/UploadUsersToAudienceGroup
In Body
id is an audience group ID,
url is a URL link to the file.
In response, you get JSON with an ID of the audience group in which you added users and a message about successful completion.
Adding users with a specific ID type using a file from the computer
To upload a file with a list of users, select the file upload option in the Body of a POST request and add a .csv file from your local directory in the data parameter.
.png)
| Parameter | Description |
|---|---|
| id | Audience Group ID |
| data | A .csv file for download |
The uploaded or linked file must indicate the ID format type in the top row in order to be read. For example, the cells in the top row may contain such identifier names as IDFA, AAID, etc. If you enter other values, the file may not be read correctly.
Adding MultiID type of users using a file from the computer
Adding users to the Audience Group.
To add users to the audience group, use the method.
https://dmpapi.admixer.net/AudienceAPI/UploadUsersToAudienceGroup
Specify the following parameters in the POST request:
| Parameter | Description |
|---|---|
| id | Audience Group ID |
| data | A .csv file for download |
Important!
It is necessary to use the file for downloading that corresponds to the example provided in the attached file (as well as for uploading through the interface).When uploading data in bulk, the table with user data must exactly match the format provided in the example file, otherwise the data will not be uploaded correctly. The order of columns must be preserved, but some of them may be absent. Empty values are also allowed in the rows of the corresponding columns. In case of incorrect input of data, the row will be skipped (not read and not written). When uploading the table, there is case sensitivity.
The uploaded data must follow these formats:
- AdmixerId data column must contain 32 alphanumerical only symbols with no spaces;
- Idfa and >AAID data columns must contain no non-alphanumerical symbols and follow the general format: 035911ea-467d-4056-903b-65cf44f5633b;
- Email data column must follow the generally accepted format for emails;
- Phone data must contain 10 or 12 digits only, with no additional symbols (e.g. a “+” sign) and follow one of the following formats: 0991234567 or 380991234567;
- EmailMD5 and PhoneMD5 data must contain emails and phones hashed in MD5 format;
- EmailSHA256 and PhoneSHA256 data must contain emails and phones hashed in SHA256 format;
- PubId and ClientId columns can contain any data in any format.
Only .csv tables are accepted
| AdmixerId | IDFA | AAID | ClientId | Phone | PubId | EmailMD5 | PhoneMD5 | EmailSHA256 | PhoneSHA256 |
Download the sample of a filled-out row of the table with the examples of hashed data strings here.
Remember!
When adding users, if one of the types of audience group identifiers is PubID, you must include the containerId parameter in the request. It follows that PubID is initially collected by a container (Tag Manager) from sites and it is the ID of this container that must be specified when uploading.