> 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/)La plateforme d’AppsFlyer est utilisée par les entreprises pour comprendre comment les utilisateurs découvrent et interagissent avec leurs applications.\
Avec cette destination, vous pouvez exploiter [API des événements AppsFlyer PC/Console/CTV](https://dev.appsflyer.com/hc/reference/pc-console-ctv-api-overview) pour mesurer [premières ouvertures de l’application](https://dev.appsflyer.com/hc/reference/post_first-open-app-platform-app-id) et [événements in-app](https://dev.appsflyer.com/hc/reference/post_first-open-app-platform-app-id).

## Fonctionnalités clés

La destination API des événements AppsFlyer PC/Console/CTV offre 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) prend en charge [la structure d’événements d’AppsFlyer](https://dev.appsflyer.com/hc/reference/post_inapp-app-platform-app-id), 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.
* **Événements et propriétés personnalisés**: vous pouvez librement envoyer des événements et des propriétés personnalisés selon vos besoins spécifiques.
* **Smart mapping**: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Prise en charge des données multi-items**: les informations incluses dans le [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) le tableau est transmis à AppsFlyer.

## Configuration de la destination

{% hint style="info" %}
Assurez-vous que votre application est enregistrée dans [AppsFlyer](https://hq1.appsflyer.com/auth/login) dans <mark style="color:bleu;">`Mes applications`</mark> .
{% endhint %}

### Configuration

<table><thead><tr><th width="300">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Clé secrète de signature</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>La clé développeur comme clé secrète de signature. Vous pouvez trouver sa valeur dans le <a href="https://hq1.appsflyer.com/unified-ltv/dashboard">le Dashboard d’AppsFlyer</a> dans <mark style="color:bleu;"><code>Paramètres</code></mark> → <mark style="color:bleu;"><code>Mes applications</code></mark> → cliquez <mark style="color:bleu;"><code>⋮</code></mark> à côté de votre application → <mark style="color:bleu;"><code>Paramètres de l’application</code></mark> → <mark style="color:bleu;"><code>Clé de développement</code></mark> .</td></tr><tr><td><code>ID de l'application</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre identifiant d’application (app-id). Vous pouvez trouver sa valeur dans le <a href="https://hq1.appsflyer.com/unified-ltv/dashboard">le Dashboard d’AppsFlyer</a> dans <mark style="color:bleu;"><code>Paramètres</code></mark> → <mark style="color:bleu;"><code>Mes applications</code></mark> → survolez juste sous le nom de votre application → cliquez <mark style="color:bleu;"><code>Copier l’ID de l’application</code></mark> .</td></tr><tr><td><code>Plateforme</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Sélectionnez la plateforme de l’application mesurée dans la liste fournie : <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>Nom de l’événement First Open</code></td><td><em><strong><code>Requis, voir ci-dessous</code></strong></em><br>Le nom de l’événement identifiant les premières ouvertures de l’application. Par défaut : <mark style="color:bleu;"><code>first_open</code></mark> . Ceci est requis 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>Correspondance des ID d’appareil</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Mappez vos identifiants d’appareil en sélectionnant un <mark style="color:bleu;"><code>type</code></mark> dans la liste fournie, et un <mark style="color:bleu;"><code>valeur</code></mark> . Au moins une entrée est requise.</td></tr><tr><td><code>Correspondance des événements</code></td><td>Modifiez la correspondance standard entre les événements AppsFlyer et les vôtres ou ajoutez de nouvelles correspondances.</td></tr><tr><td><code>Correspondance des paramètres</code></td><td>Mappez vos paramètres personnalisés en définissant leurs noms de champ dans <code>paramètre AppsFlyer</code> et en ajoutant la valeur dans <code>Votre valeur</code>.</td></tr></tbody></table>

## Référence rapide

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Commanders Act Events</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>

## Correspondances des champs

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

<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>IP de l'appareil</code></td><td><code>context.device.ip</code></td><td><code>ip</code> <strong>[*]</strong></td></tr><tr><td><code>-</code></td><td><code>Correspondance des ID d’appareil</code></td><td><code>device_ids</code> <strong>[*]</strong></td></tr><tr><td><code>Horodatage de l’événement</code></td><td><code>context.event_timestamp</code></td><td><code>timestamp</code></td></tr><tr><td><code>ID de requête</code></td><td><code>context.event_id</code></td><td><code>request_id</code></td></tr><tr><td><code>Agent utilisateur de l'appareil</code></td><td><code>context.device.user_agent</code></td><td><code>user_agent</code></td></tr><tr><td><code>Version de l’OS de l’appareil</code></td><td><code>context.device.os.version</code></td><td><code>device_os_version</code></td></tr><tr><td><code>Modèle de l’appareil</code></td><td><code>context.device.model</code></td><td><code>device_model</code></td></tr><tr><td><code>Le suivi publicitaire est activé</code></td><td><code>context.device.ad_tracking_enabled</code></td><td><code>limit_ad_tracking</code></td></tr><tr><td><code>ID utilisateur</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>Version de l’application</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>valeur</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 d’annonce</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 urbain</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'item</code></td><td><code>items.0.product.name</code></td><td><code>af_content</code> <strong>[3][4]</strong></td></tr><tr><td><code>ID de l'item</code></td><td><code>items.0.id</code></td><td><code>af_content_id</code> <strong>[3][4]</strong></td></tr><tr><td><code>ID de l'item</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 des 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 national</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 du trajet 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 du trajet 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 du trajet 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 du trajet 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 de l’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>ID de transaction</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>Zone 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’arrêts de l’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 projeté</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>Trajet régional</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 d’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>Succès</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>Deep Link</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 la correspondance 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 pour les 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 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/appsflyer/appsflyer-pc-console-ctv-events-api.md?ask=<question>&goal=<endgoal>
```

`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.