TECH DOCS
UTILISATION DE L'IDENTIFIANT FIRST-ID
Maintenant que vous avez implémenté la solution first-id, vous aurez sans doute besoin de le transmettre à certains partenaires publicitaires ou à des outils internes. Voici ci-dessous quelques exemples d'intégration fréquentes. N'hésitez pas à nous contacter si besoin à l'adresse email support@first-id.fr
⚠️ IMPORTANT ⚠️
les codes fournis sur ces pages sont fournis tel quel, sans aucune garantie, expresse ou induite. En aucun cas First-id ne pourra être tenu responsable en cas de réclamation, dommages, mises à jour ou autre responsabilité. il est de vôtre responsabilité que le code utilisé fonctionne correctement sur vos supports.
⚠️ IMPORTANT ⚠️
il est important de vous mettre en relation avec votre contact chez first-id avant de procéder à l'envoi de l'identifiant à un partenaire externe qui ne serait pas prévu dans les termes de votre contrat first-id
Comment récupérer la valeur de l'id first-id
💡 TIP : Vous pouvez utiiser notre SDK pour simplifier la récupération de l'id first-id. Voir la documentation
First-id étant déposé dans un cookie first-party, vous pouvez récupérer sa valeur facilement afin de l'utiliser pour toute intégration tierce future, comme une DMP, google PPID, les modules d'identity prebid, etc. Nous listons ci-dessous les intégrations dont vous pourriez avoir besoin.
Voici un code javascript basique que vous pouvez adapter à votre convenance, et qui vous retournera la valeur du cookie first-id dans la console de votre navigateur :
const GetCookie = {
get: name => {
let pattern = new RegExp(`(?:(?:^|.*; *)${name} *= *([^;]*).*$)|^.*$`, 'i');
let c = document.cookie.match(pattern)[1];
if (c) return decodeURIComponent(c);
}
}
console.log("My First-id ==> " + GetCookie.get('firstid'));
UTILISATION DANS VOTRE ADSERVER
Votre adserver est Google Ad Manager : Google PPID
⚠️ IMPORTANT ⚠️
il est important de vous mettre en relation avec votre contact chez Google avant de procéder à l'envoi de l'identifiant sur la fonctionnalité ppid, cette dernière pouvant être soumise à des obligations contractuelles de l'adserver.
La valeur du cookie first-id peut être passée au PPID Google si vous utilisez GAM en temps qu'adserver
Merci de vous référer à la documentation officielle du support Google pour plus d'informations et de détails sur l'intégration.
Pour les sites web, utilisez la méthode PublisherProvidedId :
dans votre implémentation du Google Publisher Tag, vous devez ajouter cette fonction googletag.pubads().setPublisherProvidedId comme décrit dans l'exemple ci-dessous avec la valeur du cookie first-id
<script type = "text/javascript" >
googletag.pubads().setPublisherProvidedId('650349c9714c95f857f63dbd089683c3');
googletag.enableServices();
</script>
Détails pour la méhode pubService
pubService.setPublisherProvidedId(identifier)
Cette méthode définit les valeurs du publisher Provided ID qui est utilisé pour le capping et les activité basées sur l'audience dans GAM
Paramètres :
string identifiant: Un ID alphanumérique fournit par l'éditeur avec un nombre maximum de 150 caractères (32 pour first-id)
💡 TIP : Si vous utilisez un lecteur video avec le SDK IMA html5, merci de vous reporter à cette documentation du support Google pour passer la valeur du cookie First-id au SDK.
💡 TIP : L'installation/utilisation de notre SDK peut grandement simplifier la récupération de l'identifiant first-id afin de le passer à votre adserver.
⚠️ IMPORTANT ⚠️
il est important de vous mettre en relation avec votre contact chez Xandr avant de procéder à l'envoi de l'identifiant sur la fonctionnalité ppid, cette dernière pouvant être soumise à des obligations contractuelles de l'adserver.
apntag.setPageOpts({
member: 958,
user: {
age: 25,
externalUid: '10',
userIds: [
{
"type": "extendedIDs",
"eids": [{
"id": "650349c9714c95f857f63dbd089683c3",
"source": "first-id.fr"
}]
}, // publisher first party IDs
],
Votre adserver est Xandr : Xandr PPID (alpha)
La valeur du cookie first-id peut être passée à votre implémentation adserver via le PPID Xandr si vous utilisez Xandr en temps qu'adserver
Merci de vous référer à la documentation officielle du support Xandr pour plus d'informations et de détails sur l'intégration.
Dans le cas précis de first-id, voilà ce à quoi l'intégration doit ressembler le paramètre optionnel du tag Xandr :
💡 TIP : L'installation/utilisation de notre SDK peut grandement simplifier la récupération de l'identifiant first-id afin de le passer à votre adserver.
UTILISATION DANS VOTRE WRAPPER PREBID
💡 TIP : Si vous ne gérez pas vous même votre wrapper prebid, il est possible qu'une adaptation soit nécessaire auprès de votre techno de wrapper afin de récupérer correctement l'identifiant first-id pour le passer correctement dans Prebid. Nous pourrons prendre contact avec votre prestataire afin qu'i effectue les développements nécessaires.
PubProvidedId
⚠️ IMPORTANT ⚠️
il est important de vous mettre en relation avec votre contact chez first-id avant de procéder à l'envoi de l'identifiant à un partenaire externe qui ne serait pas prévu dans les termes de votre contrat First-id
Le module PubProvided ID permet aux éditeurs de passer un identifiant first party dans le bid stream de leur intégration Prebid. C'est la méthode préférée pour passer l'identifiant first-id aux bidders prebid ayant des accords avec First-id.
Le module supporte une fonction définie par l'utilisateur qui génère un objet de type eids :
Ou bien, les valeurs eids euvent etre passées directement dans l'appel du setConfig :
Dans les deux cas, les bids adapters recevront l'id après que le consentement ait été validé.
Ce design autorise la mise en palce de plusieurs uiids dans l'objet eids. Vous travaillez déjà peut être avec d'autres providers d'ids, mais vous pouvez inclure l'identifiant first-id dans le même objet eids.
l'extension "source-type eids.uids.ext.stype " aide les entités en aval de la bid request à identifier la donnée. Pour first-id, le source-type à utiliser est :
Les bid adapters qui écoutent userIds.pubprovidedId ne recevront pas une string. Merci d'utiliser la valeur/fonction userIdAsEids pour retourner l'id comme une string.
Pour utiliser PubProvidedId, ajoutez-le à votre package prebid.js :
Configuration de PubProvidedId pour first-id :
Nom | Scope | Type | Description | Example |
|---|---|---|---|---|
uids.ext.stype | Optional | String | Description de comment es généré l'id et par qui | ppuid
|
uids.atype | Optional | int | ADCOM - Type de user agent correspondant | "1" |
params.eidsFunction | Optional | function | n'importe quelle fonction sur la page | getIdsFn() |
params | Optional | Object | Details for syncing. | |
Nom | Obligatoire | String | Valeur de L'ID pour le Module | "PubProvided" |
UTILISATION DANS VOTRE DMP
DMP 1plusX
💡 TIP : L'installation/utilisation de notre SDK peut grandement simplifier la récupération de l'identifiant first-id afin de le passer à votre DMP.
Tout d'abord, récupérez l'identifiant first-id à l'aide de notre sdk javascript (grâce aux méthodes documentées ici)
Vous pouvez ensuite ajouter cette valeur au SDK oneplusX appelé sur vos pages, cela permettra à 1plusX de récupérer l'id :
ope("[[clientID]]", "syncIds", ["firstID:c61f9ef05a94c77d9c3bddb7ab6fb2ed"]);
💡 TIP : [clientID] doit être remplacé par votre propre id editeur fourni par 1plusX, et la valeur en gras par celle de l'indentifiant first-id récupérée
Vous trouverez plus d'informations concernant l'intégration du SDK sur la documentation 1plusX
DMP Permutive
Comment activer la collecte de l'identifiant first-id via le dashboard Permutive
Pour voir les différents identifiants, suivez ces étapes :
-
Naviguez vers le dashboard de votre espace de travail
-
sur la gauche, sélectionnez 'Settings'
-
en haut, sélectionnez l'onglet 'Identifiants'
Pour ajouter les identifiants First-id, suivez ces étapes :
-
Naviguez vers le dashboard > 'settings' > 'Identifiers'
-
Selectionnez 'Ajoutez un identifiant' (les boutons rouges et verts fonctionnent tous les deux)
-
Ajoutez le tag pour l'identifiant first-id. Cliquez sur OK, c'est terminé.
Mettre en place le collecteur JavaScript pour router les identifiants vers Permutive
💡 TIP : L'installation/utilisation de notre SDK peut grandement simplifier la récupération de l'identifiant first-id afin de le passer à votre DMP.
⚠️ IMPORTANT ⚠️ Ce code est fourni tel quel, sans aucune garantie, expresse ou induite. En aucun cas Permutive ou First-id ne pourra être tenu responsable en cas de réclamation, dommages, mises à jour ou autre responsabilité. il est de vôtre responsabilité que le code utilisé fonctionne correctement sur vos supports.
Exemple de code :
Merci de vous référer à la documentation sur le site de Permutive
DMP Mediarithmics
La récupération des identifiants first-id ne nécessite pas de modification de l'intégration médiarithmics déjà en place sur le site de l'éditeur. L'activation de la collecte se fait directement dans l'interface "Navigator" de Mediarithmics.
Pour connaitre la méthode à suivre, référez vous à la documentation sur le site Mediarithmics
Widget Outbrain
⚠️ IMPORTANT ⚠️
il est important de vous mettre en relation avec votre contact chez first-id avant de procéder à l'envoi de l'identifiant à un partenaire externe qui ne serait pas prévu dans les termes de votre contrat first-id
Les widgets Outbrain incluent un paramètre data-ob-user-id que vous pouvez utiliser pour passer l'identifiant first-id qui sera reconnu comme tel par Outbrain
L'intégration ressemble à cela :
La valeur de data-ob-user-id devra être remplacée par la valeur du cookie firstid s'il est présent sur la page.
Installation du bidder First-id
Étape 1 : définition des emplacements publicitaires
La première étape coté éditeur consiste à fournir à first-id la liste de ses placements publicitaires disponibles par site et les tailles/formats qu'ils acceptent. Il est important de préciser quel type de découpe vous avez l'habitude d'utiliser, par device notamment (desktop / mobile / tablette...).
À partir de cette liste, nous allons créer les emplacements nécessaires à l'intégration du bidder sur vos emplacements publicitaire, en vous fournissant une liste d'id correspondant à votre découpage publicitaire.
Étape 2 : installation du bidder pour votre build prebid
💡 TIP : vous aurez beson de la version 7.35 de Prebid ou ultérieur pour installer le bidder
Téléchargez l'adapter "nexx360" en suivant ce lien
💡 TIP : Il est inutile de mettre en place un alias "first-id" pour le nom du bidder, cet alias étant déjà présent dans l'adapter nexx360
Si vous avez choisi d'envoyer tous les bids à votre adserver, il est nécessaire de mettre en place des jeux de line items supplémentaires avec comme target key-value la valeur de l'alias. Dans notre cas :
hb_pb_first-id
hb_adid_first-id
hb_size_first-id
hb_deal_first-id
Il vous faut ensuite mettre à jour vos placements publicitaires avec les ids fournis par first-id, comme toute autre intégration prebid.
Voici un exemple de configuration d'un adunit configuré avec l'adapter first-id :
💡 TIP : vous devez remplacer la valeur du paramètre tagId ("xxxxxxxx") dans le script ci-dessus par les données fournies par first-id
Facultatif : dans les params vous pouvez settez l'account id first-id comme suit >> account: '1101')
TCF vendor
Si vous utilisez le bidder Prebid first-id, il est nécessaire d'intégrer notre vendor dans votre CMP.
Le numéro de Vendor IAB de first-id est 1178. A voir ici
ads.txt
Voici les lignes qui doivent être présentes dans votre ads.txt afin que les enchères vers le bidder first-id puisse fonctionner :
Copyright First-id 2023 - all rights reserved
