Feeds de partida (heredados)

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 dos tipos de feeds:

   • 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): El feed de servicios describe los servicios y los action_links a nivel del servicio que tus comercios proporcionan en la plataforma.

   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	Opcional si se proporcionan feeds de servicios; de lo contrario, es obligatorio
   Merchant	brand_id	Es una cadena que identifica la marca orientada al consumidor que se debe usar.	Opcional
   Servicios	service_id	Identificador único del servicio proporcionado por el comercio	Sí (solo si se proporciona el feed de servicios)
   Servicios	merchant_id	Vínculo al comercio que proporciona este servicio	Sí (solo si se proporciona el feed de servicios)
   Servicios	localized_service_name	Nombre del servicio proporcionado	Sí (solo si se proporciona el feed de servicios)
   Servicios	localized_description	Descripción del servicio visible para el usuario	Opcional
   Servicios	action_link	Proporciona información sobre los vínculos directos relacionados con el servicio	Sí (solo si se proporciona el feed de servicios)
   Servicios	tipo	Tipo de vínculo directo (p.ej., SERVICE_TYPE_DINING_RESERVATION)	Sí (solo si se proporciona el feed de servicios)

   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
   • Feed de entrega de pedidos de comida
   • Feed de retiro de pedidos de comida
   • Feeds de pedidos de comida con metadatos
   • Feeds de pedidos minoristas
   • Feeds de pedidos minoristas con metadatos
   • Feeds de reservas presenciales
   • Feeds de reservas virtuales o en línea

   Si un comercio tiene varios servicios, pero los publica con un solo vínculo de acción, debes proporcionar un solo vínculo de acción para todos los servicios asociados con el comercio en el feed de comercios.

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

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

   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: La integración inicial heredada también se puede implementar junto con una integración de extremo a extremo de Actions Center o como un complemento de la integración de extremo a extremo. 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 la integración heredada inicial por sí sola 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.