Search

Setting up Tiktok Leads

To gain access to Online Ads TikTok Leads, Customer Engagement users should contact their Voyado account manager.

A single TikTok account can only be connected to one site in OSM. However, a TikTok account can contain multiple lead forms. So if you have several markets, it's possible to map each one to a separate form in the same TikTok account. For example, if a TikTok account contains separate forms for Sweden, Norway, and Denmark, all three forms can be connected through the same Onsite site.

How it works summary

  1. Connect your TikTok Business account to Voyado Customer Engagement
  2. Choose your TikTok Pages and lead forms to sync
  3. Map the data fields to Customer Engagement attributes
  4. Set up automations or flows to activate those leads

Setting up the integration

The setup and configuration of the TikTok Leads integration is done like this:

  1. Create contact attribute

    To track what form the customer has arrived from, go to Config Hub and create a custom attribute called customSource of type String.

    Do it like this:

    meta-leads-setup-01.png

     

  2. Initial leads setup

    Log in to Onsite Manager:

    Take me to Onsite Manager

    Or go to Config Hub again, where you can configure Lead Ads.

    Take me to Config Hub

    meta-leads-setup-02.png

    If you don't see Lead Ads in Config Hub, contact Voyado support.

    Contact Voyado Support

  3. Accelerator setup

    In Onsite Manager, go to Accelerator Configuration → Accelerators for lead ads.

    If this section is missing, contact Voyado support.

    Contact Voyado Support

    Use your existing site in OSM. Currently, you can only connect to one site in OSM.

  4. Connect to TikTok

    In Onsite Manager, press Actions → Edit.

    In the TikTok section, connect to your TikTok Page.

    Go through the TikTok permission flow.

  5. Screenshot showing TikTok permissions dialog
  6. Click Connect. Then you will see this:
  7. Screenshot showing Leads permissions dialog with the account information

     

    Press Confirm. You should now be authenticated with TikTok.

  8. Form mapping

    Once connected, Customer Engagement will pull in your TikTok Lead Forms.

    If no forms are visible, ensure one is created in TikTok for your campaign.

    Choose the form you want and then map its fields to Customer Engagement.

    The Get forms button will fetch all the forms on your page that you can connect to Voyado Customer Engagement.

    Once you've done that, you will get a list of forms under TikTok forms.

    Press the form that you want to connect to Voyado Customer Engagement, then press Get fields.

    This will retrieve all the fields on that specific form.

    Map the fields as shown in the image.

    Then press Save.

    meta-leads-setup-07.png

  9. CRM verification in TikTok

    There is no way to see in TikTok if the connection has been done unfortunately but you should be able to test the integration, see below.

Testing the integration

You can test your form directly in TikTok Ads or manually using TikTok Lead Ads Testing Tool.

See this article for more.

Was this article helpful?

/