Servicio de configuración de segmentos de Batch

Artículo
05/18/2024

Nota:

Este servicio está disponible actualmente para un conjunto limitado de clientes y empleados de Microsoft.

Advertencia

Si necesita realizar cambios en los límites o byte de la num_line configuración del segmento por lotes de un miembro, presente un vale en EPIC: DMP-376, siguiendo las instrucciones de la sección de información de la página. Tendrá que recibir la aprobación de Ewa Maciukiewicz para continuar con los cambios.

El servicio de configuración de segmentos de Batch es una API interna de solo administrador que se usa para agregar y modificar la configuración por cliente relacionada con su uso del servicio de segmento de Batch. Puede configurar el formato de archivo preferido del cliente, así como la rigurosidad de la comprobación de errores en 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 cliente a los datos de otros miembros

Un cliente que quiera acceder a los datos de otro miembro tendrá que pedir a ese miembro que abra una solicitud de soporte técnico a través de nuestro Portal de soporte al cliente. Por ejemplo, si el cliente A quiere acceder a los datos del cliente B, el cliente B debe enviar una solicitud de soporte técnico que autorice el acceso del cliente A.

Campos JSON

Campo	Tipo	Descripción
`created_on`	string	Hora a la que se creó este objeto. Filtrar por: Sí Ordenar por: Sí
`daily_byte_limit`	Entero	Número máximo de bytes por día que el cliente puede cargar. Guía general: 10G (aproximadamente 280M líneas gzipped con formato detallado) Nota: Los clientes que quieran generar esto deben confirmar que usan sus límites de datos correctamente, es decir, nos envían un archivo diff en lugar de un volcado de base de datos completo todos los días. Los clientes que no usan datos de forma inteligente deben refactorizar su proceso de carga para minimizar el envío de datos. Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`daily_num_lines_limit`	Entero	Número máximo de líneas por día que el cliente puede cargar. Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`default_domain`	string	Dominio de base de datos interno al que se va a 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. Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`default_expiration`	Entero	Cantidad de tiempo, en minutos, después de la cual este cliente desea que sus segmentos expiren. Esto se invalida por cualquier configuración de expiración en el archivo de datos del 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 cualquier motivo, `POST` las solicitudes rechazan 0 como entrada válida, con un valor distinto de cero y, a continuación`PUT`, `POST` el mismo archivo de nuevo con 0 como valor y debería funcionar. Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`external_member_uid`	Entero	Si "`use_external_uids`" es `true`, indique el identificador de miembro cuyos identificadores de usuario usará el cliente. Un valor de `null` significa usar el propio `member_id`cliente. Solo es válido para los miembros que usan la sincronización de usuarios de mapUID (HINT: muy pocos clientes usan esto). Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`hourly_byte_limit`	Entero	Número máximo de bytes por hora que el cliente puede cargar. Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`hourly_num_lines_limit`	Entero	Número máximo de líneas por hora que el cliente puede cargar. Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`id`	Entero	Identificador único de este objeto. Filtrar por: Sí Ordenar por: Sí
`last_modified`	string	Hora a la que se modificó por última vez este objeto. Filtrar por: Sí Ordenar por: Sí
`max_concurrent_uploads`	Entero	Número máximo de cargas que el cliente puede realizar a la vez. Guía general: 1 Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`member_id`	Entero	Identificador de miembro del cliente cuya configuración está editando. Obligatorio activado: `PUT`, `POST` Filtrar por: Sí Ordenar por: Sí
`member_segment_access`	matriz de objetos	Identificadores de miembro a los que tiene acceso el cliente. (Úsenlo si va a agregar usuarios a segmentos en nombre de alguien). Para obtener más información, vea la sección Matriz de acceso a segmentos de miembros a continuación. Obligatorio activado: `POST` Filtrar por: No Ordenar por: No
`num_error_log_lines`	Entero	Número de líneas que se mostrarán en el registro de errores. Guía general: menos de 200 Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`num_invalid_before_error`	Entero	Número de líneas no válidas que se aceptan antes de indicar un error. Cuando se alcanza este límite, se elimina el trabajo, pero todo lo agregado antes del primer error entrará. Guía general: 50 % del archivo de un cliente. Cuando esté en duda, establezca esto muy alto. Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`segment_fields`	matriz	Lista de segmentos correlacionados con el `SEG` bloque del formato de archivo. Para obtener más información, vea Batch Segment Service. Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`separator_1`	string	Carácter o cadena de caracteres utilizados como separador por el servicio batch segment. Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`separator_2`	string	Carácter o cadena de caracteres utilizados como separador por el servicio batch segment.
`separator_3`	string	Carácter o cadena de caracteres utilizados como separador por el servicio batch segment. Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`separator_4`	string	Carácter o cadena de caracteres utilizados como separador por el servicio batch segment. Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`separator_5`	string	Carácter o cadena de caracteres utilizados como separador por el servicio batch segment. Obligatorio activado: `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 `true` en para usar .`external_member_uid` Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí
`use_specific_geo`	string	Establézcalo `NULL` en de forma predeterminada. Este campo ya no es necesario para realizar mejoras en el segmento de batch en 2013. El sistema comprobará todas las geos. Si el usuario se encuentra en varias geoáreas, se agregará a los segmentos adecuados en cada ubicación geográfica en la que exista. Obligatorio activado: `POST` Filtrar por: Sí Ordenar por: Sí

Matriz de acceso a segmentos de miembros

Campo	Tipo	Description
`segment_owner_member_id`	Entero	Identificador de miembro del propietario del segmento. Filtrar por: No Ordenar por: No

Ejemplos

Consulte 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
        }
      ]
    }
  }
  }

Compartir a través de