Paso 2: Feeds

Primero, debes crear tus feeds y, luego, Google los evalúa.

Crea tus feeds

1. Genera tus feeds. La mayor parte de los datos de tu inventario se transmiten a Google a través de feeds. Para comenzar, crea tu feed de Merchant (y el feed de Servicios, si corresponde):

   • Feed de comercios: El feed de comercios describe tus comercios y los vínculos de acción a nivel de cada comercio.
   • Feed de servicios (opcional o no recomendado): No se recomienda implementar feeds de servicios para las nuevas integraciones de la vinculación de la empresa de Reservas. Si quieres mantener tu integración existente, consulta esta documentación heredada.

   Campos obligatorios y recomendados

   Feed	Nombre del campo	Descripción	¿Obligatorio?
   Comercio	merchant_id	Identificador único del comercio	Sí
   Comercio	nombre	Nombre del comercio	Sí
   Comercio	geo	Dirección y coordenadas geográficas del comercio	Sí
   Comercio	teléfono	Teléfono del comercio	Sí
   Comercio	categoría	Tipo de lugar del comercio	Deseable (Nice to Have)
   Comercio	action_link	Información sobre los vínculos directos específicos del comercio	Sí
   Merchant	action_link_type	Es el tipo de acción del vínculo. Los socios de Vínculo comercial de reservas deben usar ACTION_LINK_TYPE_MAKE_DINING_RESERVATION.
   Merchant	brand_id	Es una cadena que identifica la marca orientada al consumidor que se debe usar.	Opcional

   Nota: Se deben ignorar todos los campos adicionales que se describen en la sección de referencia.
   Punto clave: Solo debes subir el feed de comercio.

   Para comenzar, consulta los feeds de ejemplo

   • Feeds de reserva de restaurantes

   Puedes obtener más información para especificar vínculos de acción en los feeds de la integración de la vinculación de la empresa de Reservas aquí.

   Incluye metadatos del feed en cada uno de tus feeds para indicarle a Google cómo interpretar el feed.

   A continuación, se muestra un fragmento de metadatos del feed:

   "metadata": {
    "generation_timestamp": "1467993600",
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "total_shards": 1
   }

   Nota: Todos los feeds deben subirse con el valor PROCESS_AS_COMPLETE en la propiedad processing_instruction. El valor PROCESS_AS_INCREMENTAL dejó de estar disponible y ya no puede usarse.
   Nota: Esta integración también se puede implementar junto con la integración de extremo a extremo del Centro de acciones o como un complemento de esta última. Para ello, también deberás implementar los feeds de disponibilidad y los campos obligatorios de integración de extremo a extremo, tal como se indica en esta guía.

2. Exporta tus feeds. El formato de los feeds se describe con la sintaxis del búfer de protocolo 3, pero puedes consultar los ejemplos mencionados anteriormente para ver el formato JSON. Te recomendamos que subas los feeds en formato JSON.

   Si realmente deseas continuar con el formato pb3, consulta Conceptos básicos del búfer de protocolo: Java para obtener información general sobre cómo usar búferes de protocolo para generar un archivo pb3.

3. Sube los feeds a tu servidor de SFTP. Para subir tus feeds, usa la información del servidor de SFTP que te proporcionó Google y la clave privada que creaste durante la Configuración. El servidor SFTP de Google está disponible en sftp://partnerupload.google.com en el puerto 19321.

   Sube tus archivos con nombres únicos, como un nombre que incluya una marca de tiempo. Los nombres únicos son útiles para solucionar problemas y consultar el estado del feed.

   Para determinar el tamaño de los feeds y la frecuencia con que se publican, utiliza los siguientes lineamientos:

   • Tamaño de los archivos del feed y los fragmentos:
     • Mantén el tamaño del archivo del feed por debajo de los 200 MB (después de la compresión). Comprímelos con gzip.
     • Si es posible que tu archivo alcance más de 200 MB (después de la compresión), divídelo en varios fragmentos siguiendo el instructivo para fragmentar archivos de feeds . Sin embargo, es poco probable que solo esta integración alcance el límite de 200 MB.
   • Frecuencia de las actualizaciones completas:
     • Se proporciona un feed completo de comercios una vez al día.
     • (Si se implementa) Se proporciona un feed de servicios completo una vez al día.
   Nota: Google procesa los archivos del feed en cuanto se suben al servidor SFTP. Si el feed se fragmenta en varios archivos, el proceso comienza después de que subes el último archivo. Si tu feed contiene errores, recibirás un correo electrónico con los códigos de error del feed.

Google evalúa los feeds

Una vez que subes los feeds, Google los procesa y evalúa su calidad y nivel de integridad. Consideramos los siguientes factores:

• Los feeds cumplen con las especificaciones.
• Los feeds incluyen todos los campos obligatorios.
• Cada comercio tiene al menos un action_link o un servicio con al menos un action_link definido.
• La mayoría de los datos de tus comercios coinciden con las ubicaciones de Google Maps.

Nota: Para garantizar una integración fluida, realiza una evaluación previa de los factores anteriores, excepto el último, antes de enviar tus feeds.