Track event

POST {{baseUrl}}/v2/events?silent=yes&dry=true

Triggers a custom event. You can build a condition around this event in your rules.

Talon.One offers a set of built-in events. Ensure you do not create a custom event when you can use a built-in event.

For example, use this endpoint to trigger an event when a customer shares a link to a product. See the tutorial.

Important: - profileId is required. An event is associated with a customer profile. - Before using this endpoint, create your event as a custom attribute of type event. See the Developer docs. - We recommend sending requests sequentially. See Managing parallel requests.

When you successfully sent an event to Talon.One, you can list received events in the Events view in the Campaign Manager.

Request Params

KeyDatatypeRequiredDescription
silentstringPossible values: yes or no.
  • yes: Increases the perfomance of the API call by returning a 204 response.
  • no: Returns a 200 response that contains the updated customer profiles. | | dry | boolean | | Indicates whether to persist the changes. Changes are ignored when dry=true. |

Request Body

{"profileId"=>"URNGV8294NV", "storeIntegrationId"=>"STORE-001", "evaluableCampaignIds"=>[10, 12], "type"=>"pageViewed", "attributes"=>{"myAttribute"=>"myValue"}, "responseContent"=>["triggeredCampaigns", "customerProfile"]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring