Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En esta página se enumeran las características del lenguaje Bonsai que puedes utilizar para evaluar las impresiones como parte de la lógica de tu modelo personalizado. Para cada característica, explicamos la sintaxis y proporcionamos un ejemplo para demostrar el uso.
Nota:
- Las pujas negativas o cero (0) no se admiten a menos que se especifique explícitamente en la descripción de la característica. No use estas expresiones o se pueden producir resultados inesperados. Es mejor especificar
no_bidexplícitamente mediante 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úa las impresiones según el país o la región del usuario.
Palabra clave: country
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: Id. de país o código, como 233 o "US". Utilice el servicio del 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úa las impresiones basándose en el 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 comprobar si hay 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úa las impresiones en función de la región geográfica del usuario.
Palabra clave: region
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: Identificador de región o combinación de código de país y 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úa las impresiones en función de la ciudad del usuario.
Palabra clave: city
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: Id. de ciudad o combinación de código país/región/ciudad, como "US:NY:New York". Utilice el Servicio de la Ciudad para recuperar estas identificaciones y códigos.
Ejemplo:
if city = 162:
5
elif city = "US:MA:Boston":
3
else:
0.1
DMA
Evalúa las impresiones según la DMA (área de mercado designada) del usuario.
Palabra clave: dma
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: Id. de DMA, como 602 (para área metropolitana de Chicago). Use el servicio de la ciudad para recuperar los identificadores de DMA.
Ejemplo:
if dma = 602:
5
elif dma = 603:
3
else:
0.1
Código postal
Evalúa las impresiones en función del código postal del usuario. El código postal solo está disponible para algunas impresiones móviles e impresiones de proveedores externos.
Palabra clave: postal_code
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: Id. de código postal (un entero) o combinación de país o región/código postal (una cadena como "CA:J0K 1B0" o "US:10010"). Incluye códigos postales de EE. UU.
Use el servicio de códigos postales (documentado en el servicio de perfiles) 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úa las impresiones en función de la lista de códigos postales del usuario.
Palabra clave: postal_code_list[ID]
Operador: Ninguno para presencia, no para 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 presencia, no para ausencia.
Valor: ninguno
Ejemplo:
elif deal_list[4107]:
value: 2
Size
Evalúa las impresiones según el tamaño de la ubicación. Ten en cuenta que, en caso de promo_sizes que se aprueben en la llamada de anuncios, la evaluación se realizará utilizando solo el tamaño primario.
Palabra clave: size
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: cadena que representa las dimensiones de emplazamiento, con formato ."WIDTHxHEIGHT"
Ejemplo:
if size = "300x250":
5
elif size = "250x250":
3
else:
0.1
Día de la semana
Evalúa las impresiones en función de días específicos de la semana.
Palabra clave: user_day
Operador: Cualquiera
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úa las impresiones en función de horas específicas del día.
Palabra clave: user_hour
Operador: Cualquiera
Valor: hora del día, en la zona horaria del usuario. Valores posibles: 0 - 23, donde 0 es medianoche y 23 es 11 pm.
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úa las impresiones en función del sistema operativo del usuario.
Palabra clave: os_family
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: el id. de familia o el nombre 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úa 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 que falta.
Palabra clave: os_extended
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: ID extendido del sistema operativo, como 81 para "10.8 Mountain Lion". Use el servicio extendido del sistema operativo para recuperar estos identificadores.
Nota:
El Id. del sistema operativo se muestra 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úa 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 que falta.
Palabra clave: browser
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: Id. o nombre del explorador, como 8 o "Chrome (all versions)". Utilice el servicio de explorador 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úa 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 que falta.
Palabra clave: language
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: Id. de idioma. Use el servicio de idiomas para recuperar estos identificadores.
Ejemplo:
if language = 1:
3
elif language = 0:
1
else:
0
Gender
Evalúa las impresiones en función del sexo del usuario. Ten en cuenta que el sexo solo está disponible en los casos en que el editor lo pase en la llamada del anuncio. Para obtener más información sobre las llamadas de anuncios, consulta "Parámetros de la etiqueta de emplazamiento" en la documentación.
Palabra clave: user_gender
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay 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
Evalúa las impresiones según el dominio.
Palabra clave: domain
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay 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 o regiones que cumplan con las normativas del RGPD deben tener en cuenta que al dirigirse a direcciones IP o rangos de IP, ya sea en su elemento de línea, árbol Bonsái o 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úa las impresiones según las posiciones de posicionamiento específicas en relación con el pliegue de la página.
Palabra clave: position
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: Posición de plegado. Posibles valores:
-
0 or "unknown"- Usa estos valores para segmentar ubicaciones en las que se desconozca la posición de retirada. -
1 or "above"- Usa estos valores para segmentar ubicaciones en la parte superior de la página. -
2 or "below"- Usa estos valores para segmentar ubicaciones debajo del pliegue.
Ejemplo:
if position = "above":
3
elif position = 2:
1
else:
0
Ubicación
Evalúa las impresiones basándote en emplazamientos específicos.
Palabra clave: placement
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: Id. de emplazamiento
Nota:
El ID de emplazamiento se muestra como tag_id en los datos de nivel de registro.
Ejemplo:
if placement = 300:
5
elif placement = 301:
4.5
else:
0.2
Grupo con ubicación
Evalúa las impresiones basándote en grupos de emplazamientos específicos.
Palabra clave: placement_group
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: identificador del grupo de ubicación.
Nota:
El ID del grupo con ubicación aparece en site_id los datos de nivel de registro.
Ejemplo:
if placement_group = 155:
5
elif placement_group = 156:
4.50
else:
0.2
Publisher
Evalúa las impresiones basándote en editores específicos.
Palabra clave: publisher
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: Id. de editor.
Nota:
El Id. del publicador aparece en los publisher_id datos de nivel de registro.
Ejemplo:
if publisher = 1300:
5
elif publisher = 1301:
4.50
else:
0.2
Miembro vendedor
Evalúa las impresiones en función de miembros vendedores específicos.
Palabra clave: seller_member_id
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay 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 comprobar si hay varios valores, use in.
Valor: Id. o nombre del tipo de suministro. Posibles valores:
-
0 or "web"- Use cualquiera de estos valores para orientar los sitios web estándar. -
1 or "mobile_web"- Utilice cualquiera de estos valores para orientar sitios web optimizados para navegadores móviles, tabletas y teléfonos. -
2 or "mobile_app"- Usa cualquiera de estos valores para segmentar las aplicaciones instaladas en teléfonos y tabletas móviles.
Ejemplo:
if supply_type = "web":
4
elif supply_type = "mobile_web":
3
elif supply_type = 2:
2
else:
0.2
Tipo de dispositivo
Evalúa las impresiones en función de tipos específicos de dispositivos físicos.
Palabra clave: device_type
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: nombre de tipo de dispositivo. Posibles valores:
-
"pc & other devices"- Usa este valor para segmentar equipos de escritorio y portátiles. -
"phone"- Usa este valor para dirigirte a teléfonos móviles. -
"tablet"- Usa este valor para dirigirte a las 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úa las impresiones en función de modelos específicos de dispositivos físicos.
Palabra clave: device_model
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: Id. de modelo de dispositivo. Use el Servicio de modelo de dispositivo para recuperar estos identificadores.
Nota:
El identificador de 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
Operador
Evalúa las impresiones en función de los operadores de telefonía móvil específicos.
Palabra clave: carrier
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay 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úa las impresiones basándote en aplicaciones móviles específicas.
Palabra clave: mobile_app
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay 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úa las impresiones basándote en instalaciones específicas de aplicaciones móviles.
Palabra clave: mobile_app_instance
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: Id. de instancia de aplicación móvil. Use el Servicio de instancia de aplicaciones móviles 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 aplicación móvil
Evalúa las impresiones basándote en paquetes de aplicaciones móviles específicos.
Palabra clave: mobile_app_bundle
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: Id. de agrupación de aplicación móvil. Use el Servicio de instancia de aplicaciones móviles para recuperar estos identificadores.
Ejemplo:
if mobile_app_bundle in ("553834731", "com.king.candycrushsaga"):
5
else:
0.2
Edad de las cookies
Evalúa las impresiones en función de cuánto tiempo, en minutos, el usuario ha tenido una cookie Xandr.
Palabra clave: cookie_age
Operador: Cualquiera
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 visibilidad IAB prevista
(Anteriormente conocida como "Tasa de visibilidad IAB estimada"). Evalúa las impresiones de visualización web en función de la probabilidad de que se midan como visibles según 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: Cualquiera
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 visibilidad IAB prevista sobre el total
Evalúa las impresiones de visualización web en función de la probabilidad de que se midan como visibles, sobre el número total de impresiones (vistas / impresiones totales), según el estándar IAB, determinado por la optimización de Xandr.
Palabra clave: predicted_iab_view_rate_over_total
Operador: Cualquiera
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
Tasa de visualización de vídeo IAB prevista
Evalúa las impresiones de vídeo web en función de la probabilidad de que se midan como visibles según el estándar IAB, según lo determinado por la optimización de Xandr.
Palabra clave: predicted_iab_video_view_rate
Operador: Cualquiera
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 IAB prevista sobre el total
Evalúa las impresiones de vídeo web en función de la probabilidad de que se midan como visibles sobre el número total de impresiones (vistas o impresiones medidas) mediante la definición personalizada de 100 % píxeles visibles durante al menos 1 segundo, según viene determinado por la optimización de Xandr.
Palabra clave: predicted_iab_video_view_rate_over_total
Operador: Cualquiera
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 visibilidad de pantalla prevista (100 % de visualización, un segundo de duración)
Evalúa las impresiones de vídeo visualizadas en función de la probabilidad de que se midan como visibles (impresiones vistas/medidas) mediante la definición personalizada de 100 % píxeles visibles durante al menos 1 segundo, según lo determinado por la optimización de Xandr.
Palabra clave: predicted_100pv1s_display_view_rate
Operador: Cualquiera
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 visibilidad de pantalla prevista sobre el total (100 % de vista, duración de un segundo)
Evalúa las impresiones de visualización web en función de la probabilidad de que se midan como visibles (impresiones vistas/totales) mediante la definición personalizada de 100 % píxeles visibles durante al menos 1 segundo, según determina la optimización de Xandr.
Palabra clave: predicted_100pv1s_display_view_rate_over_total
Operador: Cualquiera
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
Tasa de visualización de vídeo prevista (100 % de visualización, 50 % de duración, sonido activado)
Evalúa las impresiones de vídeo web en función de la probabilidad de que se midan como visibles (impresiones vistas/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: Cualquiera
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 visualización, 50 % de duración, sonido activado)
Evalúa las impresiones de vídeo web en función de la probabilidad de que se midan como visibles, sobre el número total de impresiones (impresiones vistas/totales), 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_over_total
Operador: Cualquiera
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úa las impresiones de vídeo web en función de la probabilidad de que se completen, según determine la optimización de Xandr.
Palabra clave: predicted_video_completion_rate
Alias (en desuso):estimated_video_completion_rate
Operador: Cualquiera
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
Público objetivo de Xandr
Evalúa las impresiones en función de su público objetivo, según lo determinado por la auditoría de la plataforma Xandr.
Palabra clave: appnexus_intended_audience
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: "general", "children", "young_adult"o "mature".
Ejemplo:
if appnexus_intended_audience = "mature":
1
else:
0
Público objetivo del vendedor
Evalúa las impresiones en función de su público objetivo, según lo determinado por la autoauditoría. Para obtener más información, vea "Autoclasificación de inventario" en documentación y Servicio de perfiles.
Palabra clave: seller_intended_audience
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay 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 autoauditado
Evalúa si el inventario ha sido auditado por el editor.
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 desee utilizar el grupo de usuarios para probar varias estrategias en paralelo y comparar su rendimiento. Diferentes pruebas deberían particionar los mil grupos de usuarios de manera diferente; De lo contrario, las pruebas concurrentes interactuarán entre sí y será difícil interpretar los resultados. Para obtener más información, consulta Segmentación de prueba y control en la documentación.
Palabra clave: user_group
Operador: Cualquiera
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 la campaña (solo administradores del sistema)
Evalúa las impresiones según el número de impresiones que ha visto un usuario en la campaña actual durante el mes en curso.
Palabra clave: campaign_month_frequency
Operador: =<, <=, presence/absence, notincomparison, , y .range
Valor: entero positivo que representa el número de impresiones que ha visto un usuario durante 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 de mes de la línea de pedido
Evalúa las impresiones según el número de impresiones vistas por un usuario para la línea de pedido actual en el mes actual.
Palabra clave: line_item_month_frequency
Operador: =<, <=, presence/absence, notincomparison, , y .range
Valor: entero positivo que representa el número de impresiones que ha visto un usuario en la línea de pedido actual durante el mes en curso.
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úa las impresiones según el número de anuncios que ve un usuario en el mes actual.
Palabra clave: advertiser_month_frequency
Operador: =<, <=, presence/absence, notincomparison, , y .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úa las impresiones según el número de anuncios que ve un usuario en la hora actual.
Palabra clave: campaign_hour_frequency
Operador: =<, <=, presence/absence, notincomparison, , y .range
Valor: entero positivo que representa el número de anuncios que ve 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 las horas de la línea de pedido
Evalúa las impresiones según el número de anuncios que ve un usuario en la hora actual.
Palabra clave: line_item_hour_frequency
Operador: =<, <=, presence/absence, notincomparison, , y .range
Valor: entero positivo que representa el número de anuncios que ve 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 line_item_hour_frequency < 2:
5
else:
0.1
Frecuencia de la hora del anunciante
Evalúa las impresiones según el número de anuncios que ve un usuario en la hora actual.
Palabra clave: advertiser_hour_frequency
Operador: =<, <=, presence/absence, notincomparison, , y .range
Valor: entero positivo que representa el número de anuncios que ve 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 advertiser_hour_frequency < 2:
2
else:
0.1
Frecuencia de la semana de la campaña (solo administradores del sistema)
Evalúa las impresiones según el número de anuncios vistos por un usuario en la semana actual, comenzando el domingo.
Palabra clave: campaign_week_frequency
Operador: =<, <=, presence/absence, notincomparison, , y .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 semanas de línea de pedido
Evalúa las impresiones según el número de anuncios vistos por un usuario en la semana actual, comenzando el domingo.
Palabra clave: line_item_week_frequency
Operador: =<, <=, presence/absence, notincomparison, , y .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 line_item_week_frequency < 2:
5
else:
0.1
Frecuencia de semana del anunciante
Evalúa las impresiones según el número de anuncios vistos por un usuario en la semana actual, comenzando el domingo.
Palabra clave: advertiser_week_frequency
Operador: =<, <=, presence/absence, notincomparison, , y .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 advertiser_week_frequency < 2:
5
else:
0.1
Frecuencia del día de la campaña (solo administradores del sistema)
Evalúa las impresiones según el número de anuncios que ve un usuario en el día actual.
Palabra clave: campaign_day_frequency
Operador: =<, <=, presence/absence, notincomparison, , y .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
Actualidad de la campaña (solo administradores del sistema)
Evalúe si los datos de actualidad están disponibles para un usuario y, si están disponibles, la cantidad de minutos desde que un usuario ha visto un anuncio.
Palabra clave: campaign_recency
Operador: =<, <=, presence/absence, notincomparison, , y .range
Valor: un entero positivo que indica el número de minutos desde que un usuario ha visto una impresión, redondeado hacia abajo. 59 segundos se evaluarán como , 061 segundos se evaluarán como 1.
0 significa que la impresión se vio muy recientemente.
Null significa que no hay datos recientes disponibles (el usuario no ha visto esta impresión antes).
Ejemplo:
if campaign_recency < 2 :
2
else :
0.1
Actualidad de la línea de pedido
Evalúe si los datos de actualidad están disponibles para un usuario y, si están disponibles, la cantidad de minutos desde que un usuario ha visto un anuncio.
Palabra clave: line_item_recency
Operador: =<, <=, presence/absence, notincomparison, , y .range
Valor: un entero positivo que indica el número de minutos desde que un usuario ha visto una impresión, redondeado hacia abajo. 59 segundos se evaluarán como , 061 segundos se evaluarán como 1.
0 significa que la impresión se vio muy recientemente.
Null significa que no hay datos recientes disponibles (el usuario no ha visto esta impresión antes).
Ejemplo:
if line_item_recency < 2:
5
else:
0.1
Actualidad del anunciante
Evalúe si los datos de actualidad están disponibles para un usuario y, si están disponibles, la cantidad de minutos desde que un usuario ha visto un anuncio.
Palabra clave: advertiser_recency
Operador: =<, <=, presence/absence, notincomparison, , y .range
Valor: un entero positivo que indica el número de minutos desde que un usuario ha visto una impresión, redondeado hacia abajo. 59 segundos se evaluarán como , 061 segundos se evaluarán como 1.
0 significa que la impresión se vio muy recientemente.
Null significa que no hay datos recientes disponibles (el usuario no ha visto esta impresión antes).
Ejemplo:
if advertiser_recency < 2:
5
else:
0.1
Creatividad
Evalúa las impresiones basándote en la creatividad.
Palabra clave: creative
Operador: Cualquiera
Valor: cadena que representa el id. creativo (debe ser un entero).
Ejemplo:
if creative=12345:
5
else:
0.1
Tamaño creativo
Evalúa las impresiones según el tamaño de la creatividad.
Palabra clave: creative_size
Operador: Cualquiera excepto <, >, <=, >=, y range. Para comprobar si hay varios valores, use in.
Valor: cadena que representa las dimensiones de la creatividad, con formato de "WIDTHxHEIGHT"archivo
Ejemplo:
if creative_size = "300x250":
5
elif creative_size = "250x250":
3
else:
0.1
Id. de oferta
Evalúe las impresiones en función del identificador de trato.
Palabra clave: deal_id
Operador: Cualquiera excepto range.
Valor: Cadena que representa el ID de la transacción como un entero.
Ejemplo:
if deal_id in (12345,98765):
1.0
else:
0.1
Aleatorio1, Aleatorio2, Aleatorio 3
Evalúa las impresiones basándote en una variable de aleatorización entre 0 y .1 Cuando se usa, este parámetro agrega cierta aleatoriedad al algoritmo Bonsai.
Palabra clave: random1, random2, random3
Operador: Cualquiera. Para comprobar si hay varios valores, use in.
Valor: un valor entre 0 y , 1con formato decimal de hasta 6 decimales.
Ejemplo:
if random1 > 0.8:
1.0
elif random1 range (0.4, 0.8):
2.0
else:
0.1
Id. de URL de inventario
Evalúa las impresiones basándote en el id. de URL de inventario*, que se asigna a una URL de inventario.
Palabra clave: inventory_url_id
Operador: Cualquiera excepto <, >, <=, >=, y range.
Valor: Id. de URL de inventario (un entero).
Ejemplo:
if inventory_url_id=12345:
5
else:
0.1
* Solo disponible en líneas de pedido aumentadas
Características compuestas
Las sencillas características anteriores te permiten evaluar un solo aspecto de la impresión (país o región, edad de las cookies, aplicación móvil, etc.). Las características de segmento compuesto y Frecuencia/Recencia son más matizadas; Le permiten evaluar varios atributos de estas entidades, como la antigüedad de un segmento o el valor del segmento.
Segmento
Segmentar presencia/ausencia
Evalúa las impresiones basándote en la presencia del usuario en un segmento propio o de terceros.
Palabra clave: segment[ID] donde ID es el ID de segmento.
Use el Servicio de segmentos para recuperar los identificadores de segmento.
Atributo: ninguno
Operador: Ninguno para presencia, not para 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
Edad del segmento
Evalúe las impresiones en función de los minutos transcurridos desde que el usuario se agregó a un segmento propio o de terceros.
Nota:
Si el usuario no está en el segmento, esta característica se evalúa como False.
Palabra clave: segment[ID] donde ID es el ID de segmento.
Use el Servicio de segmentos para recuperar los 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
Segment value
Evalúa 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 por lotes o una cadena de consulta de segmento de origen o de terceros. Para obtener más información sobre cómo pasar valores a través de cadenas de consulta de segmentos, consulte Píxeles de segmento avanzados en la documentación.
Nota:
Si el usuario no está en el segmento, esta característica se evalúa como False.
Palabra clave: segment[ID] donde ID es el ID de segmento.
Use el Servicio de segmentos para recuperar los 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/actualidad
- Frecuencia Presencia/Ausencia
- Frecuencia de duración
- Frecuencia diaria
- Presencia / ausencia de inmediatez y datos
Frecuencia, presencia/ausencia
Evalúa si los datos de frecuencia están disponibles o no para el usuario. Esto se puede determinar para todos los anuncios de un anunciante, línea de pedido o campaña.
Palabra clave: frequency
Atributo: OBJECT[ID]. donde OBJECT es advertiser, line_item, o campaign, y ID es el Id. de objeto. Use el servicio de anunciantes, el servicio de línea de pedido o el servicio de campaña para recuperar 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 actualidad, los datos de frecuencia nunca son nulos. Si un usuario nunca ha visto una impresión de este objeto, la frecuencia 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úa las impresiones según el número de anuncios vistos por un usuario a lo largo de la vida útil de un anunciante, una línea de pedido o una campaña.
Palabra clave: lifetime_frequency
Atributo: OBJECT[ID]. donde OBJECT es advertiser, line_item, o campaign, o creative, y ID es el Id. de objeto. Use el servicio de anunciantes, el servicio de línea de pedido o el servicio de campaña para recuperar identificadores.
Operador: =<, <=, presence/absence, notincomparison, , y .range
Valor: entero positivo que representa el número de anuncios que ve un usuario durante la vida útil 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úa las impresiones según el número de impresiones que ha visto un usuario en el día actual. Esto se puede determinar para un anunciante, una línea de pedido o una campaña.
Palabra clave: day_frequency
Atributo: OBJECT[ID]. donde OBJECT es advertiser, line_item, o campaign, y ID es el Id. de objeto. Use el servicio de anunciantes, el servicio de línea de pedido o el servicio de campaña para recuperar identificadores.
Operador: =<, <=, presence/absence, notincomparison, , y .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[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 inmediatez y datos
Evalúa si los datos de actualidad están disponibles para un usuario y, si están disponibles, el número de minutos desde que un usuario ha visto un anuncio. Esto se puede determinar para un usuario para todos los anuncios de un anunciante, línea de pedido o campaña.
Palabra clave: recency
Atributo: OBJECT[ID]. donde OBJECT es advertiser, line_item, o campaign, y ID es el Id. de objeto. Use el servicio de anunciantes, el servicio de línea de pedido o el servicio de campaña para recuperar identificadores.
Operador: =<, <=, presence/absence, notincomparison, , y .range
Valor: un entero positivo que indica el número de minutos desde que un usuario ha visto una impresión, redondeado hacia abajo. 59 segundos se evaluarán como , 061 segundos se evaluarán como 1.
0 significa que la impresión se vio muy recientemente.
Null significa que no hay datos recientes disponibles (el usuario no ha visto esta impresión antes).
Ejemplo:
if not advertiser.recency:
0.1
elif advertiser[3].recency > 60:
1
else:
0.2
Ejemplos de sintaxis de entidades compuestas que utilizan 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 actualidad/frecuencia 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