Spécifier des liens d'action (ancien)

Un lien d'action permet aux utilisateurs d'interagir avec un lien profond qui redirige vers le site Web du partenaire pour effectuer une action. Les liens profonds s'affichent dans la fiche info du marchand. Ce guide explique comment ajouter des liens d'action aux flux.

Vous pouvez fournir des liens d'action à deux endroits :

  • Flux marchands : implémentez des liens d'action via les flux marchands lorsqu'un même marchand propose plusieurs services effectuant une action similaire.
  • Flux de services : implémentez des liens d'action via les flux de services lorsqu'un même marchand propose plusieurs services effectuant différentes actions.

Vous devez fournir un lien d'action via les flux de marchands lorsque tous les services d'un marchand donné redirigent l'utilisateur vers la même page de destination sur le site Web du partenaire.

Il s'agit généralement de la seule implémentation pertinente pour la restauration, car il n'y a qu'un seul service par établissement.

Voici un exemple :

  • Un marchand propose plusieurs services, comme des cours de yoga, de boxe ou de vélo, des coupes de cheveux, des colorations ou des shampoings. Le lien d'action redirige vers une page de destination affichant l'intégralité du catalogue de services du marchand.

Le type d'action doit être spécifié à l'aide de ActionLinkType, qui fait partie de ActionLink dans le flux des marchands.

  // 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;
  }

Vous devez fournir un lien d'action via le flux Services lorsque le marchand dispose de différents liens profonds par service ou de plusieurs services effectuant différentes actions, comme la commande de repas et la réservation de table.

Voici un exemple :

  • Un restaurant propose des réservations et des commandes de plats. Un lien d'action redirige l'utilisateur vers la page de réservation de restaurant, et un autre le redirige vers la page de commande de plats.

Le type d'action peut être spécifié à l'aide de ServiceType dans les services et de ActionLinkType, qui fait partie de ActionLink dans le flux des marchands.

  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;
  }

Utiliser OrderOnlineMetadata

OrderOnlineMetadata permet de spécifier les informations à afficher à l'utilisateur concernant les frais, les montants de commande minimum et la disponibilité des différentes méthodes de traitement des achats en ligne. Lorsqu'elles sont incluses, ces métadonnées sont incluses avec le lien d'action dans le flux de marchand.

Pour savoir comment inclure correctement ces informations dans vos flux si votre intégration l'exige, consultez la documentation suivante :