

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Fonctions liées à la confidentialité
<a name="privacy-related-functions"></a>

AWS Clean Rooms fournit des fonctions qui vous aident à respecter les spécifications suivantes en matière de respect de la vie privée.
+ **Global Privacy Platform (GPP)** — Spécification de l'Interactive Advertising Bureau (IAB) qui établit un cadre mondial normalisé pour la confidentialité en ligne et l'utilisation des données. Pour plus d'informations sur les spécifications techniques du GPP, consultez la [documentation de la Global Privacy Platform sur GitHub](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform).
+ **Cadre de transparence et de consentement (TCF)** — Élément clé du GPP, lancé en 2020, qui fournit un cadre technique standardisé pour aider les entreprises à se conformer aux réglementations en matière de confidentialité telles que le règlement général sur la protection des données (RGPD) de l'UE. Le TCF permet aux clients d'accorder ou de refuser leur consentement à la collecte et au traitement des données. Pour plus d'informations sur les spécifications techniques du TCF, consultez la [documentation du TCF sur](https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/tree/master/TCFv2). GitHub

**Topics**
+ [

# Fonction consent\$1gpp\$1v1\$1decode
](consent_gpp_v1_decode.md)
+ [

# Fonction consent\$1tcf\$1v2\$1decode
](consent_tcf_v2_decode.md)

# Fonction consent\$1gpp\$1v1\$1decode
<a name="consent_gpp_v1_decode"></a>

La `consent_gpp_v1_decode` fonction est utilisée pour décoder les données de consentement de la Global Privacy Platform (GPP) v1. Il prend la chaîne de consentement codée en entrée et renvoie les données de consentement décodées, qui incluent des informations sur les préférences de confidentialité et les choix de consentement de l'utilisateur. Cette fonction est utile lorsque vous travaillez avec des données qui incluent des informations de consentement GPP v1, car elle vous permet d'accéder aux données de consentement et de les analyser dans un format structuré.

## Syntaxe
<a name="consent_gpp_v1_decode-syntax"></a>

```
consent_gpp_v1_decode(gpp_string)
```

## Arguments
<a name="consent_gpp_v1_decode-arguments"></a>

 *gpp\$1string*   
La chaîne de consentement GPP v1 codée.

## Renvoie
<a name="consent_gpp_v1_decode-returm-type"></a>

Le dictionnaire renvoyé inclut les paires clé-valeur suivantes : 
+ `version`: version de la spécification GPP utilisée (actuellement 1). 
+ `cmpId`: ID de la plateforme de gestion du consentement (CMP) qui a codé la chaîne de consentement. 
+ `cmpVersion`: version du CMP qui a codé la chaîne de consentement. 
+ `consentScreen`: ID de l'écran dans l'interface utilisateur CMP où l'utilisateur a donné son consentement. 
+ `consentLanguage`: Le code de langue des informations de consentement. 
+ `vendorListVersion`: version de la liste des fournisseurs utilisée. 
+ `publisherCountryCode`: le code du pays de l'éditeur. 
+ `purposeConsent`: liste d'entiers représentant les objectifs auxquels l'utilisateur a consenti. 
+ `purposeLegitimateInterest`: Une liste des objectifs IDs pour lesquels l'intérêt légitime de l'utilisateur a été communiqué de manière transparente.
+ `specialFeatureOptIns`: liste d'entiers représentant les fonctionnalités spéciales que l'utilisateur a choisies.
+ `vendorConsent`: liste des fournisseurs IDs auxquels l'utilisateur a donné son accord.
+ `vendorLegitimateInterest`: Liste des fournisseurs IDs pour lesquels l'intérêt légitime de l'utilisateur a été communiqué de manière transparente.

## exemple
<a name="consent_gpp_v1_decode-example"></a>

L'exemple suivant prend un seul argument, qui est la chaîne de consentement codée. Il renvoie un dictionnaire contenant les données de consentement décodées, y compris des informations sur les préférences de confidentialité de l'utilisateur, les choix de consentement et d'autres métadonnées.

```
SELECT * FROM consent_gpp_v1_decode('ABCDEFGHIJK');
```

La structure de base des données de consentement renvoyées comprend des informations sur la version de la chaîne de consentement, les détails de la CMP (Consent Management Platform), le consentement de l'utilisateur et les choix d'intérêts légitimes pour différents objectifs et fournisseurs, ainsi que d'autres métadonnées. 

```
{
    "version": 1,
    "cmpId": 12,
    "cmpVersion": 34,
    "consentScreen": 5,
    "consentLanguage": "en",
    "vendorListVersion": 89,
    "publisherCountryCode": "US",
    "purposeConsent": [1],
    "purposeLegitimateInterests": [1],
    "specialFeatureOptins": [1],
    "vendorConsent": [1],
    "vendorLegitimateInterests": [1]}
}
```

# Fonction consent\$1tcf\$1v2\$1decode
<a name="consent_tcf_v2_decode"></a>

La `consent_tcf_v2_decode` fonction est utilisée pour décoder les données de consentement du Transparency and Consent Framework (TCF) v2. Il prend la chaîne de consentement codée en entrée et renvoie les données de consentement décodées, qui incluent des informations sur les préférences de confidentialité et les choix de consentement de l'utilisateur. Cette fonction est utile lorsque vous travaillez avec des données qui incluent des informations de consentement TCF v2, car elle vous permet d'accéder aux données de consentement et de les analyser dans un format structuré.

## Syntaxe
<a name="consent_tcf_v2_decode-syntax"></a>

```
consent_tcf_v2_decode(tcf_string)
```

## Arguments
<a name="consent_tcf_v2_decode-arguments"></a>

 *tcf\$1string*   
La chaîne de consentement TCF v2 codée.

## Renvoie
<a name="consent_tcf_v2_decode-return-type"></a>

La `consent_tcf_v2_decode` fonction renvoie un dictionnaire contenant les données de consentement décodées à partir d'une chaîne de consentement TCF (Transparency and Consent Framework) v2. 

Le dictionnaire renvoyé inclut les paires clé-valeur suivantes : 

**Segment principal**
+ `version`: version de la spécification TCF utilisée (actuellement 2). 
+ `created`: date et heure de création de la chaîne de consentement.
+ `lastUpdated`: date et heure de dernière mise à jour de la chaîne de consentement.
+ `cmpId`: ID de la plateforme de gestion du consentement (CMP) qui a codé la chaîne de consentement. 
+ `cmpVersion`: version du CMP qui a codé la chaîne de consentement. 
+ `consentScreen`: ID de l'écran dans l'interface utilisateur CMP où l'utilisateur a donné son consentement. 
+ `consentLanguage`: Le code de langue des informations de consentement. 
+ `vendorListVersion`: version de la liste des fournisseurs utilisée. 
+ `tcfPolicyVersion`: version de la politique TCF sur laquelle est basée la chaîne de consentement.
+ `isServiceSpecific`: valeur booléenne indiquant si le consentement est spécifique à un service en particulier ou s'applique à tous les services.
+ `useNonStandardStacks`: valeur booléenne indiquant si des piles non standard sont utilisées.
+ `specialFeatureOptIns`: liste d'entiers représentant les fonctionnalités spéciales que l'utilisateur a choisies.
+ `purposeConsent`: liste d'entiers représentant les objectifs auxquels l'utilisateur a consenti. 
+ `purposesLITransparency`: Une liste d'entiers représentant les objectifs pour lesquels l'utilisateur a exprimé un intérêt légitime en termes de transparence.
+ `purposeOneTreatment`: valeur booléenne indiquant si l'utilisateur a demandé le « traitement dans un seul but » (c'est-à-dire que tous les objectifs sont traités de la même manière).
+ `publisherCountryCode`: le code du pays de l'éditeur. 
+ `vendorConsent`: liste des fournisseurs IDs auxquels l'utilisateur a donné son accord.
+ `vendorLegitimateInterest`: Liste des fournisseurs IDs pour lesquels l'intérêt légitime de l'utilisateur a été communiqué de manière transparente.
+ `pubRestrictionEntry`: liste des restrictions imposées aux éditeurs. Ce champ contient l'ID d'objectif, le type de restriction et la liste des fournisseurs concernés IDs par cette restriction d'objectif.

**Segment de fournisseurs divulgué**
+ `disclosedVendors`: liste d'entiers représentant les fournisseurs qui ont été divulgués à l'utilisateur.

**Segment destiné aux éditeurs**
+ `pubPurposesConsent`: une liste d'entiers représentant les objectifs spécifiques à l'éditeur pour lesquels l'utilisateur a donné son consentement.
+ `pubPurposesLITransparency`: une liste de nombres entiers représentant les objectifs spécifiques à l'éditeur pour lesquels l'utilisateur a fait preuve de transparence en matière d'intérêts légitimes.
+ `customPurposesConsent`: liste d'entiers représentant les objectifs personnalisés pour lesquels l'utilisateur a donné son consentement.
+ `customPurposesLITransparency`: Une liste d'entiers représentant les objectifs personnalisés pour lesquels l'utilisateur a accordé la transparence à ses intérêts légitimes.

Ces données de consentement détaillées peuvent être utilisées pour comprendre et respecter les préférences de confidentialité de l'utilisateur lorsqu'il travaille avec des données personnelles.

## exemple
<a name="consent_tcf_v2_decode-examples"></a>

L'exemple suivant prend un seul argument, qui est la chaîne de consentement codée. Il renvoie un dictionnaire contenant les données de consentement décodées, y compris des informations sur les préférences de confidentialité de l'utilisateur, les choix de consentement et d'autres métadonnées.

```
from aws_clean_rooms.functions import consent_tcf_v2_decode

consent_string = "CO1234567890abcdef"
consent_data = consent_tcf_v2_decode(consent_string)

print(consent_data)
```

La structure de base des données de consentement renvoyées comprend des informations sur la version de la chaîne de consentement, les détails de la CMP (Consent Management Platform), le consentement de l'utilisateur et les choix d'intérêts légitimes pour différents objectifs et fournisseurs, ainsi que d'autres métadonnées. 

```
    /** core segment **/
    version: 2,
    created: "2023-10-01T12:00:00Z",
    lastUpdated: "2023-10-01T12:00:00Z",
    cmpId: 1234,
    cmpVersion: 5,
    consentScreen: 1,
    consentLanguage: "en",
    vendorListVersion: 2,
    tcfPolicyVersion: 2,
    isServiceSpecific: false,
    useNonStandardStacks: false,
    specialFeatureOptIns: [1, 2, 3],
    purposeConsent: [1, 2, 3],
    purposesLITransparency: [1, 2, 3],
    purposeOneTreatment: true,
    publisherCountryCode: "US",
    vendorConsent: [1, 2, 3],
    vendorLegitimateInterest: [1, 2, 3],
    pubRestrictionEntry: [
        { purpose: 1, restrictionType: 2, restrictionDescription: "Example restriction" },
    ],

    /** disclosed vendor segment **/
    disclosedVendors: [1, 2, 3],

    /** publisher purposes  segment **/
    pubPurposesConsent: [1, 2, 3],
    pubPurposesLITransparency: [1, 2, 3],
    customPurposesConsent: [1, 2, 3],
    customPurposesLITransparency: [1, 2, 3],
};
```