RemarketingUsersList

Data source is a users list.

Used in resources: RemarketingUsersLists, RemarketingUsersList

Field nameTypeConditionsDescription
baseintegerreadable writable default_field create_only min_value=-2147483647 max_value=2147483647Source list ID that is used to update the lists. Possible commands: - "base = 0" - the current source list - "base = N" - adds IDs from the new list to the current souce list - "base = -N" - removed IDs from the new list from the current source list.
can_create_portraitbooleanreadablePossibility to build an audience profile.
createddatetimereadable default_fieldTime of the list creation.
entries_countintegerreadable default_field min_value=-2147483647 max_value=2147483647Number of list entries that were uploaded.
has_historybooleanreadable default_fieldFlag of source list revision history.
historylist of RemarketingUsersListHistoryreadableSource list revision history.
ididreadable default_field min_value=1 max_value=2147483647List ID.
ids_countintegerreadable default_field min_value=-2147483647 max_value=2147483647Original list size.
matched_ids_countintegerreadable default_field min_value=-2147483647 max_value=2147483647Number of source IDs for which corresponding IDs have been found.
namestringreadable required writable default_fieldList name.
statusstringreadable default_field
choices =
  • receiving - List is being sent for processing (default status).
  • received - List was received for processing.
  • mapping - List is being processed (comparison in progress).
  • mapped - List has been processed.
  • writing - Processed list is being written to the database.
  • ready - List is written to the database and ready for use.
  • pending_delete - User has marked the list for deletion.
  • deleting - List is being deleted from the database.
  • deleted - List has been deleted.
  • deleted_to_notify - List was deleted at VK Ads requests and user may not be aware of it.
Processing status.
typestringreadable required writable default_field create_only
choices =
  • ok - List of Odnoklassniki users IDs.
  • mm - LIst of my.mail.ru gamers IDs.
  • phones - List of phone numbers or their hash sums.
  • emails - List of emails or their hash sums.
  • device_id - List of Android devices hardware IDs.
  • android_id - List of Android devices software IDs.
  • advertising_id - List of Google Advertising ID.
  • idfa - List of Apple mobile devices IDs.
  • dmp_id - List of external user IDs from partner DMP providers.
  • dmp_top - List of first-party data IDs.
  • vk - List of VKontakte users IDs.
  • mac - List of MAC addresses.
  • mparticle - List of mParticle users.
  • human - Common list makes it possible to load several types of identifiers in one file.
List type. For more information about list types, see this article.
updateddatetimereadableTime of the list last update.
userslist of RemarketingUsersListUserreadableUsers who can access the list.
users_countintegerreadable min_value=-2147483647 max_value=2147483647Number of users who can access the list.