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

El dropbox de feed genérico permite subir varios tipos de feeds a un solo dropbox por entorno. En esta guía, se explica cómo usar el dropbox genérico y se proporcionan vínculos a la guía correspondiente para el feed correspondiente que planeas usar.

Advertencia: Esta guía no se aplica a los buzones de Comercio, Servicios ni Disponibilidad. Solo se aplica al dropbox genérico.

Nota: Debes contar con la aprobación correspondiente para cada tipo de feed que subirás. Si subes un tipo de feed que no está aprobado para la integración, no se procesará el feed. Si no estás seguro de qué tipos de feeds se aplican a tu integración, comunícate con tu contacto del Centro de acciones.

Advertencia: Es posible que debas restablecer tu clave SSH para habilitar las cargas al dropbox de feed genérico. Para hacerlo, consulta la configuración del feed del Portal para socios (documentación).

El dropbox genérico se basa en que haya dos cargas separadas:

1. Archivo descriptor: Describe el tipo de feed que subirás.
2. Archivos de feed: el contenido del feed real.

Nota: Si realizas una carga al dropbox genérico y no ves ninguna entrada correspondiente en el Portal para socios, es posible que tu archivo descriptor no se haya subido o tenga un nombre de archivo incorrecto. Si necesitas ayuda para depurar este problema, comunícate con tu contacto del Centro de acciones.

Estructura el campo descriptor

El archivo descriptor se sube para informar a nuestro sistema qué tipo de feed deseas subir. Esto nos permite validar y procesar el feed correctamente. El archivo descriptor se debe subir antes del contenido del feed y debe cumplir con los siguientes requisitos de nomenclatura:

• Usa la extensión de archivo .filesetdesc.json
• Cada nombre de archivo descriptor debe ser único y no se puede volver a utilizar en diferentes cargas. Recomendamos 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 para el campo name, se incluyen los siguientes:

• reservewithgoogle.conversion_data

A continuación, se muestra un ejemplo de un archivo descriptor JSON para un feed de ofertas con dos fragmentos:

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

Estructura del contenido del feed

Después de subir el archivo descriptor, debes subir todos los archivos del feed para el tipo de datos del feed correspondiente al archivo de configuración del feed nombrado por el archivo descriptor. Los nombres de archivos y las ubicaciones de las rutas (relativas dentro del dropbox) deben coincidir exactamente con lo que se incluyó en el campo data_file. Si falta algún archivo, no se asignó un nombre incorrecto o se sube a una ubicación diferente, no se procesará todo el feed.

El contenido de estos archivos de datos del feed debe cumplir con las especificaciones relevantes del feed especificado en el archivo descriptor.

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

• Ejemplo: offers_1524606581_1.json

Tamaños de archivos de feed y frecuencia de carga

• El tamaño del archivo del feed debe ser inferior a los 200 MB (después de la compresión).
• La mayoría de las integraciones solo necesitan usar un fragmento. Debes usar la menor cantidad posible de fragmentos. Hay un máximo de 1,000 fragmentos por feed.
• No es necesario que los registros individuales enviados en un fragmento se envíen en el mismo número de fragmento en feeds futuros.
• Si deseas obtener un mejor rendimiento, divide los datos de manera uniforme entre los fragmentos para que todos los archivos tengan 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 feeds), ve al panel de historial de feeds (documentación) en el Portal para socios (navega a Historial > Feeds) para seguir el progreso de la transferencia del feed.

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

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