Science des données Toolkit - Fonctionnalités du langage Bonsai

Cette page répertorie les fonctionnalités du langage Bonsai que vous pouvez utiliser pour évaluer les impressions dans le cadre de votre logique de modèle personnalisé. Pour chaque fonctionnalité, nous expliquons la syntaxe et fournissons un exemple pour illustrer l’utilisation.

Remarque

• Les enchères négatives ou nulles (0) ne sont pas prises en charge, sauf indication explicite dans la description de la fonctionnalité. N’utilisez pas ces expressions ou des résultats inattendus peuvent se produire. Il est préférable de spécifier no_bid explicitement à l’aide de Feuilles intelligentes.
• Les enchères calculées par le modèle sont toujours exprimées dans la devise définie sur l’annonceur, même si vous avez spécifié une autre devise pour la campagne.

Fonctionnalités simples

Pays

Évaluez les impressions en fonction du pays de l’utilisateur.

Mot clé : country

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID ou code du pays, tel que 233 ou "US". Utilisez le service country pour récupérer ces ID ou codes.

Exemple :

if country = "US":
5
elif country = 70:
3
else:
0.1

Ciblage de contenu vidéo

Évaluez les impressions en fonction de l’inventaire de contenu vidéo de l’utilisateur.

Mot clé : video_duration, video_delivery_type, video_genre, video_program_type, video_rating, video_network

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur :

Exemple :

if any video_duration in (1,2), video_delivery_type in (1,2):
value: 0.050000
elif every video_genre in (1,2,3), video_rating =1:
value: 0.060000
elif every video_network in (1,3), video_genre in (1,2):
value: 0.0700000
elif not video_network =2:
value: 0.01

Région

Évaluez les impressions en fonction de la région géographique de l’utilisateur.

Mot clé : region

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID de région ou combinaison de codes pays/région, telle que "US:NY". Utilisez le service de région pour récupérer ces ID et codes.

Exemple :

if region = 123:
5
elif region = "US:NJ":
3
else:
0.1

Ville

Évaluez les impressions en fonction de la ville de l’utilisateur.

Mot clé : city

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID de ville ou combinaison de codes pays/région/ville, telle que "US:NY:New York". Utilisez le service municipal pour récupérer ces ID et codes.

Exemple :

if city = 162:
5
elif city = "US:MA:Boston":
3
else:
0.1

DMA

Évaluez les impressions en fonction du DMA (zone de marché désignée) de l’utilisateur.

Mot clé : dma

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID DMA, par 602 exemple (pour la zone de métro de Chicago). Utilisez city service pour récupérer les ID DMA.

Exemple :

if dma = 602:
5
elif dma = 603:
3
else:
0.1

Code postal

Évaluez les impressions en fonction du code postal de l’utilisateur. Le code postal est disponible uniquement pour certaines impressions mobiles et les impressions de partenaires fournisseurs externes.

Mot clé : postal_code

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID de code postal (entier) ou combinaison de codes pays/postal (une chaîne telle que "CA:J0K 1B0" ou "US:10010"). Inclut les codes postaux américains. Utilisez le service de code postal (documenté dans le service de profil) pour récupérer les ID de code postal.

Exemple :

if postal_code in ("CA:J0k 1B0", "US:10010"):
5
elif postal_code = 1367515:
3
else:
0.1

Liste de codes postaux

Évaluez les impressions en fonction de la liste de codes postaux de l’utilisateur.

Mot clé : postal_code_list[ID]

Opérateur : Aucun pour la présence, pas pour l’absence.

Valeur : Aucun

Exemple :

elif postal_code_list[120]:
value: 1

Liste des transactions

Évaluez les impressions en fonction de la liste des transactions de l’utilisateur.

Mot clé : deal_list[ID]

Opérateur : Aucun pour la présence, pas pour l’absence.

Valeur : Aucun

Exemple :

elif deal_list[4107]:
value: 2

Size

Évaluez les impressions en fonction de la taille du placement. Notez que si promo_sizes l’appel publicitaire est passé, l’évaluation est effectuée à l’aide de la taille principale uniquement.

Mot clé : size

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : chaîne représentant des dimensions de placement, au "WIDTHxHEIGHT"format .

Exemple :

if size = "300x250":
5
elif size = "250x250":
3
else:
0.1

Jour de la semaine

Évaluez les impressions en fonction de jours spécifiques de la semaine.

Mot clé : user_day

Opérateur : Any

Valeur : jour de la semaine. Valeurs possibles : 0 - 6, où 0 est dimanche et 6 samedi.

Exemple :

if user_day in (1,2,3,4,5):
5
else:
0.1

Heure de la journée

Évaluez les impressions en fonction d’heures spécifiques de la journée.

Mot clé : user_hour

Opérateur : Any

Valeur : heure du jour, dans le fuseau horaire de l’utilisateur. Valeurs possibles : 0 - 23, où 0 est minuit et 23 23 heures.

Exemple :

if user_hour in (18,19,20,21,22,23):
5
elif user_hour in (14,15,16,17):
4
else:
2

Famille de systèmes d’exploitation

Évaluez les impressions en fonction du système d’exploitation de l’utilisateur.

Mot clé : os_family

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID ou nom de la famille du système d’exploitation, par 2 exemple ou "Android". Utilisez le service famille de systèmes d’exploitation pour récupérer ces ID et noms.

Exemple :

if os_family = 2:
5
elif os_family = "Apple iOS":
4
else:
0.2

Version du système d'exploitation

Évaluez les impressions en fonction de la version spécifique du système d’exploitation de l’utilisateur.

Remarque

Pour la os_extended fonctionnalité, un résultat de table de recherche égal à 0 est considéré comme manquant.

Mot clé : os_extended

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID étendu du système d’exploitation, par exemple 81 pour "10.8 Mountain Lion". Utilisez le service étendu du système d’exploitation pour récupérer ces ID.

Remarque

L’ID du système d’exploitation est répertorié comme operating_system étant dans les données au niveau du journal.

Exemple :

if os_extended = 81:
5
elif os_extended = 82:
4
else:
0.2

Navigateur

Évaluez les impressions en fonction du navigateur de l’utilisateur.

Remarque

Pour la browser fonctionnalité, un résultat de table de recherche égal à 0 est considéré comme manquant.

Mot clé : browser

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID ou nom du navigateur, par 8 exemple ou "Chrome (all versions)". Utilisez le service de navigateur pour récupérer ces ID et noms.

Exemple :

if browser = 8:
3
elif browser = "Safari (all versions)":
2.5
else:
0.2

Langue du navigateur

Évaluez les impressions en fonction de la langue du navigateur.

Remarque

Pour la language fonctionnalité, un résultat de table de recherche égal à 0 est considéré comme manquant.

Mot clé : language

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID de langue. Utilisez le service de langage pour récupérer ces ID.

Exemple :

if language = 1:
3
elif language = 0:
1
else:
0

Gender

Évaluez les impressions en fonction du sexe de l’utilisateur. Notez que le sexe est disponible uniquement dans les cas où l’éditeur le transmet lors de l’appel publicitaire. Pour plus d’informations sur les appels publicitaires, consultez « Paramètres de balise de placement » dans la documentation.

Mot clé : user_gender

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : sexe de l’utilisateur. Valeurs possibles :

• "female"
• "male"
• "unknown"

Exemple :

if user_gender in (male, female):
5
else:
2

Domain

Évaluez les impressions en fonction du domaine.

Mot clé : domain

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : chaîne représentant un nom de domaine de niveau supérieur, comme "food.com" ou "books".

Exemple :

if domain = "food.com":
3
elif domain = "books.com":
2.5
else:
0.2

Adresse IP

Évalue les impressions en fonction de l’adresse IP.

Remarque

Les clients des pays qui se conforment aux réglementations RGPD doivent savoir qu’en ciblant des adresses IP ou des plages d’adresses IP, que ce soit dans votre élément de ligne, votre arborescence Bonsai ou votre modèle de régression logistique, il est possible que l’adresse soit tronquée. Pour plus d’informations sur ce processus, consultez nos stratégies de service.

Mot clé : ip_address

Opérateur : in

Valeur : chaîne représentant toute adresse IP valide, y compris la notation de sous-réseau. Par exemple, la plage (192.168.0.1, 10.0.0.0/24) indique les adresses IP 192.168.0.1 et 10.0.0.0-10.0.0.255.

Exemple :

if ip_address in (192.168.0.1, 10.0.0.0/24):
5
else:
1

Position de pliage

Évaluez les impressions en fonction de positions de positionnement spécifiques par rapport au pli de la page.

Mot clé : position

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : position de repli. Valeurs possibles :

• 0 or "unknown" - Utilisez ces valeurs pour cibler les emplacements où la position de repli est inconnue.
• 1 or "above" - Utilisez ces valeurs pour cibler les placements au-dessus du pli.
• 2 or "below" - Utilisez ces valeurs pour cibler les placements sous le pli.

Exemple :

if position = "above":
3
elif position = 2:
1
else:
0

Placement

Évaluez les impressions en fonction de placements spécifiques.

Mot clé : placement

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID de placement.

Remarque

L’ID de placement est répertorié comme tag_id dans les données au niveau du journal.

Exemple :

if placement = 300:
5
elif placement = 301:
4.5
else:
0.2

Groupe de placement

Évaluez les impressions en fonction de groupes de placements spécifiques.

Mot clé : placement_group

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID du groupe de placement.

Remarque

L’ID du groupe de placement est répertorié dans site_id les données au niveau du journal.

Exemple :

if placement_group = 155:
5
elif placement_group = 156:
4.50
else:
0.2

Éditeur

Évaluez les impressions en fonction de serveurs de publication spécifiques.

Mot clé : publisher

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID de l’éditeur.

Remarque

L’ID de l’éditeur est répertorié comme publisher_id étant dans les données au niveau du journal.

Exemple :

if publisher = 1300:
5
elif publisher = 1301:
4.50
else:
0.2

Membre vendeur

Évaluez les impressions en fonction de membres vendeurs spécifiques.

Mot clé : seller_member_id

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID de membre du vendeur.

Exemple :

if any seller_member_id = 100, seller_member_id = 175:
4
elif any seller_member_id = 500, seller_member_id = 501:
3.50
else:
0.2

Type d’approvisionnement

Évaluez les impressions en fonction de types d’approvisionnement spécifiques.

Mot clé : supply_type

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : indiquez l’ID ou le nom du type. Valeurs possibles :

• 0 or "web" - Utilisez l’une ou l’autre de ces valeurs pour cibler des sites web standard.
• 1 or "mobile_web" - Utilisez l’une ou l’autre de ces valeurs pour cibler des sites web optimisés pour les navigateurs sur les tablettes mobiles et les téléphones.
• 2 or "mobile_app" - Utilisez l’une ou l’autre de ces valeurs pour cibler les applications installées sur les tablettes et les téléphones mobiles.

Exemple :

if supply_type = "web":
4
elif supply_type = "mobile_web":
3
elif supply_type = 2:
2
else:
0.2

Type d’appareil

Évaluez les impressions en fonction de types spécifiques d’appareils physiques.

Mot clé : device_type

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : nom du type d’appareil. Valeurs possibles :

• "pc & other devices" - Utilisez cette valeur pour cibler les ordinateurs de bureau et les ordinateurs portables.
• "phone" - Utilisez cette valeur pour cibler les téléphones mobiles.
• "tablet" - Utilisez cette valeur pour cibler les tablettes mobiles.

Exemple :

if device_type = "pc & other devices":
5
elif device_type = "tablet":
4
elif device_type = "phone":
3.50
else:
0

Modèle du périphérique

Évaluez les impressions en fonction de modèles spécifiques d’appareils physiques.

Mot clé : device_model

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID du modèle d’appareil. Utilisez le service de modèle d’appareil pour récupérer ces ID.

Remarque

L’ID de modèle d’appareil est répertorié dans device_id les données au niveau du journal.

Exemple :

if device_model = 46:
5
elif device_model = 47:
4.75
elif device_model = 48:
3.50
else:
0

Transporteur

Évaluez les impressions en fonction d’opérateurs mobiles spécifiques.

Mot clé : carrier

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID ou nom de l’opérateur mobile, tel que 14 ou "Verizon". Utilisez le service opérateur pour récupérer ces ID et noms.

Exemple :

if carrier = 14:
4
elif carrier = "Sprint":
3.50
else:
0.2

Application mobile

Évaluez les impressions en fonction d’applications mobiles spécifiques.

Mot clé : mobile_app

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID ou noms d’application mobile. Utilisez Mobile App Service pour récupérer ces ID ou noms.

Exemple :

if mobile_app = 1:
5
elif mobile_app = 2:
3.5
elif mobile_app = "Candy Crush Saga":
2
else:
0.2

Instance d’application mobile

Évaluez les impressions en fonction d’installations d’applications mobiles spécifiques.

Mot clé : mobile_app_instance

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID de instance de l’application mobile. Utilisez Mobile App Instance Service pour récupérer ces ID.

Exemple :

if mobile_app_instance = 1:
5
elif mobile_app_instance = 2:
3.5
elif mobile_app_instance = 3:
2
else:
0.2

Offre groupée d’applications mobiles

Évaluez les impressions en fonction de bundles d’applications mobiles spécifiques.

Mot clé : mobile_app_bundle

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : ID d’offre groupée d’applications mobiles. Utilisez Mobile App Instance Service pour récupérer ces ID.

Exemple :

if mobile_app_bundle in ("553834731", "com.king.candycrushsaga"):
5
else:
0.2

Âge du cookie

Évaluez les impressions en fonction de la durée, en minutes, que l’utilisateur a eu un cookie Xandr.

Mot clé : cookie_age

Opérateur : Any

Valeur : entier positif représentant le nombre de minutes pendant lesquelles l’utilisateur a eu un cookie Xandr. Cette valeur peut être absente, ce qui indique que l’utilisateur n’a pas de cookie Xandr.

Exemple :

if cookie_age > 30:
2
else:
0.2

Taux de visibilité IAB prédit

(Précédemment appelé « Taux d’affichage IAB estimé ».) Évaluez les impressions d’affichage web en fonction de la probabilité qu’elles soient mesurées comme étant visibles par la norme IAB, comme déterminé par l’optimisation Xandr.

Mot clé : predicted_iab_view_rate

Alias (déconseillé) : estimated_iab_viewthrough_rate

Opérateur : Any

Valeur : nombre décimal compris entre 0 et 1, représentant un pourcentage.

Exemple :

if predicted_iab_view_rate = 1:
5
elif predicted_iab_view_rate >= 0.75:
3.5
elif predicted_iab_view_rate >= 0.50:
2
else:
0

Taux d’affichage de l’IAB prédit sur le total

Évaluez les impressions d’affichage web en fonction de la probabilité qu’elles soient mesurées comme étant visibles, par rapport au nombre total d’impressions (vues/impressions totales), selon la norme IAB, comme déterminé par l’optimisation Xandr.

Mot clé : predicted_iab_view_rate_over_total

Opérateur : Any

Valeur : nombre décimal compris entre 0 et 1, représentant un pourcentage.

Exemple :

if predicted_iab_view_rate_over_total = 1:
5
elif predicted_iab_view_rate_over_total >= 0.75:
3.5
elif predicted_iab_view_rate_over_total >= 0.50:
2
else:
0

Taux de visionabilité des vidéos IAB prédit

Évaluez les impressions vidéo web en fonction de la probabilité qu’elles soient mesurées comme étant visibles par la norme IAB, comme déterminé par l’optimisation Xandr.

Mot clé : predicted_iab_video_view_rate

Opérateur : Any

Valeur : nombre décimal compris entre 0 et 1, représentant un pourcentage.

Exemple :

if predicted_iab_video_view_rate = 1:
5
elif predicted_iab_video_view_rate >= 0.75:
3.5
elif predicted_iab_video_view_rate >= 0.50:
2
else:
0

Taux de visionabilité des vidéos IAB prédit par rapport au total

Évaluez les impressions vidéo web en fonction de leur probabilité d’être mesurées comme étant visibles sur le nombre total d’impressions (vues/mesurées) par la définition personnalisée de 100 % de pixels visibles pendant au moins 1 seconde, comme déterminé par l’optimisation Xandr.

Mot clé : predicted_iab_video_view_rate_over_total

Opérateur : Any

Valeur : nombre décimal compris entre 0 et 1, représentant un pourcentage.

Exemple :

if predicted_100pv1s_display_view_rate = 1:
5
elif predicted_100pv1s_display_view_rate >= 0.75:
3.5
elif predicted_100pv1s_display_view_rate >= 0.50:
2
else:
0

Taux de visibilité d’affichage prédit (100 % d’affichage, durée d’une seconde)

Évaluez les impressions vidéo d’affichage en fonction de la probabilité qu’elles soient mesurées comme visibles (impressions vues/mesurées) selon la définition personnalisée de 100 % pixels visibles pendant au moins 1 seconde, comme déterminé par l’optimisation Xandr.

Mot clé : predicted_100pv1s_display_view_rate

Opérateur : Any

Valeur : nombre décimal compris entre 0 et 1, représentant un pourcentage.

Exemple :

if predicted_100pv50pd_video_view_rate = 1:
5
elif predicted_100pv50pd_video_view_rate >= 0.75:
3.5
elif predicted_100pv50pd_video_view_rate >= 0.50:
2
else:
0

Taux de visibilité d’affichage prédit sur le total (100 % d’affichage, durée d’une seconde)

Évaluez les impressions d’affichage web en fonction de la probabilité qu’elles soient mesurées en tant qu’impressions visibles (vues/impressions totales) selon la définition personnalisée de 100 % de pixels visibles pendant au moins 1 seconde, comme déterminé par l’optimisation Xandr.

Mot clé : predicted_100pv1s_display_view_rate_over_total

Opérateur : Any

Valeur : nombre décimal compris entre 0 et 1, représentant un pourcentage.

Exemple :

if predicted_100pv1s_display_view_rate_over_total = 1:
5
elif predicted_100pv1s_display_view_rate_over_total >= 0.75:
3.5
elif predicted_100pv1s_display_view_rate_over_total >= 0.50:
2
else:
0

Taux de visibilité des vidéos prédites (100 % d’affichage, durée de 50 %, son activé)

Évaluez les impressions vidéo web en fonction de la probabilité qu’elles soient mesurées comme étant visibles (impressions vues/mesurées), où une « vue » est définie comme une publicité qui est 100 % visible et a été diffusée pendant au moins 50 % de sa durée, avec le son activé. La probabilité est déterminée par l’optimisation Xandr.

Mot clé : predicted_100pv50pd_video_view_rate

Opérateur : Any

Valeur : nombre décimal compris entre 0 et 1, représentant un pourcentage.

Exemple :

if predicted_100pv50pd_video_view_rate = 1:
5
elif predicted_100pv50pd_video_view_rate >= 0.75:
3.5
elif predicted_100pv50pd_video_view_rate >= 0.50:
2
else:
0

Taux de visibilité vidéo prédit sur le total (100 % d’affichage, 50 % de durée, son activé)

Évaluez les impressions vidéo web en fonction de leur probabilité d’être mesurées comme étant visibles, sur le nombre total d’impressions (vues/impressions totales), où une « vue » est définie comme une publicité qui est 100 % visible et a été lue pendant au moins 50 % de sa durée, avec le son activé. La probabilité est déterminée par l’optimisation Xandr.

Mot clé : predicted_100pv50pd_video_view_rate_over_total

Opérateur : Any

Valeur : nombre décimal compris entre 0 et 1, représentant un pourcentage.

Exemple :

if predicted_100pv50pd_video_view_rate_over_total = 1:
5
elif predicted_100pv50pd_video_view_rate_over_total >= 0.75:
3.5
elif predicted_100pv50pd_video_view_rate_over_total >= 0.50:
2
else:
0

Taux de saisie semi-automatique de la vidéo prédite

Évaluez les impressions vidéo web en fonction de leur probabilité de réalisation, comme déterminé par l’optimisation Xandr.

Mot clé : predicted_video_completion_rate

Alias (déconseillé) : estimated_video_completion_rate

Opérateur : Any

Valeur : nombre décimal compris entre 0 et 1, représentant un pourcentage. 0 représente l’inventaire non vidéo.

Exemple :

if predicted_video_completion_rate = 1:
5
elif predicted_video_completion_rate >= 0.75:
3.5
elif predicted_video_completion_rate >= 0.50:
2
else:
0

Public prévu par Xandr

Évalue les impressions en fonction de l’audience prévue, comme déterminé par l’audit de la plateforme Xandr.

Mot clé : appnexus_intended_audience

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : "general", "children", "young_adult"ou "mature".

Exemple :

if appnexus_intended_audience = "mature":
1
else:
0

Audience destinée au vendeur

Évalue les impressions en fonction de l’audience prévue, telle qu’elle est déterminée par l’auto-audit. Pour plus d’informations, consultez « Auto-classification de l’inventaire » dans la documentation et Service de profil.

Mot clé : seller_intended_audience

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : "general", "children", "young_adult"ou "mature".

Exemple :

if appnexus_intended_audience = "general":
1
else:
0

Xandr audité status

Évalue si l’inventaire a été audité par Xandr.

Mot clé : appnexus_audited

Opérateur : tout sauf <, >, <=, >=et range.

Valeur : true ou false

Exemple :

if appnexus_audited = true:
1.0
else:
0.0

Status auto-auditée

Évalue si l’inventaire a été audité par l’éditeur.

Mot clé : self_audited

Opérateur : tout sauf <, >, <=, >=et range.

Valeur : true ou false

Exemple :

if self_audited = true:
1.0
else:
0.0

Groupe d’utilisateurs

Évalue si l’utilisateur appartient à un groupe attribué de manière aléatoire. Chaque utilisateur Xandr a un groupe d’utilisateurs persistant de 0 à 999. Vous pouvez utiliser le groupe d’utilisateurs pour tester différentes stratégies en parallèle et comparer leurs performances. Différents tests doivent partitionner les milliers de groupes d’utilisateurs différemment ; sinon, les tests simultanés interagissent les uns avec les autres et il sera difficile d’interpréter les résultats. Pour plus d’informations, consultez Ciblage de test et de contrôle dans la documentation.

Mot clé : user_group

Opérateur : Any

Valeur : entier compris entre 0 et 999.

Exemple :

if user_group <= 249:
1.0
elif user_group <= 499:
2.0
elif user_group <= 749:
3.0
elif user_group <= 999:
4.0
else:
0.0

Fréquence des mois de campagne (administrateurs système uniquement)

Évaluez les impressions en fonction du nombre d’impressions vues par un utilisateur pour la campagne en cours au cours du mois en cours.

Mot clé : campaign_month_frequency

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif représentant le nombre d’impressions vues par un utilisateur pour la campagne en cours dans le calendrier actuel. 0 indique qu’aucune information de fréquence n’est disponible (l’utilisateur n’a pas vu cet objet dans le calendrier actuel).

Exemple :

if campaign_month_frequency < 2 :
5
else :
0.1

Fréquence du mois de l’élément de ligne

Évaluez les impressions en fonction du nombre d’impressions vues par un utilisateur pour l’élément de ligne actif dans le mois en cours.  

Mot clé : line_item_month_frequency

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif représentant le nombre d’impressions vues par un utilisateur pour l’élément de ligne actif dans le mois en cours. 0 indique qu’aucune information de fréquence n’est disponible (l’utilisateur n’a pas vu de création relative à cet objet sur le mois en cours).

Exemple :

if line_item_month_frequency < 2:
5
else:
0.1

Fréquence du mois de l’annonceur

Évaluez les impressions en fonction du nombre d’annonces vues par un utilisateur sur le mois en cours.

Mot clé : advertiser_month_frequency

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif représentant le nombre d’annonces vues par un utilisateur sur le mois en cours. 0 indique qu’aucune information de fréquence n’est disponible (l’utilisateur n’a pas vu cet objet sur le mois en cours).

Exemple :

if advertiser_month_frequency < 2:
5
else:
0.1

Fréquence des heures de campagne

Évaluez les impressions en fonction du nombre d’annonces vues par un utilisateur à l’heure actuelle.

Mot clé : campaign_hour_frequency

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif représentant le nombre d’annonces vues par un utilisateur à l’heure actuelle. 0 indique qu’aucune information de fréquence n’est disponible (l’utilisateur n’a pas vu cet objet à l’heure actuelle).

Exemple :

if campaign_hour_frequency < 2:
5
else:
0.1

Fréquence de l’heure de l’élément de ligne

Évaluez les impressions en fonction du nombre d’annonces vues par un utilisateur à l’heure actuelle.

Mot clé : line_item_hour_frequency

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif représentant le nombre d’annonces vues par un utilisateur à l’heure actuelle. 0 indique qu’aucune information de fréquence n’est disponible (l’utilisateur n’a pas vu cet objet à l’heure actuelle).

Exemple :

if line_item_hour_frequency < 2:
5
else:
0.1

Fréquence horaire de l’annonceur

Évaluez les impressions en fonction du nombre d’annonces vues par un utilisateur à l’heure actuelle.

Mot clé : advertiser_hour_frequency

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif représentant le nombre d’annonces vues par un utilisateur à l’heure actuelle. 0 indique qu’aucune information de fréquence n’est disponible (l’utilisateur n’a pas vu cet objet à l’heure actuelle).

Exemple :

if advertiser_hour_frequency < 2:
2
else:
0.1

Fréquence des semaines de campagne (administrateurs système uniquement)

Évaluez les impressions en fonction du nombre d’annonces vues par un utilisateur au cours de la semaine en cours, à partir du dimanche.

Mot clé : campaign_week_frequency

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif représentant le nombre d’annonces vues par un utilisateur au cours de la semaine en cours. 0 indique qu’aucune information de fréquence n’est disponible (l’utilisateur n’a pas vu cet objet au cours de la semaine en cours).

Exemple :

if campaign_week_frequency < 2 :
5
else :
0.1

Fréquence de semaine d’élément de ligne

Évaluez les impressions en fonction du nombre d’annonces vues par un utilisateur au cours de la semaine en cours, à partir du dimanche.  

Mot clé : line_item_week_frequency

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif représentant le nombre d’annonces vues par un utilisateur au cours de la semaine en cours. 0 indique qu’aucune information de fréquence n’est disponible (l’utilisateur n’a pas vu cet objet au cours de la semaine en cours).

Exemple :

if line_item_week_frequency < 2:
5
else:
0.1

Fréquence de semaine de l’annonceur

Évaluez les impressions en fonction du nombre d’annonces vues par un utilisateur au cours de la semaine en cours, à compter du dimanche.  

Mot clé : advertiser_week_frequency

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif représentant le nombre d’annonces vues par un utilisateur au cours de la semaine en cours. 0 indique qu’aucune information de fréquence n’est disponible (l’utilisateur n’a pas vu cet objet au cours de la semaine en cours).

Exemple :

if advertiser_week_frequency < 2:
5
else:
0.1

Fréquence des jours de campagne (administrateurs système uniquement)

Évaluez les impressions en fonction du nombre d’annonces vues par un utilisateur le jour actuel.

Mot clé : campaign_day_frequency

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif représentant le nombre d’annonces vues par un utilisateur le jour actuel. 0 indique qu’aucune information de fréquence n’est disponible (l’utilisateur n’a pas vu cet objet le jour actuel).

Exemple :

if campaign_day_frequency < 2 :
5
else :
0.1

Récence des campagnes (administrateurs système uniquement)

Évaluez si les données de récurrence sont disponibles pour un utilisateur et, le cas échéant, le nombre de minutes depuis qu’un utilisateur a vu une publicité.

Mot clé : campaign_recency

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif indiquant le nombre de minutes depuis qu’un utilisateur a vu une impression, arrondie vers le bas. 59 secondes correspond à 0, 61 secondes à 1. 0 signifie que l’impression a été vue très récemment. Null signifie qu’aucune donnée de récence n’est disponible (l’utilisateur n’a pas vu cette impression auparavant).

Exemple :

if campaign_recency < 2 :
2
else :
0.1

Récurrence des éléments de ligne

Évaluez si les données de récurrence sont disponibles pour un utilisateur et, le cas échéant, le nombre de minutes depuis qu’un utilisateur a vu une publicité.

Mot clé : line_item_recency

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif indiquant le nombre de minutes depuis qu’un utilisateur a vu une impression, arrondie vers le bas. 59 secondes correspond à 0, 61 secondes à 1. 0 signifie que l’impression a été vue très récemment. Null signifie qu’aucune donnée de récence n’est disponible (l’utilisateur n’a pas vu cette impression auparavant).

Exemple :

if line_item_recency < 2:
5
else:
0.1

Récurrence de l’annonceur

Évaluez si les données de récurrence sont disponibles pour un utilisateur et, le cas échéant, le nombre de minutes depuis qu’un utilisateur a vu une publicité.

Mot clé : advertiser_recency

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif indiquant le nombre de minutes depuis qu’un utilisateur a vu une impression, arrondie vers le bas. 59 secondes correspond à 0, 61 secondes à 1. 0 signifie que l’impression a été vue très récemment. Null signifie qu’aucune donnée de récence n’est disponible (l’utilisateur n’a pas vu cette impression auparavant).

Exemple :

if advertiser_recency < 2:
5
else:
0.1

Créatif

Évaluez les impressions en fonction de la créativité.

Mot clé : creative

Opérateur : Any

Valeur : chaîne représentant l’ID créatif (doit être un entier).

Exemple :

if creative=12345:
5
else:
0.1

Taille créative

Évaluez les impressions en fonction de la taille de la création.

Mot clé : creative_size

Opérateur : tout sauf <, >, <=, >=et range. Pour tester plusieurs valeurs, utilisez in.

Valeur : chaîne représentant des dimensions créatives, au "WIDTHxHEIGHT"format .

Exemple :

if creative_size = "300x250":
5
elif creative_size = "250x250":
3
else:
0.1

ID de la transaction

Évaluez les impressions en fonction de l’ID de transaction.  

Mot clé : deal_id

Opérateur : tout sauf range.

Valeur : chaîne représentant l’ID de transaction sous la forme d’un entier.

Exemple :

if deal_id in (12345,98765):
1.0
else:
0.1

Random1, Random2, Random 3

Évaluez les impressions en fonction d’une variable de randomisation entre 0 et 1. Lorsqu’il est utilisé, ce paramètre ajoute un caractère aléatoire à l’algorithme Bonsai.

Mot clé : random1, random2, random3

Opérateur : Any. Pour tester plusieurs valeurs, utilisez in.

Valeur : valeur comprise entre 0 et 1, mise en forme en tant que décimale jusqu’à 6 décimales.

Exemple :

if random1 > 0.8:
1.0
elif random1 range (0.4, 0.8):
2.0
else:
0.1

ID d’URL d’inventaire

Évaluez les impressions en fonction de l’ID d’URL d’inventaire* qui correspond à une URL d’inventaire.

Mot clé : inventory_url_id

Opérateur : tout sauf <, >, <=, >=et range.

Valeur : ID d’URL d’inventaire (entier).

Exemple :

if inventory_url_id=12345:
5
else:
0.1

* Disponible uniquement sur les éléments de ligne augmentés

Caractéristiques composées

Les fonctionnalités simples ci-dessus vous permettent d’évaluer un seul aspect de l’impression (pays, âge des cookies, application mobile, etc.). Les caractéristiques segment et fréquence/récence composées sont plus nuancées ; ils vous permettent d’évaluer plusieurs attributs de ces fonctionnalités, tels que l’âge d’un segment ou la valeur du segment.

Segment

• Présence/absence de segment
• Âge du segment
• Valeur de segment

Présence/absence de segment

Évaluez les impressions en fonction de la présence de l’utilisateur dans un segment interne ou tiers.

Mot clé : segment[ID] où ID est l’ID de segment. Utilisez le service de segment pour récupérer les ID de segment.

Attribut : Aucun

Opérateur : Aucun pour la présence, not pour l’absence.

Valeur : Aucun

Exemple :

if any segment[12345], segment[23456], segment[34567]:
5
elif any segment[76543], segment[65432], segment[54321]:
3
elif not segment[9999]:
1
else:
0.2

Âge du segment

Évaluez les impressions en fonction des minutes écoulées depuis l’ajout de l’utilisateur à un segment interne ou tiers.

Remarque

Si l’utilisateur n’est pas dans le segment, cette fonctionnalité prend Falsela valeur .

Mot clé : segment[ID] où ID est l’ID de segment. Utilisez le service de segment pour récupérer les ID de segment.

Attribut : .age

Opérateur : < , > ou =

Valeur : entier positif représentant les minutes depuis que l’utilisateur a été ajouté au segment.

Exemple :

if segment[12345].age < 5:
2
else:
0.2

Valeur de segment

Évaluez les impressions en fonction d’une valeur définie par l’utilisateur. La valeur peut être passée de plusieurs façons, par exemple par le biais du service de segment batch ou d’une chaîne de requête de segment interne ou tierce. Pour plus d’informations sur la transmission de valeurs par le biais de chaînes de requête de segment, consultez Segment Pixels Advanced dans la documentation.

Remarque

Si l’utilisateur n’est pas dans le segment, cette fonctionnalité prend Falsela valeur .

Mot clé : segment[ID] où ID est l’ID de segment. Utilisez le service de segment pour récupérer les ID de segment.

Attribut : .value

Opérateur : <, >ou =

Valeur : entier positif non nul représentant la valeur définie par l’utilisateur.

Exemple :

if segment[12345].value = 5:
2
else:
0.2

Fréquence/récurrence

• Présence/absence de fréquence
• Fréquence de la durée de vie
• Fréquence quotidienne
• Présence/absence de récurrence et données

Présence/absence de fréquence

Évaluer si les données de fréquence sont disponibles ou non pour l’utilisateur. Cela peut être déterminé pour toutes les annonces d’un annonceur, d’un élément de ligne ou d’une campagne.

Mot clé : frequency

Attribut : OBJECT[ID]. où OBJECT est advertiser, line_itemou campaign, et ID est l’ID d’objet. Utilisez le service annonceur, le service d’élément de ligne ou le service campagne pour récupérer les ID.

Opérateur : < , > ou =

Valeur : 0 indique que l’utilisateur n’a jamais vu d’impression pour cet objet ; un entier positif indique que des informations de fréquence sont disponibles.

Remarque

Contrairement à la récence, les données de fréquence ne sont jamais null. Si un utilisateur n’a jamais vu d’impression pour cet objet, la fréquence est 0.

Exemple :

if line_item[15].frequency > 0:
2
elif campaign[20].frequency > 0:
1.5
elif campaign[23].frequency > 0:
1
else:
0.1

Fréquence de la durée de vie

Évaluez les impressions en fonction du nombre d’annonces vues par un utilisateur au cours de la durée de vie d’un annonceur, d’un élément de ligne ou d’une campagne.  

Mot clé : lifetime_frequency

Attribute : OBJECT[ID]. où OBJECT est advertiser, line_itemou campaign, ou creative, et ID est l’ID d’objet. Utilisez le service annonceur, le service d’élément de ligne ou le service campagne pour récupérer les ID.

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif représentant le nombre d’annonces vues par un utilisateur pendant la durée de vie de l’objet. 0 indique qu’aucune information de fréquence n’est disponible (l’utilisateur n’a jamais vu cet objet).

Exemple :

if campaign[20].lifetime_frequency < 2:
5
elif advertiser[12].lifetime_frequency < 10:
4
elif advertiser[12].lifetime_frequency < 20:
2
else:
0.1

Fréquence quotidienne

Évaluez les impressions en fonction du nombre d’impressions vues par un utilisateur le jour actuel. Cela peut être déterminé pour un annonceur, un élément de ligne ou une campagne.  

Mot clé : day_frequency

Attribut : OBJECT[ID]. où OBJECT est advertiser, line_itemou campaign, et ID est l’ID d’objet. Utilisez le service annonceur, le service d’élément de ligne ou le service campagne pour récupérer les ID.

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif représentant le nombre d’annonces vues par un utilisateur le jour actuel. 0 indique qu’aucune information de fréquence n’est disponible (l’utilisateur n’a pas vu cet objet le jour actuel).

Exemple :

if campaign[20].day_frequency < 2:
5
elif advertiser[12].day_frequency < 10:
4
elif advertiser[12].day_frequency < 20:
2
else:
0.1

Présence/absence de récurrence et données

Évalue si des données de récence sont disponibles pour un utilisateur et, le cas échéant, le nombre de minutes depuis qu’un utilisateur a vu une publicité. Cela peut être déterminé pour un utilisateur pour toutes les publicités sous un annonceur, un élément de ligne ou une campagne.

Mot clé : recency

Attribut : OBJECT[ID]. où OBJECT est advertiser, line_itemou campaign, et ID est l’ID d’objet. Utilisez le service annonceur, le service d’élément de ligne ou le service campagne pour récupérer les ID.

Opérateur : =<, <=, presence/absence, in, comparison, notet range.

Valeur : entier positif indiquant le nombre de minutes depuis qu’un utilisateur a vu une impression, arrondie vers le bas. 59 secondes correspond à 0, 61 secondes à 1. 0 signifie que l’impression a été vue très récemment. Null signifie qu’aucune donnée de récence n’est disponible (l’utilisateur n’a pas vu cette impression auparavant).

Exemple :

if not advertiser.recency:
0.1
elif advertiser[3].recency > 60:
1
else:
0.2

Exemples de syntaxe de fonctionnalité composée utilisant plusieurs attributs

Exemple d’attributs de segment multiples

# This tree determines a bid price as follows:
# 1. If the user is in segment 3 and has a value greater than 1 or has been in the segment for 5 minutes, bid $1.
# 2. Otherwise, bid $2.
if any segment[3].value > 1, segment[3].age = 5:
    1.0
else:
    2.0  

Exemple de syntaxe de récurrence/fréquence avec plusieurs attributs

# This tree determines a bid price as follows:
# 1. If there's no recency data for this user related to ads in line item 3, bid $1.
# 2. If the user has seen an ad in line item 3 more than 5 minutes ago and the user has seen an ad in campaign 2 less than four times today, bid $3.
#3. If the user has seen an ad in line item 1 more than 5 times ever or more than 4 times today, or if the user has seen an ad in advertiser 2 more than 4 times today, bid $0.50.
#4. Otherwise, bid nothing.
if not line_item[3].recency: 
        1
elif every line_item[3].recency > 5, campaign[2].day_frequency < 4: 
        3 
elif any line_item[1].lifetime_frequency > 5, line_item[1].day_frequency > 4, advertiser[2].day_frequency > 4: 
        0.50 
else: 
        0  

Exemple d’attributs composés multiples

# This tree determines a bid price as follows:
# 1. If this user is in segment 3 and has a value greater than 1 or has been in the segment for 5 minutes, bid $1.
# 2. If the user has seen an ad in line item 3 more than 5 minutes ago and an ad in campaign 2 less than four times today, bid $3.
# 3. If the user has seen an ad in line item 1 more than 5 times ever or more than 4 times today, or if the user has seen an ad in advertiser 2 more than 4 times today, bid $0.50.
# 4. Otherwise, bid nothing.
if any segment[3].value > 1, segment[3].age = 5:
    1
elif every line_item[3].recency > 5, campaign[2].day_frequency < 4: 
        3 
elif any line_item[1].lifetime_frequency > 5, line_item[1].day_frequency > 4, advertiser[2].day_frequency > 4: 
        0.50 
else: 
        0