# 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 %}