Cómo utilizar el buzón de feeds genérico

El buzón de feeds genérico permite subir varios tipos de feeds a un un solo dropbox por entorno. En esta guía, se explica cómo usar dropbox genérico y proporcionar vínculos a la guía adecuada del canal feed que planeas usar.

El dropbox genérico depende de que haya dos cargas independientes:

1. Archivo descriptor: describe el tipo de feed que serás. cargando...
2. Archivos del feed: El contenido del feed real.

Estructura el campo descriptor

El archivo descriptor se sube para informar a nuestro sistema qué tipo de feed están subiendo. Esto nos permite validar y procesar el feed correctamente. El archivo descriptor debe subirse antes del contenido del feed y debe seguir estos requisitos de nomenclatura:

• Usa la extensión de archivo .filesetdesc.json
• Cada nombre de archivo descriptor debe ser único y no puede volver a usarse en diferentes cargas. Mié se recomienda incluir la marca de tiempo de generación en el nombre del archivo.
  • Ejemplo: offers_1524606581.filesetdesc.json

message FilesetDescriptor {
  // The timestamp at which this feed was generated, in Unix time format
  // (seconds since the epoch). (required)
  int64 generation_timestamp = 1;

  // Identifies the name of this feed. (required)
  string name = 2;

  // Paths (relative to the dropbox root) specifying data files included in this
  // feed. (required)
  repeated string data_file = 3;
}

Entre los valores posibles del campo name, se incluyen los siguientes:

Este es un ejemplo de archivo descriptor JSON para un feed de ofertas con dos fragmentos disponibles a continuación:

{
  "generation_timestamp": 1524606581,
  "name": "promote.offer",
  "data_file": [
    "offers_1524606581_1.json",
    "offers_1524606581_2.json"
  ]
}

Estructuración del contenido del feed

Después de subir el archivo descriptor, subirás todos los archivos del feed para el tipo de datos del feed correspondiente al archivo de configuración del feed nombrado por tu archivo descriptor. Los nombres de archivos y las ubicaciones de las rutas de acceso (relativas dentro del dropbox) debe coincidir exactamente con el contenido del data_file. Si falta algún archivo, tiene un nombre incorrecto o subido a una ubicación diferente, no se eliminará todo el feed se procesan.

El contenido de estos archivos de datos de feed debe cumplir con las especificaciones pertinentes del el feed que se especificó en el archivo descriptor.

Cada nombre de archivo de feed debe ser único y no se puede volver a utilizar en diferentes cargas. Recomendaciones incluida la marca de tiempo de generación y el número de fragmento (ID incremental) en el nombre del archivo.

• Ejemplo: offer_1524606581_1.json

Tamaños de archivo del feed y frecuencia de carga

• Mantén el tamaño del archivo del feed por debajo de los 200 MB (después de la compresión).
• La mayoría de las integraciones solo necesitarán usar un único fragmento. Debes usar como pocos fragmentos como sea posible. Hay un máximo de 1,000 fragmentos por feed.
• No es necesario que los registros individuales que se envían en un fragmento se envíen en el mismo en los feeds futuros.
• Para obtener un mejor rendimiento, divide los datos de manera uniforme entre los fragmentos los archivos de fragmentos tienen un tamaño similar.
• Si es necesario, usa gzip para comprimir los feeds. Sin embargo, hazlo para cada fragmento de feed individual.

Solución de problemas y depuración

Después de subir los archivos (archivos de descriptores y de feed), dirígete a la Panel del historial de feeds (documentación) en el Portal para socios (ve a Historial > Feeds) para seguir el progreso de la transferencia de tu feed.

Busca el name que ingresaste en el archivo descriptor de "Nombre del feed". para encontrar tu feed.

Una vez que se haya transferido el feed (el estado es Success o Fail), puedes hacer clic en su fila para ver los detalles de los errores y las advertencias.