Atomic operations

replace

When replace action is used, the data sent to ADventori for a user replaces all existing data.

ALL the user data will be replaced, not only the key present in the new data. If some existing key does not exist in the new data, it will be lost.

The URL to use is :

https://eu-usersync.adventori.com/ADVERTISER_CODE/data/replace?provider=PROVIDER_CODE&key=PROVIDER_AUTH_KEY&[uid=UID_PROVIDER|adv_uid=UID_ADVENTORI]
  • The ADVERTISER_CODE parameter must be specified in the service call. It represents the unique code of the advertiser on behalf of whom the data are posted.
  • The PROVIDER_CODE parameter must be specified in the service call. It represents the data provider unique code and match the PROVIDER_CODE used for cookie sync.
  • The PROVIDER_AUTH_KEY represents the authentication key of the data provider. It must be specified in the service call. It is provided by ADventori.
  • Either the UID_PROVIDER parameter or the UID_ADVENTORI must be specified in the service call depending on who keeps the UID matching. It must represent the data provider (resp. ADventori) unique identifier for the given user.

Curl usage:

curl -X POST -H "Content-Type: application/json" -d '{"key1": "value1", "key2": "value2"}' 'http://eu-usersync.adventori.com/ADVERTISER_CODE/data/replace?provider=PROVIDER_CODE&key=PROVIDER_AUTH_KEY&uid=UID_PROVIDER'

upsert

When upsert action is used, only keys present in the JSON message are modified (inserted if they don’t exist yet, updated if they exist or deleted if the new value is null)

The URL to use is:

https://eu-usersync.adventori.com/ADVERTISER_CODE/data/upsert?provider=PROVIDER_CODE&key=PROVIDER_AUTH_KEY&[uid=UID_PROVIDER|adv_uid=UID_ADVENTORI]
  • The ADVERTISER_CODE parameter must be specified in the service call. It represents the unique code of the advertiser on behalf of whom the data are posted
  • The PROVIDER_CODE parameter must be specified in the service call. It represents the data provider unique code and match the PROVIDER_CODE used for cookie sync
  • The PROVIDER_AUTH_KEY represents the authentication key of the data provider. It must be specified in the service call. It is provided by ADventori.
  • Either the UID_PROVIDER parameter or the UID_ADVENTORI must be specified in the service call depending on who keeps the UID matching. It must represent the data provider (resp. ADventori) unique identifier for the given user.

Curl usage:

curl -X POST -H "Content-Type: application/json" -d '{"key1": "value1", "key2": "value2"}' 'http://eu-usersync.adventori.com/ADVERTISER_CODE/data/upsert?provider=PROVIDER_CODE&key=PROVIDER_AUTH_KEY&uid=UID_PROVIDER'

delete

When delete action is used, all data for the given user are deleted. This action cannot be undone.

The URL to use is:

https://eu-usersync.adventori.com/ADVERTISER_CODE/data/delete?provider=PROVIDER_CODE&key=PROVIDER_AUTH_KEY&[uid=UID_PROVIDER|adv_uid=UID_ADVENTORI]
  • The ADVERTISER_CODE parameter must be specified in the service call. It represents the unique code of the advertiser on behalf of whom the data are posted
  • The PROVIDER_CODE parameter must be specified in the service call. It represents the data provider unique code and match the PROVIDER_CODE used for cookie sync
  • The PROVIDER_AUTH_KEY represents the authentication key of the data provider. It must be specified in the service call. It is provided by ADventori.
  • Either the UID_PROVIDER parameter or the UID_ADVENTORI must be specified in the service call depending on who keeps the UID matching. It must represent the data provider (resp. ADventori) unique identifier for the given user.

Curl usage:

curl -X POST -H "Content-Type: application/json" 'http://eu-usersync.adventori.com/ADVERTISER_CODE/data/delete?provider=PROVIDER_CODE&key=PROVIDER_AUTH_KEY&uid=UID_PROVIDER'