Szablony URL do przekierowania płatności

Po zarezerwowaniu przedziału dostępności w określonej cenie użytkownik przekierowany na stronę rezerwacji przy użyciu zdefiniowanego przez Ciebie adresu URL. Czynności Pokażemy Ci, jak:

1. Zdefiniuj szablon adresu URL.
2. Ustaw szablon URL w plikach danych.
3. Włącz linki do konkretnych przedziałów dostępności.
4. Sprawdź pola w Centrum działań.

1. Definiowanie szablonu adresu URL

Szablon adresu URL jest zgodny ze specyfikacją RFC6570 poziomu 2 IETF (Internet Engineering Task Force) – więcej informacji znajdziesz na stronie datatracker.ietf.org. Adres URL jest ustawiany przez Ciebie i dynamicznie wypełniany parametrami dotyczącymi rezerwacji. Tabela poniżej zawiera wymagane i opcjonalne parametry dostępne dla Twojego szablonu URI.

`https://reservation-provider.com/examplerestaurant/book?date={availability_slot_start_seconds}&num_guests={resources_party_size}`

Dostępne wartości szablonu URL

Parametry szablonu	Wymagany / Opcjonalny	Kanał	Pole	Przykładowa wartość
availability_slot_start_seconds	Wymagane	dostępność	start_sec	4152695841
resources_party_size	Wymagane	availability.resources	party_size	2
availability_slot_availability_tag	Opcjonalnie	dostępność	availability_tag	res-123
availability_slot_duration_seconds	Opcjonalnie	dostępność	duration_sec	3600
resources_room_id	Opcjonalnie	availability.resources	room_id	bar_123

Ważne: zalecamy rozpoczęcie od wymaganych parametrów, a potem dodanie pozostałych w miarę potrzeby. Jeśli opcjonalny parametr znajduje się w szablonie uri_template, ale nie został zdefiniowany w źródle treści nie będzie się wyświetlać w tym boksie.

2. W pliku danych ustaw szablon identyfikatora URI.

W tej sekcji zakładamy, że masz aktywną integrację E2E z istniejącą Plik danych o usługach. Zdefiniowany przez Ciebie URL zostanie ustawiony w pliku danych usługi. Poniżej znajdziesz definicję tego pola.

message Service {
  // ..
  UriTemplate uri_template = 38;
}

Uwaga: szablon adresu URI jest zdefiniowany dla wszystkich slotów dostępności powiązanych z usługą. Jeśli chcesz ustawić inne parametry dla restauracji, możesz to zrobić, przesyłając różne usługi z unikanymi szablonami adresów URI. Na przykład jedna usługa może być powiązana z ogólnymi rezerwacjami restauracji, a druga z rezerwacjami z pokojami. Dzięki temu możesz zdefiniować szablon z parametrem „room_id” dla slotów zawierających pokoje.

Definicja szablonu identyfikatora URI

// A template specifying how Google should generate URLs to external site.
message UriTemplate {
  // The uri template must follow the RFC6570, see
  // https://datatracker.ietf.org/doc/html/rfc6570.
  // Supports Level 2 templates.
  // These parameters will be resolved to their values specified in their
  // respective entities.
  //
  // 5 available parameters for Dining Reservation Linkout:
  // 1) (required) {availability_slot_start_seconds} :: populated from start_sec
  //   field in availability feed
  // 2) (required) {availability_slot_duration_seconds} :: populated from
  //   duration_sec field in availability feed
  // 3) (optional) {resources_party_size} :: populated from party_size field in
  //   availability feed
  // 4) (optional) {availability_availability_tag} :: populated from
  //   availability_tag field in availability feed
  // 5) (optional) {resources_room_id} :: populated from room_id field in
  //   availability feed
  //
  // Example usage:
  // http://example.com/book/restaurant?start={availability_slot_start_seconds}
  // &num_guests={resources_party_size}
  // * start_sec = 123456
  // * party_size = 2
  // https://example.com/book/restaurant?start=123456&num_guests=2
  string uri_template = 1;
}

Definicja przykładowej usługi

{
  "metadata": {
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "shard_number": 0,
    "total_shards": 1,
    "nonce": "12484913",
    "generation_timestamp": 1530432018
  },
  "service": [
    {
      "merchant_id": "dining-A",
      "service_id": "reservation",
      "uri_template": {
        "uri_template": "https://reservation-provider.com/examplerestaurant/book?date={availability_slot_start_seconds}&num_guests={resources_party_size}"
      },
      "localized_service_name": {
        "value": "Reservation",
        "localized_value": [
          {
            "locale": "en",
            "value": "Reservation"
          }
        ]
      }
    }
  ]
}

3. Włącz linkowanie na podstawie slotu dostępności.

W tej sekcji zakładamy, że masz aktywną integrację E2E z istniejącą Plik danych dostępności. Po ustawieniu szablonu adresu URL w pliku danych o usłudze musisz określić, które sloty z dostępnością będą wymagane do linkowania.

Możesz to zrobić, dodając pole linkout_required_reason z wartością PAYMENT_REQUIRED.

Definicja przyczyny linkowania zewnętrznego

message Availability {
  // ..
  LinkoutRequiredReason linkout_required_reason = 19;
}

  // The reason why a slot requires a linkout. Currently only used for Dining
  // Reservations Payment Redirect Partners.
  enum LinkoutRequiredReason {
    // Default value: Do not use, equates to unknown.
    LINKOUT_REQUIRED_REASON_UNSPECIFIED = 0;
    // Slot requires payment in the partner platform to be booked.
    PAYMENT_REQUIRED = 1;
  }

Przykładowa definicja przyczyny linku

{
  "metadata": {
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "shard_number": 0,
    "total_shards": 1,
    "nonce": "11203880",
    "generation_timestamp": 1543875200
  },
  "service_availability": [
    {
      "availability": [
        {
          "merchant_id": "dining-A",
          "service_id": "reservation",
          "linkout_required_reason": "PAYMENT_REQUIRED",
          "start_sec": 1535853600,
          "duration_sec": 2700,
          "spots_total": 2,
          "spots_open": 2,
          "resources": {
            "room_id": "A-dining-room",
            "room_name": "Dining Room",
            "party_size": 2
          }
        }
      ]
    }
  ]
}

Ważne: po wykonaniu tego kroku boksy przekierowania płatności będą dostępne tylko pojawi się, jeśli ten przedział ma konfigurację płatności, więcej informacji znajdziesz w artykule Określanie typów płatności

4. Weryfikacja pól w Centrum akcji

Gdy przesłane przez Ciebie pliki danych zostaną przetworzone, a w ich historii nie będzie błędów, możesz zweryfikować pola, wykonując te czynności.

Uwaga: pamiętaj, że przetwarzanie pliku danych może potrwać 4–8 godzin. Jeśli pola nie są widoczne od razu, może być konieczne odczekanie dłuższej chwili.

Szablon adresu URL w przeglądarce zasobów reklamowych

Definicję szablonu URL znajdziesz w sekcji Usługi w widoku asortymentu sprzedawcy. Szablon znajdziesz w sekcji „Fragment pliku danych”. . Więcej informacji o widoku danych o asortymencie znajdziesz w sekcji Widok danych o asortymencie.

Rysunek 1. Lokalizacja adresu URL w Centrum działań.

Przyczyna linku w przeglądarce dostępności

Pole linkout_reason_required znajdziesz podczas wyświetlania przedział czasu w widoku dostępności.

Rysunek 1. Lokalizacja adresu URL w Centrum działań.