Różnica między linkami do składania zamówień i działaniami Takeout (starsza wersja)

Ostrzeżenie: jest to starszy samouczek, którego należy używać wyłącznie do utrzymania obecnych integracje. Nowe integracje muszą używać interfejsu aktualny samouczek.

Uwaga: ten przewodnik dotyczy tylko starszej wersji Starter partnerów integracyjnych, którzy dostarczają action_link za pomocą których użytkownicy mogą wykonywać zamówienia.

.

Cel: ten przewodnik wyjaśnia, jak partnerzy mogą udostępniać Centrum działań informacje na temat tego, jakie czynności pokarmowe użytkownik może wykonać za pomocą action_link.

Partnerzy korzystający ze starszej wersji Starter Integration mogą powiązać różne action_link_type wraz ze swoim action_link. action_link_type pomaga określić rodzaj działania, które użytkownik może wykonać gdy zostaną przekierowani do witryny partnera za pomocą tego linku.

• Z każdym linkiem action_link możesz powiązać tylko jeden obiekt action_link_type.

Aby zamawiać jedzenie, użytkownik może zażądać następujących 2 czynności: wykonano:

• Zamów jedzenie z odbiorem z restauracji (zamawianie jedzenia na wynos)
• Zamów jedzenie z dostawą do określonej lokalizacji (zamawianie jedzenia z dostawą)

Jest to zalecane w przypadku wszystkich partnerów uczestniczących w programie Food Actions, jeśli: aktualnie wysyłają nam action_link z action_link_type = ACTION_LINK_TYPE_ORDER_FOOD lub service_type = SERVICE_TYPE_FOOD_ORDERING – zalecamy aktualizujesz pliki danych, dostosowując je do obecnego podejścia.

Uwaga: nadal będziemy obsługiwać starą implementację.

Sprzedawcy oferujący możliwość zamawiania jedzenia z odbiorem na wynos

Ważne: aby otagować action_link tylko na wynos, będziemy potrzebować action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT

Sprzedawcy

{
  "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"
        }
      ]
    }
  ]
}

Usługi

{
  "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"
        }
      ]
    }
  ]
}

Sprzedawcy oferujący dostawę jedzenia w sklepie

Ważne: aby otagować action_link jako dostawę jedzenia, jednak wymagamy podania action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY

Sprzedawcy

{
 "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"
        }
      ]
    }
  ]
}

Usługi

{
  "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"
        }
      ]
    }
  ]
}

Sprzedawcy oferujący odbiór i dostawę żywności na wynos

Jeśli sprzedawca obsługuje oba te działania, np. dostawę jedzenia i zamawianie jedzenia na potrzeby odbioru, zalecamy przesłanie dwóch osobnych action_link i kojarzyć je z odpowiednimi działaniami.

Uwaga: upewnij się, że parametr action_link precyzyjny link do odpowiedniego działania, a nie do ogólnej strony docelowej.

Sprzedawcy

{
  "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"
        }
      ]
    }
  ]
}

Usługi

{
  s"ervice:" [
    {
      m"erchant_id:" m"erch10,"
      s"ervice_id:" 1"0,"
      l"ocalized_service_name:" {
        v"alue:" F"ood Order,"
        l"ocalized_value:" [
          {
            l"ocale:" e"n,"
            v"alue:" F"ood Order
"          }
        ]
      },
      a"ction_link:" [
        {
          u"rl:" h"ttps://www.rwgpartnerwebsite.com/foodpickup/merch10,"
          a"ction_link_type:" A"CTION_LINK_TYPE_ORDER_FOOD_TAKEOUT,"
          l"anguage:" e"n,"
          p"latform:" A"CTION_PLATFORM_WEB_APPLICATION
"        }
      ]
    },
    {
      m"erchant_id:" m"erch10,"
      s"ervice_id:" 1"0,"
      l"ocalized_service_name:" {
        v"alue:" F"ood Delivery,"
        l"ocalized_value:" [
          {
            l"ocale:" e"n,"
            v"alue:" F"ood Delivery
"          }
        ]
      },
      a"ction_link:" [
        {
          u"rl:" h"ttps://www.rwgpartnerwebsite.com/fooddelivery/merch10,"
          a"ction_link_type:" A"CTION_LINK_TYPE_ORDER_FOOD_DELIVERY,"
          l"anguage:" e"n,"
          p"latform:" A"CTION_PLATFORM_WEB_APPLICATION
"        }
      ]
    }
  ]
}

Sprzedawcy obsługujący oba działania za pomocą jednego adresu URL

Jeśli na przykład action_link które precyzyjne linki prowadzą do ogólnej strony składania zamówień w restauracji, na której użytkownik musisz wybrać opcję Dostawa jedzenia lub Odbiór jedzenia, zalecamy obserwujesz

Prześlij action_link URL dwukrotnie, wiążąc każde wystąpienie z odpowiednim action_link_type jako wspomniane poniżej:

• W przypadku pierwszego wystąpienia otaguj action_link przy użyciu: action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY
• W przypadku drugiego wystąpienia otaguj action_link przy użyciu: action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_PICKUP

Sprzedawcy

{
  "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"
        }

      ]
    }
  ]
}

Usługi

{
  "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"
        }
      ]
    }
  ]
}