Bahasa Indonesia
Buat Iklan

Pengukuran Web

  1. Pengukuran /
  2. Pengukuran Web /
  3. Solusi Pengukuran Web TikTok /

How to set up a secure data connection with TikTok through mParticle

Terakhir diperbarui: Februari 2025

TikTok for Business offers many tools that let you share the actions people take on your website with TikTok. When you share these events with TikTok, you can better optimize your campaigns and measure ad performance.

This article describes how to setup a secure data connection through mParticle. mParticle supports TikTok Events API. TikTok’s Events API is a secure server-to-server integration that allows advertisers to share the actions customers take on their websites directly with TikTok, without needing to install a pixel on your website.


For more information on these connection tools, please review the following resources:


Prerequisites

When setting up a data connection with TikTok, you will need your Access Token and Pixel ID.

To locate your Pixel ID:

  • Go to TikTok Ads Manager. Hover over the Tools option and click on Events to open Events Manager.

mParticle eAPI Implementation Guide - Step 1
  • On the right side under Datasets overview, click the Pixel you want to use.

mParticle eAPI Implementation Guide - Step2
  • Copy the Pixel ID value

mParticle eAPI Implementation Guide - Step3

To locate your Access Token ID:

  • In Events Manager, click the Settings tab and scroll to the bottom until you see Events API

  • Click Generate Access Token

  • Copy the Access Token value

mParticle eAPI Implementation Guide - Step4

Supported Inputs

  • Web


Supported Identifiers

In outgoing TikTok event payloads, 3 primary identifiers are supported:

  • Email

  • External ID

  • Phone Number

For each, a drop-down setting is exposed allowing customers to choose which mParticle identity type should be mapped to that value. All outgoing identity information is SHA-256 hashed as per TikTok’s documentation. See Connection Settings for more information.

At least one of the above identifiers is required. If a given user’s profile doesn’t include any, their events will not be forwarded to TikTok since attribution would fail.


Supported Events

mParticle Field

TikTok Event Field

Description

event.name

event

Conversion event name. Set depending on the incoming event type.

event.source_message_id

event_id

The default ID used for the dedupliation of events in TikTok. If unavailable, we fallback on event_id

event.timestamp_unixtime_ms

timestamp

The original event timestamp. This must be in millisecond resolution (ex.1455236520490)

ip

context.ip

Non-hashed public IP address of the browser. Both ip and user_agent are required for TikTok processing, and aid in increasing the probability of matching website visitor events with TikTok ads.

event.device_info.http_header_user_agent

context.user_agent

Non-hashed user agent from the user’s device. Both ip and user_agent are required for TikTok processing, and aid in increasing the probability of matching website visitor events with TikTok ads.


Standard Event Info & Custom Flags

The following event information will be included for all outgoing events, regardless of type.

Custom Flags must be specified on each valid incoming event to support specific fields within each outgoing TikTok event’s context property.


mParticle Custom Flag

TikTok Event Field

Is Required

Description

Example

TikTok.URL

context.page.url

TRUE

Page url when event happened. Must start with ‘http://’ or ’https://’, otherwise the event will fail TikTok processing

”http://demo.mywebsite.com/purchase”

TikTok.Referrer

context.page.referrer

FALSE

Page referrer.

”http://demo.mywebsite.com”

TikTok.Callback

context.ad.callback

FALSE

TikTok Click ID (ttclid). This represents a tracking parameter appended to a landing page URL whenever a user clicks on an ad on TikTok. Correctly formatted strings should start with “E.C.P”. Don’t send TikTok dummy values.

“E.C.P.v3fQ2RHacdksKfofPmlyuStIIHJ4Af1tKYxF9zz2c2PLx1Oaw15oHpcfl5AH”



Event Mappings for Native mParticle Event Types

The only native mParticle event type that’s supported by this integration is CommerceEvent. mParticle supports the following event mappings:

mParticle Event

TikTok Event

Commerce Event with add_to_cart product action.

AddToCart

Commerce Event with add_to_wishlist product action.

AddToWishlist

Commerce Event with purchase product action. Refunds are not natively supported by Snap.

PlaceAnOrder

Commerce Event with checkout product action.

InitiateCheckout

Commerce Event with view_detail product action.

ViewContent


Other CommerceEvent types remain unsupported. mParticle supports the following commerce and product information mappings:

mParticle Field

TikTok Event Field

Description

event.product_action.currency

properties.currency

ISO 4217 code. Example: “USD”.

event.product_action.total_amount

properties.value

Value of the order or items sold. Example: 100. Note: Price is the price for a single item, and value is the total price of the order.

event.product_action.products[x].price

properties.contents[x].price

The price of the item. Example: 25. Note: Price is the price for a single item, and value is the total price of the order.

event.product_action.products[x].quantity

properties.contents[x].quantity

Number of item. Example: 4

event.product_action.products[x].id

properties.contents[x].content_id

ID of the product item. Example: “1077218”

event.product_action.products[x].category

properties.contents[x].content_category

Category of the page/product. Example: “apparel”

event.product_action.products[x].name

properties.contents[x].content_name

Category of the page/product. Example: “apparel”


Custom Event Mappings

In order to support TikTok event types that don’t map one-to-one with mParticle events, you can manually configure Custom Mappings for a particular connection within the mParticle UI. This feature allows incoming mParticle events to be mapped to known TikTok event types, including with specific attributes and outgoing parameters.

All TikTok event mappings support the description property.

In addition, the following additional properties are supported for each respective event:

  • AddPaymentInfo: price, quantity, currency, value, content_id, content_name, content_category

  • AddToCart: price, quantity, currency, value, content_id, content_name, content_category

  • AddToWishlist: price, quantity, currency, value, content_id, content_name, content_category

  • ClickButton

  • CompletePayment: price, quantity, currency, value, content_id, content_name, content_category

  • Contact

  • Download

  • InitiateCheckout: price, quantity, currency, value, content_id, content_name, content_category

  • PlaceAnOrder: price, quantity, currency, value, content_id, content_name, content_category

  • Search: query

  • Subscribe: currency, value

  • ViewContent: price, quantity, currency, value, content_id, content_name, content_category


Settings

Configuration Settings

Setting Name

Data Type

Is Required

Is Encrypted

Description

Access Token

string

TRUE

TRUE

Provides access to TikTok Events API. You can create an access token in the TikTok Events Manager.


Connection Settings

Setting Name

Data Type

Default

Is Required

Description

Pixel Id

string

null

TRUE

The unique Pixel ID for your TikTok ads account.

Email Identity Type

string

Email

TRUE

The Identity Type to forward as the email to TikTok.

External Identity Type

string

Customer ID

TRUE

The Identity Type to forward as the external ID to TikTok.

Phone Identity Type

string

Mobile Number

TRUE

The Identity Type to forward as the phone number to TikTok.

Phone Identity Type

string

product

TRUE

The content_type property can be set to either ‘product’ or ‘product_group’, depending on how your data feed and product catalog are configured on TikTok’s end.




*Apakah informasi ini membantu?
Artikel Relevan
How to set up a secure data connection with TikTok through Blotout
Cara Mulai Menggunakan Events API
How to set up a TikTok conversions destination with Adobe