# Guide de migration IAB TCF v2.2 App

## Introduction

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

{% hint style="warning" %}
Exigences\
Pour être autorisée à migrer vers IAB TCF v2.2, votre application doit utiliser la v5 de nos SDK\
Si vous utilisez encore la v4, veuillez vous référer au principal [Guide de migration du 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" %}
Veuillez noter : cette documentation est un guide pas à pas, conçu pour être simple d’utilisation. Pour les détails techniques, veuillez vous référer à notre 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

**Téléchargez la dernière version pour mettre à jour vos 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) (requis si vous utilisez d’autres langues que EN, cet exemple de lien est pour la langue FR)
* votre fichier json de confidentialité mis à jour (doit être modifié, en suivant l’étape "Mettre à jour le contenu de votre fichier json de confidentialité")

**Téléchargez votre fichier json CDN**

Votre fichier json de confidentialité mis à jour doit être téléversé sur le CDN Commanders Act, veuillez contacter votre consultant ou notre équipe support pour téléverser la dernière version de votre 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érifiez votre liste de vendors `"vendors": "15,48,501,506,520,539,512,895",`\
   \*si vous avez laissé "vendors" vide, cela sera considéré comme TOUS les vendors par notre SDK\
   Faites attention à votre Vendor List, certains Vendors n’existent plus dans la GVL v3\\
2. Ajouter les nouveaux champs requis\
   `texts -> generic -> "illustationsButton": "illustrations"`

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

Exemple complet de 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": "Save & Exit",
			"detailButton": "Details",
			"acceptAllButton": "Accept All",
			"refuseAllButton": "Refuse All",
			"vendorButton": "Vendors",
			"purposeButton": "Purposes",
			"legalButton": "Legals",
			"illustationsButton": "illustrations",
			"backButton": "Back",
			"purposeDef": "Purposes",
			"consentDef": "Consent",
			"legIntPurposeDef": "Legitimate Interest",
			"flexiblePurposeDef": "Flexible Purpose",
			"specialPurposeDef": "Special Purpose",
			"featureDef": "Features",
			"specialFeatureDef": "Special Features",
            		"dataCategoriesDef" : "Data Categories",
			"partnersLinkText": "our partners",
			"relatedVendorsButton": "show related vendors",
			"month": "month",
			"day": "day",
			"seconds": "seconds",
			"hours": "hours"
		},
		"popup": {
			"title": "Nous respectons votre vie privée",
			"content": "Nous et nos partenaires utilisons des technologies, telles que des cookie, et traitons des données personnelles, telles que des adresses IP et des identifiants cookie, afin de personnaliser les publicités et le contenu en fonction de vos intérêts, mesurer la performance des publicités et du contenu, et obtenir des Insights sur les audiences ayant vu les publicités et le contenu. Cliquez ci-dessous pour consentir à l’utilisation de cette technologie 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": "Nous et nos {total_number} partenaires :","t75":""specialPurposeTitle": "Nous avons besoin de votre consentement pour toutes les finalités ci-dessus, mais nous avons un intérêt légitime pour ces finalités :","t76":""featureTitle": "Pour certaines des finalités ci-dessus, nous et nos partenaires :","t77":""specialFeatureTitle": "Pour certaines des finalités ci-dessus, nous et nos partenaires :"","t78":""purposes": {","t79":""title": "Découvrez comment vos données personnelles sont traitées et définissez vos préférences ci-dessous.",","t80":""content": "Vous pouvez définir vos préférences de consentement et déterminer comment vous souhaitez que vos données soient utilisées en fonction des finalités ci-dessous. Vous pouvez définir vos préférences pour nous indépendamment de celles des partenaires Third-party. Chaque finalité dispose d’une description afin que vous sachiez comment nous et les partenaires utilisons vos données.",","t81":""privacy_policy_text": "Consultez nos politiques de confidentialité",","t82":""privacy_policy_url": "https://ourcompany.com/privacypolicies"","t83":""vendors": {","t84":""title": "Découvrez ci-dessous les partenaires avec lesquels nous travaillons. Développez chacun d’eux pour voir comment ils traitent vos données.",","t85":""content": "Vous pouvez définir ci-dessous vos préférences de consentement pour chaque partenaire Third-party avec lequel nous travaillons. Développez chaque élément de la liste des entreprises pour voir à quelles finalités elles utilisent les données afin de vous aider à faire vos choix. Dans certains cas, les entreprises peuvent utiliser vos données sans demander votre consentement, sur la base de leurs intérêts légitimes. Vous pouvez cliquer sur les liens de leur politique de confidentialité pour obtenir plus d’informations et vous opposer à ce type de traitement.",","t86":""privacyPolicyText": "Politique de confidentialité",","t87":""legIntClaimTitle": "Legal policies",","t88":""deviceStorageTitle": "Type de stockage :",","t89":""deviceStorageCookieLifetime": "Durée de vie du cookie : ",","t90":""deviceStorageOther": "Autres",","t91":""deviceStorageCookies": "cookie",","t92":""googleVendorsDef" : "Fournisseurs de technologies publicitaires Google",","t93":""domainsDef" : "Liste des domaines",","t94":""IABVendorsDef" : "Vendors IAB TCF"","t95":""others": {","t96":""title_purpose": "Other categories EN",","t97":""title_vendors": "Other vendors EN"","t98":""texts_fr": {","t99":""saveButton": "J'accepte",","t100":""detailButton": "Détail",","t101":""acceptAllButton": "Tout Accepter",","t102":""refuseAllButton": "Tout Refuser",","t103":""vendorButton": "Afficher les partenaires",","t104":""purposeButton": "Afficher les finalités",","t105":""legalButton": "Informations légales",","t106":""backButton": "Retour",","t107":""purposeDef": "Finalités",","t108":""consentDef": "Consentement",","t109":""legIntPurposeDef": "Intérêts légitimes",","t110":""flexiblePurposeDef": "Finalités flexibles",","t111":""specialPurposeDef": "Finalités spéciales",","t112":""featureDef": "Fonctionnalités",","t113":""specialFeatureDef": "Fonctionnalités spéciales",","t114":""dataCategoriesDef" : "Catégories de données",","t115":""partnersLinkText": "nos partenaires",","t116":""relatedVendorsButton": "Voir les partenaires",","t117":""month": "mois",","t118":""day": "jours",","t119":""seconds": "secondes",","t120":""hours": "heures"","t121":""title": "Le respect de votre vie privée est notre priorité",","t122":""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",","t123":""purposeTitle": "Gérer vos préférences",","t124":""specialPurposeTitle": "Gérer vos special purposes",","t125":""featureTitle": "Gérer vos features ",","t126":""specialFeatureTitle": "Gérer vos specialFeatures"","t127":""title": "Gérer vos préférences P",","t128":""content": "Nos partenaires P et nous déposons des cookie afin d'assurer la sécurité, améliorer votre expérience digitale et afficher des publicités et contenus personnalisés Vous pouvez accepter ou refuser ces différentes opérations.",","t129":""privacy_policy_text": "Notre politique de confidentialité",","t130":""title": "Gérer vos préférences V",","t131":""content": "Nos partenaires V et nous déposons des cookie afin d'assurer la sécurité, améliorer votre expérience digitale et afficher des publicités et contenus personnalisés Vous pouvez accepter ou refuser ces différentes opérations.",","t132":""privacyPolicyText": "Politique de confidentialité",","t133":""deviceStorageTitle": "Type de stockage:",","t134":""legIntClaimTitle": "Legal policies"","t135":""deviceStorageCookieLifetime": "Durée du cookie : ",","t136":""deviceStorageOther": "Autres",","t137":""googleVendorsDef" : "Partenaires Google Ad Technology",","t138":""domainsDef" : "liste des domaines utilisés",","t139":""IABVendorsDef" : "liste des partenaires IAB"","t140":""title_purpose": "Other categories FR",","t141":""title_vendors": "Other vendors FR"","t142":""categories": [{","t143":""name": "Statistiques",","t144":""ID": "1",","t145":"/* Ajouter "isMandatory": "true" pour bloquer la category sur ON","t146":"If you are using sub-categories, only sub can be marked as mandatories */","t147":""isMandatory": "true",","t148":""related_vendors": [1],","t149":""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.",","t150":""name": "Publicité",","t151":""ID": "2",","t152":""related_vendors": [2],","t153":""description": "Ces cookies nous permettent d’afficher des publicités correspondant à vos intérêts sur les sites web que vous visitez.",","t154":""name": "Grosse catégorie",","t155":""ID": "30",","t156":""description": "Ici, vous pouvez sélectionner les vendors.",","t157":""subcategories": [{","t158":""name": "GA",","t159":""ID": "31",","t160":""description": "Doit-on envoyer des informations à GA.",","t161":""name": "Xiti",","t162":""ID": "32",","t163":""description": "Doit-on envoyer des informations à AT Internet.",","t164":""name": "Vendor3",","t165":""ID": "33",","t166":""related_vendors": [1, 2],","t167":""description": "Doit-on envoyer des informations à ce vendor3.",","t168":""vendors": [{ /* list here all the not IAB Vendors */","t169":""name": "Commanders Act",","t170":""description": "Autoriser Commanders Act",","t171":""privacy_policy": "http://commandersact.com/privacypolicy"","t172":""name": "Another non IAB Vendor",","t173":""description": "La description d’un autre vendor",","t174":""privacy_policy": "http://anothervendor.free.fr/privacypolicy"","t175":""categories_fr": [{","t176":""name": "Statistiques",","t177":""description": "Avec cette catégorie on remonte les stats.",","t178":""name": "Pub",","t179":""description": "Pour afficher de superbes pubs personalisées",","t180":""name": "Super cat",","t181":""description": "Une super cat.",","t182":""name": "Sous cat 1",","t183":""description": "Mais on peut choisir que cette sous cat.",","t184":""name": "Sous cat 2",","t185":""description": "Ou alors uniquement celle-ci.",","t186":""name": "Sous cat 3",","t187":""description": "Ou plus en fait, mais la 3 c'est pareil.",","t188":""vendors_fr": [{","t189":""description": "Permettre à Commanders Act d'envoyer des informations",","t190":""name": "Autre Vendors",","t191":""description": "Permettre à cet autre vendor d'envoyer pleins d'informations",","t192":"La valeur {total_number} dans "purposeTitle" est un champ dynamique. Le nombre total de vos vendors IAB sera affiché ici"}]} 00json}】】
			Nous avons besoin de votre consentement pour toutes les finalités ci-dessus, mais nous avons un intérêt légitime pour ces finalités :
			Pour certaines des finalités ci-dessus, nous et nos partenaires :
			Pour certaines des finalités ci-dessus, nous et nos partenaires :
		},
		"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 vous souhaitez que vos données soient utilisées en fonction des finalités ci-dessous. Vous pouvez définir vos préférences pour nous indépendamment de celles des partenaires Third-party. Chaque finalité dispose d’une description afin que vous sachiez comment nous et les partenaires utilisons vos données.",
            "privacy_policy_text": "Consultez nos politiques de confidentialité",
			"privacy_policy_url": "https://ourcompany.com/privacypolicies"
		},
		"vendors": {
			"title": "Découvrez ci-dessous les partenaires avec lesquels nous travaillons. Développez chacun d’eux pour voir comment ils traitent vos données.",
			"content": "Vous pouvez définir ci-dessous vos préférences de consentement pour chaque partenaire Third-party avec lequel nous travaillons. Développez chaque élément de la liste des entreprises pour voir à quelles finalités elles utilisent les données afin de vous aider à faire vos choix. Dans certains cas, les entreprises peuvent utiliser vos données sans demander votre consentement, sur la base de leurs intérêts légitimes. Vous pouvez cliquer sur les liens de leur politique de confidentialité pour obtenir plus d’informations et vous opposer à ce type de traitement.",
			"privacyPolicyText": "Politique de confidentialité",
			"legIntClaimTitle": "Legal policies",
			"deviceStorageTitle": "Type de stockage:",
			"deviceStorageCookieLifetime": "Durée du cookie: ",
			"deviceStorageOther": "Autres",
			"deviceStorageCookies": "Cookies",
            "googleVendorsDef" : "Fournisseurs de technologies publicitaires Google",
            "domainsDef" : "Liste des domaines", 
            "IABVendorsDef" : "Vendors IAB TCF"
		},
		"others": {
			"title_purpose": "Other categories EN",
			"title_vendors": "Other vendors EN"
		}
	},
	"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" : "Categories de Data",
			"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 special purposes",
			"featureTitle": "Gérer vos features ",
			"specialFeatureTitle": "Gérer vos specialFeatures"
		},
		"purposes": {
			"title": "Gérer vos préférences P",
			"content": "Nos partenaires P et nous déposons des cookie afin d'assurer la sécurité, améliorer votre expérience digitale et afficher des publicités et 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 cookie afin d'assurer la sécurité, améliorer votre expérience digitale et afficher des publicités et contenus personnalisés Vous pouvez accepter ou refuser ces différentes opérations.",
			"privacyPolicyText": "Politique de confidentialité",
			"deviceStorageTitle": "Type de stockage:",
			"legIntClaimTitle": "Legal policies" 
			"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": "Other categories FR",
			"title_vendors": "Other vendors FR"
		}
	},
	"categories": [{
			"name": "Statistiques",
			"ID": "1",
			/* Ajouter "isMandatory": "true" pour bloquer la category sur ON 
			   If you are using sub-categories, only sub can be marked as mandatories */
			"isMandatory": "true",
			"related_vendors": [1],
			"description": "These cookies allow us analyze user behavior on the site, measure and improve performance and the quality of our service."
		},
		{
			"name": "Advertising",
			"ID": "2",
			"related_vendors": [2],
			"description": "These cookies allow us display adverts matching your interests on the websites you visit."
		},
		{
			"name": "Big category",
			"ID": "30",
			"description": "Here you can select the vendors.",
			"subcategories": [{
					"name": "GA",
					"ID": "31",
					"description": "Should we send information to GA.",
				},
				{
					"name": "Xiti",
					"ID": "32",
					"description": "Should we send information to AT Internet.",
				},
				{
					"name": "Vendor3",
					"ID": "33",
					"related_vendors": [1, 2],
					"description": "Should we send information to this vendor3.",
				}
			]
		}
	],
	"vendors": [{ /* list here all the not IAB Vendors */
			"name": "Commanders Act",
			"ID": "1",
			"description": "Allow Commanders Act",
			"privacy_policy": "http://commandersact.com/privacypolicy"
		},
		{
			"name": "Another non IAB Vendor",
			"ID": "2",
			"description": "The desc of another vendor",
			"privacy_policy": "http://anothervendor.free.fr/privacypolicy"
		}
	],
	"categories_fr": [{
			"name": "Statistiques",
			"ID": "1",
			"related_vendors": [1],
			"description": "Avec cette catégorie on remonte les stats.",
		},
		{
			"name": "Pub",
			"ID": "2",
			"related_vendors": [2],
			"description": "Pour afficher de superbes pubs personalisées",
		},
		{
			"name": "Super cat",
			"ID": "30",
			"description": "Une super cat.",
			"subcategories": [{
					"name": "Sous cat 1",
					"ID": "31",
					"description": "Mais on peut choisir que cette sous cat.",
				},
				{
					"name": "Sous cat 2",
					"ID": "32",
					"description": "Ou alors uniquement celle-ci.",
				},
				{
					"name": "Sous cat 3",
					"ID": "33",
					"related_vendors": [1, 2],
					"description": "Ou plus en fait, mais la 3 c'est pareil.",
				}
			]
		}
	],
	"vendors_fr": [{
			"name": "Commanders Act",
			"ID": "1",
			"description": "Permettre à Commanders Act d'envoyer des informations",
			"privacy_policy": "http://commandersact.com/privacypolicy"
		},
		{
			"name": "Autre Vendors",
			"ID": "2",
			"description": "Permettre à cet autre vendor d'envoyer pleins 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 sera affiché ici
{% endhint %}

{% hint style="danger" %}
La date limite de migration est le 20 novembre 2023
{% endhint %}


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.
