# TikTok Offline Events

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

[TikTok](https://www.tiktok.com/) est un service d’hébergement de vidéos courtes sur une plateforme sociale.\
Cette destination exploite TikTok [Events API](https://ads.tiktok.com/help/article/events-api?redirected=1) pour [rapporter 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 fonctionnalités clé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 les événements se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Mappage intelligent**: le mappage des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Prise en charge des données multi-éléments**: les informations incluses dans le [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) array 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>Event Set Id</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>La valeur de votre identifiant d’event set. Plus de détails sont disponibles en suivant ce <a href="https://ads.tiktok.com/marketing_api/docs?id=1758428013689857">LIEN</a>. Ce paramètre prend en charge les valeurs dynamiques <strong>[1].</strong></td></tr><tr><td><code>Mapping</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>TikTok Event Type</code> et un <code>Commanders Act Event Name</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 (par ex. `{{myEventPropertyPathAndName}}`).
{% endhint %}

## Référence rapide

| Événements Commanders Act | TikTok Event Type                                                    |
| ------------------------- | -------------------------------------------------------------------- |
| `[Tous les événements]`   | `CompletePayment` , `Contact` , `Subscribe` et `SubmitForm` **\[1]** |

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

## Field Mappings

{% hint style="info" %}
Voir plus de détails sur le format de téléphone en suivant ce [LIEN](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>TikTok Properties</th></tr></thead><tbody><tr><td><code>Event Set Id</code></td><td><code>event_set_id</code></td></tr><tr><td><code>TikTok Event Type</code></td><td><code>event</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>value</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;">`Mapping`</mark> dans [Configuration](#configuration) pour plus de détails.\
> \&#xNAN;**\[2]** Horodatage à fournir en millisecondes. Celui-ci est converti en [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format.\
> \&#xNAN;**\[3]** Champ automatiquement haché avec SHA256 s’il n’est pas transmis en clair.
> {% endhint %}


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.