Servicio de configuración de segmento por lotes

Nota:

Actualmente, este servicio solo está disponible para un conjunto limitado de clientes y empleados de Microsoft.

Advertencia

Si necesitas realizar algún cambio o byte límites en la num_line configuración del segmento por lotes de un miembro, presenta un ticket bajo EPIC: DMP-376, siguiendo las instrucciones en la sección de información de la página. Deberá recibir la aprobación de Ewa Maciukiewicz para continuar con los cambios.

El servicio de configuración de segmentos por lotes es una API interna solo para administradores que se usa para agregar y modificar opciones de configuración por cliente relacionadas con el uso del servicio de segmentos por lotes. Puede configurar el formato de archivo preferido del cliente, así como el rigor de nuestra comprobación de errores con respecto a ese formato. También puede establecer límites de uso y definir a qué datos de segmento de otros miembros tiene acceso el cliente.

Nota:

Para obtener más información sobre los detalles del formato de archivo, consulte Configuración inicial de la cuenta BSS.

Acceso de clientes a los datos de otros miembros

Un cliente que desee acceder a los datos de otro miembro tendrá que pedirle que le solicite que presente una solicitud de soporte técnico a través de nuestro Portal de soporte técnico de Microsoft Advertising. Por ejemplo, si el cliente A desea acceder a los datos del cliente B, el cliente B debe enviar una solicitud de soporte técnico autorizando el acceso del cliente A.

Campos JSON

Campo	Tipo	Descripción
created_on	string	Momento en que se creó este objeto. Filtrar por: Sí Ordenar por: Sí
daily_byte_limit	Entero	El número máximo de bytes por día que el cliente puede cargar. Guía general: 10G (aproximadamente 280 millones de líneas comprimidas con formato detallado) Nota: Los clientes que quieran plantear esto deben confirmar que están utilizando sus límites de datos correctamente, es decir, que nos están enviando un archivo diff en lugar de un volcado completo de la base de datos todos los días. Los clientes que no usan los datos de forma inteligente deben refactorizar su proceso de carga para minimizar el envío de datos. Requerido en: POST Filtrar por: Sí Ordenar por: Sí
daily_num_lines_limit	Entero	El número máximo de líneas al día que puede cargar el cliente. Requerido en: POST Filtrar por: Sí Ordenar por: Sí
default_domain	string	El dominio interno de la base de datos al que agregar el identificador de usuario. El valor predeterminado se establece en "userdata". Normalmente no se usa, ya que casi todos los clientes están en un dominio en este momento. Requerido en: POST Filtrar por: Sí Ordenar por: Sí
default_expiration	Entero	La cantidad de tiempo, en minutos, después del cual este cliente quiere que expiren sus segmentos. Esto se invalida mediante cualquier configuración de expiración en el archivo de datos de segmento. Un valor de 0 indica que el segmento nunca debe expirar; -1 indica que este usuario se quitará de este segmento. Nota: Si por alguna razón, POST las solicitudes rechazan 0 como entrada válida, POST con un valor distinto de cero y luego PUT el mismo archivo nuevamente con 0 como valor, y debería funcionar. Requerido en: POST Filtrar por: Sí Ordenar por: Sí
external_member_uid	Entero	Si "" es true,use_external_uids indique el ID de miembro cuyos ID de usuario utilizará el cliente. Un valor de null los medios para utilizar los propios recursos del cliente member_id. Solo válido para miembros que usan mapUID usersyncing (SUGERENCIA: Muy pocos clientes usan esto). Requerido en: POST Filtrar por: Sí Ordenar por: Sí
hourly_byte_limit	Entero	El número máximo de bytes por hora que el cliente puede cargar. Requerido en: POST Filtrar por: Sí Ordenar por: Sí
hourly_num_lines_limit	Entero	El número máximo de líneas por hora que el cliente puede cargar. Requerido en: POST Filtrar por: Sí Ordenar por: Sí
id	Entero	El identificador único de este objeto. Filtrar por: Sí Ordenar por: Sí
last_modified	string	Hora en la que se modificó por última vez este objeto. Filtrar por: Sí Ordenar por: Sí
max_concurrent_uploads	Entero	El número máximo de cargas que el cliente puede realizar a la vez. Guía general: 1 Requerido en: POST Filtrar por: Sí Ordenar por: Sí
member_id	Entero	El id. de miembro del cliente cuya configuración está editando. Requerido el: PUT, POST Filtrar por: Sí Ordenar por: Sí
member_segment_access	matriz de objetos	Identificadores de miembro a cuyos segmentos tiene acceso el cliente. (Use esta opción si está agregando usuarios a segmentos en nombre de alguien). Para obtener más información, consulte la sección Matriz de acceso a segmentos de miembros a continuación. Requerido en: POST Filtrar por: No Ordenar por: No
num_error_log_lines	Entero	El número de líneas que se mostrarán en el registro de errores. Guía general: menos de 200 Requerido en: POST Filtrar por: Sí Ordenar por: Sí
num_invalid_before_error	Entero	El número de líneas no válidas que se deben aceptar antes de señalar un error. Cuando se alcanza este límite, el trabajo se elimina, pero todo lo que se agregue antes del primer error entrará. Guía general: 50% de la ficha de un cliente. En caso de duda, establezca esto muy alto. Requerido en: POST Filtrar por: Sí Ordenar por: Sí
segment_fields	matriz	Una lista de segmentos correlacionados con el SEG bloque del formato de archivo. Para obtener más información, consulte Servicio de segmentos por lotes. Requerido en: POST Filtrar por: Sí Ordenar por: Sí
separator_1	string	Carácter o cadena de caracteres usado como separador por el servicio de segmento por lotes. Requerido en: POST Filtrar por: Sí Ordenar por: Sí
separator_2	string	Carácter o cadena de caracteres usado como separador por el servicio de segmento por lotes.
separator_3	string	Carácter o cadena de caracteres usado como separador por el servicio de segmento por lotes. Requerido en: POST Filtrar por: Sí Ordenar por: Sí
separator_4	string	Carácter o cadena de caracteres usado como separador por el servicio de segmento por lotes. Requerido en: POST Filtrar por: Sí Ordenar por: Sí
separator_5	string	Carácter o cadena de caracteres usado como separador por el servicio de segmento por lotes. Requerido en: POST Filtrar por: Sí Ordenar por: Sí
use_external_uids	bool	Si el cliente desea usar identificadores de usuario externos para la asignación de un nombre a otro. Establezca este campo en true para usar un external_member_uidarchivo . Requerido en: POST Filtrar por: Sí Ordenar por: Sí
use_specific_geo	string	Establézcalo en NULL de forma predeterminada. Este campo ya no es necesario para realizar las mejoras realizadas en el segmento por lotes en 2013. El sistema verificará todas las geos. Si el usuario se encuentra en varias ubicaciones geográficas, se agregará a los segmentos adecuados en cada ubicación geográfica en la que exista. Requerido en: POST Filtrar por: Sí Ordenar por: Sí

Matriz de acceso a segmento de miembro

Campo	Tipo	Descripción
segment_owner_member_id	Entero	El id. de miembro del propietario del segmento. Filtrar por: No Ordenar por: No

Ejemplos

Ver la configuración de un miembro determinado

$ curl -b cookies "https://api.appnexus.com/batch-segment-config?member_id=1226"
{
  "response": {
    "status": "OK",
    "count": null,
    "start_element": 0,
    "num_elements": 100,
    "batch_segment_upload_config": {
      "member_id": 1226,
      "id": 2,
      "hourly_byte_limit": 3500000000,
      "daily_byte_limit": 3500000000,
      "max_concurrent_uploads": 1,
      "num_error_log_lines": 50,
      "num_invalid_before_error": 1000000000,
      "separator_1": ";",
      "separator_2": ",",
      "separator_3": ":",
      "separator_4": "\t",
      "separator_5": "^",
      "default_domain": "userdata",
      "use_specific_geo": null,
      "segment_fields": "[SEG_ID,EXPIRATION,VALUE]",
      "last_modified": "2012-06-01 15:10:20",
      "created_on": "0000-00-00 00:00:00",
      "default_expiration": 0,
      "use_external_uids": false,
      "external_member_uid": null,
      "member_segment_access": [
        {
          "segment_owner_member_id": 23
        }
      ]
    }
  }
  }