TikTok Ads Web - Web-to-App Campaigns

Follow
Avatar
Liz Lauer-Lopez
Updated
Setting Up TikTok for Business
Web & Mobile
Web-to-App
Configure for Web & Mobile Web-to-App Campaigns

 

This article details how to configure Singular mobile, PC and Console install attribution for TikTok web campaigns (non-app campaigns). For directions on configuring and attributing TikTok app campaigns, see our TikTok Ads Attribution guide.

TikTok web campaigns support third-party impression URLs so talk to your TikTok contact if you need assistance placing the impression URL in the correct campaign field. Singular will attribute view-through attribution when possible.

Overview

Singular’s web-to-app attribution solutions empower marketers to run web campaigns that drive app installs across Mobile, PC, and Console platforms. Singular's TikTok web integration supports the Direct to Store flow described in our Web to App Guide here.

Add TikTok Ads Web Partner Configuration in Singular

Add TikTok Ads Web Partner Configuration in Singular

  1. Go to Singular > Attribution Setup > Partner Configuration
  2. Click “Add a Partner”, and type and choose “TikTok Ads Web”
  3. In the dialog, choose your App and App site (platform) to configure. Mobile, PC, and console apps are supported with this integration
  4. Paste in your app's "Access Token" and "Pixel Code or Event Set ID" from your TikTok Ads Manager dashboard.
  5. Optionally configure any additional events to send to TikTok and map it to a "TikTok Event Name"

Create Singular Link for "TikTok Ads Web"

Create Singular Link for "TikTok Ads Web"

  1. Go to Singular > Attribution Setup > Manage Links
  2. Select your mobile app from the list of apps on the left
  3. Select "Create Link" -> Link Type "Partner" -> Source Name "TikTok Ads Web"
  4. Continue through the step-by-step link creation. 
  5. Click "Generate"
  6. Copy the "Click-through Tracking Link" for the next step
Set up your TikTok Ads Web Campaign

Set up your TikTok Ads Web Campaign

  1. In TikTok Ads Business Manager, create a web campaign and select the optimization goal.
  2. Add Singular Link from the section above to the Destination Website URL
  3. In the Tools Events section, create a "Web" Event to send the conversion data to the Events API. Assign the event a name and generate an access token for the event. This is needed for your Singular Partner Configuration setup. ( See more TikTok instructions here. ) An Admin or Operator permission of the TikTok ad account is required to generate an access token through Events Manager.

FAQ

How does Singular report TikTok Ads Web attributions?
Once an attribution is tracked, TikTok Ads Web attributions are reported as follows:
  • Source = "TikTok Ads"
  • Tracker Source Name = "TikTok Ads Web"
  • Campaign ID = (Campaign ID)
  • Sub Campaign ID = (AdSet ID)
  • Creative ID = (Ad ID)
What data does Singular send via API?
  • For mobile integrations, TikTok and Singular recommend passing mobile conversion data through Singular's dedicated mobile attribution integration with TikTok Ads. If you are interested in passing mobile conversion data through TikTok's Events API, reach out to your Singular customer success manager.
Parameter Details
event_name
  • A standard event or custom event name. This field is automatically mapped to the Singular Event Name. This value is used to assist TikTok in the deduplication of events. The event_id parameter is also used in deduplication.
ttclid
  • TikTok click ID
  • automatically passed
hashed email
  • Optional
  • Hashed email may be passed as a Singular instrumented event attribute "ehash"
  • Hashed email value must be normalized and SHA 256 hashed
hashed phone number
  • Optional
  • Hashed phone number may be passed as a Singular instrumented event attribute "phash"
  • Hashed phone number must be E164 normalized and SHA 256 hashed
hashed first name
  • Optional
  • Hashed first name may be passed as a Singular instrumented event attribute "fnamehash"
  • Using Roman alphabet a-z characters is recommended. Lowercase only with no punctuation. If using special characters, the text must be encoded in UTF-8 format.
  • Hashed first name be SHA 256 hashed
hashed last name
  • Optional
  • Hashed last name may be passed as a Singular instrumented event attribute "fnamehash"
  • Using Roman alphabet a-z characters is recommended. Lowercase only with no punctuation. If using special characters, the text must be encoded in UTF-8 format.
  • Hashed last name be SHA 256 hashed