Partager via

Science des données Toolkit - Flux d’incrémentisation au niveau du journal

Le flux d’incrémenticité Log-Level fournit des données sur les impressions affichées à une audience réparties de manière aléatoire entre un groupe de test (le groupe exposé à des publicités) et un groupe de contrôle (le groupe non exposé aux publicités). Le test utilise la même approche de ciblage et d’enchère pour chaque groupe afin que les annonceurs puissent analyser le chiffre d’affaires généré par les utilisateurs de chaque groupe afin de déterminer l’augmentation incrémentielle des utilisateurs exposés aux publicités. Le flux contient une ligne par impression.

Incrémentielle dans l’interface utilisateur de la console (obligatoire)

  1. Dans l’interface utilisateur de Xandr, accédez à Élément de ligne> BasicSetup>Incrementality et sélectionnez « Utiliser le groupe de contrôles ».
  2. Affectez une clé et un pourcentage de trafic à affecter au groupe de contrôle.

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).

Visibilité et "NULL" valeurs des données

Toutes les colonnes sont toujours incluses, mais vous pouvez uniquement voir les données pour lesquelles vous avez l’autorisation. Les colonnes qui ne sont pas visibles s’affichent sous la forme "NULL".

"NULL" peut être retourné dans les cas où :

  • Le vendeur sur l’impression a des paramètres de visibilité qui masquent la valeur de ce champ aux acheteurs (en supposant que vous êtes un acheteur dans cette transaction).
  • Les données ne sont pas disponibles.

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.

Remarque

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 standard 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 date_time Heure d’époque UNIX Heure et date de l’impression (par exemple, 1526057561 qui doit être traduite au vendredi 11 mai 2018 16 :52 :41 (UTC)).
02 auction_id_64 Bigint Identificateur d’enchère unique Xandr.
03 price numérique (18,6) Le montant en dollars * 1000 qu’un réseau paie pour une impression.
04 buyer_member_id int ID de membre de l’acheteur.
05 advertiser_id int ID de l’annonceur.
06 campaign_group_id int ID de l’élément de ligne.
07 campaign_id int ID de la campagne.
08 creative_id int ID du créatif servi.
09 creative_freq int Fréquence au niveau de la création (fois où l’utilisateur a vu cette créativité).
10 creative_rec int La récurrence au niveau créatif en minutes (depuis que l’utilisateur a vu cette publicité créative).
11 advertiser_freq int Fréquence au niveau de l’annonceur (fois où l’utilisateur a vu une création de cet annonceur).
12 advertiser_rec int La récurrence au niveau créatif en minutes (depuis combien de temps l’utilisateur a vu une publicité créative par cet annonceur).
13 is_remarketing Tinyint Indique qu’un nouveau pixel de segment est destiné au remarketing.
14 user_group_id int ID de groupe, si l’annonceur sépare les utilisateurs en groupes à des fins de test A/B.
15 media_buy_cost numérique (18,6) Le montant en dollars * 1000 qu’un réseau paie pour une impression.
16 is_default int Indique qu’une création par défaut a été servie.
17 pub_rule_id int ID de la règle d’éditeur, qui est configuré dans et définit le mode de paiement du serveur de publication.
18 media_buy_rev_share_pct numeric(18,6) La part des revenus de l’éditeur ou le pourcentage des recettes réservées que le vendeur partage avec son éditeur. Il s’agit d’une fraction comprise entre 0 et 1. Si vous multipliez par 100, vous obtenez la valeur du pourcentage.
19 pricing_type string(3) Type de prix d’article de ligne, ou comment le réseau d’acheteurs est payé par l’annonceur (par exemple, cpm, cpc).
20 can_convert Tinyint Indique que les pixels de conversion associés sont associés à l’impression.
22 control_pct numeric(18,6) Pourcentage de trafic envoyé au groupe de contrôle.
23 control_creative_id int ID du créatif servi au groupe de contrôle.
24 cadence_modifier numeric(18,6) Modificateur de cadence pour l’impression, qui est le nombre par lequel l’enchère a été multipliée.
25 advertiser_currency string Devise utilisée par l’annonceur.
26 advertiser_exchange_rate numeric(18,6) Taux de change le jour de l’événement. Le tarif est mis à jour tous les jours à 16h00 GMT.
27 insertion_order_id int ID de l’ordre d’insertion, s’il est utilisé.
28 predict_type Tinyint Phase d’optimisation de l’enchère. Valeurs possibles :
-2 = Aucune phase de prédiction
-1 = Phase de prédiction de base
0 = Don d’apprentissage
1 = Learn
2 = Limité
3 = Optimisé
4 = Biaisé
5 = Optimisé 1
8 = Don optimisé
9 = Enchère de base sous l’offre
29 predict_type_goal int Quantité d’objectif du type de prédiction spécifié.
30 revenue_value_dollars numeric(18,6) Montant en dollars gagné par le réseau sur l’impression.
31 revenue_value_adv_curr string Montant du dollar gagné sur impression, affiché dans la devise de votre annonceur.
32 commission_cpm numeric(18,6) Spécifie la commission dans cpm, si elle est utilisée.
33 commission_revshare numeric(18,6) Spécifie la commission dans la part des revenus, si elle est utilisée.
34 serving_fees_cpm numeric(18,6) Les frais de mise en service en plus des frais de média à lors de la diffusion d’une publicité.
35 serving_fees_revshare numeric(18,6) Les frais de service en plus du partage des revenus lors de la diffusion d’une publicité.
36 publisher_currency string(3) Devise dans laquelle l’éditeur est payé.
37 publisher_exchange_rate numeric(18,6) Taux de change (devise de l’éditeur : USD) le jour de la transaction.
38 payment_type Tinyint Méthode par laquelle l’acheteur paie pour l’impression. Valeurs possibles :
-1 = Aucun paiement
0 = CPM
1 = CPC
2 = CPA
3 = Propriétaire CPM
4 = Partage de révérend du propriétaire
39 payment_value numeric(18,6) Montant payé pour l’impression à l’aide du type de paiement spécifié.
40 creative_group_freq int Fréquence au niveau du groupe créatif (fois où l’utilisateur a vu ce groupe créatif).
41 creative_group_rec int La récence au niveau du groupe créatif (depuis combien de temps l’utilisateur a vu ce groupe créatif).
42 revenue_type Tinyint La méthode selon laquelle le réseau d’acheteurs est payé par l’annonceur, ou la façon dont le réseau de vendeurs a été payé par le réseau d’acheteurs. Valeurs possibles :

-1 = Aucun paiement
0 = CPM plat
1 = Cost Plus CPM
2 = Coût plus marge
3 = CPC
4 = CPA
5 = Revshare
6 = Frais fixes
7 = Variable CPM (vcpm)
8 = Estimation du CPM (est_cpm)
43 apply_cost_on_default int Indique s’il faut appliquer le coût aux créations par défaut.
44 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.
45 vp_expose_gender bool Indique si le sexe est exposé.
46 targeted_segments tableau ID des pixels du segment ciblé.
47 ttl int Durée de vie (TTL) des pixels de segment.
48 auction_timestamp Heure d’époque UNIX Heure et date de l’impression (par exemple, 1526057561 qui doit être traduite au vendredi 11 mai 2018 16 :52 :41 (UTC)).
49 data_costs numeric(18,6) Le coût total des données est payé par l’acheteur pour l’impression donnée.
50 targeted_segment_list tableau ID des pixels du segment ciblé.
51 campaign_group_freq int Fréquence au niveau de l’élément de ligne (fréquence à laquelle l’utilisateur a vu une publicité à partir de cet élément de ligne).
52 campaign_group_rec int Récurrence au niveau de l’élément de ligne en minutes (depuis que l’utilisateur a vu une publicité à partir de cet élément de ligne).
53 insertion_order_freq int Fréquence au niveau de l’ordre d’insertion (fréquence à laquelle l’utilisateur a vu une publicité à partir de cet ordre d’insertion).
54 insertion_order_rec int La récurrence au niveau de l’ordre d’insertion en minutes (depuis que l’utilisateur a vu une publicité à partir de cet ordre d’insertion).
55 buyer_gender string(1) Le sexe de l’utilisateur, s’il est connu. Les valeurs possibles sont les suivantes : "u", "m" et "f".
56 buyer_age int Âge de l’utilisateur, s’il est connu.
57 custom_model_id int ID du modèle personnalisé utilisé dans la vente aux enchères. Lorsqu’aucun modèle personnalisé n’est utilisé, la valeur par défaut est 0.
58 custom_model_last_modified int Date et heure (en heure d’époque Unix) depuis la dernière modification du modèle personnalisé utilisé dans la mise aux enchères. Si aucun modèle n’a été utilisé, la valeur par défaut est 0.
59 custom_model_output_code string(7) Valeur de chaîne facultative qui sera transmise aux journaux et aux rapports pour faciliter le débogage et l’analyse des performances. custom_model_output_code peut contenir jusqu’à sept caractères ASCII (7 bits) et n’est pas obligatoirement unique.
60 bid_priority int Spécifie la priorité de la campagne ou de l’élément de ligne pour les impressions gérées uniquement. Pour toutes les autres impressions, la valeur par défaut est 0.
61 is_control Tinyint Indique si le créatif servi est un contrôle créatif.
0 = impression de test
1 = impression de contrôle
2 = aucun utilisateur de cookie. (Xandr n’inclut pas d’utilisateurs de cookies pour éviter de biaiser la taille des groupes de test et de contrôle).
62 site_domain string(100) L’identificateur le plus précis du site disponible pour les acheteurs (il peut s’agir du domaine d’un partenaire fournisseur, par exemple : doubleclick.com ; réseau propriétaire de l’inventaire revendu ; ou il peut simplement dire 'stock revendu'). L’exposition à l’acheteur dépend du profil de visibilité du vendeur.
63 eap numeric(18,6) Prix moyen estimé pour l’étiquette de placement, en dollars, sauf si une autre devise d’annonceur est spécifiée.
64 ecp numeric(18,6) Prix clair estimé pour l’étiquette de placement, en dollars, sauf si une autre devise de l’annonceur est spécifiée.
65 user_id_64 Bigint ID utilisateur Xandr 64 bits stocké dans le magasin de cookies Xandr. Ce champ est 0 lorsque Xandr n’a pas de correspondance pour cet utilisateur ou que le navigateur de l’utilisateur n’accepte pas les cookies. Il sera -1 destiné aux utilisateurs opt-out.
66 predicted_engagement_rate int Pourcentage calculé pour prédire la probabilité que l’impression soit visible.
67 seller_member_id int ID de membre du vendeur.
68 bidder_auction_rank int Rang ordonné hypothétique de l’offre actuelle, calculé par le soumissionnaire par rapport aux autres soumissions renvoyées à Impression Bus. L’enchère la plus élevée est le rang d’enchère 0 (indexé 0).
69 hashed_user_id_64 octets ID utilisateur représenté sous la forme d’une valeur hachée 64 bits.
70 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).
71 device_unique_id string Remarque : ce champ est rempli uniquement pour les clients qui ont signé un addendum de contrat. Pour plus d’informations, contactez votre responsable de compte Xandr.

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)
72 ip_address string Remarque : ce champ est rempli uniquement pour les clients qui ont signé un addendum de contrat. Pour plus d’informations, contactez votre responsable de compte Xandr.

Adresse IP de l’utilisateur.

Incrémenticité

  • Last updated on