Ciencia de datos Toolkit: características del lenguaje Bonsai

Artículo
05/18/2024

En esta página se enumeran las características del lenguaje Bonsai que puede usar para evaluar las impresiones como parte de la lógica del modelo personalizado. Para cada característica, se explica la sintaxis y se proporciona un ejemplo para demostrar el uso.

Nota:

Las pujas que son negativas o cero (0) no se admiten a menos que se especifiquen explícitamente en la descripción de la característica. No use estas expresiones ni se pueden producir resultados inesperados. Es mejor especificar no_bid explícitamente el uso de hojas inteligentes.
Las pujas calculadas por el modelo siempre se expresan en la moneda establecida en el anunciante, incluso si ha especificado una moneda diferente para la campaña.

Características sencillas

País

Evalúe las impresiones en función del país del usuario.

Palabra clave: country

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: id. de país o código, como 233 o "US". Use el Servicio de país para recuperar estos identificadores o códigos.

Ejemplo:

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

Segmentación de contenido de vídeo

Evalúe las impresiones en función del inventario de contenido de vídeo del usuario.

Palabra clave: video_duration, video_delivery_type, video_genre, video_program_type, video_rating, video_network

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor:

Ejemplo:

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

Región

Evalúe las impresiones en función de la región geográfica del usuario.

Palabra clave: region

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: id. de región o combinación de código de país o región, como "US:NY". Use el Servicio de región para recuperar estos identificadores y códigos.

Ejemplo:

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

Ciudad

Evalúe las impresiones en función de la ciudad del usuario.

Palabra clave: city

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: id. de ciudad o combinación de código de país, región o ciudad, como "US:NY:New York". Use city service para recuperar estos identificadores y códigos.

Ejemplo:

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

DMA

Evalúe las impresiones en función de la DMA del usuario (área de mercado designada).

Palabra clave: dma

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: id. DMA, como 602 (para el área metropolitana de Chicago). Use city service para recuperar identificadores DMA.

Ejemplo:

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

Código postal

Evalúe las impresiones en función del código postal del usuario. El código postal solo está disponible para algunas impresiones y impresiones móviles de proveedores externos.

Palabra clave: postal_code

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: id. de código postal (un entero) o combinación de país o código postal (una cadena como "CA:J0K 1B0" o "US:10010"). Incluye códigos postales de EE. UU. Use el Servicio de código postal (documentado en el servicio de perfil) para recuperar los identificadores de código postal.

Ejemplo:

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

Lista de códigos postales

Evalúe las impresiones en función de la lista de códigos postales del usuario.

Palabra clave: postal_code_list[ID]

Operador: ninguno para la presencia, no para la ausencia.

Valor: Ninguno

Ejemplo:

elif postal_code_list[120]:
value: 1

Lista de ofertas

Evalúe las impresiones en función de la lista de ofertas del usuario.

Palabra clave: deal_list[ID]

Operador: ninguno para la presencia, no para la ausencia.

Valor: Ninguno

Ejemplo:

elif deal_list[4107]:
value: 2

Size

Evalúe las impresiones en función del tamaño de la ubicación. Tenga en cuenta que, en caso promo_sizes de que se pasen en la llamada de anuncio, la evaluación se realizará solo con el tamaño principal.

Palabra clave: size

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: cadena que representa las dimensiones de ubicación, con "WIDTHxHEIGHT"formato .

Ejemplo:

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

Día de la semana

Evalúe las impresiones en función de los días específicos de la semana.

Palabra clave: user_day

Operador: Any

Valor: día de la semana. Valores posibles: 0 - 6, donde 0 es domingo y 6 es sábado.

Ejemplo:

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

Hora del día

Evalúe las impresiones en función de horas específicas del día.

Palabra clave: user_hour

Operador: Any

Valor: hora del día, en la zona horaria del usuario. Valores posibles: 0 - 23, donde 0 es medianoche y 23 es a las 23:00.

Ejemplo:

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

Familia de sistemas operativos

Evalúe las impresiones en función del sistema operativo del usuario.

Palabra clave: os_family

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: id. o nombre de la familia del sistema operativo, como 2 o "Android". Use el servicio de familia del sistema operativo para recuperar estos identificadores y nombres.

Ejemplo:

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

Versión del sistema operativo

Evalúe las impresiones en función de la versión específica del sistema operativo del usuario.

Nota:

Para la os_extended característica, un resultado de la tabla de búsqueda de 0 se considera igual a falta.

Palabra clave: os_extended

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: identificador extendido del sistema operativo, como 81 para "10.8 Mountain Lion". Use el servicio extendido del sistema operativo para recuperar estos identificadores.

Nota:

El identificador del sistema operativo aparece como operating_system en los datos de nivel de registro.

Ejemplo:

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

Explorador

Evalúe las impresiones en función del explorador del usuario.

Nota:

Para la browser característica, un resultado de la tabla de búsqueda de 0 se considera igual a falta.

Palabra clave: browser

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: id. o nombre del explorador, como 8 o "Chrome (all versions)". Use el servicio Browser para recuperar estos identificadores y nombres.

Ejemplo:

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

Idioma del explorador

Evalúe las impresiones en función del idioma del explorador.

Nota:

Para la language característica, un resultado de la tabla de búsqueda de 0 se considera igual a falta.

Palabra clave: language

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: Id. de idioma. Use language service para recuperar estos identificadores.

Ejemplo:

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

Gender

Evalúe las impresiones en función del sexo del usuario. Tenga en cuenta que el género solo está disponible en los casos en los que el publicador lo pasa en la llamada de anuncio. Para obtener más información sobre las llamadas de anuncios, consulte "Parámetros de etiqueta de ubicación" en la documentación.

Palabra clave: user_gender

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: género del usuario. Posibles valores:

"female"
"male"
"unknown"

Ejemplo:

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

Dominio

Evaluar las impresiones en función del dominio.

Palabra clave: domain

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: cadena que representa un nombre de dominio de nivel superior, como "food.com" o "books".

Ejemplo:

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

Dirección IP

Evalúa las impresiones en función de la dirección IP.

Nota:

Los clientes de países que cumplan con las regulaciones del RGPD deben tener en cuenta que al dirigirse a direcciones IP o intervalos IP, ya sea en el elemento de línea, el árbol de Bonsai o el modelo de regresión logística, existe la posibilidad de que la dirección se trunque. Para obtener más información sobre este proceso, consulte nuestras directivas de servicio.

Palabra clave: ip_address

Operador: in

Valor: cadena que representa cualquier dirección IP válida, incluida la notación de subred. Por ejemplo, el intervalo (192.168.0.1, 10.0.0.0/24) indica las direcciones IP 192.168.0.1 y 10.0.0.0-10.0.0.255.

Ejemplo:

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

Posición de plegado

Evalúe las impresiones en función de posiciones de ubicación específicas en relación con el pliegue de la página.

Palabra clave: position

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: posición de plegado. Posibles valores:

0 or "unknown" - Use estos valores para establecer como destino las ubicaciones en las que se desconoce la posición del pliegue.
1 or "above" - Use estos valores para establecer como destino las ubicaciones situadas encima del pliegue.
2 or "below" - Use estos valores para dirigirse a las ubicaciones situadas debajo del pliegue.

Ejemplo:

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

Ubicación

Evalúe las impresiones en función de ubicaciones específicas.

Palabra clave: placement

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: id. de ubicación.

Nota:

El identificador de ubicación aparece como tag_id en los datos de nivel de registro.

Ejemplo:

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

Grupo de selección de ubicación

Evalúe las impresiones en función de grupos de ubicaciones específicos.

Palabra clave: placement_group

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: identificador de grupo de selección de ubicación.

Nota:

El identificador de grupo de selección de ubicación aparece como site_id en los datos de nivel de registro.

Ejemplo:

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

Publisher

Evalúe las impresiones en función de publicadores específicos.

Palabra clave: publisher

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: Id. del publicador.

Nota:

El identificador del publicador aparece como publisher_id en los datos de nivel de registro.

Ejemplo:

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

Miembro del vendedor

Evalúe las impresiones en función de los miembros del vendedor específicos.

Palabra clave: seller_member_id

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: id. de miembro del vendedor.

Ejemplo:

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

Tipo de suministro

Evalúe las impresiones en función de tipos específicos de suministro.

Palabra clave: supply_type

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: proporcione el identificador o el nombre del tipo. Posibles valores:

0 or "web" - Use cualquiera de estos valores para dirigirse a sitios web estándar.
1 or "mobile_web" - Use cualquiera de estos valores para dirigirse a sitios web optimizados para exploradores en tabletas móviles y teléfonos.
2 or "mobile_app" - Use cualquiera de estos valores para dirigirse a aplicaciones instaladas en tabletas móviles y teléfonos.

Ejemplo:

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

Tipo de dispositivo

Evalúe las impresiones en función de tipos específicos de dispositivos físicos.

Palabra clave: device_type

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: nombre del tipo de dispositivo. Posibles valores:

"pc & other devices" - Use este valor para dirigirse a equipos de escritorio y portátiles.
"phone" - Use este valor para dirigirse a teléfonos móviles.
"tablet" - Use este valor para dirigirse a tabletas móviles.

Ejemplo:

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

Modelo del dispositivo

Evalúe las impresiones en función de modelos específicos de dispositivos físicos.

Palabra clave: device_model

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: id. de modelo de dispositivo. Use device model service para recuperar estos identificadores.

Nota:

El identificador del modelo de dispositivo aparece como device_id en los datos de nivel de registro.

Ejemplo:

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

Portador

Evalúe las impresiones en función de operadores móviles específicos.

Palabra clave: carrier

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: id. o nombre del operador de telefonía móvil, como 14 o "Verizon". Use el Servicio de operador para recuperar estos identificadores y nombres.

Ejemplo:

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

Aplicación para móviles

Evalúe las impresiones en función de aplicaciones móviles específicas.

Palabra clave: mobile_app

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: id. o nombres de aplicación móvil. Use Mobile App Service para recuperar estos identificadores o nombres.

Ejemplo:

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

Instancia de aplicación móvil

Evalúe las impresiones en función de instalaciones de aplicaciones móviles específicas.

Palabra clave: mobile_app_instance

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: Id. de instancia de aplicación móvil. Use Mobile App Instance Service para recuperar estos identificadores.

Ejemplo:

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

Paquete de aplicaciones móviles

Evalúe las impresiones en función de conjuntos de aplicaciones móviles específicos.

Palabra clave: mobile_app_bundle

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: id. de lote de aplicaciones móviles. Use Mobile App Instance Service para recuperar estos identificadores.

Ejemplo:

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

Evalúe las impresiones en función de cuánto tiempo, en minutos, el usuario ha tenido una cookie Xandr.

Palabra clave: cookie_age

Operador: Any

Valor: entero positivo que representa el número de minutos que el usuario ha tenido una cookie Xandr. Este valor puede estar ausente, lo que indica que el usuario no tiene una cookie Xandr.

Ejemplo:

if cookie_age > 30:
2
else:
0.2

Tasa de visualización de IAB prevista

(Anteriormente conocido como "Tasa de visualización estimada de IAB"). Evalúe las impresiones de la pantalla web según la probabilidad de que se midan como visibles por el estándar IAB, según lo determinado por la optimización de Xandr.

Palabra clave: predicted_iab_view_rate

Alias (en desuso):estimated_iab_viewthrough_rate

Operador: Any

Valor: número decimal entre 0 y 1, que representa un porcentaje.

Ejemplo:

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

Tasa de visualización de IAB prevista sobre el total

Evalúe las impresiones de la pantalla web según la probabilidad de que se midan como visibles, sobre el número total de impresiones (vistas o totales), según el estándar IAB, determinado por la optimización Xandr.

Palabra clave: predicted_iab_view_rate_over_total

Operador: Any

Valor: número decimal entre 0 y 1, que representa un porcentaje.

Ejemplo:

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

Velocidad de visualización de vídeo de IAB prevista

Evalúe las impresiones de vídeo web según la probabilidad de que se midan como visibles por el estándar IAB, según lo determinado por la optimización de Xandr.

Palabra clave: predicted_iab_video_view_rate

Operador: Any

Valor: número decimal entre 0 y 1, que representa un porcentaje.

Ejemplo:

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

Tasa de visualización de vídeo de IAB prevista sobre el total

Evalúe las impresiones de vídeo web según la probabilidad de que se midan como visibles sobre el número total de impresiones (impresiones vistas o medidas) por la definición personalizada de 100 % de píxeles visibles durante al menos 1 segundo, según lo determinado por la optimización Xandr.

Palabra clave: predicted_iab_video_view_rate_over_total

Operador: Any

Valor: número decimal entre 0 y 1, que representa un porcentaje.

Ejemplo:

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

Tasa de visualización prevista (100 % de vista, una segunda duración)

Evalúe las impresiones de vídeo de visualización según la probabilidad de que se midan como visibles (vistas o medidas) mediante la definición personalizada de 100 % de píxeles visibles durante al menos 1 segundo, según lo determinado por la optimización Xandr.

Palabra clave: predicted_100pv1s_display_view_rate

Operador: Any

Valor: número decimal entre 0 y 1, que representa un porcentaje.

Ejemplo:

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

Tasa de visualización de visualización prevista sobre el total (100 % de vista, una segunda duración)

Evalúe las impresiones de pantalla web según la probabilidad de que se midan como visibles (vistas o totales) mediante la definición personalizada de 100 % de píxeles visibles durante al menos 1 segundo, según lo determinado por la optimización Xandr.

Palabra clave: predicted_100pv1s_display_view_rate_over_total

Operador: Any

Valor: número decimal entre 0 y 1, que representa un porcentaje.

Ejemplo:

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

Velocidad de visualización de vídeo prevista (100 % de vista, 50 % de duración, sonido activado)

Evalúe las impresiones de vídeo web según la probabilidad de que se midan como visibles (impresiones vistas o medidas) donde una "vista" se define como un anuncio que es 100% visible y se ha reproducido durante al menos el 50 % de su duración, con el sonido activado. La probabilidad viene determinada por la optimización de Xandr.

Palabra clave: predicted_100pv50pd_video_view_rate

Operador: Any

Valor: número decimal entre 0 y 1, que representa un porcentaje.

Ejemplo:

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

Tasa de visualización de vídeo prevista sobre el total (100 % de vista, 50 % de duración, sonido activado)

Evalúe las impresiones de vídeo web según la probabilidad de que se midan como visibles, sobre el número total de impresiones (vistas o totales), donde una "vista" se define como un anuncio que es 100% visible y ha jugado al menos el 50 % de su duración, con el sonido activado. La probabilidad viene determinada por la optimización de Xandr.

Palabra clave: predicted_100pv50pd_video_view_rate_over_total

Operador: Any

Valor: número decimal entre 0 y 1, que representa un porcentaje.

Ejemplo:

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

Tasa de finalización de vídeo prevista

Evalúe las impresiones de vídeo web según la probabilidad de que se completen, según lo determinado por la optimización de Xandr.

Palabra clave: predicted_video_completion_rate

Alias (en desuso):estimated_video_completion_rate

Operador: Any

Valor: número decimal entre 0 y 1, que representa un porcentaje. 0 representa el inventario que no es de vídeo.

Ejemplo:

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

Audiencia prevista de Xandr

Evalúa las impresiones en función de su audiencia prevista según lo determinado por la auditoría de la plataforma Xandr.

Palabra clave: appnexus_intended_audience

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: "general", "children", "young_adult"o "mature".

Ejemplo:

if appnexus_intended_audience = "mature":
1
else:
0

Audiencia prevista para el vendedor

Evalúa las impresiones en función de su audiencia prevista según lo determinado por la auto auditación. Para obtener más información, consulte "Clasificación automática de inventario" en la documentación y Servicio de perfiles.

Palabra clave: seller_intended_audience

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: "general", "children", "young_adult"o "mature".

Ejemplo:

if appnexus_intended_audience = "general":
1
else:
0

Estado auditado de Xandr

Evalúa si Xandr ha auditado el inventario.

Palabra clave: appnexus_audited

Operador: cualquiera excepto <, >, <=, >=y range.

Valor: true o false

Ejemplo:

if appnexus_audited = true:
1.0
else:
0.0

Estado auto auditado

Evalúa si el publicador ha auditado el inventario.

Palabra clave: self_audited

Operador: cualquiera excepto <, >, <=, >=y range.

Valor: true o false

Ejemplo:

if self_audited = true:
1.0
else:
0.0

Grupo de usuarios

Evalúa si el usuario pertenece a un grupo asignado aleatoriamente. Cada usuario de Xandr tiene un grupo de usuarios persistente de 0 a 999. Es posible que quiera usar el grupo de usuarios para probar varias estrategias en paralelo y comparar su rendimiento. Las distintas pruebas deben particionar los miles de grupos de usuarios de forma diferente; De lo contrario, las pruebas simultáneas interactuarán entre sí y será difícil interpretar los resultados. Para obtener más información, consulte Test and Control Targeting en la documentación.

Palabra clave: user_group

Operador: Any

Valor: entero entre 0 y 999.

Ejemplo:

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

Frecuencia del mes de campaña (solo administradores del sistema)

Evalúe las impresiones en función del número de impresiones que ha visto un usuario para la campaña actual en el mes actual.

Palabra clave: campaign_month_frequency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Valor: entero positivo que representa el número de impresiones que ha visto un usuario para la campaña actual en el calendario actual. 0 indica que no hay información de frecuencia disponible (el usuario no ha visto este objeto en el calendario actual).

Ejemplo:

if campaign_month_frequency < 2 :
5
else :
0.1

Frecuencia del mes del elemento de línea

Evalúe las impresiones en función del número de impresiones que ha visto un usuario para el elemento de línea actual en el mes actual.

Palabra clave: line_item_month_frequency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Valor: entero positivo que representa el número de impresiones que ha visto un usuario para el elemento de línea actual en el mes actual. 0 indica que no hay información de frecuencia disponible (el usuario no ha visto una creatividad relacionada con este objeto en el mes actual).

Ejemplo:

if line_item_month_frequency < 2:
5
else:
0.1

Frecuencia del mes del anunciante

Evalúe las impresiones en función del número de anuncios vistos por un usuario en el mes actual.

Palabra clave: advertiser_month_frequency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Valor: entero positivo que representa el número de anuncios vistos por un usuario en el mes actual. 0 indica que no hay información de frecuencia disponible (el usuario no ha visto este objeto en el mes actual).

Ejemplo:

if advertiser_month_frequency < 2:
5
else:
0.1

Frecuencia de la hora de la campaña

Evalúe las impresiones en función del número de anuncios vistos por un usuario en la hora actual.

Palabra clave: campaign_hour_frequency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Valor: entero positivo que representa el número de anuncios vistos por un usuario en la hora actual. 0 indica que no hay información de frecuencia disponible (el usuario no ha visto este objeto en la hora actual).

Ejemplo:

if campaign_hour_frequency < 2:
5
else:
0.1

Frecuencia de la hora del elemento de línea

Evalúe las impresiones en función del número de anuncios vistos por un usuario en la hora actual.

Palabra clave: line_item_hour_frequency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Ejemplo:

if line_item_hour_frequency < 2:
5
else:
0.1

Frecuencia de hora del anunciante

Evalúe las impresiones en función del número de anuncios vistos por un usuario en la hora actual.

Palabra clave: advertiser_hour_frequency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Ejemplo:

if advertiser_hour_frequency < 2:
2
else:
0.1

Frecuencia de la semana de la campaña (solo administradores del sistema)

Evalúe las impresiones en función del número de anuncios vistos por un usuario en la semana actual, a partir del domingo.

Palabra clave: campaign_week_frequency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Valor: entero positivo que representa el número de anuncios vistos por un usuario en la semana actual. 0 indica que no hay información de frecuencia disponible (el usuario no ha visto este objeto en la semana actual).

Ejemplo:

if campaign_week_frequency < 2 :
5
else :
0.1

Frecuencia de la semana del elemento de línea

Evalúe las impresiones en función del número de anuncios vistos por un usuario en la semana actual, a partir del domingo.

Palabra clave: line_item_week_frequency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Ejemplo:

if line_item_week_frequency < 2:
5
else:
0.1

Frecuencia de la semana del anunciante

Evalúe las impresiones en función del número de anuncios vistos por un usuario en la semana actual, a partir del domingo.

Palabra clave: advertiser_week_frequency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Ejemplo:

if advertiser_week_frequency < 2:
5
else:
0.1

Frecuencia del día de la campaña (solo administradores del sistema)

Evalúe las impresiones en función del número de anuncios vistos por un usuario en el día actual.

Palabra clave: campaign_day_frequency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Valor: entero positivo que representa el número de anuncios vistos por un usuario en el día actual. 0 indica que no hay información de frecuencia disponible (el usuario no ha visto este objeto en el día actual).

Ejemplo:

if campaign_day_frequency < 2 :
5
else :
0.1

Recencia de campaña (solo administradores del sistema)

Evalúe si hay datos de censura disponibles para un usuario y, si está disponible, el número de minutos transcurridos desde que un usuario ha visto un anuncio.

Palabra clave: campaign_recency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Valor: entero positivo que indica el número de minutos desde que un usuario ha visto una impresión, redondeada hacia abajo. 59 segundos se evaluarán como 0, 61 segundos se evaluarán como 1. 0 significa que la impresión se ha visto muy recientemente. Null significa que no hay datos de censura disponibles (el usuario no ha visto esta impresión antes).

Ejemplo:

if campaign_recency < 2 :
2
else :
0.1

Recencia de elementos de línea

Evalúe si hay datos de censura disponibles para un usuario y, si está disponible, el número de minutos transcurridos desde que un usuario ha visto un anuncio.

Palabra clave: line_item_recency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Ejemplo:

if line_item_recency < 2:
5
else:
0.1

Censura del anunciante

Evalúe si hay datos de censura disponibles para un usuario y, si está disponible, el número de minutos transcurridos desde que un usuario ha visto un anuncio.

Palabra clave: advertiser_recency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Ejemplo:

if advertiser_recency < 2:
5
else:
0.1

Creatividad

Evaluar las impresiones en función de la creatividad.

Palabra clave: creative

Operador: Any

Valor: cadena que representa el identificador creativo (debe ser un entero).

Ejemplo:

if creative=12345:
5
else:
0.1

Tamaño creativo

Evalúe las impresiones en función del tamaño creativo.

Palabra clave: creative_size

Operador: cualquiera excepto <, >, <=, >=y range. Para probar varios valores, use in.

Valor: cadena que representa dimensiones creativas, con "WIDTHxHEIGHT"formato .

Ejemplo:

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

Identificador de la oferta

Evalúe las impresiones en función del identificador de la oferta.

Palabra clave: deal_id

Operador: Cualquiera excepto range.

Valor: cadena que representa el identificador de la transacción como un entero.

Ejemplo:

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

Aleatorio1, Aleatorio2, Aleatorio 3

Evalúe las impresiones en función de una variable aleatoria entre 0 y 1. Cuando se usa, este parámetro agrega cierta aleatoriedad al algoritmo Bonsai.

Palabra clave : random1, random2, random3

Operador: Cualquiera. Para probar varios valores, use in.

Valor: valor entre 0 y 1, con formato decimal de hasta 6 posiciones decimales.

Ejemplo:

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

Id. de dirección URL de inventario

Evalúe las impresiones en función del identificador de dirección URL de inventario* que se asigna a una dirección URL de inventario.

Palabra clave: inventory_url_id

Operador: cualquiera excepto <, >, <=, >=y range.

Valor: id. de dirección URL de inventario (un entero).

Ejemplo:

if inventory_url_id=12345:
5
else:
0.1

* Solo disponible en elementos de línea aumentadas

Características compuestas

Las características simples anteriores permiten evaluar un único aspecto de la impresión (país, edad de las cookies, aplicación móvil, etc.). Las características compuestas de segmento y frecuencia/recencia son más matizadas; permiten evaluar varios atributos de estas características, como la antigüedad de un segmento o el valor del segmento.

Presencia/ausencia de segmentos

Evalúe las impresiones en función de la presencia del usuario en un segmento de terceros o de terceros.

Palabra clave: segment[ID] donde ID es el identificador de segmento. Use Segment Service para recuperar identificadores de segmento.

Atributo: Ninguno

Operador: ninguno para la presencia, not para la ausencia.

Valor: Ninguno

Ejemplo:

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

Antigüedad del segmento

Evalúe las impresiones en función de los minutos transcurridos desde que el usuario se agregó a un segmento de terceros o de terceros.

Nota:

Si el usuario no está en el segmento, esta característica se Falseevalúa como .

Palabra clave: segment[ID] donde ID es el identificador de segmento. Use Segment Service para recuperar identificadores de segmento.

Atributo: .age

Operador: < , > o =

Valor: entero positivo que representa los minutos transcurridos desde que el usuario se agregó al segmento.

Ejemplo:

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

Valor de segmento

Evalúe las impresiones en función de un valor definido por el usuario. El valor se puede pasar de varias maneras, por ejemplo, a través del servicio de segmento de Batch o una cadena de consulta de segmento de terceros o de terceros. Para obtener más información sobre cómo pasar valores a través de cadenas de consulta de segmentos, consulte Segment Pixels Advanced en la documentación.

Nota:

Si el usuario no está en el segmento, esta característica se Falseevalúa como .

Palabra clave: segment[ID] donde ID es el identificador de segmento. Use Segment Service para recuperar identificadores de segmento.

Atributo: .value

Operador: <, >o =

Valor: entero positivo distinto de cero que representa el valor definido por el usuario.

Ejemplo:

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

Frecuencia/recencia

Presencia/ausencia de frecuencia
Frecuencia de duración
Frecuencia diaria
Presencia/ausencia y datos de recencia

Presencia/ausencia de frecuencia

Evalúe si los datos de frecuencia están disponibles o no para el usuario. Esto se puede determinar para todos los anuncios de un anunciante, artículo de línea o campaña.

Palabra clave: frequency

Atributo: OBJECT[ID]. donde OBJECT es advertiser, line_itemo campaign, y ID es el identificador de objeto. Use el Servicio de anunciantes, el Servicio de artículos de línea o el Servicio de campaña para recuperar los identificadores.

Operador: < , > o =

Valor: 0 indica que el usuario nunca ha visto una impresión para este objeto; un entero positivo indica que la información de frecuencia está disponible.

Nota:

A diferencia de la recencia, los datos de frecuencia nunca son null. Si un usuario nunca ha visto una impresión para este objeto, frequency es 0.

Ejemplo:

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

Frecuencia de duración

Evalúe las impresiones en función del número de anuncios vistos por un usuario a lo largo de la duración de un anunciante, un artículo de línea o una campaña.

Palabra clave: lifetime_frequency

Atributo: OBJECT[ID]. donde OBJECT es advertiser, line_itemo campaign, o creative, y ID es el identificador de objeto. Use el Servicio de anunciantes, el Servicio de artículos de línea o el Servicio de campaña para recuperar los identificadores.

Operador: =<, <=, presence/absence, in, comparison, noty range.

Valor: entero positivo que representa el número de anuncios vistos por un usuario a lo largo de la duración del objeto. 0 indica que no hay información de frecuencia disponible (el usuario nunca ha visto este objeto).

Ejemplo:

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

Frecuencia diaria

Evalúe las impresiones en función del número de impresiones que ha visto un usuario en el día actual. Esto se puede determinar para un anunciante, un artículo de línea o una campaña.

Palabra clave: day_frequency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Ejemplo:

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

Presencia o ausencia de censura y datos

Evalúa si hay datos de recencia disponibles para un usuario y, si está disponible, el número de minutos transcurridos desde que un usuario ha visto un anuncio. Esto se puede determinar para un usuario para todos los anuncios de un anunciante, un artículo de línea o una campaña.

Palabra clave: recency

Operador: =<, <=, presence/absence, in, comparison, noty range.

Ejemplo:

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

Ejemplos de sintaxis de características compuestas mediante varios atributos

Ejemplo de varios atributos de segmento

# 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

Ejemplo de sintaxis de frecuencia y recencia con varios atributos

# 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

Ejemplo de varios atributos compuestos

# 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

Compartir a través de

Ciencia de datos Toolkit: características del lenguaje Bonsai

Características sencillas

País

Segmentación de contenido de vídeo

Región

Ciudad

DMA

Código postal

Lista de códigos postales

Lista de ofertas

Size

Día de la semana

Hora del día

Familia de sistemas operativos

Versión del sistema operativo

Explorador

Idioma del explorador

Gender

Dominio

Dirección IP

Posición de plegado

Ubicación

Grupo de selección de ubicación

Publisher

Miembro del vendedor

Tipo de suministro

Tipo de dispositivo

Modelo del dispositivo

Portador

Aplicación para móviles

Instancia de aplicación móvil

Paquete de aplicaciones móviles

Antigüedad de las cookies

Tasa de visualización de IAB prevista

Tasa de visualización de IAB prevista sobre el total

Velocidad de visualización de vídeo de IAB prevista

Tasa de visualización de vídeo de IAB prevista sobre el total

Tasa de visualización prevista (100 % de vista, una segunda duración)

Tasa de visualización de visualización prevista sobre el total (100 % de vista, una segunda duración)

Velocidad de visualización de vídeo prevista (100 % de vista, 50 % de duración, sonido activado)

Tasa de visualización de vídeo prevista sobre el total (100 % de vista, 50 % de duración, sonido activado)

Tasa de finalización de vídeo prevista

Audiencia prevista de Xandr

Audiencia prevista para el vendedor

Estado auditado de Xandr

Estado auto auditado

Grupo de usuarios

Frecuencia del mes de campaña (solo administradores del sistema)

Frecuencia del mes del elemento de línea

Frecuencia del mes del anunciante

Frecuencia de la hora de la campaña

Frecuencia de la hora del elemento de línea

Frecuencia de hora del anunciante

Frecuencia de la semana de la campaña (solo administradores del sistema)

Frecuencia de la semana del elemento de línea

Frecuencia de la semana del anunciante

Frecuencia del día de la campaña (solo administradores del sistema)

Recencia de campaña (solo administradores del sistema)

Recencia de elementos de línea

Censura del anunciante

Creatividad

Tamaño creativo

Identificador de la oferta

Aleatorio1, Aleatorio2, Aleatorio 3

Id. de dirección URL de inventario

Características compuestas

Segmento

Presencia/ausencia de segmentos

Antigüedad del segmento

Valor de segmento

Frecuencia/recencia

Presencia/ausencia de frecuencia

Frecuencia de duración

Frecuencia diaria

Presencia o ausencia de censura y datos

Ejemplos de sintaxis de características compuestas mediante varios atributos

Ejemplo de varios atributos de segmento

Ejemplo de sintaxis de frecuencia y recencia con varios atributos

Ejemplo de varios atributos compuestos