Guía de migración de perfiles de licitador

Los perfiles de ofertante (tanto el servicio de perfiles heredado como los perfiles de ofertante mejorados) le permiten filtrar el tráfico que recibe de Xandr. Esta guía de migración de perfiles lo ayuda a migrar su configuración de los perfiles de licitador heredados a los perfiles de licitador mejorados.

Nota:

El paso 4 de esta página solo es relevante si ha recibido una comunicación por correo electrónico de cambio importante sobre la migración del perfil. Si no lo has hecho, ponte en contacto con el administrador de cuentas.

Aviso de cambio importante: Si no completas la migración:

El 4 de octubre de 2019, habilitaremos su ofertante para los perfiles de ofertante mejorados, momento en el cual sus nuevos perfiles controlarán cómo recibe el tráfico y sus perfiles heredados quedarán en desuso. Si no actualiza sus Perfiles de Postor Mejorado antes de esta fecha, de forma predeterminada su postor no tendrá restricciones de inventario configuradas.

Introducción al proceso de migración

  1. Obtenga el estado actual a través de la API de servicio de perfiles heredada (recomendado) o la interfaz de usuario de licitador heredada. (0.25 ~ 0.5 horas)
  2. Comprenda los cambios y reevalúe los filtros en función de las necesidades de su negocio. (0,5 ~ 1 horas)
  3. Configure perfiles de ofertantes mejorados en la nueva interfaz de usuario de la plataforma de licitadores (recomendado) o a través del nuevo servicio de perfiles de ofertantes. (0,5 ~ 1 horas)
  4. Póngase en contacto con el soporte técnico para cambiar el cambio del uso de perfiles heredados a perfiles de ofertante mejorados. (~1 día laborable)

La nueva configuración del perfil de ofertante mejorado en nuestra API NO afecta el flujo de tráfico hasta que complete el Paso 4 antes del 21 de mayo de 2019.

Proceso de migración

Paso 1: Obtenga el estado actual (0.25 ~ 0.5 horas)

Hay dos formas de comprobar el estado actual. Se recomienda el método API, ya que es posible que la interfaz de usuario heredada no muestre todos los parámetros de segmentación.

Sugerencia

Descripción de la relación entre el perfil principal & secundario en el perfil de licitador heredado

En los perfiles de ofertantes heredados, hay perfiles principales y perfiles secundarios (opcionales). Todo el tráfico entrante de Xandr debe cumplir primero las condiciones del perfil primario. Además, el tráfico debe pasar por uno de los perfiles secundarios si su ofertante tiene perfiles secundarios activos. En resumen, el tráfico se envía cuando cumple los criterios de (Parent Profile) AND (Child Profile 1 OR Child Profile 2 OR ... OR Child Profile N).

Ejemplo:

Si incluyes a Estados Unidos en tu perfil principal, incluyes el tipo de oferta de aplicación móvil en tu perfil infantil 1 e incluyes el tipo de oferta web móvil en tu perfil infantil 2, tu ofertante recibirá tanto el tráfico de aplicaciones móviles de EE. UU. (a través del perfil de menor 1) como el tráfico de la web móvil de EE. UU. (a través del perfil de menor 2). El pujador no recibirá tráfico de escritorio de EE. UU. ni tráfico de fuera de EE. UU.

Para obtener más información, consulte las preguntas frecuentes sobre el perfil de licitador heredado.

Información general
  • Obtenga los objetos de perfil activos a través de la API de servicio de licitadores: GET bidder/[bidder id].
  • Para todos los objetos de perfil activos, GET profile/[profile id] a través de la API de servicio de perfiles de ofertante heredada.
  • Resuma los resultados.
Paso 1.1: Obtener los objetos de perfil activos a través de la API de servicio de licitador: GET bidder/[bidder id]

El identificador de perfil primario activo se encuentra en el parent_profile_id campo y los identificadores de perfil secundario activo se encuentran en la child_profiles matriz.

Referencia: Servicio de Autenticación y Servicio de Licitadores.

Ejemplo
-> curl -b cookie -c cookie -s "https://api.adnxs.com/bidder/129" # 129 is a sample bidder ID.
{
    "response": {
        "bidder": {
            ...
            "parent_profile_id": 12345,
            "child_profiles": [
                {
                    "id": 34567
                },
                {
                    "id": 56789
                }
            ],
            ...
        }
    }
}
Paso 1.2: Para todos los objetos de perfil activos, GET profile/[profile id] a través de la API de servicio de perfiles de ofertante heredada

Cada perfil tiene una lista de elementos permitidos o de bloqueo. Por lo general, hay "acciones" y "objetivos" por miembro, país o región, etc.

  • "..._action" se puede establecer en "incluir" o "excluir".
  • "..._targets" puede tener una lista de identificadores para el miembro del vendedor, el país o la región, etc.

Referencia: Servicio de perfil de licitador heredado

Paso 1.2: Ejemplo
-> curl -b cookie -c cookie -s "https://api.adnxs.com/profile/129/12345" # 129 is a sample bidder id and 12345 is a sample bider profile ID.
{
    "response": {
        "profile": {
            "country_action": "include",
            "country_targets": [
                {
                    "active": true,
                    "code": "US",
                    "id": 233,
                    "name": "United States"
                }
            ],
            ...
        }
    }
}
Paso 1.3: Resumir los resultados

Recuerde evaluar la lógica del perfil primario & secundario: el tráfico se envía cuando cumple los criterios de (Parent Profile) AND (Child Profile 1 OR Chile Profile 2 OR ... OR Child Profile N).

Hay varios campos en desuso en el servicio de API de perfiles heredado. Te recomendamos que solo te centres en estos campos segmentables a continuación. Hay una guía sobre los campos exactos que se deben tener en cuenta en la sección Asignación de campos de perfil de licitador heredados a mejorados de esta página.

Para facilitar la configuración de los nuevos perfiles de ofertante mejorados, para cada uno de estos campos, enumera los atributos incluidos/excluidos:

  • Miembros vendedores
  • Países o regiones
  • Listas de dominios
  • Tamaños
  • Tipos de suministro
  • Atributos de inventario
  • Solo usuarios conocidos

    Nota:

    Si solo escuchas a usuarios conocidos, tendrás una tasa de transferencia del 0 % en tu perfil de ofertante.

  • Acción de URL no auditada

Sugerencia

¿Qué es AppNexus Direct?

Dependiendo de la configuración de tu perfil heredado, el suministro directo de Xandr puede incluirse en tu objeto de perfil, además de los miembros vendedores incluidos. Para obtener más información, consulte: Microsoft Monetize Supply for External Demand Partners.

En la nueva interfaz de usuario de la plataforma de ofertantes, podrá ver qué miembros del vendedor pertenecen al grupo de intercambio "directo" de Xandr.

¿Cómo extraer los dominios de la lista de dominios?

Si desea revisar los dominios de la lista de dominios, puede obtenerla o editarla mediante el servicio de API de lista de dominios: Servicio de lista de dominios.

Método 2: Usar la interfaz de usuario del ofertante heredada

Información general (método 2)
  • Consulta los filtros actuales en el perfil de cada licitador.
  • Resuma los resultados.
Paso 1.1: Ver los filtros actuales en el perfil de cada postor

Ve e https://bidder.adnxs.net/ inicia sesión con tus credenciales de usuario de pujador. Si no puedes iniciar sesión, consulta primero con el equipo de integraciones de tu empresa y ponte en contacto con el soporte técnico de Xandr.

Navega a la pestaña Perfiles de la izquierda. Puede ver la configuración del perfil primario.

Los perfiles de secundarios no cursivos están activos actualmente. Si hace clic en el perfil de un niño, puede ver la configuración del perfil.

Paso 1.2: Resumir los resultados

Recuerde evaluar la lógica del perfil principal & secundario: Todo el tráfico entrante de Xandr debe cumplir primero con las condiciones del perfil principal; Además, el tráfico debe pasar por uno de los perfiles de menores si tienes configurados perfiles de menores.

Para facilitar la configuración de los nuevos perfiles de ofertante mejorados, para cada uno de estos campos, enumera los atributos incluidos/excluidos:

  • Miembros vendedores
  • Países o regiones
  • Listas de dominios
  • Tamaños
  • Tipos de suministro
  • Atributos de inventario
  • Solo usuarios conocidos

    Nota:

    Si solo escuchas a usuarios conocidos, tendrás una tasa de transferencia del 0 % en tu perfil de ofertante.

  • Acción de URL no auditada

Sugerencia

¿Qué es AppNexus Direct?

Es posible que no lo veas en la interfaz de usuario del ofertante heredado, pero además de que el miembro vendedor se dirija a un perfil, los miembros vendedores del suministro directo de Xandr se incluyen en un perfil. Para obtener más información, consulte: Microsoft Monetize Supply for External Demand Partners.

En la nueva interfaz de usuario de la plataforma de ofertantes, podrá ver qué miembros del vendedor pertenecen al grupo de intercambio "directo" de Xandr.

¿Cómo extraer los dominios de la lista de dominios?

Si desea revisar los dominios de la lista de dominios, puede obtenerla o editarla mediante el servicio de API de lista de dominios: Servicio de lista de dominios.

Paso 2: Comprenda los cambios y vuelva a evaluar los filtros (0,5 ~ 1 horas)

Los perfiles de ofertantes mejorados ofrecen los siguientes beneficios:

  • Jerarquía plana: Se ha eliminado el modelo de perfil primario y secundario.
  • Tipos de anuncios: ahora puede dirigirse fácilmente a los cuatro tipos de anuncios principales que desea recibir: Banner, Video, Nativo y Audio.
  • Intercambios: hemos agrupado a los miembros del vendedor en intercambios para facilitar la orientación.
  • Perfil simplificado: hemos reducido el perfil solo a campos relevantes para su negocio.
  • Nueva interfaz de usuario de la plataforma de ofertantes: hemos creado una nueva interfaz de usuario para que pueda administrar y mantener sus perfiles. Se agregarán capacidades adicionales a esta interfaz de usuario a lo largo de 2019.

Revise estas páginas primero: Registro de cambios para los perfiles de licitador mejorados y Preguntas frecuentes (FAQ) para los perfiles de licitador mejorados.

Paso 3: Configurar perfiles de ofertantes mejorados (0.5 ~ 1 horas)

Nota:

La configuración mejorada del perfil del ofertante en la nueva API del servicio de perfil del ofertante o la nueva interfaz de usuario de la plataforma del ofertante NO afecta el flujo de tráfico de Xandr hasta que complete el Paso 4: Póngase en contacto con el soporte técnico de Xandr y activaremos el interruptor en el backend antes del 21 de mayo de 2019.

Hay dos formas de configurar los perfiles de licitador mejorados. Recomendamos usar la nueva interfaz de usuario de la plataforma de ofertantes a través de la API.

Uso de varios perfiles en el perfil de licitador mejorado

La impresión debe cumplir con los requisitos de un solo perfil para ser enviada a su ofertante. Si crea varios perfiles, la lógica entre los perfiles es OR. En otras palabras, la impresión se envía cuando cumple los criterios de (Profile 1 OR Profile 2 OR ... Profile N).

Asignación de campos de perfil de licitador heredados a campos de perfil de licitador mejorados

Segmentación Campos de API de perfil de licitador heredado Campos mejorados de la API & la interfaz de usuario del perfil de ofertante
Miembros/grupos vendedores member_targets y seller_member_group_targets campos en API Pestaña Intercambios y Miembros. Todos los miembros vendedores pertenecen a uno de los tres Exchanges, y puede ver qué miembros vendedores pertenecen a cada Exchange en.
exchanges en API (para control a nivel de miembro, uso excluded_members y included_members matrices en intercambios).
Países country_action el campo tiene include o exclude.
country_targets array tiene una lista de países o regiones.		 Pestaña de países en.
countries en la API. (Use action y targets en countries. Para los objetivos, use las identificaciones recuperadas de Country Service).
Listas de dominios domain_list_action el campo tiene include o exclude.
domain_list_targets matriz tiene una lista de dominios. Utilice el Servicio de lista de dominios para crear, ver o editar dominios.		 Pestaña Listas de dominios en (Para editar dominios, use el servicio de lista de dominios).
domain_lists en la API. (Use action y targets en domain_lists. Para los destinos, use los identificadores recuperados del servicio de lista de dominios).
Tamaños (y tipos de anuncios) size_targets matriz (solo para incluir). pestaña Tipos de anuncios. En primer lugar, puedes seleccionar los tipos de anuncio que quieres incluir. Si incluyes el tipo de anuncio de banner, puedes seleccionar los tamaños que quieres incluir.
ad_types en la API. Para cada tipo de anuncio, establece action en include o exclude. En cuanto banner al tipo de anuncio, puedes incluir tamaños en la sizes matriz.
Tipos de suministro supply_type_action el campo tiene include o exclude.
supply_type_targets matriz tiene web, web móvil o aplicación móvil.		 Pestaña Tipos de suministro en .
supply_types en la API. (Use action y targets en supply_types. Para los destinos, los valores posibles son web, mobile_weby mobile_app.)
Atributos de inventario use_inventory_attribute_targets Tiene verdadero o falso.
inventory_attribute_targets matriz tiene una lista de atributos de inventario (solo Incluir).		 Pestaña Atributos confidenciales en .
inventory_attributes en la API. (La acción es solo incluir. Para los destinos, use identificadores recuperados del Servicio de atributos de inventario).
Solo recepción de usuarios conocidos Si passthrough_percent el campo tiene 0 y el objeto Ofertante tiene always_send_owned_segments el valor verdadero, solo escuchará a los usuarios conocidos.
Alternativamente, tu perfil de ofertante puede incluir un identificador de segmento solo para dirigirse a los usuarios conocidos.		 Nota: Para usar esta característica, debe usar la dirección URL /setuid con Xandr para la coincidencia de usuarios.

Los usuarios desconocidos pueden activarse. Establecer Allow Unknown Users en excluido.
user_not_in_segment_action en la API. Establézcalo en exclude para escuchar solo a los usuarios conocidos.
Acción de URL no auditada non_audited_url_action en la API. non_audited_url_action en la API.

Ajuste del volumen de tráfico: alternativa al porcentaje de paso

En el perfil de ofertante heredado, algunos clientes solían passthrough_percent controlar el volumen de tráfico o QPS (consulta por segundo) de solicitud de oferta. El perfil de licitador mejorado no tiene una función de control de volumen; en su lugar, use el qps_limit campo en Instancia de ofertante para configurar un límite de seguridad de QPS por centro de datos. Para ver tu volumen de tráfico actual, consulta la pestaña Métricas en la interfaz de usuario del ofertante heredado: https://bidder.adnxs.net/metrics.

Si tiene límites de seguridad de QPS en todas las instancias de los ofertantes, tiene una opción para habilitar la característica Optimized Bid Stream. Todo el tráfico se envía hasta que se cumple el límite de QPS; cuando haya más tráfico disponible que su límite de QPS, en lugar de cortar el volumen de tráfico al azar para alcanzar su límite de QPS, se reducirá el tráfico de baja prioridad basado en su comportamiento de compra que exceda su límite de QPS. Para obtener más información, consulta Preguntas frecuentes sobre la puja optimizada de Stream. Si estás interesado en la característica, ponte en contacto con el administrador de cuentas o con el soporte técnico de Xandr.

Activación de un nuevo perfil de licitador

Para activar un nuevo perfil de ofertante en la API, establezca el campo activo en true. Ya no es necesario establecer una identificación de perfil en la API de servicio de Bidder para activar un perfil. Una vez que se complete el paso 4 a continuación, parent_profile_id se child_profiles ignorará el objeto de la API de Bidder.

Debe hacer clic en el botón Activar en la pantalla de perfil para activar el perfil. Los perfiles que no son cursivas están activos.

Activa tus nuevos perfiles de ofertante antes de pasar al paso 4. La configuración de tu perfil de ofertante mejorado no afecta el flujo de tráfico hasta que el soporte de Xandr active el conmutador de backend en el Paso 4 antes del 21 de mayo de 2019.

Paso 4: Ponte en contacto con el soporte técnico de Xandr para completar la migración (~1 día laborable)

Nota:

Esta sección solo es relevante si ha recibido una comunicación por correo electrónico de cambio importante sobre la migración de perfiles. No sigas este paso si no lo hiciste. En su lugar, ponte en contacto con el administrador de cuentas.

Advertencia

La configuración del nuevo perfil de ofertante mejorado no afecta el flujo de tráfico hasta que complete este paso antes del 21 de mayo de 2019.

Abra una incidencia de soporte técnico. Al introducir la información:

  • Categoría: seleccionar soporte técnico de productos
  • ¿En qué podemos ayudar?: Seleccionar integración de licitador externo

Use esta plantilla para su incidencia de soporte técnico

He revisado y configurado los Perfiles de Ofertantes Mejorados. Migrar la configuración de mi perfil.

  1. Id. de licitante y nombre del licitante:
  2. ¿Configuraste utilizando la nueva interfaz de usuario o API de la plataforma de ofertantes?:
  3. Proporcione una breve explicación de los cambios de la configuración del perfil actual (si no hay cambios, escriba "N/D"):

¿Qué pasará después?

Nuestros especialistas de soporte revisarán primero la configuración del perfil de ofertante heredado y mejorado. Si se ven bien, los especialistas de soporte activarán el interruptor en el backend y le enviarán una nota de confirmación. Cuando esto suceda, la nueva configuración del perfil de licitador mejorado comenzará a afectar el flujo de tráfico y se ignorará la configuración del perfil de licitador heredado.

Supervisa tu flujo de tráfico utilizando la pestaña Métricas en la interfaz de usuario del ofertante heredado: https://bidder.adnxs.net/metrics. Si hay algún problema, los especialistas de soporte pueden volver a la configuración del perfil heredado de inmediato (que entrará en vigencia en el flujo de tráfico en 5 a 10 minutos) y usted puede trabajar en la solución de problemas de la configuración del perfil de licitador mejorado.

Si no hay ningún problema en el flujo de tráfico durante un día, la migración se ha completado y el vale de soporte técnico se cerrará.

Sugerencia

Los perfiles de los ofertantes heredados aún se mostrarán como activos en la API y en la interfaz de usuario del ofertante heredado una vez que se complete la migración. Siempre que se migre en el back-end, la configuración del perfil heredado se omitirá y no afectará al flujo de tráfico.

Si no completa el paso 4

El 21 de mayo de 2019, habilitaremos su ofertante para los perfiles de licitador mejorados, momento en el que sus nuevos perfiles controlarán cómo recibe el tráfico y sus perfiles heredados quedarán en desuso. Si no actualiza sus Perfiles de Postor Mejorado antes de esta fecha, de forma predeterminada su postor no tendrá restricciones de inventario configuradas.

  • Last updated on