TikTok Ads cloud mode
Send events to TikTok Ads using RudderStack cloud mode.
RudderStack lets you send your event data to TikTok Ads via cloud mode.
Find the open source transformer code for this destination in the GitHub repository.
Track
Use the track
call to capture user events along with the associated properties.
A sample track
call is shown below:
rudderanalytics.track("Order Completed", {
checkout_id: "12345",
order_id: "1234",
affiliation: "Apple Store",
total: 20,
revenue: 15.0,
shipping: 22,
tax: 1,
discount: 1.5,
coupon: "ImagePro",
currency: "USD",
contentType: "product",
products: [{
product_id: "123",
sku: "G-32",
name: "Monopoly",
price: 14,
quantity: 1,
category: "Games",
url: "https://www.website.com/product/path",
image_url: "https://www.website.com/product/path.jpg",
},
{
product_id: "345",
sku: "F-32",
name: "UNO",
price: 3.45,
quantity: 2,
category: "Games",
},
],
})
Event mapping
RudderStack maps the following events to the corresponding TikTok Ads Events:
RudderStack event | TikTok Ads event |
---|
ViewContent | ViewContent |
ClickButton | ClickButton |
Search | Search |
Contact | Contact |
Download | Download |
SubmitForm | SubmitForm |
CompleteRegistration | CompleteRegistration |
Subscribe | Subscribe |
RudderStack also maps the following ecommerce events:
RudderStack event | TikTok Ads event |
---|
Product Added to Wishlist | AddToWishlist |
Product Added | AddToCart |
Checkout Started | InitiateCheckout |
Payment Info Entered | AddPaymentInfo |
Checkout Step Completed | CompletePayment |
Order Completed | PlaceAnOrder |
Property mapping
RudderStack maps the following optional event properties to the corresponding TikTok Ads fields:
RudderStack property | TikTok Ads property |
---|
properties.eventId | event_id |
timestamp | timestamp |
properties.testEventCode | test_event_code |
properties.contents | properties.contents |
properties.currency | properties.currency |
properties.value | properties.value |
properties.description | properties.description |
properties.query | properties.query |
properties.context.ad or context.ad | context.ad |
properties.context.page or context.page | context.page |
properties.context.user | context.user |
context.ip | context.ip |
context.userAgent | context.user_agent |
From externalId tiktokExternalId | user.external_id |
FAQ
I see a 40002 response code with ‘No permission to operate pixel code’ error message, what can I do?
This error code is related to the authentication of your TikTok account. For more information, refer to the TikTok documentation.
Questions? Contact us by email or on
Slack