Skip to content

Commit 6de6db0

Browse files
author
Jaehyuk Rhee
committed
add tiktok-pixel documentation
1 parent 5566875 commit 6de6db0

File tree

1 file changed

+72
-0
lines changed
  • src/connections/destinations/catalog/actions-tiktok-pixel

1 file changed

+72
-0
lines changed
Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: [integration_name] Destination
3+
---
4+
5+
{% include content/plan-grid.md name="actions" %}
6+
7+
[TikTok Pixel](https://ads.tiktok.com/marketing_api/docs?id=1739583652957185) is a piece of code that you can place on your website that allows you to share website events with TikTok. With any of our TikTok for Business Tools, the pixel can help you measure traffic on your website, measure ad campaign performance, optimize your campaigns and find new customers.
8+
9+
**Benefits**
10+
- **Build marketing audiences**: Create Custom Audiences based on website visitor events, like viewing a product page or making a purchase. Audiences can be used to re-engage previous site visitors or model lookalikes to find new customers.
11+
- **Optimize ad delivery**: Target audiences that are more likely to initiate a website event by setting an optimization goal on visitor events like add to cart, view page or purchase.
12+
- **Measure campaign performance**: Measure your ad performance and return on ad spend (ROAS) based on a series of conversion events you define.
13+
14+
This destination is maintained by Tiktok. For any issues with the destination, [contact their Support team](mailto:[email protected]).
15+
16+
{% include content/ajs-upgrade.md %}
17+
18+
## Getting started
19+
20+
1. From the Segment web app, click **Catalog**, then click **Destinations**.
21+
2. Find the Destinations Actions item in the left navigation, and click it.
22+
3. Click **Configure TikTok Pixel**.
23+
4. Select an existing Source to connect to TikTok Pixel.
24+
5. Give Destination a name.
25+
6. On the Settings screen, provide Pixel Code and toggle "Use Existin Pixel" to use existing Pixel that is already installed on your website.
26+
7. Toggle on the Destination.
27+
8. Hit the Save Change button.
28+
29+
**Mappings Enabled by Default**
30+
31+
After setting up the Destination, seven mappings will be enabled by default. You can click on the mappings tab to view and edit these mappings.
32+
33+
- **View Content**: When a page is viewed
34+
- **Search**: When a search is made
35+
- **Add to Wishlist**: When an item is added to a wishlist
36+
- **Add to Cart**: When an item is added to the shopping cart
37+
- **Initiate Checkout**: When the checkout process is started
38+
- **Add Payment Info**: When payment information is added in the checkout flow
39+
- **Place an Order**: When an order is placed
40+
41+
{% include components/actions-fields.html %}
42+
43+
## Getting Started with Pixel & Obtaining Pixel Code
44+
Please refer to the [TikTok Help Center documentation](https://ads.tiktok.com/help/article/get-started-pixel?redirected=2) to learn more about how to get started with TikTok Pixel. Once the Pixel is created, please retrieve the Pixel Code from TikTok Events Manager (TTEM).
45+
46+
## PII Requirement & Validation
47+
The email addresses and phone numbers need to be hashed using SHA-256 before they are sent to TikTok. Please normalize and hash the PIIs before sending them to Segment. In addition, TikTok Pixel Destination will validate all web events before forwarding them to TikTok.
48+
49+
**Important notes for passing PIIs**
50+
51+
**Emails**
52+
- Must reduce all letters into lowercase prior to hashing.
53+
- Leading/Trailing spaces need to be trimmed before hashing.
54+
- Do not perform any other types of normalization on emails prior to hashing.
55+
- Only sha-256 is accepted. Here is the [recommended package](https://github.com/emn178/js-sha256).
56+
57+
**Phone Numbers**
58+
- Normalize your phone numbers to E164 format, a combination of+{country code}{phone number}.
59+
- Recommend using [this package](https://github.com/catamphetamine/libphonenumber-js) for E164 parsing.
60+
- Only sha-256 is accepted. Here is the [recommended package](https://github.com/emn178/js-sha256).
61+
62+
**External IDs**
63+
64+
- Leading/Trailing spaces need to be trimmed before hashing.
65+
66+
Please refer to the [TikTok Pixel Advanced Matching documentation](https://ads.tiktok.com/marketing_api/docs?id=1739585700402178) for additional information regarding sharing cusomter information with TikTok.
67+
68+
## Data and Privacy Considerations
69+
70+
Please refer [here](https://ads.tiktok.com/i18n/official/policy/business-products-terms) for TikTok Business Products (Data) Terms.
71+
72+
---

0 commit comments

Comments
 (0)