Engage SDK Travel: instrukcje integracji technicznej firm zewnętrznych

Zwiększ zaangażowanie w aplikację, docierając do użytkowników tam, gdzie się znajdują. Zintegruj pakiet Engage SDK, aby wyświetlać spersonalizowane rekomendacje i treści kontynuacji bezpośrednio użytkownikom na różnych platformach na urządzeniu, takich jak Kolekcje, Entertainment Space i Sklep Play. Integracja zwiększa rozmiar średniego pliku APK (skompresowany) o mniej niż 50 KB i zajmuje deweloperom około tygodnia pracy. Więcej informacji znajdziesz na naszej stronie.

Ten przewodnik zawiera instrukcje dla partnerów deweloperów dotyczące przesyłania treści związanych z podróżami i wydarzeniami na platformy treści Engage.

Szczegóły integracji

Terminologia

Ta integracja obejmuje te typy klastrów: Rekomendacje, Wyróżnione, Rezerwacja i Kontynuuj wyszukiwanie.

  • Rekomendacje to grupy zawierające spersonalizowane sugestie dotyczące podróży i wydarzeń od konkretnego partnera deweloperskiego. Rekomendacje mogą być spersonalizowane dla danego użytkownika lub ogólne (np. popularne produkty). Używaj ich do wyświetlania rekomendacji artykułów, wydarzeń, miejsc noclegowych lub miejsc wartych odwiedzenia.

    • Klaster rekomendacji może składać się z ArticleEntity, EventEntity, LodgingEntity, PointOfInterestEntity lub StoreEntity wizytówek, ale nie z mieszanki różnych typów encji.

    Rekomendacje mają następującą strukturę:

    • Grupa rekomendacji: widok interfejsu, który zawiera grupę rekomendacji od tego samego partnera deweloperskiego.

    • Jednostka: obiekt reprezentujący pojedynczy element w klastrze. Ta integracja udostępnia niektóre elementy, które byłyby wyświetlane w klastrze rekomendacji:

      • ArticleEntity: ArticleEntity reprezentuje rekomendację treści tekstowych związanych z podróżami i wydarzeniami. Można go używać w przypadku artykułów, postów na blogu, treści marketingowych, fragmentów wiadomości itp.

        Ilustracja 1. Interfejs pokazujący pojedynczy element ArticleEntity w klastrze Rekomendacje.

      • EventEntity: EventEntity reprezentuje wydarzenie, które odbędzie się w przyszłości. Czas rozpoczęcia wydarzenia to kluczowa informacja, którą należy przekazać użytkownikom.

        Ilustracja 2. Interfejs pokazujący pojedynczy element EventEntity w klastrze rekomendacji.

      • LodgingEntity: LodgingEntity reprezentuje obiekt noclegowy, taki jak hotel, mieszkanie lub dom wakacyjny na wynajem krótkoterminowy i długoterminowy.

        Ilustracja 3. Interfejs pokazujący pojedynczy element LodgingEntity w klastrze rekomendacji.

      • StoreEntity: StoreEntity reprezentuje sklep, restaurację, kawiarnię itp. Wyróżnia treści, w których lokal gastronomiczny lub sklep jest kluczową informacją, którą należy przekazać użytkownikom.

        Ilustracja 4. Interfejs pokazujący pojedynczy element StoreEntity w klastrze rekomendacji.

      • PointOfInterestEntity: PointOfInterestEntity reprezentuje miejsce, które może być interesujące dla użytkowników, np. stację benzynową, miejsce wydarzenia, park rozrywki, muzeum, atrakcję turystyczną, szlak turystyczny itp. Podkreśla treści, w których lokalizacja jest kluczową informacją, którą należy przekazać użytkownikom. Nie należy go używać w przypadku obiektów noclegowych, sklepów ani lokali gastronomicznych.

        Rysunek 5. Interfejs pokazujący pojedynczy element PointOfInterestEntity w klastrze Rekomendacje.

  • Grupa Rezerwacja zawiera treści, z którymi użytkownicy ostatnio wchodzili w interakcję, pochodzące od wielu partnerów programistów w jednym układzie interfejsu. Każdy partner deweloper może transmitować maksymalnie 10 elementów w klastrze Rezerwacja.

    Treści dotyczące rezerwacji mogą mieć następującą strukturę:

    • RestaurantReservationEntity: RestaurantReservationEntity reprezentuje rezerwację w restauracji lub kawiarni i pomaga użytkownikom śledzić zbliżające się lub trwające rezerwacje.

      Rysunek 6. Interfejs pokazujący pojedynczy element RestaurantReservationEntity w klastrze Reservation.

    • EventReservationEntity: EventReservationEntity reprezentuje rezerwację wydarzenia i pomaga użytkownikom śledzić rezerwacje nadchodzących lub trwających wydarzeń. Wydarzenia mogą obejmować m.in.:

      • wydarzenia sportowe, np. rezerwacja miejsca na mecz piłki nożnej;
      • wydarzenia związane z grami, np. rezerwacje miejsc na turnieje e-sportowe;
      • wydarzeń rozrywkowych, takich jak rezerwacja biletów na film w kinie, koncert, spektakl teatralny czy spotkanie autorskie;
      • rezerwacje podróży lub miejsc wartych odwiedzenia, np. wycieczek z przewodnikiem czy biletów do muzeum;
      • Rezerwacje miejsc na spotkania towarzyskie, seminaria i konferencje
      • Rezerwacje sesji edukacyjnych lub szkoleniowych
      Rysunek 7. Interfejs pokazujący pojedynczy element EventReservationEntity w klastrze Reservation.

    • LodgingReservationEntity: LodgingEntityReservation reprezentuje rezerwację noclegu w podróży i pomaga użytkownikom śledzić nadchodzące lub trwające rezerwacje hoteli lub kwater wakacyjnych.

      Rysunek 8. Interfejs użytkownika pokazujący pojedynczy element LodgingReservationEntity w grupie Reservation.

    • TransportationReservationEntity: TransportationReservationEntity reprezentuje rezerwację transportu dowolnym środkiem lokomocji i pomaga użytkownikom śledzić rezerwacje nadchodzących lub trwających lotów, promów, pociągów, autobusów, przejazdów taksówką lub rejsów.

      Rysunek 9. Interfejs pokazujący pojedynczy element TransportationReservationEntity w grupie Reservation.

    • VehicleRentalReservationEntity: VehicleRentalReservationEntity reprezentuje rezerwację wynajmu pojazdu i pomaga użytkownikom śledzić nadchodzące lub trwające rezerwacje wynajmu pojazdów.

      Rysunek 10. Interfejs użytkownika pokazujący pojedynczy element VehicleRentalReservationEntity w grupie Reservation.

  • Grupa Polecane zawiera wybrane elementy od wielu partnerów programistów w jednym układzie interfejsu. Jeden wyróżniony klaster będzie wyświetlany u góry interfejsu w priorytetowym miejscu nad wszystkimi innymi klastrami rekomendacji. Każdy partner deweloper może transmitować maksymalnie 10 elementów w klastrze Polecane.

    • GenericFeaturedEntity: GenericFeaturedEntity różni się od elementu rekomendacji tym, że element polecany powinien być używany w przypadku pojedynczych najlepszych treści od deweloperów, które są najważniejsze i mogą być interesujące i przydatne dla użytkowników.

      Ilustracja 11. Interfejs użytkownika przedstawiający wyróżniony klaster z listą elementów GenericFeaturedEntity

  • Klaster Kontynuuj wyszukiwanie pomaga użytkownikom wznowić poprzednie wyszukiwanie informacji o podróżach, wyświetlając listę zapytań, które użytkownik ostatnio wyszukiwał we wszystkich aplikacjach do planowania podróży. Klaster będzie przypięty na drugiej pozycji, po rezerwacjach, a przed klastrami z reklamami wyróżnionymi i rekomendacjami. Każdy partner deweloper może transmitować maksymalnie 3 elementy w klastrze Kontynuuj wyszukiwanie.

    • PointOfInterestEntity: PointOfInterestEntity reprezentuje miejsce, które może być interesujące dla użytkownika, np. stację benzynową, miejsce wydarzenia, park rozrywki, muzeum, atrakcję turystyczną, szlak turystyczny itp. Podkreśla treści, których użytkownik wcześniej szukał.

Przygotowanie

Minimalny poziom interfejsu API: 19

Dodaj bibliotekę com.google.android.engage:engage-core do aplikacji:

dependencies {
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.5.12'
}

Podsumowanie

Projekt jest oparty na implementacji powiązanej usługi.

Dane, które klient może publikować, podlegają tym limitom w przypadku różnych typów klastrów:

Typ klastra Limity klastra Minimalne limity jednostek w klastrze Maksymalne limity elementów w klastrze
Klastry rekomendacji Maksymalnie 7 Co najmniej 1 Maksymalnie 50 (ArticleEntity, EventEntity,LodgingEntity, StoreEntity lub PointOfInterestEntity)
Klaster rezerwacji Maksymalnie 1 Co najmniej 1 Maksymalnie 20 (RestaurantReservationEntity, EventReservationEntity, LodgingReservationEntity, TransportationReservationEntity lub VehicleRentalReservationEntity)
Polecany klaster Maksymalnie 1 Co najmniej 1 Maksymalnie 20 osób (GenericFeaturedEntity)
Kontynuuj wyszukiwanie klastra Maksymalnie 1 Co najmniej 1 Maksymalnie 3 (PointOfInterestEntity)

Krok 1. Podaj dane podmiotu

Pakiet SDK ma zdefiniowane różne elementy reprezentujące każdy typ produktu. W przypadku kategorii Podróże i wydarzenia obsługujemy te typy danych:

  1. GenericFeaturedEntity
  2. ArticleEntity
  3. EventEntity
  4. LodgingEntity
  5. StoreEntity
  6. PointOfInterestEntity
  7. RestaurantReservationEntity
  8. EventReservationEntity
  9. LodgingReservationEntity
  10. TransportationReservationEntity
  11. VehicleRentalReservationEntity

W tabelach poniżej znajdziesz listę dostępnych atrybutów i wymagań dotyczących każdego typu.

GenericFeaturedEntity

Atrybut Wymaganie Opis Format
Identyfikator URI działania Wymagany

Precyzyjny link do podmiotu w aplikacji dla usługodawców.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.

Uri
Obrazy plakatu Wymagany

Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.

Uwaga: jeśli podano plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczna przestrzeń o wielkości 24 dp.

 Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Tytuł Opcjonalnie Nazwa elementu.

Dowolny tekst

Zalecany rozmiar tekstu: 50 znaków
Opis Opcjonalnie

Jeden akapit tekstu opisujący encję.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecany rozmiar tekstu: 180 znaków
Lista podtytułów Opcjonalnie

Maksymalnie 3 napisy, każdy w jednym wierszu tekstu.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecana długość każdego podtytułu: maks. 50 znaków
Odznaki Opcjonalnie

Każda plakietka to tekst (maksymalnie 15 znaków) lub mały obraz.

Specjalne elementy UX na obrazie lub filmie, np. plakietka nakładana na obraz

  • „Aktualizacja na żywo”
  • Czas czytania artykułu
Plakietka – tekst Opcjonalnie

Tytuł plakietki

Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.

Dowolny tekst

Zalecany rozmiar tekstu: maksymalnie 15 znaków
Plakietka – obraz Opcjonalnie

Mały obraz

Specjalne traktowanie pod względem UX, np. nakładka w postaci plakietki na miniaturę obrazu lub filmu.

Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.

Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Kategorie treści Opcjonalnie Opisz kategorię treści w obiekcie.

Lista wartości w polu enum

Wskazówki znajdziesz w sekcji Kategoria treści.
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia Opcjonalnie

Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia Opcjonalnie

Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach

ArticleEntity

Atrybut Wymaganie Opis Format
Identyfikator URI działania Wymagany

Precyzyjny link do podmiotu w aplikacji dla usługodawców.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.

Uri
Tytuł Wymagany Nazwa elementu.

Dowolny tekst

Zalecany rozmiar tekstu: maksymalnie 50 znaków
Obrazy plakatu Opcjonalnie

Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.

Uwaga: zdecydowanie zalecamy dodanie obrazu. Jeśli podasz plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczna przestrzeń o wielkości 24 dp.

 Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Źródło – tytuł Opcjonalnie imię i nazwisko autora, nazwę organizacji lub imię i nazwisko reportera;

Dowolny tekst

Zalecana długość tekstu: poniżej 25 znaków
Źródło – obraz Opcjonalnie obraz źródła, np. autora, organizacji lub reportera; Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis Opcjonalnie

Jeden akapit tekstu opisujący encję.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecany rozmiar tekstu: 180 znaków
Lista podtytułów Opcjonalnie

Maksymalnie 3 napisy, każdy w jednym wierszu tekstu.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecana długość każdego podtytułu: maks. 50 znaków
Odznaki Opcjonalnie

Każda plakietka to tekst (maksymalnie 15 znaków) lub mały obraz.

Specjalne traktowanie UX na obrazie lub filmie, np. jako nakładka w postaci plakietki na obrazie

  • „Aktualizacja na żywo”
  • Czas czytania artykułu
Plakietka – tekst Opcjonalnie

Tytuł plakietki

Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.

Dowolny tekst

Zalecany rozmiar tekstu: maksymalnie 15 znaków
Plakietka – obraz Opcjonalnie

Mały obraz

Specjalne traktowanie pod względem UX, np. nakładka w postaci plakietki na miniaturę obrazu lub filmu.

Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.

Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Czas publikacji treści Opcjonalnie Jest to sygnatura czasowa epoki w milisekundach, która określa, kiedy treści zostały opublikowane lub zaktualizowane w aplikacji. Sygnatura czasowa epoki w milisekundach
Czas ostatniego działania związanego z zaangażowaniem Opcjonalnie

Sygnatura czasowa epoki w milisekundach, kiedy użytkownik ostatnio wchodził w interakcję z tym elementem.

Sygnatura czasowa epoki w milisekundach
Procent postępu Opcjonalnie

Procent pełnej treści, który użytkownik wykorzystał do tej pory.

 Liczba całkowita z zakresu od 0 do 100 (włącznie).
Kategorie treści Opcjonalnie Opisz kategorię treści w obiekcie.

Lista wartości w polu enum

Wskazówki znajdziesz w sekcji Kategoria treści.
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia Opcjonalnie

Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia Opcjonalnie

Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach

EventEntity

Atrybut Wymaganie Opis Format
Identyfikator URI działania Wymagany

Precyzyjny link do podmiotu w aplikacji dla usługodawców.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.

Uri
Tytuł Wymagany Nazwa elementu.

Ciąg znaków

Zalecany rozmiar tekstu: maksymalnie 50 znaków
Zlokalizowany czas rozpoczęcia – sygnatura czasowa Wymagany

Sygnatura czasowa w formacie epoki, kiedy ma się rozpocząć wydarzenie.

 Joda-Time Instant
Zlokalizowany czas rozpoczęcia – strefa czasowa Wymagany

Strefa czasowa, w której ma się rozpocząć wydarzenie.

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.
Tryb zdarzenia Wymagany

Pole wskazujące, czy wydarzenie będzie wirtualne, stacjonarne czy w obu formach.

 Lista wartości: VIRTUAL, IN_PERSON lub HYBRID
Obrazy plakatu Wymagany

Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.

Uwaga: zdecydowanie zalecamy dodanie obrazu. Jeśli podasz plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczna przestrzeń o wielkości 24 dp.

 Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Lokalizacja – kraj Wymagane warunkowo

Kraj, w którym odbywa się wydarzenie.

Uwaga: jest to wymagane w przypadku wydarzeń, które są STACJONARNE lub HYBRYDOWE.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – miasto Wymagane warunkowo

Miasto, w którym odbywa się wydarzenie.

Uwaga: jest to wymagane w przypadku wydarzeń, które są STACJONARNE lub HYBRYDOWE.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlany adres Wymagane warunkowo

Adres lub nazwa miejsca, w którym odbędzie się wydarzenie, które powinny być wyświetlane użytkownikowi.

Uwaga: jest to wymagane w przypadku wydarzeń, które są STACJONARNE lub HYBRYDOWE.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – adres Opcjonalnie Adres ulicy (w odpowiednich przypadkach) miejsca, w którym odbywa się wydarzenie.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan Opcjonalnie Stan lub województwo (jeśli ma zastosowanie), w którym odbywa się wydarzenie.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy Opcjonalnie Kod pocztowy (jeśli występuje) lokalizacji, w której odbywa się wydarzenie.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – dzielnica Opcjonalnie Dzielnica (jeśli dotyczy), w której odbywa się wydarzenie.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Czas zakończenia Opcjonalnie

Sygnatura czasowa w formacie epoki, kiedy wydarzenie ma się zakończyć.

Uwaga: ta wartość będzie podana w milisekundach.

 Sygnatura czasowa epoki w milisekundach
Opis Opcjonalnie

Jeden akapit tekstu opisujący encję.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecany rozmiar tekstu: 180 znaków
Lista podtytułów Opcjonalnie

Maksymalnie 3 napisy, każdy w jednym wierszu tekstu.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecana długość każdego podtytułu: maks. 50 znaków
Odznaki Opcjonalnie

Każda plakietka to tekst (maksymalnie 15 znaków) lub mały obraz.
Plakietka – tekst Opcjonalnie

Tytuł plakietki

Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.

Dowolny tekst

Zalecany rozmiar tekstu: maksymalnie 15 znaków
Plakietka – obraz Opcjonalnie

Mały obraz

Specjalne traktowanie pod względem UX, np. nakładka w postaci plakietki na miniaturę obrazu lub filmu.

Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.

Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Cena – CurrentPrice Wymagane warunkowo

Obecna cena biletu/karnetu na wydarzenie.

Należy podać, jeśli podano cenę przekreśloną.

Dowolny tekst
Cena – StrikethroughPrice Opcjonalnie Pierwotna cena biletu na wydarzenie. Dowolny tekst
Objaśnienie dotyczące ceny Opcjonalnie Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu (jeśli są dostępne).

Dowolny tekst

Zalecana długość tekstu: mniej niż 45 znaków (za długi tekst może być wyświetlany z wielokropkiem)
Kategorie treści Opcjonalnie Opisz kategorię treści w obiekcie.

Lista kwalifikujących się typów wyliczeniowych

  • TYPE_MOVIES_AND_TV_SHOWS (przykład: kino)
  • TYPE_DIGITAL_GAMES (przykład: e-sport)
  • TYPE_MUSIC (przykład: koncert)
  • TYPE_TRAVEL_AND_LOCAL (przykład: wycieczka, festiwal)
  • TYPE_HEALTH_AND_FITENESS (przykład: zajęcia z jogi)
  • TYPE_EDUCATION (przykład: Class)
  • TYPE_SPORTS (przykład: mecz piłki nożnej)
  • TYPE_DATING (przykład: spotkanie)

Wskazówki znajdziesz w sekcji Kategoria treści.
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia Opcjonalnie

Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia Opcjonalnie

Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach

LodgingEntity

Atrybut Wymaganie Opis Format
Identyfikator URI działania Wymagany

Precyzyjny link do podmiotu w aplikacji dla usługodawców.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.

Uri
Tytuł Wymagany Nazwa elementu.

Ciąg znaków

Zalecany rozmiar tekstu: maksymalnie 50 znaków
Obrazy plakatu Wymagany

Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.

Uwaga: jeśli podano plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczna przestrzeń o wielkości 24 dp.

Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Lokalizacja – kraj Wymagany Kraj, w którym znajduje się obiekt noclegowy.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – miasto Wymagany Miasto, w którym znajduje się obiekt noclegowy.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlany adres Wymagany Adres, który będzie wyświetlany użytkownikowi. W większości przypadków zalecamy podanie nazwy miasta, a także stanu lub kraju. Podawaj tylko adres lub nazwę dzielnicy, jeśli użytkownik znajduje się w pobliżu lokalizacji, zna ją lub miasto jest uwzględnione w tytule klastra. Jeśli podajesz adres, użyj skróconej formy, stosując w miarę możliwości skróty (np. „ul.” zamiast „ulica”, „al.” zamiast „aleja”).

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – adres Opcjonalnie Adres (jeśli dotyczy) obiektu noclegowego.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan Opcjonalnie Stan lub województwo (jeśli ma zastosowanie), w którym znajduje się obiekt.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy Opcjonalnie Kod pocztowy (jeśli występuje) obiektu noclegowego.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – dzielnica Opcjonalnie okolica (w stosownych przypadkach);

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Odznaki Opcjonalnie

Każda plakietka to tekst (maksymalnie 15 znaków) lub mały obraz.
Plakietka – tekst Opcjonalnie

Tytuł plakietki

Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.

Dowolny tekst

Zalecany rozmiar tekstu: maksymalnie 15 znaków
Plakietka – obraz Opcjonalnie

Mały obraz

Specjalne traktowanie pod względem UX, np. nakładka w postaci plakietki na miniaturę obrazu lub filmu.

Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.

Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis Opcjonalnie

Jeden akapit tekstu opisujący encję.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecany rozmiar tekstu: 180 znaków
Lista podtytułów Opcjonalnie

Maksymalnie 3 napisy, każdy w jednym wierszu tekstu.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecana długość każdego podtytułu: maks. 50 znaków
AvailabilityTimeWindow - Localized Start Time - Timestamp Opcjonalnie Sygnatura czasowa epoki, kiedy obiekt noclegowy ma być otwarty lub dostępny. Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone Opcjonalnie Strefa czasowa, w której obiekt noclegowy ma być otwarty lub dostępny.

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.
AvailabilityTimeWindow - Localized End Time - Timestamp Opcjonalnie Sygnatura czasowa w formacie epoki, do której obiekt noclegowy ma być otwarty lub dostępny. Joda-Time Instant
AvailabilityTimeWindow - Localized End Time - Timezone Opcjonalnie Strefa czasowa, w której obiekt noclegowy ma być otwarty lub dostępny.

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.
Ocena – wartość maksymalna Opcjonalnie

Maksymalna wartość skali ocen.

Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.

 Liczba >= 0,0
Ocena – bieżąca wartość Opcjonalnie

Bieżąca wartość skali ocen.

Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.

 Liczba >= 0,0
Ocena – liczba Opcjonalnie

Liczba ocen obiektu.

Uwaga: wypełnij to pole, jeśli aplikacja ma kontrolować sposób wyświetlania tego elementu użytkownikom. Podaj krótki ciąg znaków, który może być wyświetlany użytkownikowi. Jeśli np. liczba wynosi 1 000 000, rozważ użycie skrótu, np. 1 mln, aby nie została obcięta w przypadku mniejszych rozmiarów wyświetlanych elementów.

 Ciąg znaków
Ocena – wartość liczby Opcjonalnie

Liczba ocen obiektu.

Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skracania wyświetlanych wartości. Jeśli występują zarówno liczba, jak i wartość liczby, użytkownikom wyświetlimy liczbę.

 Długi
Cena – CurrentPrice Wymagane warunkowo

Obecna cena obiektu.

Musisz podać tę wartość, jeśli podasz cenę przekreśloną.

Dowolny tekst
Cena – StrikethroughPrice Opcjonalnie Pierwotna cena obiektu noclegowego, która będzie przekreślona w interfejsie. Dowolny tekst
Objaśnienie dotyczące ceny Opcjonalnie Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu (jeśli są dostępne).

Dowolny tekst

Zalecana długość tekstu: mniej niż 45 znaków (za długi tekst może być wyświetlany z wielokropkiem)
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia Opcjonalnie

Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia Opcjonalnie

Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach

StoreEntity

Obiekt StoreEntity reprezentuje pojedynczy sklep, który partnerzy deweloperzy chcą opublikować, np. popularne miejsce do jedzenia, które jest istotne dla podróżujących.

Atrybut Wymaganie Opis Format
Obrazy plakatu Wymagany Musisz podać co najmniej 1 obraz. Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Identyfikator URI działania Wymagany

Precyzyjny link do podmiotu w aplikacji dla usługodawców.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.

Uri
Tytuł Opcjonalnie Nazwa sklepu.

Dowolny tekst

Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek).
Lokalizacja Opcjonalnie Lokalizacja sklepu.

Dowolny tekst

Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
Objaśnienie Opcjonalnie Wywołanie, które umożliwia wyróżnienie promocji, wydarzenia lub aktualizacji dotyczących sklepu, jeśli jest dostępne.

Dowolny tekst

Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
Drobny druk objaśnienia Opcjonalnie Tekst drobnego druku objaśnienia.

Dowolny tekst

Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
Opis Opcjonalnie Opis sklepu.

Dowolny tekst

Zalecana długość tekstu: mniej niż 90 znaków (za długi tekst może być wyświetlany z wielokropkiem)
Kategoria Opcjonalnie

Kategoria sklepu. W przypadku lokali gastronomicznych może to być rodzaj kuchni, np. „francuska”, „nowa amerykańska”, „ramen”, „elegancka restauracja”.

Dowolny tekst

Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
Ocena – wartość maksymalna Opcjonalnie

Maksymalna wartość skali ocen.

Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.

 Liczba >= 0,0
Ocena – bieżąca wartość Opcjonalnie

Bieżąca wartość skali ocen.

Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.

 Liczba >= 0,0
Ocena – liczba Opcjonalnie

Liczba ocen obiektu.

Uwaga: wypełnij to pole, jeśli aplikacja ma kontrolować sposób wyświetlania tego elementu użytkownikom. Podaj krótki ciąg znaków, który może być wyświetlany użytkownikowi. Jeśli np. liczba wynosi 1 000 000, rozważ użycie skrótu, np. 1 mln, aby nie została obcięta w przypadku mniejszych rozmiarów wyświetlanych elementów.

 Ciąg znaków
Ocena – wartość liczby Opcjonalnie

Liczba ocen obiektu.

Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skracania wyświetlanych wartości. Jeśli występują zarówno liczba, jak i wartość liczby, użytkownikom wyświetlimy liczbę.

 Długi
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia Opcjonalnie

Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia Opcjonalnie

Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach

PointOfInterestEntity

Atrybut Wymaganie Opis Format
Identyfikator URI działania Wymagany

Precyzyjny link do podmiotu w aplikacji dla usługodawców.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.

Uri
Tytuł Wymagany Nazwa elementu.

Ciąg znaków

Zalecany rozmiar tekstu: maksymalnie 50 znaków
Obrazy plakatu Wymagane warunkowo

Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.

Uwaga: Grafika jest wymagana, jeśli encja należy do klastra rekomendacji. Jeśli podasz plakietkę, upewnij się, że u góry i u dołu obrazu znajduje się bezpieczny obszar o wielkości 24 dp.

 Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Czas ostatniego działania związanego z zaangażowaniem Wymagane warunkowo

Sygnatura czasowa w formacie epoki, która wskazuje, kiedy użytkownik ostatnio wszedł w interakcję z tym elementem.

Uwaga: to pole jest wymagane, jeśli encja jest częścią klastra wyszukiwania kontynuowanego.

 Joda-Time Instant
Lokalizacja – kraj Wymagane warunkowo

Kraj, w którym znajduje się ciekawe miejsce.

Uwaga: to pole jest wymagane, jeśli podmiot należy do klastra rekomendacji.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – miasto Wymagane warunkowo

Miasto, w którym znajduje się interesujące miejsce.

Uwaga: to pole jest wymagane, jeśli element należy do klastra rekomendacji.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlany adres Wymagane warunkowo

Adres, który będzie wyświetlany użytkownikowi. Podaj zwięzły adres, używając w miarę możliwości skrótów (np. „St” zamiast „Street”, „Ave” zamiast „Avenue”). Ten ciąg znaków może zostać skrócony w zależności od urządzenia i ustawień użytkownika. Podaj nazwę miasta, aby ułatwić identyfikację.

Uwaga: to pole jest wymagane, jeśli element należy do klastra rekomendacji.

Dowolny tekst

Zalecany rozmiar tekstu: maks. ok. 35 znaków
Lokalizacja – adres Opcjonalnie Adres (jeśli występuje) ciekawego miejsca.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan Opcjonalnie Stan lub województwo (jeśli ma zastosowanie), w którym znajduje się ważne miejsce.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy Opcjonalnie Kod pocztowy (jeśli występuje) danego ważnego miejsca.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – dzielnica Opcjonalnie Okolica (jeśli występuje), w której znajduje się dane ważne miejsce.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
AvailabilityTimeWindow - Localized Start Time - Timestamp Opcjonalnie Sygnatura czasowa epoki, kiedy ważne miejsce ma być otwarte lub dostępne. Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone Opcjonalnie Strefa czasowa, w której ważne miejsce powinno być otwarte lub dostępne.

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.
AvailabilityTimeWindow - Localized End Time - Timestamp Opcjonalnie Sygnatura czasowa w formacie epoki, do której ważne miejsce powinno być otwarte lub dostępne. Joda-Time Instant
AvailabilityTimeWindow - Localized End Time - Timezone Opcjonalnie Strefa czasowa, w której ważne miejsce powinno być otwarte lub dostępne.

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.
Odznaki Opcjonalnie

Każda plakietka to tekst (maksymalnie 15 znaków) lub mały obraz.
Plakietka – tekst Opcjonalnie

Tytuł plakietki

Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.

Dowolny tekst

Zalecany rozmiar tekstu: maksymalnie 15 znaków
Plakietka – obraz Opcjonalnie

Mały obraz

Specjalne traktowanie pod względem UX, np. nakładka w postaci plakietki na miniaturę obrazu lub filmu.

Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.

Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis Opcjonalnie

Jeden akapit tekstu opisujący encję.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecany rozmiar tekstu: 180 znaków
Lista podtytułów Opcjonalnie

Maksymalnie 3 napisy, każdy w jednym wierszu tekstu.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecana długość każdego podtytułu: maks. 50 znaków
Ocena – wartość maksymalna Opcjonalnie

Maksymalna wartość skali ocen.

Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.

 Liczba >= 0,0
Ocena – bieżąca wartość Opcjonalnie

Bieżąca wartość skali ocen.

Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.

 Liczba >= 0,0
Ocena – liczba Opcjonalnie

Liczba ocen ciekawego miejsca.

Uwaga: wypełnij to pole, jeśli aplikacja ma kontrolować sposób wyświetlania tego elementu użytkownikom. Podaj krótki ciąg znaków, który może być wyświetlany użytkownikowi. Jeśli np. liczba wynosi 1 000 000, rozważ użycie skrótu, np. 1 mln, aby nie została obcięta w przypadku mniejszych rozmiarów wyświetlanych elementów.

 Ciąg znaków
Ocena – wartość liczby Opcjonalnie

Liczba ocen ciekawego miejsca.

Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skracania wyświetlanych wartości. Jeśli występują zarówno liczba, jak i wartość liczby, użytkownikom wyświetlimy liczbę.

 Długi
Cena – CurrentPrice Wymagane warunkowo

Aktualna cena biletów lub karnetów do danego miejsca.

Należy podać, jeśli podano cenę przekreśloną.

Dowolny tekst
Cena – StrikethroughPrice Opcjonalnie Pierwotna cena biletów/karnetów do ważnego miejsca. Dowolny tekst
Objaśnienie dotyczące ceny Opcjonalnie Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu (jeśli są dostępne).

Dowolny tekst

Zalecana długość tekstu: mniej niż 45 znaków (za długi tekst może być wyświetlany z wielokropkiem)

Kategorie treści Opcjonalnie Opisz kategorię treści w obiekcie.

Lista kwalifikujących się typów wyliczeniowych

  • TYPE_TRAVEL_AND_LOCAL
  • TYPE_MOVIES_AND_TV_SHOWS (przykład: kino)
  • TYPE_MEDICAL (przykład: szpital)
  • TYPE_EDUCATION (przykład: szkoła)
  • TYPE_SPORTS (przykład: stadion)

Wskazówki znajdziesz w sekcji Kategoria treści.
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia Opcjonalnie

Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia Opcjonalnie

Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach

RestaurantReservationEntity

Atrybut Wymaganie Opis Format
Identyfikator URI działania Wymagany

Precyzyjny link do podmiotu w aplikacji dla usługodawców.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.

Uri
Tytuł Wymagany Nazwa elementu.

Ciąg znaków

Zalecany rozmiar tekstu: maksymalnie 50 znaków
Zlokalizowany czas rozpoczęcia rezerwacji – sygnatura czasowa Wymagany Sygnatura czasowa epoki, kiedy ma się rozpocząć rezerwacja. Joda-Time Instant
Zlokalizowany czas rozpoczęcia rezerwacji – strefa czasowa Wymagany Strefa czasowa, w której ma się rozpocząć rezerwacja.

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.

Lokalizacja – kraj Wymagany Kraj, w którym znajduje się restauracja.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – miasto Wymagany Miasto, w którym znajduje się restauracja.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlany adres Wymagany Adres restauracji, który będzie wyświetlany użytkownikowi.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – adres Opcjonalnie Adres pocztowy restauracji (w odpowiednich przypadkach).

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan Opcjonalnie Stan lub województwo (jeśli ma zastosowanie), w którym znajduje się restauracja.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy Opcjonalnie Kod pocztowy restauracji (w stosownych przypadkach).

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – dzielnica Opcjonalnie Okolica (jeśli dotyczy), w której znajduje się restauracja.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Obrazy plakatu Opcjonalnie Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9. Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis Opcjonalnie

Jeden akapit tekstu opisujący encję.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecany rozmiar tekstu: 180 znaków
Lista podtytułów Opcjonalnie

Maksymalnie 3 napisy, każdy w jednym wierszu tekstu.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecana długość każdego podtytułu: maks. 50 znaków
Wielkość tabeli Opcjonalnie Liczba osób w grupie rezerwacji Liczba całkowita > 0
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia Opcjonalnie

Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia Opcjonalnie

Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach

EventReservationEntity

Atrybut Wymaganie Opis Format
Identyfikator URI działania Wymagany

Precyzyjny link do podmiotu w aplikacji dla usługodawców.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.

Uri
Tytuł Wymagany Nazwa elementu.

Ciąg znaków

Zalecany rozmiar tekstu: maksymalnie 50 znaków
Zlokalizowany czas rozpoczęcia – sygnatura czasowa Wymagany

Sygnatura czasowa w formacie epoki, kiedy ma się rozpocząć wydarzenie.

 Joda-Time Instant
Zlokalizowany czas rozpoczęcia – strefa czasowa Wymagany

Strefa czasowa, w której ma się rozpocząć wydarzenie.

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.
Tryb zdarzenia Wymagany

Pole wskazujące, czy wydarzenie będzie wirtualne, stacjonarne czy w obu formach.

 Lista wartości: VIRTUAL, IN_PERSON lub HYBRID
Lokalizacja – kraj Wymagane warunkowo

Kraj, w którym odbywa się wydarzenie.

Uwaga: jest to wymagane w przypadku wydarzeń, które są STACJONARNE lub HYBRYDOWE.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – miasto Wymagane warunkowo

Miasto, w którym odbywa się wydarzenie.

Uwaga: jest to wymagane w przypadku wydarzeń, które są STACJONARNE lub HYBRYDOWE.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlany adres Wymagane warunkowo

Adres lub nazwa miejsca, w którym odbędzie się wydarzenie, które powinny być wyświetlane użytkownikowi.

Uwaga: jest to wymagane w przypadku wydarzeń, które są STACJONARNE lub HYBRYDOWE.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – adres Opcjonalnie Adres ulicy (w odpowiednich przypadkach) miejsca, w którym odbywa się wydarzenie.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan Opcjonalnie Stan lub województwo (jeśli ma zastosowanie), w którym odbywa się wydarzenie.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy Opcjonalnie Kod pocztowy (jeśli występuje) lokalizacji, w której odbywa się wydarzenie.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – dzielnica Opcjonalnie Dzielnica (jeśli dotyczy), w której odbywa się wydarzenie.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Obrazy plakatu Opcjonalnie

Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.

Uwaga: zdecydowanie zalecamy dodanie obrazu. Jeśli podasz plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczna przestrzeń o wielkości 24 dp.

 Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Zlokalizowany czas zakończenia – sygnatura czasowa Opcjonalnie

Sygnatura czasowa w formacie epoki, kiedy wydarzenie ma się zakończyć.

 Joda-Time Instant
Zlokalizowany czas zakończenia – strefa czasowa Opcjonalnie

Strefa czasowa, w której ma się zakończyć wydarzenie.

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.
Dostawca usług – nazwa Opcjonalnie

Nazwa dostawcy usługi.

Uwaga: W przypadku usługodawcy wymagany jest tekst lub obraz.

Dowolny tekst. np. nazwa organizatora wydarzenia lub wycieczki.
Usługodawca – obraz Opcjonalnie

Logo lub obraz usługodawcy.

Uwaga: W przypadku usługodawcy wymagany jest tekst lub obraz.

Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis Opcjonalnie

Jeden akapit tekstu opisujący encję.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecany rozmiar tekstu: 180 znaków
Lista podtytułów Opcjonalnie

Maksymalnie 3 napisy, każdy w jednym wierszu tekstu.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecana długość każdego podtytułu: maks. 50 znaków
Odznaki Opcjonalnie

Każda plakietka to tekst (maksymalnie 15 znaków) lub mały obraz.
Plakietka – tekst Opcjonalnie

Tytuł plakietki

Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.

Dowolny tekst

Zalecany rozmiar tekstu: maksymalnie 15 znaków
Plakietka – obraz Opcjonalnie

Mały obraz

Specjalne traktowanie pod względem UX, np. nakładka w postaci plakietki na miniaturę obrazu lub filmu.

Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.

Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Identyfikator rezerwacji Opcjonalnie Identyfikator rezerwacji biletu na wydarzenie. Dowolny tekst
Cena – CurrentPrice Wymagane warunkowo

Obecna cena biletu/karnetu na wydarzenie.

Należy podać, jeśli podano cenę przekreśloną.

Dowolny tekst
Cena – StrikethroughPrice Opcjonalnie Pierwotna cena biletu na wydarzenie. Dowolny tekst
Objaśnienie dotyczące ceny Opcjonalnie Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu (jeśli są dostępne).

Dowolny tekst

Zalecana długość tekstu: mniej niż 45 znaków (za długi tekst może być wyświetlany z wielokropkiem)
Ocena – wartość maksymalna Opcjonalnie

Maksymalna wartość skali ocen.

Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.

 Liczba >= 0,0
Ocena – bieżąca wartość Opcjonalnie

Bieżąca wartość skali ocen.

Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.

 Liczba >= 0,0
Ocena – liczba Opcjonalnie

Liczba ocen wydarzenia.

Uwaga: wypełnij to pole, jeśli aplikacja ma kontrolować sposób wyświetlania tego elementu użytkownikom. Podaj krótki ciąg znaków, który może być wyświetlany użytkownikowi. Jeśli np. liczba wynosi 1 000 000, rozważ użycie skrótu, np. 1 mln, aby nie została obcięta w przypadku mniejszych rozmiarów wyświetlanych elementów.

 Ciąg znaków
Ocena – wartość liczby Opcjonalnie

Liczba ocen wydarzenia.

Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skracania wyświetlanych wartości. Jeśli występują zarówno liczba, jak i wartość liczby, użytkownikom wyświetlimy liczbę.

 Długi
Kategorie treści Opcjonalnie Opisz kategorię treści w obiekcie.

Lista kwalifikujących się typów wyliczeniowych

  • TYPE_MOVIES_AND_TV_SHOWS (przykład: kino)
  • TYPE_DIGITAL_GAMES (przykład: e-sport)
  • TYPE_MUSIC (przykład: koncert)
  • TYPE_TRAVEL_AND_LOCAL (przykład: wycieczka, festiwal)
  • TYPE_HEALTH_AND_FITENESS (przykład: zajęcia z jogi)
  • TYPE_EDUCATION (przykład: Class)
  • TYPE_SPORTS (przykład: mecz piłki nożnej)
  • TYPE_DATING (przykład: spotkanie)

Wskazówki znajdziesz w sekcji Kategoria treści.
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia Opcjonalnie

Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia Opcjonalnie

Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach

LodgingReservationEntity

Atrybut Wymaganie Opis Format
Identyfikator URI działania Wymagany

Precyzyjny link do podmiotu w aplikacji dla usługodawców.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.

Uri
Tytuł Wymagany Nazwa elementu.

Dowolny tekst. Na przykład „Twój pobyt od 12 grudnia”.

Zalecany rozmiar tekstu: maksymalnie 50 znaków
Zlokalizowana godzina zameldowania – sygnatura czasowa Wymagany Sygnatura czasowa epoki reprezentująca czas zameldowania w przypadku rezerwacji. Joda-Time Instant
Zlokalizowana godzina zameldowania – strefa czasowa Wymagany Strefa czasowa, w której obowiązuje godzina zameldowania w przypadku rezerwacji.

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.
Zlokalizowana godzina wymeldowania – sygnatura czasowa Wymagany Sygnatura czasowa epoki, która reprezentuje czas wymeldowania w przypadku rezerwacji. Joda-Time Instant
Zlokalizowana godzina wymeldowania – strefa czasowa Wymagany Strefa czasowa, w której obowiązuje godzina wymeldowania w przypadku rezerwacji.

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.
Lokalizacja – kraj Wymagany Kraj, w którym znajduje się obiekt noclegowy.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – miasto Wymagany Miasto, w którym znajduje się obiekt noclegowy.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlany adres Wymagany Adres, który będzie wyświetlany użytkownikowi. Podaj zwięzły adres, używając w miarę możliwości skrótów (np. „St” zamiast „Street”, „Ave” zamiast „Avenue”). Ten ciąg znaków może zostać skrócony w zależności od urządzenia i ustawień użytkownika. Aby ułatwić identyfikację, podaj nazwę miasta.

Dowolny tekst

Zalecany rozmiar tekstu: maks. ok. 35 znaków
Lokalizacja – adres Opcjonalnie Adres (jeśli dotyczy) obiektu noclegowego.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan Opcjonalnie Stan lub województwo (jeśli ma zastosowanie), w którym znajduje się obiekt.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy Opcjonalnie Kod pocztowy (jeśli występuje) obiektu noclegowego.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – dzielnica Opcjonalnie okolica (w stosownych przypadkach);

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Obrazy plakatu Opcjonalnie

Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.

Uwaga: jeśli podano plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczna przestrzeń o wielkości 24 dps.

Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis Opcjonalnie

Jeden akapit tekstu opisujący encję.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecany rozmiar tekstu: 180 znaków
Lista podtytułów Opcjonalnie

Maksymalnie 3 napisy, każdy w jednym wierszu tekstu.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecana długość każdego podtytułu: maks. 50 znaków
Identyfikator rezerwacji Opcjonalnie Identyfikator rezerwacji obiektu noclegowego. Dowolny tekst
Ocena – wartość maksymalna Opcjonalnie

Maksymalna wartość skali ocen.

Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.

 Liczba >= 0,0
Ocena – bieżąca wartość Opcjonalnie

Bieżąca wartość skali ocen.

Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.

 Liczba >= 0,0
Ocena – liczba Opcjonalnie

Liczba ocen obiektu.

Uwaga: wypełnij to pole, jeśli aplikacja ma kontrolować sposób wyświetlania tego elementu użytkownikom. Podaj krótki ciąg znaków, który może być wyświetlany użytkownikowi. Jeśli np. liczba wynosi 1 000 000, rozważ użycie skrótu, np. 1 mln, aby nie została obcięta w przypadku mniejszych rozmiarów wyświetlanych elementów.

 Ciąg znaków
Ocena – wartość liczby Opcjonalnie

Liczba ocen obiektu.

Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skracania wyświetlanych wartości. Jeśli występują zarówno liczba, jak i wartość liczby, użytkownikom wyświetlimy liczbę.

 Długi
Cena – CurrentPrice Wymagane warunkowo

Obecna cena obiektu.

Musisz podać tę wartość, jeśli podasz cenę przekreśloną.

Dowolny tekst
Cena – StrikethroughPrice Opcjonalnie Pierwotna cena obiektu noclegowego, która będzie przekreślona w interfejsie. Dowolny tekst
Objaśnienie dotyczące ceny Opcjonalnie Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu (jeśli są dostępne).

Dowolny tekst

Zalecana długość tekstu: mniej niż 45 znaków (za długi tekst może być wyświetlany z wielokropkiem)
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia Opcjonalnie

Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia Opcjonalnie

Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach

TransportationReservationEntity

Atrybut Wymaganie Opis Format
Identyfikator URI działania Wymagany

Precyzyjny link do podmiotu w aplikacji dla usługodawców.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.

Uri
Tytuł Wymagany Nazwa elementu.

Dowolny tekst. Na przykład „SFO to SAN”.

Zalecany rozmiar tekstu: maksymalnie 50 znaków
Rodzaj transportu Wymagany Rodzaj/tryb środka transportu w rezerwacji. Enum: FLIGHT, TRAIN, BUS lub FERRY
Zlokalizowana godzina wylotu – sygnatura czasowa Wymagany Sygnatura czasowa epoki reprezentująca godzinę odjazdu. Joda-Time Instant
Zlokalizowana godzina odjazdu – strefa czasowa Wymagany Strefa czasowa godziny odjazdu.

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.
Zlokalizowana godzina przyjazdu – sygnatura czasowa Wymagany Sygnatura czasowa epoki reprezentująca czas przyjazdu. Joda-Time Instant
Zlokalizowana godzina przyjazdu – strefa czasowa Wymagany Strefa czasowa godziny przyjazdu.

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.
Numer transportu Wymagany Numer lotu, autobusu, pociągu lub promu/statku wycieczkowego. Dowolny tekst
Zlokalizowana godzina wejścia na pokład – sygnatura czasowa Wymagany Sygnatura czasowa epoki reprezentująca czas wejścia na pokład w przypadku rezerwacji (jeśli ma to zastosowanie). Joda-Time Instant
Zlokalizowana godzina wejścia na pokład – strefa czasowa Wymagany Strefa czasowa godziny wejścia na pokład w przypadku rezerwacji (jeśli dotyczy).

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.
Miejsce wyjazdu – kraj Opcjonalnie Kraj wyjazdu.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce wylotu – miasto Opcjonalnie Miasto wylotu.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja początkowa – wyświetlany adres Opcjonalnie Miejsce wylotu, które będzie wyświetlane użytkownikowi.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce wylotu – ulica i numer Opcjonalnie Adres (jeśli dotyczy) miejsca wylotu.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja wyjazdu/wylotu – stan Opcjonalnie Województwo (lub jego odpowiednik w innych krajach), w którym znajduje się miejsce wylotu (jeśli ma zastosowanie).

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce wylotu – kod pocztowy Opcjonalnie Kod pocztowy (w odpowiednich przypadkach) miejsca wylotu.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja początkowa – okolica Opcjonalnie dzielnica (w odpowiednich przypadkach), w której znajduje się miejsce wylotu;

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja przyjazdu – kraj Opcjonalnie Kraj przyjazdu.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja przylotu – miasto Opcjonalnie Miasto docelowe.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce docelowe – wyświetlany adres Opcjonalnie Miejsce docelowe, które będzie wyświetlane użytkownikowi.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce docelowe – adres Opcjonalnie Adres (jeśli dotyczy) miejsca docelowego.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja docelowa – stan Opcjonalnie Województwo (lub jego odpowiednik w innym kraju), w którym znajduje się miejsce docelowe (jeśli ma zastosowanie).

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce docelowe – kod pocztowy Opcjonalnie Kod pocztowy (w odpowiednich przypadkach) miejsca docelowego.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja docelowa – dzielnica Opcjonalnie Okolica (w odpowiednich przypadkach) miejsca docelowego.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Dostawca usług – nazwa Opcjonalnie

Nazwa dostawcy usługi.

Uwaga: W przypadku usługodawcy wymagany jest tekst lub obraz.

Dowolny tekst. Na przykład nazwa linii lotniczych
Usługodawca – obraz Opcjonalnie

Logo lub obraz usługodawcy.

Uwaga: W przypadku usługodawcy wymagany jest tekst lub obraz.

Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Obrazy plakatu Opcjonalnie

Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.

Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis Opcjonalnie

Jeden akapit tekstu opisujący encję.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecany rozmiar tekstu: 180 znaków
Lista podtytułów Opcjonalnie

Maksymalnie 3 napisy, każdy w jednym wierszu tekstu.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecana długość każdego podtytułu: maks. 50 znaków
Identyfikator rezerwacji Opcjonalnie Identyfikator rezerwacji środka transportu. Dowolny tekst
Cena – CurrentPrice Wymagane warunkowo

Obecna cena rezerwacji.

Musisz podać tę wartość, jeśli podasz cenę przekreśloną.

Dowolny tekst
Cena – StrikethroughPrice Opcjonalnie Pierwotna cena rezerwacji, która jest przekreślona w interfejsie. Dowolny tekst
Objaśnienie dotyczące ceny Opcjonalnie Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu (jeśli są dostępne).

Dowolny tekst

Zalecana długość tekstu: mniej niż 45 znaków (za długi tekst może być wyświetlany z wielokropkiem)
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia Opcjonalnie

Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia Opcjonalnie

Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach

VehicleRentalReservationEntity

Atrybut Wymaganie Opis Format
Identyfikator URI działania Wymagany

Precyzyjny link do podmiotu w aplikacji dla usługodawców.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.

Uri
Tytuł Wymagany Nazwa elementu.

Dowolny tekst. Na przykład „Avis Union Square SF”

Zalecany rozmiar tekstu: maksymalnie 50 znaków
Zlokalizowany czas odbioru – sygnatura czasowa Wymagany Sygnatura czasowa epoki reprezentująca godzinę odbioru w przypadku rezerwacji. Joda-Time Instant
Zlokalizowany czas odbioru – strefa czasowa Wymagany Strefa czasowa godziny odbioru w przypadku rezerwacji.

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.
Zlokalizowany czas zwrotu – sygnatura czasowa Opcjonalnie Sygnatura czasowa epoki reprezentująca czas wymeldowania w przypadku rezerwacji. Joda-Time Instant
Zlokalizowany czas zwrotu – strefa czasowa Opcjonalnie Strefa czasowa godziny wymeldowania w przypadku rezerwacji.

Joda-Time DateTimeZone

Wskazówki znajdziesz w specyfikacjach stref czasowych.
Adres odbioru – kraj Opcjonalnie Kraj miejsca odbioru.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – miasto Opcjonalnie Miasto, w którym znajduje się miejsce odbioru.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – wyświetlany adres Opcjonalnie Miejsce odbioru, które będzie wyświetlane użytkownikowi.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – ulica Opcjonalnie Adres (jeśli dotyczy) miejsca odbioru.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – stan Opcjonalnie Województwo (lub jego odpowiednik w innych krajach), w którym znajduje się miejsce odbioru (jeśli ono występuje).

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – kod pocztowy Opcjonalnie Kod pocztowy (jeśli występuje) miejsca odbioru.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – dzielnica Opcjonalnie Okolica (jeśli występuje), w której znajduje się miejsce odbioru.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – kraj Opcjonalnie Kraj lokalizacji zwrotu.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – miasto Opcjonalnie Miasto lokalizacji zwrotu.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – wyświetlany adres Opcjonalnie Lokalizacja zwrotu, która będzie wyświetlana użytkownikowi.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – adres Opcjonalnie Adres (jeśli dotyczy) lokalizacji zwrotu.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – stan Opcjonalnie Stan lub prowincja (jeśli ma zastosowanie) lokalizacji zwrotu.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – kod pocztowy Opcjonalnie Kod pocztowy (w odpowiednich przypadkach) lokalizacji zwrotu.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – dzielnica Opcjonalnie Okolica (w stosownych przypadkach) lokalizacji zwrotu.

Dowolny tekst

Zalecana długość tekstu: maks. ok. 20 znaków
Dostawca usług – nazwa Opcjonalnie

Nazwa dostawcy usługi.

Uwaga: W przypadku usługodawcy wymagany jest tekst lub obraz.

Dowolny tekst. Na przykład „Wypożyczalnia samochodów Avis”.
Usługodawca – obraz Opcjonalnie

Logo lub obraz usługodawcy.

Uwaga: W przypadku usługodawcy wymagany jest tekst lub obraz.

Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Obrazy plakatu Opcjonalnie

Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.

Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis Opcjonalnie

Jeden akapit tekstu opisujący encję.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecany rozmiar tekstu: 180 znaków
Lista podtytułów Opcjonalnie

Maksymalnie 3 napisy, każdy w jednym wierszu tekstu.

Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.

Dowolny tekst

Zalecana długość każdego podtytułu: maks. 50 znaków
Identyfikator potwierdzenia Opcjonalnie Identyfikator potwierdzenia rezerwacji wypożyczenia pojazdu. Dowolny tekst
Cena – CurrentPrice Wymagane warunkowo

Obecna cena rezerwacji.

Musisz podać tę wartość, jeśli podasz cenę przekreśloną.

Dowolny tekst
Cena – StrikethroughPrice Opcjonalnie Pierwotna cena rezerwacji, która jest przekreślona w interfejsie. Dowolny tekst
Objaśnienie dotyczące ceny Opcjonalnie Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu (jeśli są dostępne).

Dowolny tekst

Zalecana długość tekstu: mniej niż 45 znaków (za długi tekst może być wyświetlany z wielokropkiem)
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia Opcjonalnie

Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia Opcjonalnie

Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie.

Jeśli nie skonfigurujesz tej zasady, treści będą mogły być wyświetlane na danej platformie.

 Sygnatura czasowa epoki w milisekundach

Specyfikacja obrazu

Wymagane specyfikacje komponentów z obrazem znajdziesz w tej tabeli:

Format obrazu Minimalny rozmiar w pikselach Zalecany rozmiar w pikselach

Kwadrat (1:1)

Preferowane

 300 x 300 1200 x 1200
Poziomy (1,91 x 1) 600 x 314 1200 x 628
Orientacja pionowa (4x5) 480 x 600 960 x 1200

Obrazy muszą być hostowane w publicznych sieciach CDN, aby Google mógł do nich uzyskać dostęp.

Formaty plików

PNG, JPG, statyczny GIF, WebP

Maksymalny rozmiar pliku

5120 KB

Dodatkowe rekomendacje

  • Bezpieczny obszar obrazu: ważne treści umieść w środkowych 80% obrazu.
  • Użyj przezroczystego tła, aby obraz mógł być prawidłowo wyświetlany w ustawieniach motywu ciemnego i jasnego.

Specyfikacje strefy czasowej

Preferuj identyfikator (np. „America/Los_Angeles”) zamiast przesunięcia (np. „-07:00”).

Przykładowe użycie: DateTimeZone.forID("America/Los_Angeles")

Kategoria treści

Kategoria treści umożliwia aplikacjom publikowanie treści należących do wielu kategorii. Dzięki temu treści są mapowane na niektóre wstępnie zdefiniowane kategorie, takie jak:

  • TYPE_EDUCATION
  • TYPE_SPORTS
  • TYPE_MOVIES_AND_TV_SHOWS
  • TYPE_BOOKS
  • TYPE_AUDIOBOOKS
  • TYPE_MUSIC
  • TYPE_DIGITAL_GAMES
  • TYPE_TRAVEL_AND_LOCAL
  • TYPE_HOME_AND_AUTO
  • TYPE_BUSINESS
  • TYPE_NEWS
  • TYPE_FOOD_AND_DRINK
  • TYPE_SHOPPING
  • TYPE_HEALTH_AND_FITENESS
  • TYPE_MEDICAL
  • TYPE_PARENTING
  • TYPE_DATING

Obrazy muszą być hostowane w publicznych sieciach CDN, aby Google mógł do nich uzyskać dostęp.

Wskazówki dotyczące korzystania z kategorii treści

  1. Niektóre typy danych, takie jak ArticleEntity i GenericFeaturedEntity, mogą używać dowolnej kategorii treści. W przypadku innych typów elementów, takich jak EventEntity, EventReservationEntity i PointOfInterestEntity, kwalifikuje się tylko podzbiór tych kategorii. Przed wypełnieniem listy sprawdź listę kategorii kwalifikujących się do danego typu elementu.

  2. W przypadku niektórych kategorii treści używaj konkretnego typu elementu zamiast kombinacji elementów ogólnych i kategorii treści:

  3. Pole ContentCategory jest opcjonalne i należy je pozostawić puste, jeśli treść nie należy do żadnej z wcześniej wymienionych kategorii.

  4. Jeśli podasz kilka kategorii treści, podaj je w kolejności ich trafności w stosunku do treści. Najtrafniejsza kategoria treści powinna być pierwsza na liście.

Krok 2. Podaj dane klastra

Zalecamy wykonywanie zadania publikowania treści w tle (np. za pomocą WorkManager) i planowanie go regularnie lub na podstawie zdarzeń (np. za każdym razem, gdy użytkownik otwiera aplikację lub gdy właśnie dodał coś do koszyka).

AppEngageTravelClient odpowiada za publikowanie klastrów.

Aby opublikować klastry w kliencie, użyj tych interfejsów API:

  • isServiceAvailable
  • publishRecommendationClusters
  • publishFeaturedCluster
  • publishReservationCluster
  • publishContinueSearchCluster
  • publishUserAccountManagementRequest
  • updatePublishStatus
  • deleteRecommendationsClusters
  • deleteFeaturedCluster
  • deleteReservationCluster
  • deleteContinueSearchCluster
  • deleteUserManagementCluster
  • deleteClusters

isServiceAvailable

Ten interfejs API służy do sprawdzania, czy usługa jest dostępna do integracji i czy treści można wyświetlać na urządzeniu.

Kotlin

client.isServiceAvailable.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // Handle IPC call success
        if(task.result) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
}

Java

client.isServiceAvailable().addOnCompleteListener(task - > {
    if (task.isSuccessful()) {
        // Handle success
        if(task.getResult()) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
});

publishRecommendationClusters

Ten interfejs API służy do publikowania listy obiektów RecommendationCluster.

Kotlin

client.publishRecommendationClusters(
      PublishRecommendationClustersRequest.Builder()
        .addRecommendationCluster(
          RecommendationCluster.Builder()
            .addEntity(entity1)
            .addEntity(entity2)
            .setTitle("Top Picks For You")
            .build()
        )
        .build()
    )

Java

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Top Picks For You")
                        .build())
                .build());

Gdy usługa otrzyma żądanie, w ramach jednej transakcji zostaną wykonane te działania:

  • Istniejące dane RecommendationCluster od dewelopera zostaną usunięte.
  • Dane z żądania są analizowane i przechowywane w zaktualizowanym klastrze rekomendacji.

W przypadku błędu cała prośba jest odrzucana, a dotychczasowy stan pozostaje bez zmian.

publishFeaturedCluster

Ten interfejs API służy do publikowania listy obiektów FeaturedCluster.

Kotlin

client.publishFeaturedCluster(
    PublishFeaturedClusterRequest.Builder()
      .setFeaturedCluster(
        FeaturedCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

Java

client.publishFeaturedCluster(
            new PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

Gdy usługa otrzyma żądanie, w ramach jednej transakcji zostaną wykonane te działania:

  • Istniejące dane FeaturedCluster od dewelopera zostaną usunięte.
  • Dane z żądania są analizowane i przechowywane w zaktualizowanym klastrze polecanych.

W przypadku błędu cała prośba jest odrzucana, a dotychczasowy stan pozostaje bez zmian.

publishReservationCluster

Ten interfejs API służy do publikowania obiektu ReservationCluster.

Kotlin

client.publishReservationCluster(
    PublishReservationClusterRequest.Builder()
      .setReservationCluster(
        ReservationCluster.Builder()
          .addLodgingReservationEntity(lodgingReservationEntity)
          .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
          .addTransportationReservationEntity(transportationReservationEntity)
          .addEventReservationEntity(eventReservationEntity)
          .addRestaurantReservationEntity(restaurantReservationEntity)
          .build())
      .build())

Java

client.publishReservationCluster(
            new PublishReservationClusterRequest.Builder()
                .setReservationCluster(
                    new ReservationCluster.Builder()
                        .addLodgingReservationEntity(lodgingReservationEntity)
                        .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
                        .addTransportationReservationEntity(transportationReservationEntity)
                        .addEventReservationEntity(eventReservationEntity)
                        .addRestaurantReservationEntity(restaurantReservationEntity)
                        .build())
                .build());

Gdy usługa otrzyma żądanie, w ramach jednej transakcji zostaną wykonane te działania:

  • Istniejące dane ReservationCluster od dewelopera zostaną usunięte.
  • Dane z żądania są analizowane i przechowywane w zaktualizowanym klastrze rezerwacji.

W przypadku błędu cała prośba jest odrzucana, a dotychczasowy stan pozostaje bez zmian.

publishContinueSearchCluster

Ten interfejs API służy do publikowania listy obiektów ContinueSearchCluster.

interfejsy API publikowania robią to z natury.

Kotlin

client.publishContinueSearchCluster(
    PublishContinueSearchClusterRequest.Builder()
      .setContinueSearchCluster(
        ContinueSearchCluster.Builder()
          .addPointOfInterestEntity(entity1)
          .addPointOfInterestEntity(entity2)
          .build())
      .build())

Java

client.publishContinueSearchCluster(
            new PublishContinueSearchClusterRequest.Builder()
                .setContinueSearchCluster(
                    new ContinueSearchCluster.Builder()
                        .addPointOfInterestEntity(entity1)
                        .addPointOfInterestEntity(entity2)
                        .build())
                .build());

Gdy usługa otrzyma żądanie, w ramach jednej transakcji zostaną wykonane te działania:

  • Istniejące dane ContinueSearchCluster od dewelopera zostaną usunięte.
  • Dane z żądania są analizowane i przechowywane w zaktualizowanym klastrze Kontynuuj wyszukiwanie.

W przypadku błędu cała prośba jest odrzucana, a dotychczasowy stan pozostaje bez zmian.

publishUserAccountManagementRequest

Ten interfejs API służy do publikowania karty logowania . Działanie logowania przekierowuje użytkowników na stronę logowania aplikacji, aby mogła ona publikować treści (lub udostępniać bardziej spersonalizowane treści).

Karta logowania zawiera te metadane:

Atrybut Wymaganie Opis
Identyfikator URI działania Wymagane Precyzyjny link do działania (np. przejście do strony logowania w aplikacji)
Obraz Opcjonalny – jeśli nie zostanie podany, należy podać tytuł

Obraz wyświetlany na karcie

Obrazy o formacie 16:9 i rozdzielczości 1264 x 712
Tytuł Opcjonalny – jeśli nie zostanie podany, należy podać obraz Tytuł na karcie
Tekst działania Opcjonalnie Tekst wyświetlany w wezwaniu do działania (np. Zaloguj się)
Podtytuł Opcjonalnie Opcjonalny podtytuł na karcie

Kotlin

var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Java

SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Gdy usługa otrzyma żądanie, w ramach jednej transakcji zostaną wykonane te działania:

  • Dotychczasowe dane UserAccountManagementCluster od partnera dewelopera zostaną usunięte.
  • Dane z żądania są analizowane i przechowywane w zaktualizowanym klastrze UserAccountManagementCluster.

W przypadku błędu cała prośba jest odrzucana, a dotychczasowy stan pozostaje bez zmian.

updatePublishStatus

Jeśli z jakiegokolwiek powodu wewnętrznego żadna z grup nie jest opublikowana, zdecydowanie zalecamy zaktualizowanie stanu publikacji za pomocą interfejsu updatePublishStatus API. Jest to ważne, ponieważ :

  • Podawanie stanu we wszystkich scenariuszach, nawet gdy treść jest opublikowana (STATUS == PUBLISHED), jest kluczowe do wypełniania paneli, które używają tego stanu do przekazywania informacji o kondycji i innych danych integracji.
  • Jeśli żadne treści nie są publikowane, ale stan integracji nie jest przerwany (STATUS == NOT_PUBLISHED), Google może uniknąć wywoływania alertów na panelach stanu aplikacji. Potwierdza, że treści nie są publikowane z powodu przewidywanej sytuacji z punktu widzenia dostawcy.
  • Pomaga deweloperom określać, kiedy dane są publikowane, a kiedy nie.
  • Google może używać kodów stanu, aby zachęcać użytkownika do podejmowania określonych działań w aplikacji, dzięki którym będzie mógł wyświetlać jej zawartość lub rozwiązywać problemy.

Lista kwalifikujących się kodów stanu publikacji :

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

Jeśli treści nie są publikowane, ponieważ użytkownik nie jest zalogowany, Google zaleca opublikowanie karty logowania. Jeśli z jakiegoś powodu dostawcy nie mogą opublikować karty logowania, zalecamy wywołanie interfejsu API updatePublishStatus z kodem stanu NOT_PUBLISHED_REQUIRES_SIGN_IN.

Kotlin

client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())

Java

client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

deleteRecommendationClusters

Ten interfejs API służy do usuwania treści z grup rekomendacji.

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

Gdy usługa otrzyma prośbę, usunie dotychczasowe dane z klastrów rekomendacji. W przypadku błędu całe żądanie zostanie odrzucone, a dotychczasowy stan zostanie zachowany.

deleteFeaturedCluster

Ten interfejs API służy do usuwania treści z wyróżnionego klastra.

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

Gdy usługa otrzyma żądanie, usunie dotychczasowe dane z wyróżnionego klastra. W przypadku błędu całe żądanie jest odrzucane, a dotychczasowy stan pozostaje bez zmian.

deleteReservationCluster

Ten interfejs API służy do usuwania zawartości klastra rezerwacji.

Kotlin

client.deleteReservationCluster()

Java

client.deleteReservationCluster();

Gdy usługa otrzyma żądanie, usunie istniejące dane z klastra rezerwacji. W przypadku błędu całe żądanie zostanie odrzucone, a dotychczasowy stan zostanie zachowany.

deleteUserManagementCluster

Ten interfejs API służy do usuwania treści z klastra UserAccountManagement.

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

Gdy usługa otrzyma żądanie, usunie istniejące dane z klastra UserAccountManagement. W przypadku błędu całe żądanie jest odrzucane, a dotychczasowy stan zostaje zachowany.

deleteContinueSearchCluster

Ten interfejs API służy do usuwania zawartości klastra wyszukiwania kontynuowanego.

Kotlin

client.deleteContinueSearchCluster()

Java

client.deleteContinueSearchCluster();

Gdy usługa otrzyma żądanie, usunie istniejące dane z klastra wyszukiwania kontynuowanego. W przypadku błędu cała prośba jest odrzucana, a dotychczasowy stan zostaje zachowany.

deleteClusters

Ten interfejs API służy do usuwania treści danego typu klastra.

Kotlin

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_RESERVATION)
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      .addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
      .build())

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_RESERVATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
                .build());

Gdy usługa otrzyma żądanie, usunie istniejące dane ze wszystkich klastrów pasujących do określonych typów klastrów. Klienci mogą przekazywać jeden lub wiele typów klastrów. W przypadku błędu całe żądanie jest odrzucane, a dotychczasowy stan pozostaje bez zmian.

Obsługa błędów

Zdecydowanie zalecamy nasłuchiwanie wyniku zadania z interfejsów API publikowania, aby można było podjąć działania następcze w celu odzyskania i ponownego przesłania zadania, które zakończyło się niepowodzeniem.

Kotlin

client.publishRecommendationClusters(
        PublishRecommendationClustersRequest.Builder()
          .addRecommendationCluster(..)
          .build())
      .addOnCompleteListener { task ->
        if (task.isSuccessful) {
          // do something
        } else {
          val exception = task.exception
          if (exception is AppEngageException) {
            @AppEngageErrorCode val errorCode = exception.errorCode
            if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
              // do something
            }
          }
        }
      }

Java

client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

Błąd jest zwracany jako obiekt AppEngageException, a jego przyczyna jest podana jako kod błędu.

Kod błędu Nazwa błędu Uwaga
1 SERVICE_NOT_FOUND Usługa jest niedostępna na danym urządzeniu.
2 SERVICE_NOT_AVAILABLE Usługa jest dostępna na danym urządzeniu, ale nie jest dostępna w momencie połączenia (np. jest wyraźnie wyłączona).
3 SERVICE_CALL_EXECUTION_FAILURE Nie udało się wykonać zadania z powodu problemów z wątkami. W takim przypadku można ponowić próbę.
4 SERVICE_CALL_PERMISSION_DENIED Wywołujący nie ma uprawnień do wykonania wywołania usługi.
5 SERVICE_CALL_INVALID_ARGUMENT Żądanie zawiera nieprawidłowe dane (np. więcej klastrów niż dozwolona liczba).
6 SERVICE_CALL_INTERNAL Po stronie usługi wystąpił błąd.
7 SERVICE_CALL_RESOURCE_EXHAUSTED Wywołanie usługi jest wykonywane zbyt często.

Krok 3. Obsługa intencji transmisji

Oprócz wywoływania interfejsu API publikowania treści za pomocą zadania musisz też skonfigurować BroadcastReceiver, aby otrzymywać prośby o publikowanie treści.

Celem intencji rozgłaszania jest głównie ponowna aktywacja aplikacji i wymuszenie synchronizacji danych. Intencje transmisji nie są przeznaczone do wysyłania zbyt często. Jest ona wywoływana tylko wtedy, gdy usługa Engage uzna, że treść może być nieaktualna (np. ma tydzień). Dzięki temu użytkownik może mieć pewność, że będzie korzystać z najnowszych treści, nawet jeśli aplikacja nie była uruchamiana przez dłuższy czas.

BroadcastReceiver musi być skonfigurowany na 2 sposoby:

  • Dynamiczne rejestrowanie instancji klasy BroadcastReceiver za pomocą Context.registerReceiver(). Umożliwia to komunikację z aplikacjami, które są nadal aktywne w pamięci.

Kotlin

class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
  // is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
  // Trigger continue search cluster publish when PUBLISH_CONTINUE_SEARCH
  // broadcast is received
  // Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
  // received
}

fun registerBroadcastReceivers(context: Context){
  var  context = context
  context = context.applicationContext

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Continue Search Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Reservation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)
}

Java

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger continue search cluster publish when PUBLISH_CONTINUE_SEARCH
// broadcast is received

// Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
// received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Continue Search Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Reservation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

}

  • Statycznie zadeklaruj implementację za pomocą tagu <receiver> w pliku AndroidManifest.xml. Dzięki temu aplikacja może odbierać intencje transmisji, gdy nie jest uruchomiona, a także publikować treści.

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:permission="com.google.android.engage.REQUEST_ENGAGE_DATA"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCH" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.travel.PUBLISH_RESERVATION" />
      </intent-filter>
   </receiver>
</application>

Usługa wysyła te intencje:

  • com.google.android.engage.action.PUBLISH_RECOMMENDATION Zalecamy rozpoczęcie publishRecommendationClusters połączenia po otrzymaniu tego zamiaru.
  • com.google.android.engage.action.PUBLISH_FEATURED Zalecamy rozpoczęcie połączenia publishFeaturedCluster po otrzymaniu tego zamiaru.
  • com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCH Zalecamy rozpoczęcie publishContinueSearchCluster połączenia po otrzymaniu tego zamiaru.
  • com.google.android.engage.action.travel.PUBLISH_RESERVATION Zalecamy rozpoczęcie publishReservationCluster połączenia po otrzymaniu tego zamiaru.

Przepływ pracy integracji

Szczegółowe instrukcje weryfikacji integracji po jej zakończeniu znajdziesz w artykule Przepływ pracy integracji z platformą Engage dla programistów.

Najczęstsze pytania

Odpowiedzi na najczęstsze pytania znajdziesz w sekcji Najczęstsze pytania dotyczące pakietu Engage SDK.

Kontakt

Jeśli podczas procesu integracji pojawią się pytania, skontaktuj się z nami engage-developers@google.com.

Dalsze kroki

Po zakończeniu integracji wykonaj te czynności:

  • Wyślij e-maila na adres engage-developers@google.com i dołącz zintegrowany pakiet APK gotowy do testowania przez Google.
  • Google przeprowadza weryfikację i sprawdza wewnętrznie, czy integracja działa zgodnie z oczekiwaniami. Jeśli zajdzie taka potrzeba, skontaktujemy się z Tobą, aby przekazać niezbędne informacje.
  • Gdy testy zostaną zakończone i nie będą potrzebne żadne zmiany, skontaktujemy się z Tobą, aby poinformować Cię, że możesz rozpocząć publikowanie zaktualizowanego i zintegrowanego pliku APK w Sklepie Play.
  • Gdy potwierdzimy, że zaktualizowany plik APK został opublikowany w Sklepie Play, klastry Rekomendacja, Wyróżnione, Rezerwacja i Kontynuuj wyszukiwanie mogą zostać opublikowane i będą widoczne dla użytkowników.