Mark a conversion

Mark a conversion for a user who arrived via a Dynamo deep link. Optionally identify the user with their Dynamo user id and control whether they are excluded from future activity/audience targeting. Returns the known user id if one exists.

post/v1.0/user/markConversion

Authorization

x-api-key x-date x-signature x-api-version

x-api-key<token>

Your organization API key.

In: header

x-date<token>

Request timestamp as an IMF-fixdate string (GMT, US locale) "EEE, dd MMM yyyy HH:mm:ss z", e.g. "Sun, 06 Dec 2020 12:59:11 GMT". 30-second TTL.

In: header

x-signature<token>

HMAC-SHA256(x-date, secret) as lowercase hex.

In: header

x-api-version<token>

Optional for the Audience API — accepted and ignored; included for consistency with the External API (where it is required). Send 1.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

d10xLinkId*string

identifyUserWithD10xUserId?boolean

If true, Dynamo will use the Dynamo user id to identify the user. Set to true only if you are not identifying users with your own platform user id.

excludeFromAssociatedActivity?boolean

If true, the user will not receive any more messages from the activity the link is associated with.

excludeFromAssociatedAudience?boolean

If true, the user will be excluded from any future activity acting upon the custom audience that the current activity acted upon.

Response Body

`application/json`

Try it

live — writes real data

Kept in this tab only and signed in your browser — your secret never leaves your device.

Body

d10xLinkId*identifyUserWithD10xUserIdIf true, Dynamo will use the Dynamo user id to identify the user. Set to true only if you are not identifying users with your own platform user id. excludeFromAssociatedActivityIf true, the user will not receive any more messages from the activity the link is associated with.excludeFromAssociatedAudienceIf true, the user will be excluded from any future activity acting upon the custom audience that the current activity acted upon.

This sends a real POST to your live organization.

Enter your key and secret to send.

curl -X POST "https://example.com/v1.0/user/markConversion" \  -H "Content-Type: application/json" \  -d '{    "d10xLinkId": "a1b2c3",    "identifyUserWithD10xUserId": false  }'

{  "userId": "string"}

{  "message": "Signature expired"}

Authorization

Request Body

Response Body

200application/json

403application/json

Try it

`application/json`

`application/json`