Flux de curateur

Le flux de curateur Log-Level fournit des données sur les impressions traitées de vos transactions organisées. Le flux contient une ligne par impression transactionnée. Ces données peuvent ensuite être utilisées par les conservateurs pour développer des modèles d’attribution hors connexion puissants, des tableaux de bord et des rapports personnalisés, ainsi que d’autres solutions.

Le nom interne Xandr pour ce flux est curator_feed.

Séquence

Les colonnes ci-dessous sont répertoriées dans le même ordre qu’elles apparaissent dans le fichier de flux au niveau du journal (de haut en bas ici, de gauche à droite dans le fichier).

Précisions/longueurs recommandées des types de données

Dans la table Colonnes ci-dessous, certaines valeurs de la colonne Type contiennent une précision ou une longueur recommandée entre parenthèses. Par exemple, string(100) signifie « cette chaîne est probablement (mais elle n’est pas garantie) inférieure ou égale à 100 caractères ».

Pour les entiers, les tailles sont décrites dans la section Clé d’entier .

Pour numeric les types de données (à virgule flottante), nous vous recommandons d’accepter une précision de (18,6), ce qui signifie que nous prévoyons un total maximal de 18 chiffres : 12 à gauche de la virgule décimale et 6 à droite.

Pour string les types de données, la longueur recommandée du champ varie en fonction du champ. Consultez le tableau ci-dessous.

Avertissement

Il s’agit de recommandations, et non de garanties.

Les types de données sont censés être précis tels qu’ils sont documentés. Toutefois, la précision ou la longueur recommandée pour un type de données donné ne doit pas être lue comme une garantie. Par exemple, la valeur d’une chaîne ou d’une colonne numérique peut dépasser la longueur suggérée ou la précision indiquée sur cette page.

Les recommandations sont destinées à vous aider à créer votre système pour ingérer ces données. Vous devrez peut-être effectuer un traitement supplémentaire sur la sortie du flux de conservateur pour qu’il fonctionne avec votre intégration particulière.

Clé entière

• tinyint = 1 octet (8 bits)
• smallint = 2 octets (16 bits)
• int = 4 octets (32 bits)
• bigint = 8 octets (64 bits)

Columns

Index de colonne	Nom de colonne	Type	Description
01	auction_id_64	Bigint	Identificateur d’enchère unique Xandr.
02	date_time	Heure d’époque UNIX	Heure et date de l’événement (par exemple, 1526057561 qui doit être traduit en Friday, May 11, 2018 4:52:41 PM (UTC)). Consultez event_type pour obtenir la liste des événements.
03	user_tz_offset	Tinyint	Fuseau horaire de l’utilisateur par rapport à l’heure UTC. Utile pour le ciblage daypart.
04	media_type	Tinyint	Style d’affichage général du créatif, classé par sous-type de média. Pour mapper les ID de sous-type multimédia à leur nom et à leurs types de supports parents, utilisez le service De sous-type multimédia. Pour le type de média vidéo, la valeur des creative_width colonnes et creative_height est 1.
05	event_type	enum	Valeurs possibles : - imp = impression - click - served = VAST Creative a été servi - started = VAST Creative a été démarré - skipped = VAST Creative a été ignoré - error = Une erreur s’est produite lors de la lecture de la création VAST - 25_pct = La créativité VAST a joué en continu pendant au moins 25% de la durée totale à une vitesse normale - 50_pct = La créativité VAST a joué en continu pendant au moins 50 % de la durée totale à une vitesse normale - 75_pct = La créativité VAST a joué en continu pendant au moins 75 % de la durée à une vitesse normale - 100_pct = La créativité VAST a été jouée jusqu’à la fin à une vitesse normale de sorte que 100% du créatif a été joué.
06	user_id_64	Bigint	ID utilisateur Xandr 64 bits stocké dans le magasin de cookies Xandr Ce champ est 0 dans les cas suivants : - Xandr n’a pas de correspondance pour cet utilisateur ; Ou - le navigateur de l’utilisateur n’accepte pas les cookies ; Ou - vous n’avez pas de base légale pour accéder aux données personnelles et les traiter pour une impression lorsque le RGPD s’applique Il s’adresse -1 aux utilisateurs non autorisés/non consentants. Remarque : Si vous avez reçu la hashed_user_id_64 version de ce champ, vous ne recevrez pas la version non disponible.
07	hashed_user_id_64	octets	Version hachée de l’ID utilisateur Xandr 64 bits que nous fournirons en tant que proxy dans certains cas où Xandr ne peut pas fournir le réel user_id_64. Vous ne pourrez pas cibler les utilisateurs via leur ID d’utilisateur haché. Toutefois, vous pouvez utiliser cet identificateur pour calculer les utilisateurs uniques, la fréquence des utilisateurs et la récurrence des utilisateurs. Voici un exemple : user_id_64: XXXXXX304391387YYYY hashed_user_id_64: 0000f47b074866470613d9397f0bd7efa78c7adec992aac5e117cbe2d55993a94767 Remarque : Si vous recevez la user_id_64 version de ce champ, vous ne recevrez pas la version hachée.
08	Ip_address	string	Adresse IP de l’utilisateur. Ce champ comporte un maximum de 40 caractères.
09	ip_address_trunc	string	Adresse IP de l’utilisateur avec le dernier octet supprimé. Ce champ comporte un maximum de 40 caractères.
10	country	string	Pays géographique de l’impression. Dérivé de l’adresse IP de l’utilisateur ou fourni par le site associé à l’impression. Utilise les codes pays ISO 3166 .
11	Région	string	Région géographique de l’impression. Dérivé de l’adresse IP de l’utilisateur ou fourni par le site associé à l’impression. Utilise des codes ISO-3166-2 pour les régions américaines et canadiennes, et des codes FIPS pour les régions de tous les autres pays.
12	Dma	int	Spécifie l’ID de la zone de marché désignée pour cette impression. Utilisez le service de zone de marché désignée pour rechercher la zone associée à l’ID.
13	Ville	int	ID de la ville pour cette impression. Dérivé de l’adresse IP de l’utilisateur ou fourni par le site associé à l’impression. Utilisez le service municipal pour rechercher la ville associée à l’ID.
14	postal_code	string	Code postal de l’emplacement de l’utilisateur. Dérivé de l’adresse IP de l’utilisateur ou fourni par le site associé à l’impression. Pour les codes postaux, consultez Postal Code Service.
15	latitude	string	Latitude de l’emplacement de l’utilisateur, lorsque les données GPS sont disponibles à partir d’un appareil mobile. Exprimé au format « snn.ddd,snn.ddd », par exemple +12.345 ou -45.123, où sud est représenté comme négatif. Il peut y avoir un maximum de 5 décimales de précision.
16	latitude_trunc	string	Valeur tronquée (limitée à 3 décimales) de la latitude de l’emplacement de l’utilisateur, lorsque les données GPS sont disponibles à partir d’un appareil mobile. Exprimé au format « snn.ddd,snn.ddd ». Par exemple : - +12.345 ou - -45.123 (où le sud est représenté comme négatif).
17	longitude	chaîne	Longitude de l’emplacement de l’utilisateur, lorsque les données GPS sont disponibles à partir d’un appareil mobile. Exprimé au format « snn.ddd,snn.ddd », par exemple +12.345 ou -45.123, où west est représenté comme négatif. Il peut y avoir un maximum de 5 décimales de précision.
18	longitude_trunc	string	Valeur tronquée (limitée à 3 décimales) de la longitude de l’emplacement de l’utilisateur, lorsque les données GPS sont disponibles à partir d’un appareil mobile. Exprimé au format « snn.ddd,snn.ddd ». Par exemple : - +12.345 ou - -45.123 (où l’ouest est représenté comme négatif).
19	device_unique_id	chaîne	Identificateur unique représentant l’appareil mobile. Le préfixe numérique indique le type d’identificateur d’appareil unique : - 0 = IDFA (IDENTIFIANT Apple pour la publicité) - 1 = SHA1 - 2 = MD5 - 3 = ODIN - 4 = OPENUDID - 5 = AAID (Android Advertising ID) - 6 = WINDOWSADID (ID Microsoft Advertising) - 7 = RIDA (Roky id for Advertising) - 8.9 = AFAI (Amazon Fire OS) - 8.10 = TIFA (Tizen Identifier for Advertising (Samsung Ad ID)) - 8.11 = VIDA (Vizio Advertising ID) - 8.12 = LGUDID (ID d’appareil unique LG)
20	device_type	int	Type d’appareil. Les valeurs possibles sont les suivantes : - 0 = Autres appareils - 1 = Ordinateurs de bureau et ordinateurs portables - 2 = Téléphones mobiles - 3 = Tablettes - 4 = TV - 5 = Console de jeu - 6 = Lecteurs multimédias - 7 = Définir la zone supérieure
21	tc_string	string	La chaîne de transparence et de consentement représente la chaîne du framework de transparence et de consentement IAB . La chaîne est encodée en base 64 url-safe et peut être décodée à l’aide de la spécification technique de transparence et de consentement DU RGPD IAB. La chaîne contient des informations sur les droits, l’utilisation et la confidentialité des données.
22	curated_deal_id	int	ID de la transaction du curateur par le biais duquel l’impression a été traitée.
23	gross_revenue_dollars	Numérique	Montant des dépenses que l’acheteur a envoyées au curateur pour l’impression (y compris les frais de l’acheteur, le cas échéant). Cela est identique au coût média de l’acheteur (sauf que le coût média n’inclut pas les frais de l’acheteur). Il s’agit de la même valeur que curator_revenue dans le rapport d’analyse curator.
24	curator_margin	Numérique	Le bénéfice que le curateur a fait sur la transaction.
25	total_tech_fees_dollars	Numérique	Les honoraires que Xandr a facturés à un conservateur sur l’impression.
26	total_cost_dollars	Numérique	Montant que le curateur a dépensé sur les frais d’échange (à Xandr) et les médias vendeurs pour l’impression. Cela n’inclut pas la marge de curateur ou les frais de curateur. Il s’agit de la même valeur que curator_total_cost dans le rapport d’analyse curator.
27	net_media_cost_dollars	Numérique	Montant que le curateur a dépensé sur le média vendeur pour l’impression. Cela n’inclut pas les frais de curateur ni la marge du curateur (le cas échéant). Il s’agit de la même chose que le chiffre d’affaires brut des vendeurs (qui inclut les frais de vente).
28	seller_member_id	int	ID de membre du vendeur.
29	publisher_id	int	ID de l’éditeur du placement. Le membre conservateur peut mapper l’ID du serveur de publication à un nom à l’aide du service de revente d’inventaire si le vendeur a choisi d’exposer l’éditeur. L’exposition au curateur dépend du profil de visibilité du vendeur.
30	site_id	int	ID du site associé au placement. Ne peut pas être associé à un nom, sauf par le membre vendeur propriétaire du site. L’exposition au curateur dépend du profil de visibilité du vendeur.
31	site_domain	string	Identificateur le plus précis du site que nous pouvons offrir (mais pas le domaine complet). Il peut s’agir du domaine d’un partenaire d’approvisionnement (par exemple, doubleclick.com), du réseau qui possède le stock revendu ou simplement du « stock revendu ». L’exposition au curateur dépend des paramètres de profil de visibilité du vendeur. Ce champ comporte un maximum de 100 caractères.
32	tag_id	int	ID de la balise de placement de l’impression. Ne peut pas être associé à un nom, sauf par le membre vendeur propriétaire de l’étiquette. L’exposition au curateur dépend du profil de visibilité du vendeur.
33	application_id	string	ID de l’application mobile (le cas échéant).
34	mobile_app_instance_id	int	Spécifie l’ID de l’application mobile instance pour cette impression. Utilisez le service d’instance d’application mobile pour rechercher les instance d’application mobile associées à l’ID.
35	buyer_member_id	int	ID de membre de l’acheteur.
36	creative_id	int	ID du créatif servi.
37	brand_id	int	ID de la marque du créatif. Le membre conservateur peut mapper le brand_id à un nom à l’aide du service de marque.
38	deal_id	int	seller_deal_id associé à l’impression, ou 0 si le conservateur a source l’impression à partir de l’échange ouvert.
39	view_result	enum	Résultat de la mesure de la visibilité Xandr de l’impression. Valeurs possibles : - 0 = VIEW_UNKNOWN - 1 = VIEW_DETECTED - 2 = VIEW_NOT_DETECTED - 3 = VIEW_NOT_MEASURABLE - -1 = UNKNOWN Remarque : Pour plus d’informations sur la visibilité, consultez Présentation de l’affichage.
40	view_non_measurable_reason	int	Raison pour laquelle une impression n’a pas pu être mesurée pour la visibilité. Valeurs possibles : - 0 = N/A. L’impression a été mesurée pour la visibilité - 1 = SCRIPT_NOT_SERVED. Le script d’affichage n’a pas été servi avec le créatif. Par exemple, sur l’inventaire des applications mobiles. - 2 = NO_SCRIPT_CALLBACK. Le script d’affichage a été servi avec le créatif, mais aucun rappel/événement n’a été reçu. Par exemple, l’utilisateur a quitté la page avant que la création ne soit servie. - 3 = TECHNICAL_LIMITATION. Le script d’affichage a été servi et chargé, mais n’a pas pu mesurer pour une raison technique. Par exemple, un iframe inter-domaines avec Flash désactivé. - -1 = UNKNOWN. La raison est inconnue. Remarque : Pour plus d’informations sur la visibilité, consultez Présentation de la visibilité.
41	supply_type	enum	Type d’approvisionnement. Valeurs possibles : - 0 = WEB - 1 = MOBILE_WEB - 2 = MOBILE_APP - 5 = BARRE D’OUTILS
42	creative_width	smallint	Largeur du créatif.
43	creative_height	smallint	La hauteur du créatif.
44	partition_time_millis	Heure d’époque UNIX	Partition horaire dans laquelle se trouve une ligne d’enregistrement, représentée sous la forme d’une valeur d’horodatage UNIX Epoch (en millisecondes). Utile pour définir des partitions horaires lors du chargement dans une base de données ou un entrepôt de données. Pour le format Avro, ce champ reçoit le type logique timestamp-millis pour la détection d’horodatage natif. Par exemple, 1568077200000 peut également être représenté comme mardi 10 septembre 2019 1 h 00 (UTC).
45	operating_system	smallint	Système d’exploitation sur lequel l’impression s’est produite. Utilisez le service de système d’exploitation pour rechercher le système d’exploitation associé à l’ID.
46	Navigateur	smallint	Navigateur dans lequel l’impression s’est produite. Utilisez le service de navigateur pour rechercher le navigateur associé à l’ID.
47	language	smallint	Paramètre de langue du navigateur dans lequel l’impression s’est produite. Utilisez le service de langage pour rechercher la langue associée à l’ID.
48	device_id	smallint	Modèle de l’appareil sur lequel l’impression s’est produite. Utilisez le service de modèle d’appareil pour rechercher le modèle d’appareil associé à l’ID.
49	extended_ids	tableau de messages	Liste des ID étendus disponibles dans la vente aux enchères, qu’ils ont ou non influencé spécifiquement la transaction. Pour plus d’informations, consultez le tableau extended_ids ci-dessous.
50	curated_deal_code	Chaîne	curated_deal_code vous permet de recevoir facilement le code que vous avez peut-être rempli sur votre objet de transaction organisée.
51	split_id	int32	ID de la division qui a ajouté l’offre organisée à la vente aux enchères où l’acheteur a acheté l’impression.
52	external_campaign_id	string	Une valeur facultative DSP peut passer dans le champ cid de leur réponse d’offre, où ils peuvent indiquer l’ID d’élément de ligne dans leur système qui a envoyé l’offre. Étant donné que le champ cid est facultatif, le champ external_campaign_id contient uniquement des données lorsque les fournisseurs de services de sécurité cloud externes le renseignent sur leur réponse d’offre. Pour plus d’informations sur le champ cid, consultez la spécification Open RTB .
53	external_bidrequest_id	Bigint	Identificateur unique généré par Microsoft pour la demande d’offre. Les DSP peuvent utiliser cet identificateur pour associer leur réponse d’enchère à une demande d’offre et éventuellement enregistrer l’identificateur de la demande d’offre dans leurs propres données de niveau de journal.
54	external_bidrequest_imp_id	Bigint	Identificateur unique pour l’impression dans la demande d’enchère. Une seule demande d’offre peut avoir plusieurs opportunités d’impression qui ont chacune leur propre ID, ce qui permet aux fournisseurs de services de sécurité d’associer leur réponse d’offre à une impression de demande d’offre et de consigner éventuellement l’identificateur d’impression de la demande d’offre dans leurs propres données de niveau de journal.
55	postal_code_ext_id	int32	États-Unis uniquement. Le code postal américain numérique 9 de l’emplacement de l’utilisateur, au format 12345-1234. Dérivé de l’adresse IP de l’utilisateur ou fourni par le site associé à l’impression. Pour les codes postaux, consultez Postal Code Service.

extended_ids

Index de colonne	Nom de colonne	Type	Description
1	id_type	unsigned 32 bit int	Source de l’identificateur étendu : - 10 = ID du bureau d’échange (ID unifié 1.0) - 11 = ID Criteo - 12 = NetID - 13 = RampID - 15 = UID 2.0
2	id_value	string	Valeur de l’identificateur étendu (par exemple "ID0001"). Remarque : vous ne verrez la valeur de ce champ que si vous avez été autorisé.