SCscalev
Landing Page Runtime

Send a landing page TikTok Events API event

Changed on

Page-scoped public endpoint used by Scalev.analytics.track("tiktok", payload). The page path and API key select the page analytics configuration.

post/v3/pages/{page_unique_id}/analytics/tiktok/events

Request

  • Base URL
    https://api.scalev.com
  • URL
    https://api.scalev.com/v3/pages/{page_unique_id}/analytics/tiktok/events
  • Auth
    none required

Request body

tracking_contextstring

Configured page, storefront, or widget interaction context. When present, the server validates the selected event and asset against the stored configuration.

tracking_triggerstring

Interaction key from the saved tracking configuration.

tracking_asset_idinteger

Business-owned provider asset assigned to this context.

tracking_tokenstring

Optional signed runtime capability for the published configuration and allowed context. Preserve the token supplied by the runtime.

tracking_renderer'vue' | 'html'

Actual renderer sending the configured interaction. Selects the stored server parameter variant; does not grant access to other events or assets. Older clients default to vue.

event_source_urlstring uri required

Full storefront page URL for the event. The API strips query parameters before sending to TikTok.

referrer_urlstring uri nullable

Browser referrer URL. The API uses this with event_source_url to choose checkout versus home storefront analytics configuration.

Example request

{
  "events": [
    {
      "event": "AddToCart"
    }
  ]
}

Response

Success with no response body

Changes

  • 6b9152f04622Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

  • f96c47558bd4Revision changes
    • info

      api tag Landing Page Runtime added

    • info

      api tag HTML Mode Pages removed