Specifica i link di azione (legacy)

Un link all'azione consente agli utenti di interagire con un link diretto che rimanda al sito web del partner per eseguire un'azione. I link diretti vengono visualizzati nella scheda informativa del commerciante. Questa guida descrive come aggiungere link di azione ai feed.

I link alle azioni possono essere forniti in due posizioni:

  • Feed del commerciante : implementa i link di azione tramite i feed del commerciante, quando un singolo commerciante ha più servizi che eseguono un'azione simile.
  • Feed dei servizi: implementa i link di azione tramite i feed dei servizi, quando un singolo commerciante ha più servizi che eseguono azioni diverse.

Devi fornire un link all'azione tramite i feed del commerciante quando tutti i servizi di un determinato commerciante reindirizzano l'utente alla stessa pagina di destinazione sul sito web del partner.

Di solito questa è l'unica implementazione significativa per la ristorazione, in quanto esiste un solo servizio per commerciante.

Ecco un esempio:

  • Un commerciante offre diversi servizi, come lezioni di yoga, boxe e ciclismo, taglio dei capelli, colorazione dei capelli e shampoo. Il link all'azione reindirizza a una pagina di destinazione che mostra l'intero catalogo dei servizi per il commerciante.

Il tipo di azione deve essere specificato utilizzando ActionLinkType, che fa parte di ActionLink nel feed dei commercianti.

  // Predetermined type of action associated with an action link.
  enum ActionLinkType {
    // The action link type is unspecified.
    ACTION_LINK_TYPE_UNSPECIFIED = 0;
    // The action link type is booking an appointment.
    ACTION_LINK_TYPE_BOOK_APPOINTMENT = 1;
    // The action link type is booking an online appointment.
    ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT = 2;
    // The action link type is ordering food for delivery or takeout or both.
    ACTION_LINK_TYPE_ORDER_FOOD = 3;
    // The action link type is ordering food for delivery.
    ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY = 4;
    // The action link type is ordering food for takeout.
    ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT = 5;
    // The action link type is making a dining reservation.
    ACTION_LINK_TYPE_MAKE_DINING_RESERVATION = 6;
    // The action link type allows users to shop from the given merchant. It
    // could either be delivery or pickup.
    ACTION_LINK_TYPE_SHOP_ONLINE = 7;
  }

Devi fornire un link di azione tramite il feed dei servizi quando il commerciante ha link diretti diversi per servizio o se ha più servizi che eseguono azioni diverse, ad esempio ordini di cibo e prenotazione di ristoranti.

Ecco un esempio:

  • La struttura comprende un ristorante che offre prenotazione e ordinazione di cibo. Un link di azione reindirizza l'utente alla pagina di prenotazione del ristorante, mentre un altro lo reindirizza alla pagina per ordinare il cibo.

Il tipo di azione può essere specificato utilizzando ServiceType nei servizi e ActionLinkType, che fa parte di ActionLink nel feed dei commercianti.

  enum ServiceType {
    SERVICE_TYPE_UNSPECIFIED = 0;
    // Service that provides dining reservation.
    SERVICE_TYPE_DINING_RESERVATION = 1;
    // Service that provides food ordering in general, could be either takeout
    // or delivery or both.
    SERVICE_TYPE_FOOD_ORDERING = 2;
    // Service that only provides food delivery.
    SERVICE_TYPE_FOOD_DELIVERY = 6;
    // Service that only provides food takeout.
    SERVICE_TYPE_FOOD_TAKEOUT = 7;

    // Services that provide event based ticketing (e.g. concerts, sporting
    // events, shows). Do not use for Reserve with Google integrations.
    SERVICE_TYPE_EVENT_TICKET = 3;
    SERVICE_TYPE_TRIP_TOUR = 4;

    // Service that provides appointments or classes. Recommended for (1) health
    // and fitness, (2) spa and beauty, and (3) financial consults and
    // evaluations services. Please see the supported service types:
    // https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
    SERVICE_TYPE_APPOINTMENT = 5;
    // Service that provides appointment for an online class or session which
    // will be fully virtual. Must be set if enabling virtual service bookings.
    SERVICE_TYPE_ONLINE_APPOINTMENT = 8;

    // Service that allows users to shop from the given merchant. It could
    // either be delivery or pickup.
    SERVICE_TYPE_SHOPPING = 9;
  }

Utilizzo di OrderOnlineMetadata

OrderOnlineMetadata viene utilizzato per specificare le informazioni da mostrare all'utente in merito a commissioni, importi minimi degli ordini e disponibilità per i diversi metodi di evasione degli acquisti online. Se inclusi, questi metadati vengono inseriti con il link all'azione nel feed del commerciante.

Per saperne di più su come includere correttamente queste informazioni nei feed se la tua integrazione lo richiede, consulta la seguente documentazione: