OpenX comme destination Audience Manager openx-as-an-audience-manager-destination
Configurez OpenX en tant que destination et envoyez les données de segment Audience Manager à cette plateforme.
Exigences de destination OpenX openx-requirements
Normes relatives à l’emplacement du code, aux formats de valeur clé pris en charge, aux rapports et au type de données de segment envoyées à OpenX.
Consultez les éléments suivants avant de configurer OpenX en tant que destination Audience Manager :
- DIL: le code Data Integration Library doit être déployé sur votre site. DIL permet d’éviter d’écrire du code spécial pour la collecte de données, l’intégration, la lecture des valeurs de cookie et la récupération des données de page.
- Fonction
get_aamCookie: code capture l’ID utilisateur et les données de cookie d’Audience Manager. Placez ce code en haut de la page ou à l’intérieur du bloc de code<head>. - Envoyer les journaux de diffusion à Audience Manager : si vous souhaitez un rapport de diffusion de segment (facultatif), fournissez à Audience Manager un journal quotidien contenant les données de diffusion au niveau de l’impression. Les données peuvent être dans un format brut, mais chaque enregistrement doit contenir le
UUIDAudience Manager. Audience Manager peut les récupérer ou les recevoir via FTP.
Données Clé-Valeur : Exigences De Format
Audience Manager envoie des données sous la forme de paires clé-valeur. Créez des paires clé-valeur selon les spécifications suivantes :
- Clés de préface avec
c.(par exemple,c.colorouc.price). - Séparez les valeurs sérialisées associées à une seule clé par une virgule (par exemple,
c.color = red, green, blue). - Séparez plusieurs paires clé-valeur par une esperluette (par exemple,
c.color=red & c.price = 100 & c.condition = new). - Les noms de clé ne doivent pas contenir de caractères spéciaux tels que des accents, des signes de ponctuation ou d’autres symboles.
Seuls les segments qualifiés sont envoyés à OpenX.
La quantité de données transmises à OpenX dépend du nombre de segments pour lesquels un utilisateur particulier est qualifié. Supposons, par exemple, que vous ayez configuré 100 segments Audience Manager. Si un visiteur ou une visiteuse du site remplit les conditions de cinq d’entre eux, seuls ces cinq segments sont envoyés à OpenX (pas les 100).
Création d’une destination OpenX openx-destination
Créez une destination de cookie pour les OpenX dans Audience Manager.
Dans Audience Manager, une destination désigne tout autre système (serveur publicitaire, DSP, réseau publicitaire, etc.) avec lequel vous souhaitez partager des données. Destination Builder fournit les outils qui vous permettent de créer et de gérer ces processus de diffusion de données. Les fonctionnalités de destination d’Audience Manager se trouvent dans Données d’audience > Destinations. Pour commencer, cliquez sur Add New Destination et suivez les étapes ci-dessous.
Étape 1 : informations de base
Pour remplir la section Basic Information :
- Nommez la destination.
- Sélectionnez “Cookie” dans la liste déroulante Type .
- Cliquez sur Next et passez aux sections Configuration et Segment Mappings .
Étape 2 : informations de configuration
Pour remplir la section Configuration :
- Nom du cookie : donnez un nom court et descriptif à votre cookie.
- Domaine du cookie : laissez ce champ vide pour définir un cookie dans le domaine de la page active de l’utilisateur. Si vous souhaitez spécifier un domaine, ajoutez un préfixe au nom avec un point comme celui-ci,
.mydomain.com. - Choisissez une option de clé dans la section Data Format.
- Si vos clés utilisent des données avec des valeurs sérialisées, sélectionnez le contrôle Serialize et spécifiez le délimiteur de série (caractère qui sépare les valeurs sérialisées).
- Cliquez sur Save et développez la section Segment Mappings .
Étape 3 : Mappages de segments
Pour ajouter un segment à une destination de cookie :
-
Rechercher des segments : la section Segment Mappings propose deux outils de recherche pour localiser les segments. Pour rechercher un segment :
- Option 1 : commencez à saisir un nom de segment dans le champ de recherche. Le champ est automatiquement mis à jour en fonction du texte. Cliquez sur Add une fois que vous avez trouvé le segment à utiliser.
- Option 2 : cliquez sur Browse All Segments pour ouvrir une fenêtre qui vous permet de rechercher des segments par nom ou emplacement de stockage. Cliquez sur Add Selected Segments lorsque vous avez terminé.
-
Ajouter des mappages : dans la fenêtre contextuelle des mappages, saisissez l’identifiant du segment dans le champ Mappages et cliquez sur Save.
-
Cliquez sur Done.
Configuration d’OpenX openx-code-setup
Modifiez OpenX paramètres pour utiliser les données de segment Audience Manager.
Pour configurer OpenX :
-
Installez le code DIL sur l’ensemble de votre site.
-
Créez OpenX comme destination de cookie dans Audience Manager.
-
Placez la fonction
get_aamCookieen haut de la page, idéalement dans le bloc de code<head>. Le codeget_aamCookieest disponible ici. -
Modifiez la balise publicitaire pour appeler la fonction
get_aamCookieet inclure le nom du cookie que vous avez fourni lors de la configuration de la destination OpenX. Par exemple, si vous avez nommé le cookietest_cookie, la balise d’annonce doit appelerget_aamCookieet référencer le nom du cookie. -
Votre balise publicitaire peut ressembler à l’exemple ci-dessous.
code language-none <a href= "https://client.adserver.net/?" + get_aamCookie('test_cookie') + "&etc&xid=" + get_aamCookie('aam_uuid')
N’oubliez pas d’inclure xid= . Il contient l’ID d’utilisateur unique (UUID) transmis lors d’un appel publicitaire.
L’appel publicitaire entièrement formé pourrait ressembler à ceci :
https://client.adserver.net/?c.key1=val1&c.key2=val2&etc& xid =3286487458745343