> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Report Ad Results to TikTok

> Configure tracking events to report business outcomes from TikTok messaging ads.

# Report Ad Results to TikTok

Use tracking events to report meaningful business outcomes from TikTok messaging ads to TikTok. A tracking event tells YCloud when to report and which business result to report.

## How event reporting works

A TikTok messaging ad can start a WhatsApp conversation. As you follow up, a customer may become a qualified lead, place an order, complete a payment, or reach another meaningful outcome. A tracking event recognizes that outcome and reports the signal you selected to TikTok.

A tracking event has two parts:

1. **Trigger condition:** The business activity that tells YCloud when to report the selected signal to TikTok.
2. **Reported signal:** The TikTok event that describes that outcome.

When the trigger condition is met for a WhatsApp conversation attributed to the selected TikTok ad account, and **Report to TikTok** is on, YCloud reports the selected signal to TikTok.

For example, you can configure a rule that reports `QualifiedLead` when an agent applies a `Qualified lead` contact tag.

You can create multiple tracking events to report different results. Each tracking event reports one selected TikTok signal.

## Set up a tracking event

1. In YCloud, go to **CTWA** > **Track Events**.
2. Select the TikTok ad account you want to configure.
3. Select **Track new event**.
4. Name the tracking event.
5. Choose when to report a signal to TikTok.
6. Choose the TikTok signal to report.
7. Turn on **Report to TikTok**, then save the tracking event.

<Frame caption="Create a tracking event for a TikTok ad account">
  <img src="https://mintcdn.com/lchnan/zF5bhBnzwSZkZsSr/product-assets/remote-911c7c1098-image.png?fit=max&auto=format&n=zF5bhBnzwSZkZsSr&q=85&s=7dafe7a24c10ec70d5b0d12e0cc7771b" alt="YCloud form for creating a TikTok tracking event" width="1520" height="955" data-path="product-assets/remote-911c7c1098-image.png" />
</Frame>

<Frame caption="Select the TikTok signal to report">
  <img src="https://mintcdn.com/lchnan/zF5bhBnzwSZkZsSr/product-assets/remote-470585dcd9-my-photor-1773062278104.png?fit=max&auto=format&n=zF5bhBnzwSZkZsSr&q=85&s=5c6de3dacc694b2c4a2a7c6b01373bae" alt="TikTok event selector in a YCloud tracking event" width="2857" height="1807" data-path="product-assets/remote-470585dcd9-my-photor-1773062278104.png" />
</Frame>

## Choose when to report a signal to TikTok

This guide covers the following trigger types. Choose the one that best matches how your business confirms the result:

1. **Contact tag**
2. **Custom event**
3. **Conversation keyword**

The following sections explain each trigger type.

### Contact tag

Use a contact tag when an agent or automation applies a tag after confirming an outcome. For example, report `QualifiedLead` after your team adds a `Qualified lead` tag.

<Frame caption="Select a contact tag as the trigger">
  <img src="https://mintcdn.com/lchnan/zF5bhBnzwSZkZsSr/product-assets/remote-5d2cc87a62-choose-eventtype-tag-t1.png?fit=max&auto=format&n=zF5bhBnzwSZkZsSr&q=85&s=4b9fac3909f3ad05fc06044bc0f18497" alt="YCloud tracking-event editor with Contact tag selected" width="3031" height="1758" data-path="product-assets/remote-5d2cc87a62-choose-eventtype-tag-t1.png" />
</Frame>

<Frame caption="Choose the contact tag that confirms the outcome">
  <img src="https://mintcdn.com/lchnan/zF5bhBnzwSZkZsSr/product-assets/remote-a5856531cd-choose-eventtype-tag-value-t1.png?fit=max&auto=format&n=zF5bhBnzwSZkZsSr&q=85&s=0c5d29c18c85cee68ee7a1e2b8dd96f4" alt="YCloud tracking-event editor with a contact tag value entered" width="3029" height="1758" data-path="product-assets/remote-a5856531cd-choose-eventtype-tag-value-t1.png" />
</Frame>

### Custom event

Use a custom event when your business system can send a confirmed result to YCloud, such as an order being placed or a payment being completed. If the custom event includes properties, you can use its available property values as additional conditions.

* [Create and send a custom event](/en/api-reference/guides/customer-data-and-operations/track-custom-events)

For a custom event defined with `objectType: CONTACT`, you can identify an existing YCloud contact by their saved Meta username using `contactUsername`, without the leading `@`. Choose one of the contact ID, phone number, or username for each request. See [Track custom events](/en/api-reference/guides/customer-data-and-operations/track-custom-events) for identifier rules and a username request example.

This identifies the contact associated with the custom event. Reporting to TikTok still requires the relevant ad attribution and a matching rule with **Report to TikTok** turned on.

<Frame caption="Select a custom event as the trigger">
  <img src="https://mintcdn.com/lchnan/zF5bhBnzwSZkZsSr/product-assets/remote-90946dec19-choose-eventtype-customapi.png?fit=max&auto=format&n=zF5bhBnzwSZkZsSr&q=85&s=06480476076d449f3aac7c72c6ddf8bd" alt="YCloud tracking-event editor with Custom event selected" width="2858" height="1552" data-path="product-assets/remote-90946dec19-choose-eventtype-customapi.png" />
</Frame>

<Frame caption="Configure a custom-event trigger">
  <img src="https://mintcdn.com/lchnan/zF5bhBnzwSZkZsSr/product-assets/remote-655ee4e08d-choose-eventtype-customapi-2.png?fit=max&auto=format&n=zF5bhBnzwSZkZsSr&q=85&s=5d2a6a2ac9943350413c9ec9d33d6854" alt="YCloud TikTok tracking event using a custom event trigger" width="2878" height="1552" data-path="product-assets/remote-655ee4e08d-choose-eventtype-customapi-2.png" />
</Frame>

### Conversation keyword

Use a keyword when a customer's message is a clear and reliable signal of intent. For example, use a specific keyword that confirms a customer wants to book an appointment. Avoid broad or ambiguous keywords.

<Frame caption="Select conversation keywords as the trigger">
  <img src="https://mintcdn.com/lchnan/zF5bhBnzwSZkZsSr/product-assets/remote-7da818faa8-chooose-eventtype-keyword-value-t1.png?fit=max&auto=format&n=zF5bhBnzwSZkZsSr&q=85&s=de21a07957d0dac4178e43dc37ff012e" alt="YCloud tracking-event editor with conversation keyword selected" width="3047" height="1721" data-path="product-assets/remote-7da818faa8-chooose-eventtype-keyword-value-t1.png" />
</Frame>

<Frame caption="Enter keywords that identify the result">
  <img src="https://mintcdn.com/lchnan/zF5bhBnzwSZkZsSr/product-assets/remote-526f47dd40-chooose-eventtype-keyword-value1.png?fit=max&auto=format&n=zF5bhBnzwSZkZsSr&q=85&s=0946cbb4411a632da2f18c598237cda1" alt="YCloud tracking event with conversation keywords entered" width="3035" height="1762" data-path="product-assets/remote-526f47dd40-chooose-eventtype-keyword-value1.png" />
</Frame>

## Choose a signal to report to TikTok

Choose the TikTok signal that best represents the confirmed business outcome in your process. The available signals are shown when you create a tracking event.

### Report more than one signal

You can report multiple signals when your business tracks multiple meaningful outcomes. Create a separate tracking event for each signal.

For example, you can report `QualifiedLead` when a lead is qualified and `CompletePayment` when that customer later pays.

A single tracking event reports one TikTok signal. In the current account view, YCloud prevents you from enabling two rules that report the same TikTok signal. Turn off the existing rule before enabling another rule with that signal.

## Manage tracking events

In **CTWA** > **Track Events**, select your TikTok ad account to manage its tracking events.

* Turn **Report to TikTok** on or off for an editable tracking event.
* Delete a custom tracking event that you no longer need.
* Select **Track new event** to add another tracking event for a different business result.
* Built-in tracking events are shown dynamically for the selected account. They cannot be turned off or deleted.

Turning off **Report to TikTok** stops future reporting from that tracking event. It does not delete the tracking event.

## Next step

Use [CTWA Analysis](/en/documentation/ctwa-click-to-whatsapp-ad/ctwa-analysis) to review your TikTok ad data and conversation activity in YCloud.

## Frequently Asked Questions

<Accordion title="Can I report more than one business result to TikTok?">
  Yes. Create a separate tracking event for each result you want to report. For example, you can report both `QualifiedLead` and `CompletePayment` when they occur at different stages of your customer journey.
</Accordion>

<Accordion title="Which trigger should I use?">
  Use a contact tag when an agent or automation confirms the result, a custom event when your own system confirms it, and a conversation keyword when the customer's message is a reliable signal of intent.
</Accordion>

<Accordion title="What happens when I turn off Report to TikTok?">
  For an editable tracking event, turning off **Report to TikTok** stops YCloud from reporting future results triggered by that event to TikTok. You can turn it back on later.
</Accordion>

<Accordion title="Why can’t I enable another rule with the same TikTok signal?">
  In the current account view, YCloud allows one enabled rule for each TikTok signal. Turn off the existing rule before enabling another rule that reports the same signal.
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.