> 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/appsflyer/appsflyer-pc-console-ctv-events-api.md).

# AppsFlyer PC/Console/CTV Events API

[Appsflyer](https://www.appsflyer.com/) est utilisée par les entreprises pour comprendre comment les utilisateurs découvrent leurs applications et interagissent avec elles.\
Cette destination vous permet de tirer parti de [AppsFlyer PC/Console/CTV Events API](https://dev.appsflyer.com/hc/reference/pc-console-ctv-api-overview) pour mesurer les [premières ouvertures de l’application](https://dev.appsflyer.com/hc/reference/post_first-open-app-platform-app-id) et les [événements in-app](https://dev.appsflyer.com/hc/reference/post_first-open-app-platform-app-id).

## Fonctionnalités clés

La destination AppsFlyer PC/Console/CTV Events API offre 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) prend en charge [la structure des événements d’AppsFlyer](https://dev.appsflyer.com/hc/reference/post_inapp-app-platform-app-id), ce qui permet de faire correspondre correctement vos donné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 s’effectue automatiquement, ce qui simplifie les saisies des utilisateurs.
* **Événements et propriétés personnalisés** : vous pouvez envoyer librement des événements et des propriétés personnalisés en fonction de vos besoins spécifiques.
* **Mappage intelligent** : le mappage des données peut être ajusté à l’aide des champs définis dans votre datalayer.
* **Prise en charge des données à plusieurs éléments** : les informations incluses dans le tableau [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) sont transmises à AppsFlyer.

## Configuration de la destination

{% hint style="info" %}
Vérifiez que votre application est enregistrée dans [AppsFlyer](https://hq1.appsflyer.com/auth/login) sous <mark style="color:bleu;">`My Apps`</mark> .
{% endhint %}

### Configuration

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="300">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Signature Secret Key</code></td><td><em><strong><code>Required</code></strong></em><br>La clé développeur utilisée comme clé secrète de signature. Vous trouverez sa valeur dans le <a href="https://hq1.appsflyer.com/unified-ltv/dashboard">Dashboard d’AppsFlyer</a> sous <mark style="color:bleu;"><code>Settings</code></mark> → <mark style="color:bleu;"><code>My Apps</code></mark> → cliquez sur <mark style="color:bleu;"><code>⋮</code></mark> à côté de votre application → <mark style="color:bleu;"><code>App settings</code></mark> → <mark style="color:bleu;"><code>Dev key</code></mark> .</td></tr><tr><td><code>Application Id</code></td><td><em><strong><code>Required</code></strong></em><br>L’identifiant de votre application (app-id). Vous trouverez sa valeur dans le <a href="https://hq1.appsflyer.com/unified-ltv/dashboard">Dashboard d’AppsFlyer</a> sous <mark style="color:bleu;"><code>Settings</code></mark> → <mark style="color:bleu;"><code>My Apps</code></mark> → passez la souris juste sous le nom de votre application → cliquez sur <mark style="color:bleu;"><code>Copy app id</code></mark> .</td></tr><tr><td><code>Platform</code></td><td><em><strong><code>Required</code></strong></em><br>Sélectionnez la plateforme de l’application mesurée dans la liste proposée : <mark style="color:bleu;"><code>roku</code></mark> , <mark style="color:bleu;"><code>smartcast</code></mark> , <mark style="color:bleu;"><code>tizen</code></mark> , <mark style="color:bleu;"><code>webos</code></mark> , <mark style="color:bleu;"><code>playstation</code></mark> , <mark style="color:bleu;"><code>vidaa</code></mark> , <mark style="color:bleu;"><code>steam</code></mark> , <mark style="color:bleu;"><code>quest</code></mark> , <mark style="color:bleu;"><code>battlenet</code></mark> , <mark style="color:bleu;"><code>epic</code></mark> , <mark style="color:bleu;"><code>switch</code></mark> , <mark style="color:bleu;"><code>xbox</code></mark> , <mark style="color:bleu;"><code>nativepc</code></mark> et <mark style="color:bleu;"><code>vega</code></mark> .</td></tr><tr><td><code>First Open Event Name</code></td><td><em><strong><code>Required see below</code></strong></em><br>Nom de l’événement identifiant les premières ouvertures de l’application. Valeur par défaut : <mark style="color:bleu;"><code>first_open</code></mark> . Ce champ est obligatoire si votre application n’intègre pas notre <a href="https://doc.commandersact.com/features/sources/sources-catalog/mobile-app">SDK mobile</a>.</td></tr><tr><td><code>Device Id Mapping</code></td><td><em><strong><code>Required</code></strong></em><br>Associez vos identifiants d’appareil en sélectionnant un <mark style="color:bleu;"><code>type</code></mark> dans la liste proposée et une <mark style="color:bleu;"><code>value</code></mark> . Au moins une entrée est obligatoire.</td></tr><tr><td><code>Event Mapping</code></td><td>Modifiez le mapping standard entre les événements AppsFlyer et les vôtres, ou ajoutez de nouveaux mappings.</td></tr><tr><td><code>Param Mapping</code></td><td>Associez vos paramètres personnalisés en indiquant leurs noms de champ dans <code>AppsFlyer parameter</code> et en ajoutant la valeur dans <code>Your value</code>.</td></tr></tbody></table>

## Référence rapide

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Événements Commanders Act</th><th>Événements AppsFlyer</th></tr></thead><tbody><tr><td><code>achievement_unlocked</code></td><td><code>af_achievement_unlocked</code></td></tr><tr><td><code>ad_click</code></td><td><code>af_ad_click</code></td></tr><tr><td><code>ad_view</code></td><td><code>af_ad_view</code></td></tr><tr><td><code>add_payment_info</code></td><td><code>af_add_payment_info</code></td></tr><tr><td><code>add_to_cart</code></td><td><code>af_add_to_cart</code></td></tr><tr><td><code>add_to_wishlist</code></td><td><code>af_add_to_wishlist</code></td></tr><tr><td><code>app_opened</code></td><td><code>af_app_opened</code></td></tr><tr><td><code>sign_up</code></td><td><code>af_complete_registration</code></td></tr><tr><td><code>view_item</code></td><td><code>af_content_view</code></td></tr><tr><td><code>begin_checkout</code></td><td><code>af_initiated_checkout</code></td></tr><tr><td><code>invite</code></td><td><code>af_invite</code></td></tr><tr><td><code>generate_lead</code></td><td><code>lead</code></td></tr><tr><td><code>level_achieved</code></td><td><code>af_level_achieved</code></td></tr><tr><td><code>view_item_list</code></td><td><code>af_list_view</code></td></tr><tr><td><code>login</code></td><td><code>af_login</code></td></tr><tr><td><code>notification_open</code></td><td><code>af_opened_from_push_notification</code></td></tr><tr><td><code>in_app_purchase</code><br><code>purchase</code></td><td><code>af_purchase</code></td></tr><tr><td><code>submit_rating</code><br><code>rate</code></td><td><code>af_rate</code></td></tr><tr><td><code>re_engage</code></td><td><code>af_re_engage</code></td></tr><tr><td><p><code>view_search_results</code></p><p><code>search</code></p></td><td><code>af_search</code></td></tr><tr><td><code>share</code></td><td><code>af_share</code></td></tr><tr><td><code>spend_virtual_currency</code></td><td><code>af_spent_credits</code></td></tr><tr><td><code>spent_credits</code></td><td><code>af_spent_credits</code></td></tr><tr><td><code>start_trial</code></td><td><code>af_start_trial</code></td></tr><tr><td><code>subscribe</code></td><td><code>af_subscribe</code></td></tr><tr><td><code>travel_booking</code></td><td><code>af_travel_booking</code></td></tr><tr><td><code>ecommerce_purchase</code></td><td><code>af_travel_booking</code></td></tr><tr><td><code>tutorial_complete</code></td><td><code>af_tutorial_completion</code></td></tr><tr><td><code>app_update</code><br><code>update</code></td><td><code>af_update</code></td></tr></tbody></table>

## Mappages de champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l’aide de notre [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.
{% endhint %}

<table data-header-hidden="false" data-header-sticky data-full-width="true"><thead><tr><th width="240">Champs Smart Mapping</th><th width="435.6685580062747">Propriétés par défaut de Commanders Act</th><th width="333.3314419937253">Propriétés AppsFlyer</th></tr></thead><tbody><tr><td><code>Device IP</code></td><td><code>context.device.ip</code></td><td><code>ip</code> <strong>[*]</strong></td></tr><tr><td><code>-</code></td><td><code>Device Id Mapping</code></td><td><code>device_ids</code> <strong>[*]</strong></td></tr><tr><td><code>Event Timestamp</code></td><td><code>context.event_timestamp</code></td><td><code>timestamp</code></td></tr><tr><td><code>Request Id</code></td><td><code>context.event_id</code></td><td><code>request_id</code></td></tr><tr><td><code>Device User Agent</code></td><td><code>context.device.user_agent</code></td><td><code>user_agent</code></td></tr><tr><td><code>Device OS Version</code></td><td><code>context.device.os.version</code></td><td><code>device_os_version</code></td></tr><tr><td><code>Device Model</code></td><td><code>context.device.model</code></td><td><code>device_model</code></td></tr><tr><td><code>Suivi publicitaire activé</code></td><td><code>context.device.ad_tracking_enabled</code></td><td><code>limit_ad_tracking</code></td></tr><tr><td><code>User Id</code></td><td><code>user.id</code></td><td><p><code>customer_user_id</code></p><p><code>af_customer_user_id</code></p></td></tr><tr><td><code>App Version</code></td><td><code>context.app.version</code></td><td><code>app_version</code></td></tr><tr><td><code>Filtres de partage</code></td><td><code>partners.appsflyer.sharing_filters</code></td><td><code>sharing_filter</code></td></tr><tr><td><code>-</code></td><td><code>event_name</code></td><td><code>event_name</code> <strong>[1][4]</strong></td></tr><tr><td><code>Valeur</code></td><td><code>value</code></td><td><code>af_revenue</code> <strong>[2][4]</strong></td></tr><tr><td><code>Devise</code></td><td><code>currency</code></td><td><code>af_currency</code> <strong>[2][4]</strong></td></tr><tr><td><code>Type de publicité</code></td><td><code>ad_format</code></td><td><code>af_adrev_ad_type</code> <strong>[3][4]</strong></td></tr><tr><td><code>Trajet en ville</code></td><td><code>partners.appsflyer.af_city</code></td><td><code>af_city</code> <strong>[3][4]</strong></td></tr><tr><td><code>Classe de voyage</code></td><td><code>partners.appsflyer.af_class</code></td><td><code>af_class</code> <strong>[3][4]</strong></td></tr><tr><td><code>Nom de l’article</code></td><td><code>items.0.product.name</code></td><td><code>af_content</code> <strong>[3][4]</strong></td></tr><tr><td><code>Item Id</code></td><td><code>items.0.id</code></td><td><code>af_content_id</code> <strong>[3][4]</strong></td></tr><tr><td><code>Item Id</code></td><td><code>items.X.id</code></td><td><code>af_content_list</code> <strong>[3][4]</strong></td></tr><tr><td><code>Liste d’articles</code></td><td><code>items.length</code></td><td><code>af_quantity</code> <strong>[3][4]</strong></td></tr><tr><td><code>Catégorie d’article 1</code></td><td><code>items.0.product.category_1</code></td><td><code>af_content_type</code> <strong>[3][4]</strong></td></tr><tr><td><code>Trajet à la campagne</code></td><td><code>partners.appsflyer.af_country</code></td><td><code>af_country</code> <strong>[3][4]</strong></td></tr><tr><td><code>Devise</code></td><td><code>currency</code></td><td><code>af_currency</code> <strong>[3][4]</strong></td></tr><tr><td><code>Date d’arrivée</code></td><td><code>partners.appsflyer.af_date_a</code></td><td><code>af_date_a</code> <strong>[3][4]</strong></td></tr><tr><td><code>Date de départ</code></td><td><code>partners.appsflyer.af_date_b</code></td><td><code>af_date_b</code> <strong>[3][4]</strong></td></tr><tr><td><code>Date d’arrivée à l’aller</code></td><td><code>partners.appsflyer.af_departing_arrival_date</code></td><td><code>af_departing_arrival_date</code> <strong>[3][4]</strong></td></tr><tr><td><code>Date de départ à l’aller</code></td><td><code>partners.appsflyer.af_departing_departure_date</code></td><td><code>af_departing_departure_date</code> <strong>[3][4]</strong></td></tr><tr><td><code>Date d’arrivée au retour</code></td><td><code>partners.appsflyer.af_returning_arrival_date</code></td><td><code>af_returning_arrival_date</code> <strong>[3][4]</strong></td></tr><tr><td><code>Date de départ au retour</code></td><td><code>partners.appsflyer.af_returning_departure_date</code></td><td><code>af_returning_departure_date</code> <strong>[3][4]</strong></td></tr><tr><td><code>Description</code></td><td><code>partners.appsflyer.af_description</code></td><td><code>af_description</code> <strong>[3][4]</strong></td></tr><tr><td><code>Première destination</code></td><td><code>partners.appsflyer.af_dest_a</code></td><td><code>af_destination_a</code> <strong>[3][4]</strong></td></tr><tr><td><code>Deuxième destination</code></td><td><code>partners.appsflyer.af_dest_b</code></td><td><code>af_destination_b</code> <strong>[3][4]</strong></td></tr><tr><td><code>Liste des destinations</code></td><td><code>partners.appsflyer.af_dest_list</code></td><td><code>af_destination_list</code> <strong>[3][4]</strong></td></tr><tr><td><code>Note de l’hôtel</code></td><td><code>partners.appsflyer.af_hotel_score</code></td><td><code>af_hotel_score</code> <strong>[3][4]</strong></td></tr><tr><td><code>Niveau utilisateur</code></td><td><code>partners.appsflyer.af_level</code></td><td><code>af_level</code> <strong>[3][4]</strong></td></tr><tr><td><code>Valeur maximale de la note</code></td><td><code>partners.appsflyer.af_max_rating_value</code></td><td><code>af_max_rating_value</code> <strong>[3][4]</strong></td></tr><tr><td><code>Nombre d’adultes</code></td><td><code>partners.appsflyer.af_num_adults</code></td><td><code>af_num_adults</code> <strong>[3][4]</strong></td></tr><tr><td><code>Nombre d’enfants</code></td><td><code>partners.appsflyer.af_num_children</code></td><td><code>af_num_children</code> <strong>[3][4]</strong></td></tr><tr><td><code>Nombre de nourrissons</code></td><td><code>partners.appsflyer.af_num_infants</code></td><td><code>af_num_infants</code> <strong>[3][4]</strong></td></tr><tr><td><code>Transaction Id</code></td><td><code>id</code></td><td><code>af_order_id</code> <strong>[3][4]</strong></td></tr><tr><td><code>Mode de paiement</code></td><td><code>payment_method</code></td><td><code>af_payment_info_available</code> <strong>[3][4]</strong></td></tr><tr><td><code>Quartier de l’hôtel</code></td><td><code>partners.appsflyer.af_hotel_area</code></td><td><code>af_preferred_neighborhoods</code> <strong>[3][4]</strong></td></tr><tr><td><code>Nombre d’étapes utilisateur</code></td><td><code>partners.appsflyer.af_preferred_num_stops</code></td><td><code>af_preferred_num_stops</code> <strong>[3][4]</strong></td></tr><tr><td><code>Fourchette de prix de l’hôtel</code></td><td><code>partners.appsflyer.af_preferred_price_range</code></td><td><code>af_preferred_price_range</code> <strong>[3][4]</strong></td></tr><tr><td><code>Nombre d’étoiles de l’hôtel</code></td><td><code>partners.appsflyer.af_preferred_star_ratings</code></td><td><code>af_preferred_star_ratings</code> <strong>[3][4]</strong></td></tr><tr><td><code>Revenu prévisionnel</code></td><td><code>partners.appsflyer.af_projected_revenue</code></td><td><code>af_projected_revenue</code> <strong>[3][4]</strong></td></tr><tr><td><code>Valeur maximale de la note</code></td><td><code>partners.appsflyer.af_max_rating_value</code></td><td><code>af_rating_value</code> <strong>[3][4]</strong></td></tr><tr><td><code>ID du reçu</code></td><td><code>partners.appsflyer.af_receipt_id</code></td><td><code>af_receipt_id</code> <strong>[3][4]</strong></td></tr><tr><td><code>Région du trajet</code></td><td><code>partners.appsflyer.af_region</code></td><td><code>af_region</code> <strong>[3][4]</strong></td></tr><tr><td><code>Méthode d'inscription</code></td><td><code>method</code></td><td><code>af_registration_method</code> <strong>[3][4]</strong></td></tr><tr><td><code>Score</code></td><td><code>partners.appsflyer.score</code></td><td><code>af_score</code> <strong>[3][4]</strong></td></tr><tr><td><code>Terme de recherche</code></td><td><code>search_term</code></td><td><code>af_search_string</code> <strong>[3][4]</strong></td></tr><tr><td><code>ID de l'abonnement</code></td><td><code>partners.appsflyer.af_subscription_id</code></td><td><code>af_subscription_id</code> <strong>[3][4]</strong></td></tr><tr><td><code>Réussite</code></td><td><code>partners.appsflyer.af_success</code></td><td><code>af_success</code> <strong>[3][4]</strong></td></tr><tr><td><code>Destinations suggérées</code></td><td><code>partners.appsflyer.af_suggested_destinations</code></td><td><code>af_suggested_destinations</code> <strong>[3][4]</strong></td></tr><tr><td><code>Hôtels suggérés</code></td><td><code>partners.appsflyer.af_suggested_hotels</code></td><td><code>af_suggested_hotels</code> <strong>[3][4]</strong></td></tr><tr><td><code>Fin du voyage</code></td><td><code>partners.appsflyer.af_travel_end</code></td><td><code>af_travel_end</code> <strong>[3][4]</strong></td></tr><tr><td><code>Début du voyage</code></td><td><code>partners.appsflyer.af_travel_start</code></td><td><code>af_travel_start</code> <strong>[3][4]</strong></td></tr><tr><td><code>Score utilisateur</code></td><td><code>partners.appsflyer.af_user_score</code></td><td><code>af_user_score</code> <strong>[3][4]</strong></td></tr><tr><td><code>Validé</code></td><td><code>partners.appsflyer.af_validated</code></td><td><code>af_validated</code> <strong>[3][4]</strong></td></tr><tr><td><code>ID de réussite</code></td><td><code>partners.appsflyer.af_achievement_id</code></td><td><code>af_achievement_id</code> <strong>[3][4]</strong></td></tr><tr><td><code>Coupon</code></td><td><code>partners.appsflyer.af_coupon_code</code></td><td><code>af_coupon_code</code> <strong>[3][4]</strong></td></tr><tr><td><code>Segment client</code></td><td><code>partners.appsflyer.af_customer_segment</code></td><td><code>af_customer_segment</code> <strong>[3][4]</strong></td></tr><tr><td><code>Lien profond</code></td><td><code>partners.appsflyer.af_deep_link</code></td><td><code>af_deep_link</code> <strong>[3][4]</strong></td></tr><tr><td><code>Fin de l’événement</code></td><td><code>partners.appsflyer.af_event_end</code></td><td><code>af_event_end</code> <strong>[3][4]</strong></td></tr><tr><td><code>Début de l’événement</code></td><td><code>partners.appsflyer.af_event_start</code></td><td><code>af_event_start</code> <strong>[3][4]</strong></td></tr><tr><td><code>Latitude</code></td><td><code>partners.appsflyer.af_lat</code></td><td><code>af_lat</code> <strong>[3][4]</strong></td></tr><tr><td><code>Longitude</code></td><td><code>partners.appsflyer.af_long</code></td><td><code>af_long</code> <strong>[3][4]</strong></td></tr><tr><td><code>Nouvelle version</code></td><td><code>partners.appsflyer.af_new_version</code></td><td><code>af_new_version</code> <strong>[3][4]</strong></td></tr><tr><td><code>Ancienne version</code></td><td><code>partners.appsflyer.af_old_version</code></td><td><code>af_old_version</code> <strong>[3][4]</strong></td></tr><tr><td><code>Texte de l’avis</code></td><td><code>partners.appsflyer.af_review_text</code></td><td><code>af_review_text</code> <strong>[3][4]</strong></td></tr><tr><td><code>ID du tutoriel</code></td><td><code>partners.appsflyer.af_tutorial_id</code></td><td><code>af_tutorial_id</code> <strong>[3][4]</strong></td></tr><tr><td><code>Nom de la monnaie virtuelle</code></td><td><code>partners.appsflyer.af_virtual_currency_name</code></td><td><code>af_virtual_currency_name</code> <strong>[3][4]</strong></td></tr><tr><td><code>Durée en secondes</code></td><td><code>partners.appsflyer.af_duration_seconds</code></td><td><code>af_duration_seconds</code> <strong>[3][4]</strong></td></tr></tbody></table>

{% hint style="info" %}
**\*** Propriété obligatoire.\
**1.** Voir [Référence rapide](#quick-reference) pour plus de détails sur le mapping standard.\
**2.** Défini dans la propriété `event_parameters` .\
**3.** Défini dans la propriété `event_custom_parameters` .\
**4.** Cette propriété n’est pas présente lors des premières ouvertures de l’application.
{% 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/appsflyer/appsflyer-pc-console-ctv-events-api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
