> 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/branch-events.md). # Branch Events [Branch](https://www.branch.io/) (anciennement connu sous le nom de Branch Metrics) est une société de logiciels mobiles spécialisée dans le deep linking mobile et l'attribution. Cette intégration permet [suivi des événements server-side](https://help.branch.io/developers-hub/reference/events-api). ## Fonctionnalités clés La destination Branch Events offre les fonctionnalités clés suivantes : * **Structure des événements**: notre [Référence des événements](https://doc.commandersact.com/developers/tracking/events-reference) correspond à Branch [standard](https://help.branch.io/developers-hub/reference/logstandardevents) et [events custom](https://help.branch.io/developers-hub/reference/logcustomevents), 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. * **Données enrichies**: vous pouvez envoyer librement des informations supplémentaires en fonction de vos besoins spécifiques (par ex. en ajoutant des événements personnalisés et des propriétés d'événement personnalisées). * **Smart mapping**: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer. * **Mappage d'événements**: modifiez le mappage standard entre les événements de vos partenaires et les vôtres, ou ajoutez de nouveaux mappages. * **Prise en charge des données multi-items**: les informations incluses dans le [item](https://doc.commandersact.com/developers/tracking/events-reference#item) le tableau est envoyé à Branch. ## Configuration de la destination {% hint style="info" %} Avant de configurer cette destination, vous devez créer un [Branch Dashboard](https://dashboard.branch.io/). {% endhint %} ### Configuration

Paramètres	Description
`Branch Key`	`Obligatoire` Branch Key de l'application d'origine, obtenu en accédant à votre Paramètres du compte.
`Schéma du contenu`	Catégorie/Schéma pour le contenu inclus.
`Propriétés d'événement personnalisées`	Mappez vos propriétés d'événement personnalisées en définissant leurs noms de champ dans `Nom de la propriété Branch` et en ajoutant le nom du champ contenant la valeur dans `Votre propriété d'événement`.
`Correspondance des événements`	Modifiez le mapping standard (voir Référence rapide) entre les événements de Branch et les vôtres, ou ajoutez de nouveaux mappings.

## Référence rapide

Commanders Act Events	Branch Events
`achieve_level`	`ACHIEVE_LEVEL`
`add_payment_info`	`ADD_PAYMENT_INFO`
`add_to_cart`	`ADD_TO_CART`
`add_to_wishlist`	`ADD_TO_WISHLIST`
`begin_checkout`	`INITIATE_PURCHASE`
`click_ad`	`CLICK_AD`
`complete_stream`	`COMPLETE_STREAM`
`complete_tutorial`	`COMPLETE_TUTORIAL`
`generate_lead`	`COMPLETE_REGISTRATION`
`initiate_stream`	`INITIATE_STREAM`
`invite`	`INVITE`
`login`	`LOGIN`
`purchase`	`PURCHASE`
`rate`	`RATE`
`search`	`SEARCH`
`share`	`SHARE`
`start_trial`	`START_TRIAL`
`spend_credits`	`SPEND_CREDITS`
`subscribe`	`SUBSCRIBE`
`unlock_achievement`	`UNLOCK_ACHIEVEMENT`
`view_ad`	`VIEW_AD`
`view_cart`	`VIEW_CART`
`view_item`	`VIEW_ITEM`
`view_items`	`VIEW_ITEMS`
`[Tout événement]` [1]	`[Tout événement]` [1]

{% hint style="info" %} **1.** Voir `Correspondance des événements` dans [Configuration](#configuration) pour plus de détails. {% endhint %} ## Correspondances des champs {% hint style="warning" %} Au moins l’un des éléments suivants doit être inclus :\ • `developer_identity`\ • `browser_fingerprint_id`\ • `idfa` OU `idfv` (IF `os` = `iOS` )\ • `aaid` OU `android_id` (IF `os` = `Android` ) {% endhint %} {% hint style="info" %} Les propriétés peuvent être remappées à l'aide de notre [Mappage intelligent](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité. {% endhint %}

Champs Smart Mapping	Propriétés par défaut de Commanders Act	Branch Properties
`-`	`Branch Key`	`branch_key`
`Alias d'événement client`	`partners.branch.event_alias`	`customer_event_alias`
`Système d'exploitation de l'appareil`	`context.device.os.name`	`os` [1]
`Version de l’OS de l’appareil`	`context.device.os.version`	`os_version` [1]
`Environnement`	`partners.branch.env`	`environment` [1]
`Identifiant mobile de l'appareil`	`context.device.advertising_id`	`idfa` [1][5] `aaid` [1][6]
`ID matériel Android`	`partners.branch.hardware_id`	`android_id` [1]
`IDFV iOS de l'appareil`	`context.device.idfv`	`idfv` [1]
`Le suivi publicitaire est activé`	`context.device.ad_tracking_enabled`	`limit_ad_tracking` [1][7]
`Agent utilisateur de l'appareil`	`context.device.user_agent`	`user_agent` [1]
`ID de fingerprint du navigateur Branch`	`partners.branch.fingerprint_id`	`browser_fingerprint_id` [1]
`URL de la page`	`context.page.url`	`http_origin` [1]
`URL de provenance de la page`	`context.page.referrer`	`http_referrer` [1]
`ID utilisateur`	`user.id`	`developer_identity` [1]
`Pays de l'utilisateur`	`user.country`	`country` [1]
`Langue de l'utilisateur`	`context.page.lang`	`language` [1]
`IP de l'appareil`	`context.device.ip`	`ip` [1]
`IP locale de l'appareil`	`partners.branch.local_ip`	`local_ip` [1]
`Marque de l'appareil`	`context.device.manufacturer`	`brand` [1]
`Jeton d'appareil Branch`	`partners.branch.device_token`	`randomized_device_token` [1]
`Version de l’application`	`context.app.version`	`app_version` [1]
`Modèle de l’appareil`	`context.device.model`	`model` [1]
`DPI de l'appareil`	`context.device.screen.density`	`screen_dpi` [1]
`Largeur d'écran de l'appareil`	`context.device.screen.width`	`screen_width` [1]
`Hauteur d'écran de l'appareil`	`context.device.screen.height`	`screen_height` [1]
`DMA EEA`	`partners.branch.dma_eea`	`dma_eea` [1]
`DMA Ad Personalization`	`partners.branch.dma_ad_pers`	`dma_ad_personalization` [1]
`DMA Ad User Data`	`partners.branch.dma_ad_user_data`	`dma_ad_user_data` [1]
`ID de transaction`	`id`	`transaction_id` [2]
`Revenu de transaction`	`revenue`	`revenue` [2]
`Devise`	`currency`	`currency` [2]
`Montant des frais de livraison`	`shipping_amount`	`shipping` [2]
`Montant de la taxe`	`tax_amount`	`tax` [2]
`Coupon de transaction`	`coupon`	`coupon` [2]
`Type de transaction`	`type`	`affiliation` [2]
`Description de la transaction`	`event_name`	`description` [2]
`Terme de recherche`	`search_query`	`search_term` [2]
`-`	`Schéma du contenu`	`$content_schema` [3]
`Titre de l'article`	`item_title` [4]	`$og_title` [3]
`URL de l'image de l'article`	`product.image_url` [4]	`$og_image_url` [3]
`Identifiant canonique de l'article`	`product.canonical_identifier` [4]	`$canonical_identifier` [3]
`Article indexable publiquement`	`product.publicly_indexable` [4]	`$publicly_indexable` [3]
`Article indexable publiquement`	`product.locally_indexable` [4]	`$locally_indexable` [3]
`Prix de l'article`	`product.price` [4]	`$price` [3]
`Quantité de l'élément`	`quantity` [4]	`$quantity` [3]
`ID de l'item`	`id` [4]	`$sku` [3]
`Nom de l'item`	`product.name` [4]	`$product_name` [3]
`Marque de l'item`	`product.brand` [4]	`$product_brand` [3]
`Catégorie de l'item`	`product.category_1` [4]	`$product_category` [3]
`Variante de l'item`	`variant` [4]	`$product_variant` [3]
`Moyenne des notes de l'article`	`product.rating_average` [4]	`$rating_average` [3]
`Nombre d'évaluations de l'article`	`product.rating_count` [4]	`$rating_count` [3]
`Note maximale de l'article`	`product.rating_max` [4]	`$rating_max` [3]
`Horodatage de création de l'article`	`product.creation_timestamp` [4]	`$creation_timestamp` [3]
`Date d'expiration de l'article`	`product.exp_date` [4]	`$exp_date` [3]
`Mots-clés de l'article`	`product.keywords` [4]	`$keywords` [3]
`Rue de l'adresse de l'article`	`product.address_street` [4]	`$address_street` [3]
`Ville de l'adresse de l'article`	`product.address_city` [4]	`$address_city` [3]
`Région de l'adresse de l'article`	`product.address_region` [4]	`$address_region` [3]
`Pays de l'adresse de l'article`	`product.address_country` [4]	`$address_country` [3]
`Code postal de l'adresse de l'article`	`product.address_postal_code` [4]	`$address_postal_code` [3]
`Latitude de l'article`	`product.latitude` [4]	`$latitude` [3]
`Longitude de l'article`	`product.longitude` [4]	`$longitude` [3]
`Légendes de l'image de l'article`	`product.image_captions` [4]	`$image_captions` [3]
`État de l'article`	`product.condition` [4]	`$condition` [3]

{% hint style="info" %} **1.** Défini dans `user_data` .\ **2.** Défini dans `event_data` .\ **3.** Défini dans `content_items.X` .\ **4.** Défini dans `items.X` .\ **5.** propriété définie lorsque `context.device.os.name` est `iOS` (insensible à la casse).\ **6.** propriété définie lorsque `context.device.os.name` est `Android` (insensible à la casse).\ **7.** booléen opposé de `context.device.ad_tracking_enabled` . {% 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/branch-events.md?ask=&goal= ``` `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.