> 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/sources/sources-catalog/mobile-app.md).

# Application mobile

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td></td><td>SDK ANDROID</td><td></td><td><a href="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-84149aba8bdce06ff7f5513d2cc5e8c775caac2a%2FAndroid_symbol_green_RGB%5B1%5D.png?alt=media">Android_symbol_green_RGB[1].png</a></td><td><a href="https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/mobile-app/android.md">Android</a></td></tr><tr><td></td><td>SDK IOS</td><td></td><td><a href="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-7c5fd14f39e540e0a4fd11cbef2a2acd26578a01%2Fapple-logo-png-dallas-shootings-don-add-are-speech-zones-used-4%5B1%5D.png?alt=media">apple-logo-png-dallas-shootings-don-add-are-speech-zones-used-4[1].png</a></td><td><a href="https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/mobile-app/ios.md">iOS</a></td></tr><tr><td></td><td>SDK FLUTTER</td><td></td><td><a href="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-cd24ef0942b958b1847f0255cddc5a7b80b2626f%2Fflutter5786%5B1%5D.jpg?alt=media">flutter5786[1].jpg</a></td><td><a href="https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/mobile-app/flutter.md">Flutter</a></td></tr><tr><td></td><td>SDK REACT NATIVE</td><td></td><td><a href="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-4320d59923b83bbd10e14945a928e236ad2c0f18%2F2300px-React-icon.svg%5B1%5D.png?alt=media">2300px-React-icon.svg[1].png</a></td><td><a href="https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/mobile-app/react-native.md">React Native</a></td></tr><tr><td>API DE SUIVI HTTP</td><td></td><td></td><td><a href="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-be1580a5c83060c530e176626ef1a3669a96a08e%2FHTTP.jpg?alt=media">HTTP.jpg</a></td><td><a href="https://doc.commandersact.com/features/sources/sources-catalog/server/http-tracking-api">https://doc.commandersact.com/features/sources/sources-catalog/server/http-tracking-api</a></td></tr></tbody></table>

## Introduction au marquage des applications mobiles

de CommandersAct **SDK** vous permet de déclencher des destinations depuis une application mobile.

Commanders Act propose un SDK dit « super léger » que vous pouvez intégrer au code de votre application mobile. Son objectif est de réduire autant que possible les appels aux solutions partenaires afin d’améliorer les performances de votre application et l’expérience utilisateur. Un appel unique est envoyé aux serveurs de CommandersAct pour chaque action enregistrée dans l’application. Les informations relatives à la page consultée ou à l’élément sur lequel l’utilisateur a cliqué sont ensuite transmises séparément aux solutions partenaires par les serveurs de CommandersAct, ce qui évite de ralentir le chargement des applications.

**Remarque**: toutes les solutions ne sont pas compatibles avec cette méthode. Comme le SDK léger envoie les informations de l’application aux serveurs des solutions partenaires, celles-ci ne peuvent pas « revenir » vers l’application. Les solutions d’adserving (qui affichent des publicités) et les fournisseurs de notifications push ne sont donc pas compatibles avec cette méthode.

Le principe de fonctionnement de base du SDK léger de Commanders est le suivant :

– **Étape 1** : le data layer mobile et le SDK de CommandersAct sont appelés dans le code source de l’application à chaque chargement d’écran ou clic sur un élément (votre équipe informatique doit avoir mis cela en place au début du projet).

– **Étape 2** : le SDK de CommandersAct envoie des appels aux serveurs de CommandersAct et transmet automatiquement le contenu du data layer mobile. Voici la structure des hits server-side : <https://collect.commander1.com/events?tc\\_s=`${siteID}`\\&token=`${YOUR_SOURCE_KEY}`>

`${siteID}` et `${YOUR_SOURCE_KEY}` doivent être fournis au SDK et seront remplacés automatiquement.

Les autres paramètres sont envoyés dans le corps de la requête POST, comme indiqué ici :

{% content-ref url="/pages/b3c6b97fbefb13224941aa94ed75af5e25b9a16c" %}
[Spécificité des événements de l'application mobile](https://doc.commandersact.com/fr/developpeurs/tracking-and-integrations/tracking/about-events/mobile-sdk-event-specificity.md)
{% endcontent-ref %}

– **Étape 3** : les serveurs de CommandersAct transmettent les informations reçues aux différentes destinations. Le nombre de hits sortants correspond au nombre de solutions partenaires auxquelles vous souhaitez transmettre des informations.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-6593ac66eba107802fcc1fea4e06a597b0a12e0f%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Exemple : si vous souhaitez envoyer un appel à la fois à Criteo et à Google, un hit sera envoyé aux serveurs de chacune de ces solutions.

L’implémentation de nos SDK dans une application mobile est un projet qui comprend les étapes suivantes :

* Définition du plan de marquage de l’application mobile : sélection et définition des événements.
* Création d’une source mobile et de destinations
* Implémentation du SDK de CommandersAct dans le code source de l’application.
* Tests de validation de l’implémentation dans un environnement de test.
* Publication

## Étape n° 1 : définir le plan de marquage de l’application

Le plan de marquage correspond à la liste des événements qui seront envoyés.

## Étape n° 2 : créer une source mobile et configurer les destinations dans l’interface CommandersAct

* **Créer une source pour iOS, Android ou les deux.**
* **Implémenter ou sélectionner des destinations.**

L’implémentation d’une destination mobile est identique à celle d’une destination cloud.

## Étape n° 3 : implémenter le SDK dans le code source des applications

L’implémentation du SDK est réalisée par le personnel technique ou les services informatiques.

Les éléments suivants doivent être fournis :

* Le plan de marquage CommandersAct de l’application, qui indique à l’équipe informatique les événements à déclarer ainsi que les écrans ou éléments concernés.
* La documentation technique correspondant à chaque application. Elle doit contenir les éléments essentiels à la configuration du SDK ainsi que des captures d’écran présentant des exemples de configuration.

Cliquez ici pour consulter la documentation technique correspondante. iOS : <https://github.com/CommandersAct/iOSV5/> android: <https://github.com/CommandersAct/androidv5/>

L’ID du site (numéro de compte Commanders Act) et celui de la clé source sont nécessaires pour configurer le SDK. Ces deux éléments sont accessibles dans l’interface.

## Étape n° 4 : tester la configuration dans un environnement de test

Le SDK Commanders Act peut être testé à l’aide de nombreux outils :

### **Tests pour iOS avec XCode**

Le SDK Commanders Act pour iOS peut être testé avec le logiciel de développement d’Apple « XCode » :

<https://itunes.apple.com/fr/app/xcode/id497799835>

Vous devez connecter votre iPhone à votre Mac.

Ouvrez XCode, accédez à « Window » (1) > « Devices » (2), puis sélectionnez votre appareil dans la colonne de gauche (3) :

![](https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-b8576181107b9ff6c9171c4ec4dae16cd9939941%2Fxcode_1%5B1%5D.png?alt=media)

Les éléments suivants s’affichent lors de l’analyse des logs mobiles :

* Numéro de version du SDK Commanders Act\
  exemple pour le module de consentement : « Commanders Act Privacy module init with version: 5.2.0 »
* ID du site Commanders Act
* Événements server-side envoyés contenant toutes les propriétés que vous avez transmises aux serveurs Commanders Act (méthode POST). Pour en savoir plus sur la construction des événements, consultez nos  [exemples de codes d’événements](https://doc.commandersact.com/fr/developpeurs/tracking-and-integrations/tracking/events-reference.md)

![](https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-1d4017a54d1b1cef8792f7817a0ebc0cecaabbd0%2Fxcode_2%5B1%5D.png?alt=media)

\*\*\*

### **Exécuter des tests sur Android ou iOS avec Charles Debugger**

Le SDK Commanders Act pour iOS et Android peut être testé avec le proxy « Charles Debugger », téléchargeable gratuitement ici : [https://www.charlesproxy.com/](https://www.charlesproxy.com)

La première chose à faire est de configurer votre téléphone pour qu’il puisse communiquer avec Charles.

Dans les paramètres de votre téléphone, accédez à l’onglet de configuration Wi-Fi.

Sélectionnez votre réseau, puis accédez aux options avancées pour modifier les paramètres Wi-Fi.

Ajoutez un proxy manuellement :

* Nom du proxy (serveur) (1) : adresse IP de l’ordinateur (vous la trouverez dans l’onglet « Local IP address » des options de Charles)
* Port (2) : 8888

Enregistrez.

![](https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-e18b8a380a1854093788f60131dbfb4ede6a8996%2Fcharles_1%5B1%5D.png?alt=media)

Accédez à l’application Charles et autorisez-la à se connecter au téléphone.

![](https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-d42eed05aa76e5f8a22fbbabc1ec0d30b41f8b68%2Fcharles_2%5B1%5D.png?alt=media)

Naviguez sur le Web avec votre téléphone et, dans Charles (sur votre ordinateur), appliquez un filtre « Commander » pour afficher les hits server-side dans la section « Overview ». Ils ressemblent à ceci :\
<https://collect.commander1.com/events?tc_s=XXXX&token=XYZZ>

Dans la zone « Request », vous pourrez voir toutes les variables et les valeurs correspondantes envoyées via le SDK Commanders Act.

![](https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-6adcea882aa2e8604d3956223ef6a6c80df787cd%2Fcharles_3%5B1%5D.png?alt=media)

Protocole HTTPS :

La plupart du temps, les appels server-side sont effectués via le protocole HTTPS.

L’affichage des hits HTTPS avec Charles nécessite une configuration plus complexe. Vous devez ouvrir le navigateur de votre téléphone pendant que Charles s’exécute sur votre ordinateur, puis accéder à cette URL depuis votre téléphone <http://www.charlesproxy.com/getssl/>

Téléchargez et installez le certificat ; vous devrez saisir son nom pour deux applications : « VPN and applications » et « Wi-Fi ».

Retournez dans Charles > « SSL proxy settings » > « SSL Proxying » > cochez « Enable SSL Proxying » > cliquez sur « Add » et saisissez « \* » dans le champ « Host » (pour autoriser tous les hôtes).

Effectuez ensuite les tests de la même manière que pour les hits HTTP.

## Étape n° 5 : publication

Lorsque l’implémentation fonctionne correctement dans votre environnement de test, vous devez soumettre votre application aux boutiques d’applications (Apple Store ou Android Market), puis attendre qu’elles approuvent les modifications et ajoutent la nouvelle version à leurs catalogues.


---

# 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/sources/sources-catalog/mobile-app.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.
