> 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/consent-management/knowledge-base/iab-tcf-v2.2-release-details/iab-tcf-v2.2-migration-guide-app.md).

# Guide de migration App IAB TCF v2.2

Cette page est destinée aux clients utilisant le SDK Commanders Act avec le module IAB Consent dans leur application mobile

## Introduction

Voici les deux étapes à suivre pour rester conforme au TCF sur votre application mobile.

{% hint style="warning" %}
Prérequis\
Pour pouvoir migrer vers IAB TCF v2.2, votre application doit utiliser la v5 de nos SDK.\
Si vous utilisez encore la v4, consultez le guide principal [de migration des SDK](https://doc.commandersact.com/getting-started/integrating-your-data/migration-guides-to-the-platform-x/migrate-from-old-mobile-sdk)
{% endhint %}

{% hint style="info" %}
À noter : cette documentation est un guide pas à pas facile à suivre. Pour les détails techniques, consultez notre dépôt GitHub [Android](https://github.com/CommandersAct/AndroidV5/tree/master/TCIAB) et [iOS](https://github.com/CommandersAct/iOSV5/tree/master/TCIAB)
{% endhint %}

### 1-Mettre à jour le module SDK

Téléchargez simplement les dernières versions de nos modules SDK TCIAB

* [Android](https://github.com/CommandersAct/AndroidV5/tree/master/TCIAB)
* [iOS](https://github.com/CommandersAct/iOSV5/tree/master/TCIAB)

### 2-Mettre à jour les fichiers json

**Importez la dernière version pour mettre à jour vos fichiers json hors ligne**

* [vendor-list.json](https://cdn.trustcommander.net/iab-v2/gvl-v3/vendor-list.json)
* [purposes-xx.json](https://cdn.trustcommander.net/iab-v2/gvl-v3/purposes-fr.json) (obligatoire si vous utilisez une langue autre que l’anglais ; cet exemple de lien concerne le français)
* votre fichier json de confidentialité mis à jour (à modifier en suivant l’étape « Mettre à jour le contenu de votre fichier json de confidentialité »)

**Importez votre fichier json sur le CDN**

Vous devez importer votre fichier json de confidentialité mis à jour sur le CDN de Commanders Act. Contactez votre consultant ou notre équipe d’assistance pour importer la dernière version de votre fichier json sur nos serveurs. (Le contenu de ce fichier json doit être mis à jour en suivant l’étape suivante.)\\

**Mettre à jour le contenu de votre fichier json de confidentialité**

1. Vérifier votre liste de vendors `"vendors": "15,48,501,506,520,539,512,895",`\
   \*Si vous laissez « vendors » vide, notre SDK considérera que tous les vendors sont concernés.\
   Vérifiez votre liste de vendors : certains vendors ne figurent plus dans la GVL v3.\\
2. Ajouter les nouveaux champs obligatoires\
   `texts -> generic -> "illustationsButton": "illustrations"`

   `texts -> generic -> "dataCategoriesDef" : "Data Categories"`\
   `texts -> vendors -> "legIntClaimTitle": "Legal policies"`

Exemple complet de fichier json :

```
{
	"information": {
		"update": "2023-06-30",
		"version": "1",
		"vendors": "8,241",
		"google_vendors" : "323,389,385,424",
		"consentDurationInMonths": 6,
		"significantChanges": "",
		"resetSave": ""
	},
	"components": {
		"firstLayerButton": ["RefuseAll", "Detail", "AcceptAll"],
		"secondLayerButton": ["RefuseAll", "Save", "AcceptAll"]
	},
	"customisation": {
		"content": {
			"fontcolor": "#000000",
			"backgroundcolor": "#ffffff",
			"bordercolor": "#806423"
		},
		"button": {
			"fontcolor": "#ffffff",
			"backgroundcolor": "#4287f5",
			"disabledBackground": "#E1E1E1",
			"linkcolor": "#0907F7"
		},
		"order": ["Custom", "IAB"]
	},
	"texts": {
		"generic": {
			"saveButton": "Enregistrer et quitter",
			"detailButton": "Détails",
			"acceptAllButton": "Tout accepter",
			"refuseAllButton": "Tout refuser",
			"vendorButton": "Vendeurs",
			"purposeButton": "Finalités",
			"legalButton": "Mentions légales",
			"illustationsButton": "illustrations",
			"backButton": "Retour",
			"purposeDef": "Finalités",
			"consentDef": "Consentement",
			"legIntPurposeDef": "Intérêt légitime",
			"flexiblePurposeDef": "Finalité flexible",
			"specialPurposeDef": "Finalité spéciale",
			"featureDef": "Fonctionnalités",
			"specialFeatureDef": "Fonctionnalités spéciales",
            		"dataCategoriesDef" : "Catégories de données",
			"partnersLinkText": "nos partenaires",
			"relatedVendorsButton": "afficher les vendeurs associés",
			"month": "mois",
			"day": "jour",
			"seconds": "secondes",
			"hours": "heures"
		},
		"popup": {
			"title": "Nous respectons votre vie privée",
			"content": "Nos partenaires et nous-mêmes utilisons des technologies telles que les cookies et traitons des données personnelles, comme les adresses IP et les identifiants de cookie, afin de personnaliser les publicités et le contenu en fonction de vos intérêts, de mesurer leur performance et de tirer des Insights sur les audiences qui les ont vus. Cliquez ci-dessous pour consentir à l’utilisation de ces technologies et au traitement de vos données personnelles à ces fins. Vous pouvez changer d’avis et modifier vos choix de consentement à tout moment en revenant sur ce site.\n",
			"purposeTitle": "Nos partenaires et nous-mêmes ({total_number}) :",
			"specialPurposeTitle": "Nous avons besoin de votre consentement pour toutes les finalités ci-dessus, mais nous invoquons notre intérêt légitime pour les finalités suivantes :",
			"featureTitle": "Pour certaines des finalités ci-dessus, nos partenaires et nous-mêmes :",
			"specialFeatureTitle": "Pour certaines des finalités ci-dessus, nos partenaires et nous-mêmes :"
		},
		"purposes": {
			"title": "Découvrez comment vos données personnelles sont traitées et définissez vos préférences ci-dessous.",
			"content": "Vous pouvez définir vos préférences de consentement et déterminer comment vos données seront utilisées en fonction des finalités ci-dessous. Vous pouvez définir séparément vos préférences pour nous et celles concernant les partenaires Third-party. Chaque finalité est décrite afin que vous sachiez comment nos partenaires et nous-mêmes utilisons vos données.",
            "privacy_policy_text": "Consultez nos politiques de confidentialité",
			"privacy_policy_url": "https://ourcompany.com/privacypolicies"
		},
		"vendors": {
			"title": "Consultez ci-dessous les partenaires avec lesquels nous travaillons. Développez la fiche de chacun pour découvrir comment ils traitent vos données.",
			"content": "Vous pouvez définir ci-dessous vos préférences de consentement pour chacun des partenaires Third-party avec lesquels nous travaillons. Développez chaque entreprise pour découvrir les finalités pour lesquelles elle utilise les données et faire vos choix. Dans certains cas, les entreprises peuvent utiliser vos données sans demander votre consentement, sur la base de leur intérêt légitime. Consultez les liens vers leurs politiques de confidentialité pour en savoir plus et vous opposer à ce traitement.",
			"privacyPolicyText": "Politique de confidentialité",
			"legIntClaimTitle": "Politiques juridiques",
			"deviceStorageTitle": "Type de stockage :",
			"deviceStorageCookieLifetime": "Durée de vie du cookie : ",
			"deviceStorageOther": "Autres",
			"deviceStorageCookies": "Cookies",
            "googleVendorsDef" : "Fournisseurs de technologie publicitaire Google",
            "domainsDef" : "Liste des domaines", 
            "IABVendorsDef" : "Vendeurs IAB TCF"
		},
		"others": {
			"title_purpose": "Autres catégories FR",
			"title_vendors": "Autres vendeurs FR"
		}
	},
	"texts_fr": {
		"generic": {
			"saveButton": "J'accepte",
			"detailButton": "Détail",
			"acceptAllButton": "Tout accepter",
			"refuseAllButton": "Tout refuser",
			"vendorButton": "Afficher les partenaires",
			"purposeButton": "Afficher les finalités",
			"legalButton": "Informations légales",
            "illustationsButton": "illustrations",
			"backButton": "Retour",
			"purposeDef": "Finalités",
			"consentDef": "Consentement",
			"legIntPurposeDef": "Intérêts légitimes",
			"flexiblePurposeDef": "Finalités flexibles",
			"specialPurposeDef": "Finalités spéciales",
			"featureDef": "Fonctionnalités",
			"specialFeatureDef": "Fonctionnalités spéciales",
            "dataCategoriesDef" : "Catégories de données",
			"partnersLinkText": "nos partenaires",
			"relatedVendorsButton": "Voir les partenaires",
			"month": "mois",
			"day": "jours",
			"seconds": "secondes",
			"hours": "heures"
		},
		"popup": {
			"title": "Le respect de votre vie privée est notre priorité",
			"content": "Nous et nos {total_number} partenaires pouvons stocker et/ou accéder à des informations sur un terminal, sélectionner des publicités standard, créer un profil personnalisé de publicités, sélectionner des publicités personnalisées, mesurer la performance des publicités, mesurer la performance du contenu, exploiter des études de marché afin de générer des données d’audience, développer et améliorer les produits, créer un profil pour afficher un contenu personnalisé, sélectionner du contenu personnalisé, mesurer la performance des publicités, exploiter des études de marché afin de générer des données d’audience, développer et améliorer les produits, sélectionner des publicités standard, mesurer la performance du contenu, créer un profil personnalisé de publicités, sélectionner des publicités personnalisées, créer un profil pour afficher un contenu personnalisé, sélectionner du contenu personnalisé. Ces technologies peuvent traiter des données personnelles comme l'adresse IP et les données de navigation pour assurer la sécurité, prévenir la fraude et déboguer, diffuser techniquement les publicités ou le contenu. Elles peuvent mettre en correspondance et combiner des sources de données hors ligne, recevoir et utiliser des caractéristiques d’identification d’appareil envoyées automatiquement, relier différents terminaux. Elles peuvent analyser activement les caractéristiques du terminal pour l’identification, utiliser des données de géolocalisation précises.\n",
			"purposeTitle": "Gérer vos préférences",
			"specialPurposeTitle": "Gérer vos finalités spéciales",
			"featureTitle": "Gérer vos fonctionnalités ",
			"specialFeatureTitle": "Gérer vos fonctionnalités spéciales"
		},
		"purposes": {
			"title": "Gérer vos préférences P",
			"content": "Nos partenaires P et nous déposons des cookies afin d'assurer la sécurité, d'améliorer votre expérience numérique et d'afficher des publicités et des contenus personnalisés. Vous pouvez accepter ou refuser ces différentes opérations.",
			"privacy_policy_text": "Notre politique de confidentialité",
			"privacy_policy_url": "https://ourcompany.com/privacypolicies"
		},
		"vendors": {
			"title": "Gérer vos préférences V",
			"content": "Nos partenaires V et nous déposons des cookies afin d'assurer la sécurité, d'améliorer votre expérience numérique et d'afficher des publicités et des contenus personnalisés. Vous pouvez accepter ou refuser ces différentes opérations.",
			"privacyPolicyText": "Politique de confidentialité",
			"deviceStorageTitle": "Type de stockage :",
			"legIntClaimTitle": "Politiques juridiques" 
			"deviceStorageCookieLifetime": "Durée du cookie : ",
			"deviceStorageOther": "Autres",
			"deviceStorageCookies": "Cookies",
            "googleVendorsDef" : "Partenaires Google Ad Technology",
            "domainsDef" : "liste des domaines utilisés", 
            "IABVendorsDef" : "liste des partenaires IAB"
		},
		"others": {
			"title_purpose": "Autres catégories FR",
			"title_vendors": "Autres partenaires FR"
		}
	},
	"categories": [{
			"name": "Statistiques",
			"ID": "1",
			/* Ajouter "isMandatory": "true" pour bloquer la catégorie sur ON 
			   Si vous utilisez des sous-catégories, seules les sous-catégories peuvent être marquées comme obligatoires */
			"isMandatory": "true",
			"related_vendors": [1],
			"description": "Ces cookies nous permettent d’analyser le comportement des utilisateurs sur le site, de mesurer et d’améliorer les performances et la qualité de notre service."
		},
		{
			"name": "Publicité",
			"ID": "2",
			"related_vendors": [2],
			"description": "Ces cookies nous permettent d’afficher des publicités correspondant à vos centres d’intérêt sur les sites web que vous visitez."
		},
		{
			"name": "Grande catégorie",
			"ID": "30",
			"description": "Vous pouvez sélectionner les vendors ici.",
			"subcategories": [{
					"name": "GA",
					"ID": "31",
					"description": "Devons-nous envoyer des informations à GA ?"
				},
				{
					"name": "Xiti",
					"ID": "32",
					"description": "Devons-nous envoyer des informations à AT Internet ?"
				},
				{
					"name": "Vendor3",
					"ID": "33",
					"related_vendors": [1, 2],
					"description": "Devons-nous envoyer des informations à ce vendor3 ?"
				}
			]
		}
	],
	"vendors": [{ /* répertorier ici tous les vendors non-IAB */
			"name": "Commanders Act",
			"ID": "1",
			"description": "Autoriser Commanders Act",
			"privacy_policy": "http://commandersact.com/privacypolicy"
		},
		{
			"name": "Autre vendor non-IAB",
			"ID": "2",
			"description": "La description d’un autre vendor",
			"privacy_policy": "http://anothervendor.free.fr/privacypolicy"
		}
	],
	"categories_fr": [{
			"name": "Statistiques",
			"ID": "1",
			"related_vendors": [1],
			"description": "Avec cette catégorie, on recueille des statistiques."
		},
		{
			"name": "Publicité",
			"ID": "2",
			"related_vendors": [2],
			"description": "Pour afficher de superbes publicités personnalisées"
		},
		{
			"name": "Super catégorie",
			"ID": "30",
			"description": "Une super catégorie.",
			"subcategories": [{
					"name": "Sous-catégorie 1",
					"ID": "31",
					"description": "Mais on peut choisir uniquement cette sous-catégorie."
				},
				{
					"name": "Sous-catégorie 2",
					"ID": "32",
					"description": "Ou alors uniquement celle-ci."
				},
				{
					"name": "Sous-catégorie 3",
					"ID": "33",
					"related_vendors": [1, 2],
					"description": "Ou même plusieurs, mais la troisième revient au même."
				}
			]
		}
	],
	"vendors_fr": [{
			"name": "Commanders Act",
			"ID": "1",
			"description": "Permettre à Commanders Act d’envoyer des informations",
			"privacy_policy": "http://commandersact.com/privacypolicy"
		},
		{
			"name": "Autres vendors",
			"ID": "2",
			"description": "Permettre à cet autre vendor d’envoyer beaucoup d’informations",
			"privacy_policy": "http://anothervendor.free.fr/privacypolicy"
		}
	]
}
```

{% hint style="info" %}
La valeur {total\_number} dans « purposeTitle » est un champ dynamique. Le nombre total de vos vendors IAB s’affichera ici
{% endhint %}

{% hint style="danger" %}
La date limite de migration est le 20 novembre 2023
{% 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/consent-management/knowledge-base/iab-tcf-v2.2-release-details/iab-tcf-v2.2-migration-guide-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.
