TikTok Sync Order Information

Cette destination est actuellement en revue finale et sera bientôt disponible.

TikTok for Business est une plateforme mondiale conçue pour fournir aux marques et aux marketeurs des solutions afin d'être des conteurs créatifs et d'engager de manière significative la communauté TikTok. En utilisant cette destination, vous pouvez exploiter Tiktok Sync Order Information endpoint pour mettre à jour le statut de vos commandes.

Fonctionnalités clés

La destination TikTok Sync Order Information offre les fonctionnalités clés suivantes :

• Structure des événements: notre Référence des événements prend en charge Statut de commande TikTok, ce qui signifie que vos données sont correctement transmises aux champs attendus de manière optimisée.

• Mappages préconstruits: le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les saisies utilisateur.

• Mappage intelligent: le mapping des données peut être réajusté en utilisant vos champs définis dans le datalayer.

• Prise en charge des données d'article: les informations incluses dans le item tableau sont envoyées à TikTok.

Configuration de la destination

Configuration

Paramètres	Description
Identifiants	Obligatoire Vos identifiants avec TikTok tels que définis directement dans votre destination ou, dans le menu de gauche, en suivant : Administration ➜ Connector Credentials ➜ Ajouter des connector credentials ➜ TikTok .
TikTok Organic Tracking Id	Obligatoire Le TikTok Organic Tracking Id (ttoclid) est un paramètre de suivi qui est ajouté à votre URL de page lorsqu'un utilisateur clique sur votre page produit (ex. https://www.url.com/product?ttoclid=opfed89ds90132344n2dkkl12321s321va).
Third Merchant Id	Obligatoire Doit correspondre au third_merchant_id que vous avez utilisé pour créer le marchand au sein de TikTok.
Third Shop Id	Obligatoire L'identifiant de l'hôtel tel qu'il figure dans votre système.
Third Shop Name	Obligatoire Le nom de l'hôtel tel qu'il figure dans votre système.
Valeur du paiement	Obligatoire Le montant total que le client est censé payer sur le site du panel. Cela inclut tous les frais et taxes, mais exclut les remises appliquées. Calculé comme : payment_value = total_value - discounts. Cette valeur reflète le prix total de la commande, même si le client effectue le paiement à une étape ultérieure (ex. lors du checkout).
Valeur totale	Obligatoire Valeur totale de la commande avant remises, incluant taxes et frais de service. Calculé comme : total_value = total_room_fee + total_tax + total_service_fee. Cette valeur est liée au prix de la commande.
Pays de la commande	Obligatoire Le pays où l'hôtel est situé.
Heure de création	Obligatoire Le moment de création de la commande dans votre système (timestamp en secondes).
Durée du séjour	Obligatoire Durée du séjour.
Nombre de chambres	Obligatoire Nombre de chambres séjournées.
Date d'arrivée	Obligatoire Date d'arrivée.
Date de départ	Obligatoire Date de départ.
Mappage des événements	Obligatoire Mapper Statut de commande TikTok avec Votre nom d'événement . Plus de détails sont disponibles en suivant ce LINK. Au moins une entrée est requise.

Référence rapide

Commanders Act Events	TikTok Order Status
[Any Event]	[Any Order Status] [1]

[1] Voir Mappage des événements dans Configuration pour plus de détails.

Mappings des champs

La plupart des propriétés peuvent être remappées en utilisant notre fonctionnalité "Smart Mapping". Toutes les propriétés TikTok sont définies dans le chemin order_info .

Propriétés Commanders Act	Propriétés TikTok
id	order_id [*]
Third Merchant Id	third_merchant_id [*]
Third Shop Id	third_shop_id [*]
Third Shop Name	third_shop_name [*]
event_name	order_status [*][1]
Pays de la commande	order_country [*]
Heure de création	create_time [*]
context.event_timestamp	update_time [*]
partners.tiktok.initiator	initiator [2]
currency	value.currency [*]
Valeur du paiement	value.payment_value [*]
Valeur totale	value.total_value [*]
Durée du séjour	extra.length_of_stay [*]
Nombre de chambres	extra.amount_of_room [*]
Date d'arrivée	extra.check_in_date [*]
Date de départ	extra.check_out_date [*]
items.X.id	third_sku_id [*][3]
items.X.product.name	third_sku_name [*][3]
items.X.third_spu_id	spu_list.0.third_spu_id
items.X.third_spu_name	spu_list.0.third_spu_name
partners.tiktok.actual_occupancy	extra.actual_occupancy
partners.tiktok.no_show	extra.no_show
partners.tiktok.cancel_reason	extra.cancel_reason
partners.tiktok.fulfillment_value	value.fulfillment_value [4]
partners.tiktok.fulfillment_tax	value.fulfillment_tax [4]
partners.tiktok.fulfillment_service_fee	value.fulfillment_service_fee [4]
partners.tiktok.commission_currency	currency [4][5]
partners.tiktok.commission_base_amount	commission_base_amount [4][5]
partners.tiktok.total_room_fee	value.total_room_fee
tax_amount	value.total_tax
partners.tiktok.total_service_fee	value.total_service_fee
partners.tiktok.discounts	value.discounts
context.page.url	order_url
partners.tiktok.promotion_id	promotion_info.promotion_id
partners.tiktok.promotion_description	promotion_info.description
partners.tiktok.promotion_saved_amount	promotion_info.saved_amount

[*] Propriété obligatoire. [1] Voir Mappage des événements dans Configuration pour plus de détails. [2] Propriété obligatoire pour le statut de commande CANCEL_ORDER . Il s'agit soit de MERCHANT ou CUSTOMER . [3] Défini dans le chemin spu_list.0.sku_list.0 . [4] Propriété obligatoire pour le statut de commande COMPLETE_ORDER . [5] Défini dans le chemin value.commission_value.0 .