Diferencia entre los vínculos de acción para pedir comida para llevar y para recibir en tu domicilio (heredado)

Advertencia: Este es un instructivo heredado y solo debe usarse para mantener las integraciones existentes. Las integraciones nuevas deben usar el instructivo actualizado.

Nota: Esta guía solo se aplica a los socios de integración de Legacy Starter de Actions Center que proporcionan action_link que permiten a los usuarios realizar acciones de pedidos.

Objetivo: En esta guía, se explica cómo los socios pueden proporcionar a Actions Center información sobre qué acciones relacionadas con la comida puede completar un usuario a través de un action_link específico.

Los socios de la integración inicial heredada pueden asociar diferentes action_link_type con sus action_link. action_link_type ayuda a identificar qué tipo de acción puede realizar un usuario cuando se lo redirecciona al sitio web de los socios a través de ese vínculo.

• Solo puedes asociar un solo action_link_type con cada action_link.

Cuando pide comida, un usuario puede solicitar que se realicen las siguientes dos acciones:

• Solicitar comida para llevar del restaurante (pedir comida para llevar)
• Solicitar la entrega de comida en una ubicación específica (pedir envío de comida)

Esto se recomienda para todos los socios que participan en las acciones de comida. Si actualmente nos envías action_link con action_link_type = ACTION_LINK_TYPE_ORDER_FOOD o service_type = SERVICE_TYPE_FOOD_ORDERING, te recomendamos que actualices tus feeds para que se ajusten al enfoque actual.

Nota: Seguiremos admitiendo la implementación anterior.

Comercios que admiten pedidos de comida para llevar

Punto clave: Para etiquetar action_link como comida para llevar únicamente, debemos usar action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT.

Comercios

{
  "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "[phone]",
      "url": "https://www.restaurantsamplewebsite.com",
      "category": "restaurant",
      "geo": {
        "address": {
          "street_address": "803 11th Avenue",
          "locality": "Sunnyvale",
          "region": "CA",
          "country": "USA",
          "postal_code": "94089"
        }
      },
      "action_link": [
        {
          "url": "https://www.partnerwebsite.com/foodtakeout/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Servicios

{
  "service": [
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Reservation",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Order"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/reserve_table/merch1",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Comercios que admiten pedidos de envío de comida

Punto clave: Para etiquetar action_link como envío de comida únicamente, debemos usar action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY.

Comercios

{
 "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "[phone]",
      "url": "https://www.restaurantsamplewebsite.com",
      "category": "restaurant",
      "geo": {
        "address": {
          "street_address": "803 11th Avenue",
          "locality": "Sunnyvale",
          "region": "CA",
          "country": "USA",
          "postal_code": "94089"
        }
      },
      "action_link": [
        {
          "url": "https://www.partnerwebsite.com/fooddelivery/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Servicios

{
  "service": [
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Delivery",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Delivery"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/reserve_table/merch1",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Comercios que admiten los pedidos de comida para llevar y envío de comida

Si un comercio admite ambas acciones, es decir, pedidos de comida para llevar y envío de comida, te recomendamos que proporciones dos objetos action_link separados y los asocies con las acciones correspondientes.

Nota: Asegúrate de que el vínculo directo de action_link dirija a la acción adecuada y no a una página de destino genérica.

Comercios

{
  "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "[phone]",
      "url": "https://www.restaurantsamplewebsite.com",
      "category": "restaurant",
      "geo": {
        "address": {
          "street_address": "803 11th Avenue",
          "locality": "Sunnyvale",
          "region": "CA",
          "country": "USA",
          "postal_code": "94089"
        }
      },
      "action_link": [
        {
          "url": "https://www.partnerwebsite.com/foodtakeout/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        },
        {
          "url": "https://www.partnerwebsite.com/fooddelivery/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Servicios

{
  "service": [
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Order",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Order"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/foodpickup/merch10",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    },
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Delivery",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Delivery"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/fooddelivery/merch10",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Comercios que admiten ambas acciones a través de una sola URL

Por ejemplo, en el caso de un action_link que vincula directamente a una página de pedidos genérica del restaurante en la que se le solicitaría al usuario que elija entre Envío de comida y Comida para llevar, recomendamos lo siguiente:

Envía la URL de action_link dos veces y asocia cada instancia con el action_link_type adecuado, como se menciona a continuación:

• Para la primera instancia, etiqueta action_link con action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY.
• Para la segunda instancia, etiqueta action_link con action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_PICKUP.

Comercios

{
  "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "[phone]",
      "url": "https://www.restaurantsamplewebsite.com",
      "category": "restaurant",
      "geo": {
        "address": {
          "street_address": "803 11th Avenue",
          "locality": "Sunnyvale",
          "region": "CA",
          "country": "USA",
          "postal_code": "94089"
        }
      },
      "action_link": [
        {
          "url": "https://www.partnerwebsite.com/foodtakeout+delivery/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        },
        {
          "url": "https://www.partnerwebsite.com/foodtakeout+delivery/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }

      ]
    }
  ]
}

Servicios

{
  "service": [
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Order",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Order"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/foodtakeout+delivery/merch10",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    },
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Delivery",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Delivery"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/foodtakeout+delivery/merch10",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}