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é rediriger 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 les restaurants, car il n'y a qu'un seul service par marchand.

Voici un exemple :

  • Un marchand propose plusieurs services, comme des cours de yoga, de boxe et de cyclisme, des coupes de cheveux, des colorations et 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 restaurant.

Voici un exemple :

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

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. Le cas échéant, ces métadonnées sont incluses avec le lien d'action dans le flux du marchand.

Pour en savoir plus sur l'inclusion correcte de ces informations dans vos flux si votre intégration l'exige, consultez la documentation suivante: