Compartir a través de

Guía de migración del perfil del licitador

  • Artículo

Los perfiles de licitador (tanto el servicio de perfiles heredado como los perfiles mejorados del licitador) le permiten filtrar el tráfico que recibe de Xandr. Esta guía de migración de perfiles le ayuda a migrar la configuración de los perfiles de licitador heredados a 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 hizo, póngase en contacto con el administrador de cuentas en su lugar.

Aviso de cambio importante: si no completa la migración:

El 4 de octubre de 2019, habilitaremos al postor para perfiles de licitador mejorados, momento en el que los nuevos perfiles controlarán cómo recibe el tráfico y los perfiles heredados quedarán en desuso. Si no actualiza los perfiles de licitador mejorados antes de esta fecha, el pujador no tendrá ninguna restricción de inventario configurada de forma predeterminada.

Introducción al proceso de migración

  1. Obtenga el estado actual a través de la API del servicio de perfil heredada (recomendada) o la interfaz de usuario del licitador heredada. (0,25 ~ 0,5 horas)
  2. Comprenda los cambios y vuelva a evaluar los filtros en función de sus necesidades empresariales. (0,5 ~ 1 hora)
  3. Configure perfiles de licitadores mejorados en la nueva interfaz de usuario de bidder Platform (recomendado) o mediante el nuevo servicio de perfil de licitador. (0,5 ~ 1 hora)
  4. Póngase en contacto con el soporte técnico para cambiar el cambio de usar perfiles heredados a perfiles de licitador mejorados. (~1 día laborable)

La nueva configuración del perfil de licitador mejorado en o api no afecta al flujo de tráfico hasta que complete el paso 4 antes del 21 de mayo de 2019.

Proceso de migración

Paso 1: Obtener el estado actual (0,25 ~ 0,5 horas)

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

Sugerencia

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

En perfiles de licitadores heredados, hay perfiles primarios y (opcionales) secundarios. Todo el tráfico entrante de Xandr debe cumplir primero las condiciones del perfil primario. Además, el tráfico debe pasar uno de los perfiles secundarios si el licitador 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 incluye la Estados Unidos en su perfil primario, incluya el tipo de suministro de aplicación móvil en el perfil secundario 1 e incluya el tipo de suministro web móvil en el perfil secundario 2, el licitador recibirá tanto el tráfico de aplicaciones móviles de EE. UU. (a través del perfil secundario 1) como el tráfico web móvil de EE. UU. (a través del perfil secundario 2). El licitador no recibirá ningún tráfico de Escritorio de EE. UU. ni ningún tráfico que no sea de EE. UU.

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

Información general
  • Obtenga los objetos de perfil activos a través de Bidder Service API: GET bidder/[bidder id].
  • Para todos los objetos de perfil activos, GET profile/[profile id] a través de bidder Profile Service API heredada.
  • Resuma los resultados.
Paso 1.1: Obtener los objetos de perfil activos a través de Bidder Service API: GET bidder/[bidder id]

El identificador de perfil primario activo está en el parent_profile_id campo y los identificadores de perfil secundarios activos están en la child_profiles matriz.

Referencia: Servicio de autenticación y Servicio del licitador.

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 bidder Profile Service API heredado

Cada perfil tiene una lista de permitidos o una lista de bloqueo de elementos. Normalmente hay "acción" y "destinos" por miembro, país, etc.

  • "..._action" se puede establecer en "include" o "exclude".
  • "..._targets" puede tener una lista de identificadores para el miembro del vendedor, el país, 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

No olvide 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 profile API heredado. Se recomienda centrarse solo en estos campos de destino que se indican a continuación. Hay una guía para ver los campos exactos que se van a examinar 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 licitador mejorado, para cada uno de estos campos, enumera los atributos incluidos o excluidos:

  • Miembros del vendedor
  • Países
  • Listas de dominio
  • Tamaños
  • Tipos de suministro
  • Atributos de inventario
  • Solo usuarios conocidos

    Nota:

    Si solo escucha a usuarios conocidos, tiene una tasa de acceso directo del 0 % en el perfil del licitador.

  • Acción de dirección URL no auditada

Sugerencia

¿Qué es AppNexus Direct?

Dependiendo de la configuración del perfil heredado, el suministro directo de Xandr puede incluirse en el objeto de perfil, además de los miembros del vendedor incluidos. Para obtener más información, vea: Microsoft Monetize Supply for External Demand Partners (Suministro monetizar de Microsoft para asociados de demanda externa).

En la nueva interfaz de usuario de Bidder Platform, 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 obtener o editar la lista a través del servicio de API de lista de dominios: Domain List Service.

Método 2: Uso de la interfaz de usuario del licitador heredada

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

Vaya a https://bidder.adnxs.net/ e inicie sesión con las credenciales de usuario del licitador. Si no puede iniciar sesión, consulte primero con el equipo de integraciones de su empresa y póngase en contacto con el soporte técnico de Xandr.

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

Los perfiles secundarios no cursiva están activos actualmente. Si hace clic en un perfil secundario, puede ver la configuración del perfil.

Paso 1.2: Resumir los resultados

Recuerde evaluar la lógica del perfil primario & secundario: todo el tráfico entrante de Xandr debe cumplir primero las condiciones del perfil primario; Además, el tráfico debe pasar uno de los perfiles secundarios si tiene configurados los perfiles secundarios.

Para facilitar la configuración de los nuevos perfiles de licitador mejorado, para cada uno de estos campos, enumera los atributos incluidos o excluidos:

  • Miembros del vendedor
  • Países
  • Listas de dominio
  • Tamaños
  • Tipos de suministro
  • Atributos de inventario
  • Solo usuarios conocidos

    Nota:

    Si solo escucha a usuarios conocidos, tiene una tasa de acceso directo del 0 % en el perfil del licitador.

  • Acción de dirección URL no auditada

Sugerencia

¿Qué es AppNexus Direct?

Es posible que no lo vea en la interfaz de usuario del licitador heredada, pero además de que el miembro del vendedor se dirige a un perfil, los miembros del vendedor de la oferta directa de Xandr se incluyen en un perfil. Para obtener más información, vea: Microsoft Monetize Supply for External Demand Partners (Suministro monetizar de Microsoft para asociados de demanda externa).

En la nueva interfaz de usuario de Bidder Platform, 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 obtener o editar la lista a través del servicio de API de lista de dominios: Domain List Service.

Paso 2: Comprender los cambios y volver a evaluar los filtros (0,5~ 1 hora)

Los perfiles mejorados del licitador ofrecen las siguientes ventajas:

  • Jerarquía plana: se ha quitado el modelo de perfil primario y secundario.
  • Tipos de anuncios: ahora puedes dirigirte fácilmente a los cuatro tipos de anuncios principales que deseas recibir: Banner, Vídeo, Nativo y Audio.
  • Intercambios: hemos agrupado los miembros del vendedor en Exchanges para facilitar la segmentación.
  • Perfil simplificado: hemos reducido el perfil a solo los campos pertinentes para su empresa.
  • Nueva interfaz de usuario de bidder Platform: hemos creado una nueva interfaz de usuario para que pueda administrar y mantener sus perfiles. Se agregarán funcionalidades adicionales a esta interfaz de usuario a lo largo de 2019.

Revise primero estas páginas: Registro de cambios para perfiles de licitadores mejorados y preguntas más frecuentes (P+F) para perfiles de licitadores mejorados.

Paso 3: Configurar perfiles de licitador mejorados (0,5 ~ 1 hora)

Nota:

La configuración mejorada del perfil del licitador en la nueva API de servicio de perfil de licitador o en la nueva interfaz de usuario de bidder Platform no afecta al flujo de tráfico de Xandr hasta que complete el paso 4: Póngase en contacto con el soporte técnico de Xandr y voltee el conmutador en el back-end antes del 21 de mayo de 2019.

Hay dos maneras de configurar perfiles de licitador mejorados. Se recomienda usar la nueva interfaz de usuario de Bidder Platform a través de la API.

Uso de varios perfiles en un perfil de pujador mejorado

La impresión debe cumplir los requisitos de un único perfil que se enviará a su postor. 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 heredados al pujador mejorado

Orientación Campos heredados de la API de perfil de licitador Campos de API de & de interfaz de usuario de perfil de licitador mejorado
Miembros del vendedor/Grupos member_targets campos y seller_member_group_targets en la API Pestaña Exchanges and Members (Intercambios y miembros). Todos los miembros del vendedor pertenecen a uno de los tres intercambios y puede ver qué miembros del vendedor pertenecen a cada Exchange en.
exchanges campo en api (para el control de nivel de miembro, use excluded_members y included_members matrices en intercambios).
Países country_action el campo tiene include o exclude.
country_targets matriz tiene una lista de países.		 Pestaña Países.
countries campo en la API. (Use action y targets en countries. En el caso de los destinos, use los identificadores recuperados de Country Service).
Listas de dominio domain_list_action el campo tiene include o exclude.
domain_list_targets la matriz tiene una lista de dominios. Use Domain List Service para crear, ver o editar dominios.		 Pestaña Listas dominio en (Para editar dominios, use Domain List Service).
domain_lists campo en la API. (Use action y targets en domain_lists. En el caso de los destinos, use los identificadores recuperados de Domain List Service).
Tamaños (y tipos de anuncios) size_targets matriz (solo incluir). Pestaña Tipos de anuncios en . En primer lugar, puede seleccionar Tipos de anuncios para incluir. Si incluyes el tipo de anuncio Banner, puedes seleccionar los tamaños que quieras incluir.
ad_types campo en la API. Para cada tipo de anuncio, establezca en actioninclude o exclude. Para el banner tipo de anuncio, puede 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 campo en la API. (Use action y targets en supply_types. En el caso de los destinos, los valores posibles son web, mobile_weby mobile_app.)
Atributos de inventario use_inventory_attribute_targets tiene true o false.
inventory_attribute_targets la matriz tiene una lista de atributos de inventario (solo incluir).		 Pestaña Atributos confidenciales en .
inventory_attributes campo en la API. (La acción solo se incluye. En el caso de los destinos, use los identificadores recuperados del servicio de atributos de inventario).
Recepción solo de usuarios conocidos Si passthrough_percent el campo tiene 0 y el objeto Bidder se ha always_send_owned_segments establecido en true, solo está escuchando a los usuarios conocidos.
Como alternativa, el perfil del pujador puede incluir un identificador de segmento para dirigirse solo a usuarios conocidos.		 Nota: Para usar esta característica, debe usar/setuid url con Xandr para la coincidencia de usuarios.

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

Ajuste del volumen de tráfico: alternativa de porcentaje de acceso directo

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

Si tiene límites de seguridad de QPS en todas las instancias del licitador, tiene la opción de habilitar la característica de Stream de puja optimizada. Todo el tráfico se envía hasta que se cumple el límite de QPS; cuando haya más tráfico disponible que el límite de QPS, en lugar de cortar el volumen de tráfico aleatoriamente para cumplir el límite de QPS, se cortará el tráfico de prioridad baja en función del comportamiento de compra que supere el límite de QPS. Para obtener más información, consulte Preguntas más frecuentes sobre la puja optimizada Stream. Si está interesado en la característica, póngase en contacto con el administrador de cuentas o con el soporte técnico de Xandr.

Activación de un nuevo perfil de postor

Para activar un nuevo perfil de pujador en la API, establezca el campo trueactivo en . Ya no es necesario establecer un identificador de perfil en Bidder Service API para activar un perfil. Una vez completado el paso 4 siguiente, parent_profile_id y child_profiles en bidder API object will be ignore.

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

Active los nuevos perfiles del licitador antes de pasar al paso 4. La configuración del perfil de licitador mejorado no afecta al flujo de tráfico hasta que el conmutador back-end sea volteado por el soporte técnico de Xandr en el paso 4 antes del 21 de mayo de 2019.

Paso 4: Póngase en contacto con el soporte técnico de Xandr para completar la migración (aproximadamente 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 siga este paso si no lo hizo. En su lugar, póngase en contacto con el administrador de cuentas.

Advertencia

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

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

  • Categoría: seleccione Compatibilidad con productos
  • ¿Con qué podemos ayudar?: Selección de la integración del licitador externo

Uso de esta plantilla para la incidencia de soporte técnico

He revisado y configurado perfiles mejorados del licitador. Mi configuración de perfil se migra.

  1. Id. del licitador y nombre del postor:
  2. ¿Ha configurado con la nueva INTERFAZ de usuario o API de Bidder Platform?:
  3. Proporcione una breve explicación de los cambios de la configuración del perfil actual (si no hay ningún cambio, escriba "N/A"):

¿Qué pasará a continuación?

Nuestros especialistas en soporte técnico revisarán primero la configuración heredada y mejorada del perfil del licitador. Si se ven bien, los especialistas de soporte técnico invertirán el conmutador en el back-end y le enviarán una nota de confirmación. Cuando esto sucede, la nueva configuración del perfil de licitador mejorado comenzará a afectar al flujo de tráfico y se omitirá la configuración del perfil del pujador heredado.

Supervise el flujo de tráfico mediante la pestaña Métricas de la interfaz de usuario del licitador heredada: https://bidder.adnxs.net/metrics. Si hay algún problema, los especialistas de soporte técnico pueden volver a la configuración de perfil heredada inmediatamente (lo que surtirá efecto en el flujo de tráfico en 5-10 minutos) y 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 completa y se cerrará el vale de soporte técnico.

Sugerencia

Los perfiles de pujador heredados seguirán mostrándose como activos en la API y en la interfaz de usuario del licitador heredada una vez completada la migración. Siempre que se migre en el back-end, se omite la configuración del perfil heredado y no afecta al flujo de tráfico.

Si no completa el paso 4

El 21 de mayo de 2019, habilitaremos al postor para perfiles de licitador mejorados, momento en el que los nuevos perfiles controlarán cómo recibe el tráfico y los perfiles heredados quedarán en desuso. Si no actualiza los perfiles de licitador mejorados antes de esta fecha, el pujador no tendrá ninguna restricción de inventario configurada de forma predeterminada.