> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/tiktok/tiktok-offiline-events.md).

# TikTok Offline Events

{% hint style="info" %}
Cette destination est actuellement en phase de revue finale et sera bientôt disponible.
{% endhint %}

[TikTok](https://www.tiktok.com/) est un service d'hébergement de vidéos courtes d'une plateforme sociale.\
Cette destination exploite TikTok [API des événements](https://ads.tiktok.com/help/article/events-api?redirected=1) à [signaler des événements hors ligne](https://business-api.tiktok.com/portal/docs?id=1758428013689857).

## Fonctionnalités clés

La destination TikTok Offline Events fournit les principales fonctionnalités suivantes :

* **Structure des événements**: notre [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) couvre [événements hors ligne TikTok](https://ads.tiktok.com/marketing_api/docs?id=1758428013689857), ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur des événements s'effectue automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique**: les informations sont hachées automatiquement conformément aux spécifications du partenaire.
* **Smart mapping**: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Prise en charge des données multi-items**: les informations incluses dans le [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) Le tableau est envoyé à TikTok.

## Configuration de la destination

### Configuration

<table><thead><tr><th width="248">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>ID du jeu d'événements</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>La valeur de l'ID de votre jeu d'événements. Plus de détails sont disponibles en suivant ce lien <a href="https://ads.tiktok.com/marketing_api/docs?id=1758428013689857">LINK</a>. Ce paramètre prend en charge des valeurs dynamiques <strong>[1].</strong></td></tr><tr><td><code>Mappage</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Associez « TikTok Event Types » à vos « Commanders Act events » en définissant au moins un <code>Type d'événement TikTok</code> et un <code>Nom de l'événement Commanders Act</code> . Une entrée est requise.</td></tr></tbody></table>

{% hint style="info" %}
**1.** Cette fonctionnalité vous permet de définir une propriété d’événement contenant une valeur dynamique en ajoutant deux accolades ouvrantes (`{{`) devant le nom de votre propriété et deux accolades fermantes (`}}`) à la fin (p. ex. `{{myEventPropertyPathAndName}}`).
{% endhint %}

## Référence rapide

| Commanders Act Events   | Type d'événement TikTok                                              |
| ----------------------- | -------------------------------------------------------------------- |
| `[Tous les événements]` | `CompletePayment` , `Contact` , `Subscribe` et `SubmitForm` **\[1]** |

{% hint style="info" %}
**1.** Voir [Configuration](#configuration) pour plus de détails.
{% endhint %}

## Mappages de champs

{% hint style="info" %}
Voir plus de détails sur le format du téléphone en suivant ce lien [LINK](https://ads.tiktok.com/gateway/docs/index?identify_key=c0138ffadd90a955c1f0670a56fe348d1d40680b3c89461e09f78ed26785164b\&language=ENGLISH\&doc_id=1758428013689857#item-link-User%20context%20object%20parameters).
{% endhint %}

<table><thead><tr><th width="330.6685580062746">Propriétés Commanders Act</th><th>Propriétés TikTok</th></tr></thead><tbody><tr><td><code>ID du jeu d'événements</code></td><td><code>event_set_id</code></td></tr><tr><td><code>Type d'événement TikTok</code></td><td><code>événement</code> <strong>[1]</strong></td></tr><tr><td><code>id</code></td><td><code>event_id</code></td></tr><tr><td><code>context.event_timestamp</code></td><td><code>timestamp</code><strong>[2]</strong></td></tr><tr><td><code>user.phone</code></td><td><code>context.user.phone_numbers.0</code> <strong>[3]</strong></td></tr><tr><td><code>user.email</code></td><td><code>context.user.emails.0</code> <strong>[3]</strong></td></tr><tr><td><code>id</code></td><td><code>properties.order_id</code></td></tr><tr><td><code>shop_id</code></td><td><code>properties.shop_id</code></td></tr><tr><td><code>items.X.id</code></td><td><code>properties.contents.X.content_id</code></td></tr><tr><td><code>items.X.product.name</code></td><td><code>properties.contents.X.content_name</code></td></tr><tr><td><code>items.X.product.price</code></td><td><code>properties.contents.X.price</code></td></tr><tr><td><code>items.X.quantity</code></td><td><code>properties.contents.X.quantity</code></td></tr><tr><td><code>items.X.type</code></td><td><code>properties.contents.X.content_type</code></td></tr><tr><td><code>items.X.product.category_1</code>><br><code>items.X.product.category_2</code>><br><code>items.X.product.category_3</code>><br><code>items.X.product.category_4</code>><br><code>items.X.product.category_5</code></td><td><code>properties.contents.X.content_category</code></td></tr><tr><td><code>currency</code></td><td><code>properties.currency</code></td></tr><tr><td><code>valeur</code></td><td><code>properties.value</code></td></tr><tr><td><code>type</code></td><td><code>properties.event_channel</code></td></tr></tbody></table>

{% hint style="info" %}
**1.** Voir <mark style="color:bleu;">`Mappage`</mark> dans [Configuration](#configuration) pour plus de détails.\
**2.** L'horodatage doit être fourni en millisecondes. Il est converti en [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format.\
**3.** Champ automatiquement haché avec SHA256 s'il n'est pas transmis en clair.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/tiktok/tiktok-offiline-events.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.