Cette section décrit les paramètres qui améliorent la monétisation ou qui sont requis par diverses autorités et organes directeurs. Ces paramètres doivent être envoyés en plus des paramètres nécessaires pour chaque service et décrits ailleurs dans le présent document (c’est-à-dire que ces paramètres ne remplacent pas les paramètres propres au service).
Jeton partenaire
Voir également : Jeton d’accès.
Afin d'empêcher la réutilisation indésirable des paramètres par des parties non autorisées, Triton Digital recommande de rassembler tous les paramètres dans un « jeton partenaire » (partnertok ou X-Partner-Token). Le brouillage des données renforce également la protection de la vie privée des utilisateurs en bout de ligne.
Le format du jeton partenaire est documenté dans la Spécification du jeton sécurisé Triton Digital. Vous aurez besoin d’une clé privée pour signer le jeton ; une clé unique est attribuée à chaque éditeur ou partenaire. Veuillez contacter l’assistance client de Triton Digital pour obtenir votre clé privée.
Le jeton partenaire peut être fourni de deux façons différentes :
Dans la chaîne de requête HTTP : utilisez le paramètre du jeton partenaire.
Dans l’en-tête HTTP : utilisez l’en-tête jeton partenaire X.
En reprenant l'exemple de la spécification du jeton sécurisé, le paramètre résultant dans une chaîne de requête serait :
partnertok=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImtpZCI6ImExYjJjM2Q0ZTUifQ.eyJpc3MiOiJwZHZ5Iiwic3ViIjoiZm9vQGJhci5jb20iLCJpYXQiOjE0Mjk4MDI3MTYsInRkLXJlZyI6dHJ1ZX0.YeNcfr7Rcpv4P8Tu6Y2bRuGqYUGQM0lHjyK_nD8SWKA
Il est préférable d’utiliser un en-tête HTTP/HTTPS pour éviter la mise en cache et d’éventuels problèmes de troncature si l’URL obtenue est trop longue.
Une fois qu’un jeton partenaire est généré, il est valide pendant 24 heures. Cette valeur a été choisie pour éviter de générer le jeton trop souvent, ce qui retarderait l’accès au contenu, détériorant ainsi l’expérience utilisateur.
Sinon, les paramètres peuvent être fournis en texte clair directement dans la chaîne de requête HTTP comme paramètres indépendants.
Identification de l'auditeur
Notez qu’une gestion correctement implémentée des identifiants d’auditeur est nécessaire afin de cibler correctement les impressions « adressables » (intelligentes) dans Yield-Op.
Voir aussi : Gestion des identifiants auditeurs.
Triton Digital prend en charge les types spécifiques suivants d'identifiants d'auditeur :
Paramètre | Description | Valeur |
|---|---|---|
lsid | Identifiant principal de l'utilisateur pour Triton Digital à utiliser comme base pour les mesures et le plafonnement des fréquences. Ce paramètre est recommandé. Reportez-vous à la section Gestion des identifiants auditeurs. pour obtenir plus de détails sur l’utilisation. | Chaîne Caractères alphanumériques, y compris la liste suivante de caractères spéciaux :
|
ppid | Identifiant auditeur fourni par l’éditeur. Chaîne encodée en URL. | Comme ci-dessus. |
idfa | Identifiant Apple pour les annonceurs publicitaires. (À utiliser uniquement si l'utilisateur n'a pas activé l'option « limiter le suivi des publicités »). | Comme ci-dessus. |
gaid | Identifiant publicitaire Android. (À utiliser uniquement si l’utilisateur n’a pas activé l’option « Se retirer de la publicité basée sur les intérêts ».) | Comme ci-dessus. |
rida | Identifiant Roku. | Comme ci-dessus. |
aifa | Identifiant Amazon Ads. | Comme ci-dessus. |
msai | Identifiant Microsoft. | Comme ci-dessus. |
app | Identifiant généré par l'application. | Comme ci-dessus. |
cookie | Identifiant basé sur les cookies (généré par le serveur). Celui-ci utilise un cookie HTTP et ne nécessite pas de prise en charge spécifique de la part du lecteur. | Comme ci-dessus. |
<vendor>-uid | Identifiant étendu pour l'entreprise mentionnée dans <vendor>. | Comme ci-dessus. |
Informations de l'auditeur
Des informations supplémentaires sur l’auditeur peuvent être fournies via les paramètres suivants :
Paramètre | Description | Valeur |
|---|---|---|
lat | Latitude de l'emplacement actuel de l'auditeur. Voir la Remarque 1 ci-dessous. | Valeur de point flottant : -90.0 à 90.0 |
long | Longitude de l'emplacement actuel de l'auditeur. Voir la Remarque 1 ci-dessous. | Valeur de point flottant : -180.0 à 180.0 |
age | Âge de l'auditeur, selon les informations obtenues lors de l'enregistrement de l'auditeur. | Valeur en chiffres entiers : de 1 à 125 |
sexe | Sexe de l'auditeur, selon les informations obtenues lors de l'enregistrement de l'auditeur. | “m » ou « f » ou « o » pour homme, femme ou autre (sensible à la casse) |
postalcode | Code postal du lieu de résidence de l'auditeur, selon les informations obtenues lors de l'enregistrement de l'auditeur. Voir la Remarque 2 ci-dessous. | Code postal valide. Par exemple, 91403 ou H3G 1R8 |
country (pays) | Code pays du lieu de résidence de l'auditeur, selon les informations obtenues lors de l'enregistrement de l'auditeur. Voir la Remarque 2 ci-dessous. | Code pays à deux lettres, utilisant les normes ISO 3166-1 alpha-2 (exemple : US) |
Remarque 1
La latitude et la longitude doivent être fournies ensemble (si vous en spécifiez une, vous devez spécifier les deux). Quand ils spécifient la latitude/longitude, les clients/lecteurs doivent utiliser la plus grande précision raisonnable, en fonction de l’appareil, de la plateforme et de l’utilisation de la batterie. (Nous suggérons une précision de 100 mètres).
Remarque 2
Le code postal et le pays doivent être fournis ensemble.
Réglementaire
fin de rendre la communication et la transparence conformes aux pratiques du sacteur en ce qui concerne le consentement de vos utilisateurs finaux et la base juridique du traitement des informations personnelles, tous les éditeurs doivent mettre en œuvre, dans la mesure où cela est applicable en fonction de la juridiction juridique pertinente pour les opérations, les paramètres suivants pour passer les instructions codant ce consentement :
Paramètre | En-tête HTTP | Description | Valeur |
|---|---|---|---|
gpp * | X-gpp (en anglais seulement) | Chaîne GPP permettant la transmission de signaux de confidentialité, de consentement et de choix du consommateur. La chaîne doit être conforme à la spécification IAB Tech Lab Global Privacy Platform. | Chaîne GPP encodée en base 64 sécurisée par URL. |
gpp_sid * | X-gpp-sid | L’identifiant de la section indique quelle règle (c’est-à-dire la section de la chaîne GPP) est considérée comme « en vigueur ». | Chiffre entier |
RGPD * | Drapeau indiquant si le Règlement général sur la protection des données (RGPD) s'applique. Le RGPD a été établi par le Parlement européen et le Conseil de l'Union européenne. | 0 = Le RGPD ne s’applique pas 1 = Le RGPD s’applique | |
gdpr_consent * | X-gdpr-consent | La chaîne de transparence et de consentement du RGPD résume les détails pertinents sur la manière dont la transparence et le consentement ont été établis. La chaîne doit être conforme aux spécifications du cadre de transparence et de consentement de l'IAB. | Chaîne de consentement RGPD codée en base64 et sécurisée par URL. |
us_privacy | La U.S. Privacy String qui indique si la U.S. Privacy Regulations (réglementation américaine sur la protection de la vie privée) s'applique ou non au consommateur, si une divulgation légale explicite a été établie avec le consommateur et si ce dernier a choisi de ne pas vendre ses données personnelles. La version 1 ne prend en charge que les signaux relatifs à la CCPA (loi californienne sur la protection de la vie privée des consommateurs). La chaîne doit être conforme au format de l'U.S. Privacy String. | Chaîne | |
coppa | Drapeau indiquant si la réglementation Children's Online Privacy Protection Act (COPPA) s'applique. La COPPA a été établie par la U.S. Federal Trade Commission. | 0 = Les restrictions de la COPPA ne s’appliquent pas 1 = Les restrictions de la COPPA s’appliquent |
* Conformément au RGDP, Triton Digital est est un vendeur enregistré et approuvé dans le cadre de la Global Vendor List (GVL) TCF v2.0. tenue par l'Interactive Advertising Bureau Europe (IAB Europe). L'ID du fournisseur GVL de Triton Digital est 239.
Informations sur l'appareil/lecteur
Paramètre | Description | Valeur |
|---|---|---|
dist | Ce paramètre sert à identifier le canal de distribution. (c'est-à-dire la propriété numérique où l'auditeur a accédé au contenu audio.) | Chaîne. N'importe quelle chaîne de caractères peut être saisie. La limite de caractères est de 50. |
banners | Drapeau capacité de bannière. Ce paramètre sert actuellement à l'analyse statistique de Triton Digital, mais il devrait bientôt avoir un rôle plus direct. | Chaîne : liste des bannières prises en charge séparées par des virgules. Par exemple : banners=728x90,300x250 |
Omid | Indicateur révélant si le lecteur prend en charge l'API de l'Open Measurement Interface Definition (généralement via l'OMSDK), et quelle version. Ce paramètre ne peut être fourni que via le jeton partenaire. | 0 = OMID n'est pas pris en charge 1 = OMID 1.0 est pris en charge |
store-identifiant | Réservé à l'inventaire pour application mobile Identificateur de l'app store pour une application installée, utilisé pour localiser l'application dans le store en question. Exemple pour iTunes : store-identifiant=726533955 Exemple pour Google Play : store-identifiant=com.tritondigital.tritonradio Ce paramètre est requis par les acheteurs programmatiques afin de vérifier que Triton Digital est autorisé à vendre votre inventaire à l’aide du système app-ads.txt . | Chaîne |
forfait-identifiant | Réservé à l'inventaire pour application mobile, si nécessaire. L'identifiant de l'application est unique à l'application et ne dépend pas de l'app store où elle a été distribuée. Sur Android et iOS, il doit s’agir d’un nom d'ensemble (par exemple, com.tritondigital.tritonradio). | Chaîne |
store-url | Réservé à l'inventaire pour application mobile URL de l'App Store pour une application installée qui effectue la requête publicitaire/la connexion au flux. La chaîne doit être encodée en URL. Exemple :
Ce paramètre est requis par les acheteurs programmatiques afin de vérifier que Triton Digital est autorisé à vendre votre inventaire à l’aide du système app-ads.txt . | URL encoded string of a URL. |
agent | L'agent/le lecteur (logiciel) spécifique utilisé pour lire le flux audio/fichier. | Chaîne. Pour obtenir des valeurs valides pour votre agent/lecteur, contactez votre gestionnaire de compte Triton Digital. |
agent-family | Le type/la famille qui décrit le mieux un agent ou un lecteur spécifique. | Chaîne. Les valeurs valides sont : browser |
agent-device | L'appareil (matériel) spécifique utilisé pour lire le flux audio/fichier. Quoique facultatif, Triton Digital vous recommande de l'utiliser, car l'appareil ne peut pas toujours être dérivé correctement de l'en-tête « agent d'utilisateur » par défaut. | Chaîne.
|
agent-device-family | Le type/la famille qui décrit le mieux un appareil spécifique. | Chaîne.
|
agent-os | Le système d'exploitation utilisé pour lire le flux audio/fichier. Quoique facultatif, Triton Digital vous recommande de l'utiliser, car le système d'exploitation ne peut pas toujours être dérivé correctement de l'en-tête « agent d'utilisateur ». | Chaîne.
|
Les paramètres de l’appareil/du lecteur basés sur un agent peuvent être vérifiés à l’aide des validateurs répertoriés dans les règles de ciblage de formatage du document API de réservation et de disponibilité de Triton Digital, sous Ciblage par auditeur - Lecteur/appareil.
Ciblage personnalisé
Les éditeurs qui souhaitent séparer leur inventaire en segments personnalisés peuvent utiliser les paramètres suivants.
Paramètre | En-tête HTTP | Description | Valeur |
|---|---|---|---|
csegid | Identifiant de segment personnalisé. Avant d'utiliser ce paramètre, veuillez contacter l'assistance client de Triton Digital afin d'activer le ciblage par identifiant de segment personnalisé sur votre compte. Actuellement, le ciblage d'identifiant de segment personnalisé fonctionne uniquement avec la publicité Tap (pas pris en charge par Yield-Op). | Valeur en chiffres entiers : de 1 à 1000000 | |
ttag | X-ttag | Balises de ciblage personnalisées que vous pouvez faire correspondre indépendamment dans TAP ou Yield-Op. Nous conseillons d'envoyer une liste de balises séparées par des virgules, avec un format comme Exemple : Notez que l'utilisation d'une liste de balises séparées par des virgules et de paires Voir l'Exemple d'utilisation de TTag. | Caractères alphanumériques et symboles UTF-8. Notez que « & » et « = » ne sont pas des caractères valides. |
dmp-segments | X-dmp-segments | Identificateurs pour segments DMP auxquels appartiennent les auditeurs. | Liste CSV des idenficateurs des segments. Par exemple : |
N/A. | X-DMP-Segment-IDs | Identificateurs pour segments DMP auxquels appartiennent les auditeurs. Cette version du paramètre segments n’est utilisée que pour les intégrations DMP spécifiques qui utilisent le lecteur et/ou le SDK. Pour plus d'informations sur quand et comment utiliser cette fonctionnalité, nous vous invitons à contacter votre responsable de la réussite client Triton Digital. Ce paramètre n’est pas pris en charge dans le jeton partenaire ou la chaîne de requête HTTP. | Nom de la DMP (par exemple, « dmp_1_name ») et identifiants de segment séparés par des virgules (par exemple, 123,234,345). Exemple pour l’audience DMP Blork avec les identifiants de segment 1234 et 5678 : et DMP ACME Segmenter avec les identifiants de segment 4321 et 8765 : {"blork_audience":[1234,5678], "acme_segmenter":[4321,8765]} |
Exemple d'utilisation de TTag
Vous disposez maintenant d'un lecteur personnalisé et intégré au tableau de bord pour les véhicules motorisés. Vous définissez le type de véhicule dans le lecteur avec des TTags personnalisés afin que les campagnes publicitaires dans Tap puissent cibler ce véhicule. Si, par exemple, votre lecteur se trouve dans un SUV Ford à quatre roues motrices, vous pouvez créer les TTags personnalisés suivants :
ttag=vehicle:ford
ttag=vehicle:4wd
ttag=vehicle:SUV
Paramètre de l'exemple ci-dessus :
ttag=vehicle:ford,vehicle:4wd,vehicle:SUV
Ainsi, le lecteur acceptera les publicités des campagnes Tap qui ciblent :
Tous les véhicules Ford.
Tous les véhicules à quatre roues motrices.
Tous les SUV.
Plus particulièrement les véhicules Ford à quatre roues motrices.
Plus précisément les SUV Ford.
Plus spécifiquement les SUV Ford à quatre roues motrices.
Il n’acceptera ni le ciblage spécifique d’autres marques de véhicules ni celui de véhicules Ford à deux roues motrices, etc.
Conseil (Streaming Radio)
Si vous pouvez accéder au système automatique de diffusion radio de votre station, vous pouvez utiliser des marqueurs/déclencheurs de métadonnées de ciblage de contenu pour cibler vos vagues TAP sur un contenu spécifique de streaming en direct. Pour plus d’informations, consultez l’article de la base de connaissances Triton Digital, Comment utiliser les marqueurs temporels de ciblage de contenu pour cibler une émission en direct.