Differenza tra i link di azioni di ordinazione e di Takeout (legacy)

Avviso: questo è un tutorial precedente e deve essere utilizzato solo per gestire le integrazioni esistenti. Le nuove integrazioni devono utilizzare il tutorial aggiornato.

Nota: questa guida è applicabile solo ai partner di integrazione di Actions Center Legacy Starter che forniscono action_link che consentono agli utenti di eseguire azioni di ordinamento.

Obiettivo: questa guida spiega in che modo i partner possono fornire al Centro azioni informazioni sulle azioni relative al cibo che un utente può completare tramite un action_link specifico.

I partner di integrazione di Starter legacy hanno la possibilità di associare diversi action_link_type ai propri action_link. action_link_type consente di identificare il tipo di azione che un utente può eseguire quando viene reindirizzato al sito web dei partner utilizzando il link.

• Puoi associare un solo action_link_type a ogni action_link.

Quando ordina del cibo, un utente può richiedere di eseguire le seguenti due azioni:

• Richiedere il ritiro del cibo dal ristorante (Ordina cibo da asporto)
• Richiedere la consegna di cibo in una località specifica (Ordina cibo a domicilio)

Questa operazione è consigliata per tutti i partner che partecipano a Food Actions. Se al momento ci invii action_link(i) con action_link_type = ACTION_LINK_TYPE_ORDER_FOOD o service_type = SERVICE_TYPE_FOOD_ORDERING, ti consigliamo di aggiornare i tuoi feed in modo che siano in linea con l'approccio attuale.

Nota: continueremo a supportare la vecchia implementazione.

Commercianti che supportano l'ordine di cibo da asporto

Punto chiave: per taggare action_link(s) come solo per il ritiro di cibo, è necessario utilizzare action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT

Merchant CenterServizi

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

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

Commercianti che supportano l'ordine di consegna di cibo

Punto chiave: per taggare action_link(i) come solo consegna di cibo, è necessario utilizzare action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY.

Merchant CenterServizi

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

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

Commercianti che supportano il ritiro e la consegna di cibo da asporto

Se un commerciante supporta entrambe le azioni, ovvero la consegna e il ritiro degli ordini di cibo, ti consigliamo di fornire due action_link distinti e di associarli alle azioni appropriate.

Nota: assicurati che il action_link o i action_link link diretti rimandino all'azione appropriata e non a una pagina di destinazione generica.

Merchant CenterServizi

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

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

Commercianti che supportano entrambe le azioni tramite un unico URL

Ad esempio, se un action_link rimanda a una pagina di ordinazione generica del ristorante in cui l'utente deve scegliere tra Consegna a domicilio e Ritiro, consigliamo quanto segue:

Invia l'URL action_link due volte, associando ogni istanza all'action_link_type appropriato come indicato di seguito:

• Per la prima istanza, tagga action_link utilizzando action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY
• Per la seconda istanza, tagga action_link utilizzando action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_PICKUP

Merchant CenterServizi

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

      ]
    }
  ]
}

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