Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

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 dostarczania treści związanych z podróżami i wydarzeniami na platformy treści Engage.

Obsługa kategorii i platform

Dostępność platformy Engage SDK zależy od kategorii treści aplikacji. W tabeli poniżej możesz sprawdzić, czy kwalifikujesz się do korzystania z określonych platform:

Stan	Kategoria treści lub przypadek użycia	Obsługiwane platformy
Obsługiwane (Kwalifikuje się do wyświetlania na wszystkich platformach)	Wszystkie kategorie Podróże i informacje lokalne (z wyjątkiem nieobsługiwanych podkategorii wymienionych w tej tabeli) Wydarzenia (wszystkie podkategorie) Aktywność zwierząt domowych, monitorowanie, opieka, wyprowadzanie na spacer	Kolekcje Karta Aplikacje ze Sklepu Play Karta Ty w Sklepie Play Strona z informacjami o aplikacji w Sklepie Play
Nieobsługiwane	Śledzenie lotów

Umiejętności związane z Androidem

Wyświetl w GitHubie

Integracja pakietu Engage SDK

Aby zintegrować pakiet Engage SDK, debugować go i rozwiązywać problemy z wdrożeniem, użyj umiejętności na Androida.

Aby zainstalować umiejętność z interfejsu wiersza poleceń Androida, uruchom to polecenie:

android skills add engage-sdk-integration

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 interesujących miejsc.
- Klaster rekomendacji może składać się z ArticleEntity, EventEntity, LodgingEntity, PointOfInterestEntity lub StoreEntity wizytówek, ale nie z 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.
- Element: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ć do tworzenia 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. Godzina rozpoczęcia wydarzenia to kluczowa informacja, którą należy przekazać użytkownikom.
    
    Ilustracja 2. Interfejs pokazujący pojedynczy element EventEntity w klastrze Rekomendacje.
  - LodgingEntity: LodgingEntity reprezentuje miejsce zakwaterowania, takie jak hotel, apartament lub dom wakacyjny na wynajem krótko- i długoterminowy.
    
    Ilustracja 3. Interfejs pokazujący pojedynczy element LodgingEntity w klastrze Rekomendacje.
  - 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. Wyróżnia 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.
    
    Ilustracja 5. Interfejs przedstawiają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 rezerwacji mogą mieć taką strukturę:
- RestaurantReservationEntity: RestaurantReservationEntity reprezentuje rezerwację w restauracji lub kawiarni i pomaga użytkownikom śledzić nadchodzące lub trwające rezerwacje.
  
  Rysunek 6. Interfejs użytkownika 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 meczu piłki nożnej;
  - wydarzenia związane z grami, np. rezerwacje miejsc na turnieje e-sportowe;
  - wydarzeń rozrywkowych, takich jak rezerwacja biletów do kina, na koncert, do teatru czy na spotkanie autorskie;
  - rezerwacje podróży lub miejsc, np. wycieczek z przewodnikiem czy biletów do muzeów;
  - Rezerwacje miejsc na spotkania towarzyskie, seminaria i konferencje
  - Rezerwacje sesji edukacyjnych i 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 transportu i pomaga użytkownikom śledzić rezerwacje zbliżających się lub trwających lotów, promów, pociągów, autobusów, przejazdów taksówką lub statków wycieczkowych.
  
  Rysunek 9. Interfejs użytkownika pokazujący pojedynczy element TransportationReservationEntity w grupie Reservation.
- VehicleRentalReservationEntity: VehicleRentalReservationEntity reprezentuje rezerwację wypożyczenia pojazdu i pomaga użytkownikom śledzić nadchodzące lub trwające rezerwacje wypożyczenia pojazdu.
  
  Rysunek 10. Interfejs pokazujący pojedynczy element VehicleRentalReservationEntity w klastrze 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 deweloperów i reprezentować najważniejsze treści, które będą interesujące i odpowiednie dla użytkowników.
  
  Ilustracja 11: interfejs z wyróżnionym klastrem zawierającym listę elementów GenericFeaturedEntity
Grupa 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 polecanymi i rekomendowanymi treściami. 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.6.0'
}

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 obiektó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 znaków (`RestaurantReservationEntity`,`EventReservationEntity`,`LodgingReservationEntity`,`TransportationReservationEntity` lub`VehicleRentalReservationEntity`)
Polecany klaster	Maksymalnie 1	Co najmniej 1	Maksymalnie 20 znaków (`GenericFeaturedEntity`)
Klaster wyszukiwania	Maksymalnie 1	Co najmniej 1	Maksymalnie 3 (`PointOfInterestEntity`)

Krok 1. Podaj dane podmiotu

Pakiet SDK ma zdefiniowane różne elementy reprezentujące poszczególne typy produktów. W przypadku kategorii Podróże i wydarzenia obsługujemy te rodzaje obiektów:

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity

Wykresy poniżej przedstawiają dostępne atrybuty i wymagania dotyczące 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ł	Opcjonalny	Tytuł elementu.	Dowolny tekst Zalecana długość tekstu: 50 znaków
Opis	Opcjonalny	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 Zalecana długość tekstu: 180 znaków
Lista podtytułów	Opcjonalny	Maksymalnie 3 napisy, każdy w postaci jednego wiersza 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ść tekstu każdego podtytułu: maks. 50 znaków
Plakietki	Opcjonalny	Każda plakietka to tekst (maks. 15 znaków) lub mały obraz. Specjalne elementy interfejsu użytkownika na obrazie lub filmie, np. nakładka w postaci plakietki na obrazie „Aktualizacja na żywo” Czas czytania artykułu
Plakietka – tekst	Opcjonalny	Tytuł odznaki Uwaga: plakietka musi zawierać tekst lub obraz.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Odznaka – obraz	Opcjonalny	Mały obraz Specjalne traktowanie UX, np. jako nakładka z plakietką na miniaturę obrazu lub filmu. Uwaga: plakietka musi zawierać tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Kategorie treści	Opcjonalny	Opisz kategorię treści w encji.	Lista wartości w polu enum Wskazówki znajdziesz w sekcji dotyczącej kategorii treści.
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia	Opcjonalny	Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą być wyświetlane na danej platformie.	Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia	Opcjonalny	Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą 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	Tytuł elementu.	Dowolny tekst Zalecana długość tekstu: maksymalnie 50 znaków
Obrazy plakatu	Opcjonalny	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ł	Opcjonalny	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	Opcjonalny	Obraz źródła, np. autora, organizacji lub reportera	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalny	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 Zalecana długość tekstu: 180 znaków
Lista podtytułów	Opcjonalny	Maksymalnie 3 napisy, każdy w postaci jednego wiersza 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ść tekstu każdego podtytułu: maks. 50 znaków
Plakietki	Opcjonalny	Każda plakietka to tekst (maks. 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	Opcjonalny	Tytuł odznaki Uwaga: plakietka musi zawierać tekst lub obraz.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Odznaka – obraz	Opcjonalny	Mały obraz Specjalne traktowanie UX, np. jako nakładka z plakietką na miniaturę obrazu lub filmu. Uwaga: plakietka musi zawierać tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Czas publikacji treści	Opcjonalny	Jest to sygnatura czasowa epoki w milisekundach, która określa, kiedy treść została opublikowana lub zaktualizowana w aplikacji.	Sygnatura czasowa epoki w milisekundach
Czas ostatniego zaangażowania	Opcjonalny	Sygnatura czasowa epoki w milisekundach, kiedy użytkownik ostatnio wchodził w interakcję z tym elementem.	Sygnatura czasowa epoki w milisekundach
Procent postępu	Opcjonalny	Odsetek pełnej treści, z którą użytkownik zapoznał się do tej pory.	Liczba całkowita z zakresu od 0 do 100 (włącznie).
Kategorie treści	Opcjonalny	Opisz kategorię treści w encji.	Lista wartości w polu enum Wskazówki znajdziesz w sekcji dotyczącej kategorii treści.
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia	Opcjonalny	Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą być wyświetlane na danej platformie.	Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia	Opcjonalny	Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą 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	Tytuł elementu.	Ciąg znaków Zalecana długość tekstu: maksymalnie 50 znaków
Zlokalizowany czas rozpoczęcia – sygnatura czasowa	Wymagany	Sygnatura czasowa w formacie epoki, kiedy wydarzenie ma się rozpocząć.	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 sekcji Specyfikacje stref czasowych.
Tryb zdarzenia	Wymagany	Pole wskazujące, czy wydarzenie będzie wirtualne, stacjonarne czy hybrydowe.	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świetl 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	Opcjonalny	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	Opcjonalny	Stan lub prowincja (w stosownych przypadkach), w której odbywa się wydarzenie.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalny	Kod pocztowy (w odpowiednich przypadkach) miejsca, w którym odbywa się wydarzenie.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – okolica	Opcjonalny	Dzielnica (w odpowiednich przypadkach), w której odbywa się wydarzenie.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Czas zakończenia	Opcjonalny	Sygnatura czasowa w formacie epoki, kiedy wydarzenie ma się zakończyć. Uwaga: wartość będzie podana w milisekundach.	Sygnatura czasowa epoki w milisekundach
Opis	Opcjonalny	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 Zalecana długość tekstu: 180 znaków
Lista podtytułów	Opcjonalny	Maksymalnie 3 napisy, każdy w postaci jednego wiersza 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ść tekstu każdego podtytułu: maks. 50 znaków
Plakietki	Opcjonalny	Każda plakietka to tekst (maks. 15 znaków) lub mały obraz.
Plakietka – tekst	Opcjonalny	Tytuł odznaki Uwaga: plakietka musi zawierać tekst lub obraz.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Odznaka – obraz	Opcjonalny	Mały obraz Specjalne traktowanie UX, np. jako nakładka z plakietką na miniaturę obrazu lub filmu. Uwaga: plakietka musi zawierać tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Cena - CurrentPrice	Wymagane warunkowo	Aktualna cena biletu lub karnetu na wydarzenie. Musisz podać cenę promocyjną, jeśli podajesz przekreśloną cenę.	Dowolny tekst
Cena – StrikethroughPrice	Opcjonalny	Pierwotna cena biletu na wydarzenie.	Dowolny tekst
Objaśnienie ceny	Opcjonalny	Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu, jeśli są dostępne.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
Kategorie treści	Opcjonalny	Opisz kategorię treści w encji.	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 (np. wycieczka, festiwal) TYPE_HEALTH_AND_FITENESS (np. 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 dotyczącej kategorii treści.
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia	Opcjonalny	Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą być wyświetlane na danej platformie.	Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia	Opcjonalny	Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą 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	Tytuł elementu.	Ciąg znaków Zalecana długość 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.	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świetl 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 ulicy lub nazwę dzielnicy, jeśli użytkownik znajduje się w pobliżu danego miejsca, zna je lub jeśli miasto jest uwzględnione w tytule klastra. Jeśli podajesz adres, używaj skrótów, gdzie to możliwe (np. „ul.” zamiast „ulica”, „al.” zamiast „aleja”).	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalny	Adres (w odpowiednich przypadkach) obiektu noclegowego.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalny	Stan lub prowincja (w stosownych przypadkach), w której znajduje się obiekt noclegowy.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalny	Kod pocztowy obiektu noclegowego (w odpowiednich przypadkach).	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – okolica	Opcjonalny	dzielnica (w odpowiednich przypadkach),	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Plakietki	Opcjonalny	Każda plakietka to tekst (maks. 15 znaków) lub mały obraz.
Plakietka – tekst	Opcjonalny	Tytuł odznaki Uwaga: plakietka musi zawierać tekst lub obraz.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Odznaka – obraz	Opcjonalny	Mały obraz Specjalne traktowanie UX, np. jako nakładka z plakietką na miniaturę obrazu lub filmu. Uwaga: plakietka musi zawierać tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalny	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 Zalecana długość tekstu: 180 znaków
Lista podtytułów	Opcjonalny	Maksymalnie 3 napisy, każdy w postaci jednego wiersza 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ść tekstu każdego podtytułu: maks. 50 znaków
AvailabilityTimeWindow - Localized Start Time - Timestamp	Opcjonalny	Sygnatura czasowa epoki, kiedy obiekt noclegowy ma być otwarty lub dostępny.	Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone	Opcjonalny	Strefa czasowa, w której obiekt noclegowy ma być otwarty lub dostępny.	Joda-Time DateTimeZone Wskazówki znajdziesz w sekcji Specyfikacje stref czasowych.
AvailabilityTimeWindow - Localized End Time - Timestamp	Opcjonalny	Sygnatura czasowa epoki, do której obiekt noclegowy ma być otwarty lub dostępny.	Joda-Time Instant
AvailabilityTimeWindow - Localized End Time - Timezone	Opcjonalny	Strefa czasowa, w której obiekt noclegowy ma być otwarty lub dostępny.	Joda-Time DateTimeZone Wskazówki znajdziesz w sekcji Specyfikacje stref czasowych.
Ocena – wartość maksymalna	Opcjonalny	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalny	Bieżąca wartość skali ocen. Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalny	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	Opcjonalny	Liczba ocen obiektu. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skracania wyświetlanej nazwy. 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 przekreśloną cenę.	Dowolny tekst
Cena – StrikethroughPrice	Opcjonalny	Pierwotna cena obiektu noclegowego, która będzie przekreślona w interfejsie.	Dowolny tekst
Objaśnienie ceny	Opcjonalny	Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu, jeśli są dostępne.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia	Opcjonalny	Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą być wyświetlane na danej platformie.	Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia	Opcjonalny	Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą 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 lub restaurację, które są 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ł	Opcjonalny	Nazwa sklepu.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek).
Lokalizacja	Opcjonalny	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	Opcjonalny	Wywołanie, aby wyróżnić promocję, wydarzenie lub aktualizację dotyczącą sklepu, jeśli jest dostępna.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
Dodatkowe informacje o objaśnieniu	Opcjonalny	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	Opcjonalny	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	Opcjonalny	Kategoria sklepu. W przypadku lokali gastronomicznych może to być rodzaj kuchni, np. „francuska”, „nowa amerykańska”, „ramen”, „elegancka”.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
Ocena – wartość maksymalna	Opcjonalny	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalny	Bieżąca wartość skali ocen. Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalny	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	Opcjonalny	Liczba ocen obiektu. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skracania wyświetlanej nazwy. 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	Opcjonalny	Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą być wyświetlane na danej platformie.	Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia	Opcjonalny	Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą 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	Tytuł elementu.	Ciąg znaków Zalecana długość 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: obraz jest wymagany, 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ę bezpieczna przestrzeń o wielkości 24 dp.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Czas ostatniego zaangażowania	Wymagane warunkowo	Sygnatura czasowa w formacie epoki, kiedy użytkownik ostatnio wchodził w interakcję z tym elementem. Uwaga: to pole jest wymagane, jeśli podmiot należy do klastra kontynuowania wyszukiwania.	Joda-Time Instant
Lokalizacja – kraj	Wymagane warunkowo	Kraj, w którym znajduje się interesujące 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 podmiot należy do klastra rekomendacji.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetl 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 podmiot należy do klastra rekomendacji.	Dowolny tekst Zalecana długość tekstu: maksymalnie ok. 35 znaków
Lokalizacja – adres	Opcjonalny	Adres (w odpowiednich przypadkach) ciekawego miejsca.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalny	Stan lub prowincja (w odpowiednich przypadkach), w której znajduje się ważne miejsce.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalny	Kod pocztowy (w odpowiednich przypadkach) ciekawego miejsca.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – okolica	Opcjonalny	Okolica (w odpowiednich przypadkach) ciekawego miejsca.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
AvailabilityTimeWindow - Localized Start Time - Timestamp	Opcjonalny	Sygnatura czasowa epoki, kiedy ważne miejsce ma być otwarte lub dostępne.	Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone	Opcjonalny	Strefa czasowa, w której ważne miejsce powinno być otwarte lub dostępne.	Joda-Time DateTimeZone Wskazówki znajdziesz w sekcji Specyfikacje stref czasowych.
AvailabilityTimeWindow - Localized End Time - Timestamp	Opcjonalny	Sygnatura czasowa epoki, do której ważne miejsce ma być otwarte lub dostępne.	Joda-Time Instant
AvailabilityTimeWindow - Localized End Time - Timezone	Opcjonalny	Strefa czasowa, w której ważne miejsce powinno być otwarte lub dostępne.	Joda-Time DateTimeZone Wskazówki znajdziesz w sekcji Specyfikacje stref czasowych.
Plakietki	Opcjonalny	Każda plakietka to tekst (maks. 15 znaków) lub mały obraz.
Plakietka – tekst	Opcjonalny	Tytuł odznaki Uwaga: plakietka musi zawierać tekst lub obraz.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Odznaka – obraz	Opcjonalny	Mały obraz Specjalne traktowanie UX, np. jako nakładka z plakietką na miniaturę obrazu lub filmu. Uwaga: plakietka musi zawierać tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalny	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 Zalecana długość tekstu: 180 znaków
Lista podtytułów	Opcjonalny	Maksymalnie 3 napisy, każdy w postaci jednego wiersza 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ść tekstu każdego podtytułu: maks. 50 znaków
Ocena – wartość maksymalna	Opcjonalny	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalny	Bieżąca wartość skali ocen. Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalny	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	Opcjonalny	Liczba ocen ciekawego miejsca. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skracania wyświetlanej nazwy. 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 wstępu do tego miejsca. Musisz podać cenę promocyjną, jeśli podajesz przekreśloną cenę.	Dowolny tekst
Cena – StrikethroughPrice	Opcjonalny	Pierwotna cena biletów lub karnetów wstępu do ciekawego miejsca.	Dowolny tekst
Objaśnienie ceny	Opcjonalny	Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu, jeśli są dostępne.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
Kategorie treści	Opcjonalny	Opisz kategorię treści w encji.	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 dotyczącej kategorii treści.
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia	Opcjonalny	Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą być wyświetlane na danej platformie.	Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia	Opcjonalny	Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą 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	Tytuł elementu.	Ciąg znaków Zalecana długość 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 sekcji Specyfikacje 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świetl 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	Opcjonalny	Adres pocztowy restauracji (w odpowiednich przypadkach).	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalny	Stan lub województwo (w odpowiednich przypadkach), w którym znajduje się restauracja.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalny	Kod pocztowy restauracji (w odpowiednich przypadkach).	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – okolica	Opcjonalny	dzielnica, w której znajduje się restauracja (w odpowiednich przypadkach);	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Obrazy plakatu	Opcjonalny	Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalny	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 Zalecana długość tekstu: 180 znaków
Lista podtytułów	Opcjonalny	Maksymalnie 3 napisy, każdy w postaci jednego wiersza 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ść tekstu każdego podtytułu: maks. 50 znaków
Wielkość tabeli	Opcjonalny	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	Opcjonalny	Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą być wyświetlane na danej platformie.	Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia	Opcjonalny	Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą 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	Tytuł elementu.	Ciąg znaków Zalecana długość tekstu: maksymalnie 50 znaków
Zlokalizowany czas rozpoczęcia – sygnatura czasowa	Wymagany	Sygnatura czasowa w formacie epoki, kiedy wydarzenie ma się rozpocząć.	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 sekcji Specyfikacje stref czasowych.
Tryb zdarzenia	Wymagany	Pole wskazujące, czy wydarzenie będzie wirtualne, stacjonarne czy hybrydowe.	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świetl 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	Opcjonalny	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	Opcjonalny	Stan lub prowincja (w stosownych przypadkach), w której odbywa się wydarzenie.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalny	Kod pocztowy (w odpowiednich przypadkach) miejsca, w którym odbywa się wydarzenie.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – okolica	Opcjonalny	Dzielnica (w odpowiednich przypadkach), w której odbywa się wydarzenie.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Obrazy plakatu	Opcjonalny	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	Opcjonalny	Sygnatura czasowa w formacie epoki, kiedy wydarzenie ma się zakończyć.	Joda-Time Instant
Zlokalizowany czas zakończenia – strefa czasowa	Opcjonalny	Strefa czasowa, w której ma się zakończyć wydarzenie.	Joda-Time DateTimeZone Wskazówki znajdziesz w sekcji Specyfikacje stref czasowych.
Dostawca usług – nazwa	Opcjonalny	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	Opcjonalny	Logo lub obraz usługodawcy. Uwaga: w przypadku usługodawcy wymagany jest tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalny	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 Zalecana długość tekstu: 180 znaków
Lista podtytułów	Opcjonalny	Maksymalnie 3 napisy, każdy w postaci jednego wiersza 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ść tekstu każdego podtytułu: maks. 50 znaków
Plakietki	Opcjonalny	Każda plakietka to tekst (maks. 15 znaków) lub mały obraz.
Plakietka – tekst	Opcjonalny	Tytuł odznaki Uwaga: plakietka musi zawierać tekst lub obraz.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Odznaka – obraz	Opcjonalny	Mały obraz Specjalne traktowanie UX, np. jako nakładka z plakietką na miniaturę obrazu lub filmu. Uwaga: plakietka musi zawierać tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Identyfikator rezerwacji	Opcjonalny	Identyfikator rezerwacji wydarzenia.	Dowolny tekst
Cena - CurrentPrice	Wymagane warunkowo	Aktualna cena biletu lub karnetu na wydarzenie. Musisz podać cenę promocyjną, jeśli podajesz przekreśloną cenę.	Dowolny tekst
Cena – StrikethroughPrice	Opcjonalny	Pierwotna cena biletu na wydarzenie.	Dowolny tekst
Objaśnienie ceny	Opcjonalny	Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu, jeśli są dostępne.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
Ocena – wartość maksymalna	Opcjonalny	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalny	Bieżąca wartość skali ocen. Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalny	Liczba ocen zdarzenia. 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	Opcjonalny	Liczba ocen zdarzenia. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skracania wyświetlanej nazwy. Jeśli występują zarówno liczba, jak i wartość liczby, użytkownikom wyświetlimy liczbę.	Długi
Kategorie treści	Opcjonalny	Opisz kategorię treści w encji.	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 (np. wycieczka, festiwal) TYPE_HEALTH_AND_FITENESS (np. 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 dotyczącej kategorii treści.
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia	Opcjonalny	Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą być wyświetlane na danej platformie.	Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia	Opcjonalny	Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą 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	Tytuł elementu.	Dowolny tekst. Na przykład „Twój pobyt od 12 grudnia”. Zalecana długość 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 sekcji Specyfikacje 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 sekcji Specyfikacje 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świetl 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. „ul.” zamiast „ulica”, „al.” zamiast „aleja”). 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 Zalecana długość tekstu: maksymalnie ok. 35 znaków
Lokalizacja – adres	Opcjonalny	Adres (w odpowiednich przypadkach) obiektu noclegowego.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalny	Stan lub prowincja (w stosownych przypadkach), w której znajduje się obiekt noclegowy.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalny	Kod pocztowy obiektu noclegowego (w odpowiednich przypadkach).	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – okolica	Opcjonalny	dzielnica (w odpowiednich przypadkach),	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Obrazy plakatu	Opcjonalny	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.
Opis	Opcjonalny	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 Zalecana długość tekstu: 180 znaków
Lista podtytułów	Opcjonalny	Maksymalnie 3 napisy, każdy w postaci jednego wiersza 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ść tekstu każdego podtytułu: maks. 50 znaków
Identyfikator rezerwacji	Opcjonalny	Identyfikator rezerwacji obiektu noclegowego.	Dowolny tekst
Ocena – wartość maksymalna	Opcjonalny	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalny	Bieżąca wartość skali ocen. Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalny	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	Opcjonalny	Liczba ocen obiektu. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skracania wyświetlanej nazwy. 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 przekreśloną cenę.	Dowolny tekst
Cena – StrikethroughPrice	Opcjonalny	Pierwotna cena obiektu noclegowego, która będzie przekreślona w interfejsie.	Dowolny tekst
Objaśnienie ceny	Opcjonalny	Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu, jeśli są dostępne.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia	Opcjonalny	Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą być wyświetlane na danej platformie.	Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia	Opcjonalny	Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą 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	Tytuł elementu.	Dowolny tekst. Na przykład „SFO do SAN”. Zalecana długość tekstu: maksymalnie 50 znaków
Rodzaj transportu	Wymagany	Rodzaj/tryb środka transportu w rezerwacji.	Enum: FLIGHT, TRAIN, BUS lub FERRY
Zlokalizowany czas wylotu – sygnatura czasowa	Wymagany	Sygnatura czasowa epoki reprezentująca czas odjazdu.	Joda-Time Instant
Zlokalizowany czas wylotu – strefa czasowa	Wymagany	Strefa czasowa godziny odjazdu.	Joda-Time DateTimeZone Wskazówki znajdziesz w sekcji Specyfikacje stref czasowych.
Zlokalizowany czas przyjazdu – sygnatura czasowa	Wymagany	Sygnatura czasowa epoki reprezentująca godzinę przybycia.	Joda-Time Instant
Zlokalizowana godzina przyjazdu – strefa czasowa	Wymagany	Strefa czasowa godziny przyjazdu.	Joda-Time DateTimeZone Wskazówki znajdziesz w sekcji Specyfikacje stref czasowych.
Numer transportu	Wymagany	Numer lotu, autobusu, pociągu lub promu/statku wycieczkowego.	Dowolny tekst
Zlokalizowany czas 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
Zlokalizowany czas 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 sekcji Specyfikacje stref czasowych.
Miejsce wylotu – kraj	Opcjonalny	Kraj wyjazdu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja wylotu – miasto	Opcjonalny	Miasto wylotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce wylotu – wyświetl adres	Opcjonalny	Miejsce wylotu, które będzie wyświetlane użytkownikowi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce wylotu – adres	Opcjonalny	Adres (w odpowiednich przypadkach) miejsca wylotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce wylotu – województwo	Opcjonalny	Stan lub prowincja (w stosownych przypadkach) miejsca wylotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce wylotu – kod pocztowy	Opcjonalny	Kod pocztowy (w odpowiednich przypadkach) miejsca wylotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja początkowa – dzielnica	Opcjonalny	dzielnica (w odpowiednich przypadkach) miejsca wylotu;	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja przyjazdu – kraj	Opcjonalny	Kraj docelowy.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja przylotu – miasto	Opcjonalny	Miasto docelowe.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce docelowe – wyświetlany adres	Opcjonalny	Miejsce docelowe, które będzie wyświetlane użytkownikowi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce docelowe – adres	Opcjonalny	Adres (w odpowiednich przypadkach) miejsca docelowego.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja docelowa – stan	Opcjonalny	Stan lub prowincja (w stosownych przypadkach) miejsca docelowego.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce docelowe – kod pocztowy	Opcjonalny	Kod pocztowy (w odpowiednich przypadkach) miejsca docelowego.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja docelowa – dzielnica	Opcjonalny	dzielnica (w odpowiednich przypadkach) miejsca docelowego,	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Dostawca usług – nazwa	Opcjonalny	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	Opcjonalny	Logo lub obraz usługodawcy. Uwaga: w przypadku usługodawcy wymagany jest tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Obrazy plakatu	Opcjonalny	Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalny	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 Zalecana długość tekstu: 180 znaków
Lista podtytułów	Opcjonalny	Maksymalnie 3 napisy, każdy w postaci jednego wiersza 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ść tekstu każdego podtytułu: maks. 50 znaków
Identyfikator rezerwacji	Opcjonalny	Identyfikator rezerwacji transportu.	Dowolny tekst
Cena - CurrentPrice	Wymagane warunkowo	Obecna cena rezerwacji. Musisz podać tę wartość, jeśli podasz przekreśloną cenę.	Dowolny tekst
Cena – StrikethroughPrice	Opcjonalny	Pierwotna cena rezerwacji, która będzie przekreślona w interfejsie.	Dowolny tekst
Objaśnienie ceny	Opcjonalny	Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu, jeśli są dostępne.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia	Opcjonalny	Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą być wyświetlane na danej platformie.	Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia	Opcjonalny	Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą 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	Tytuł elementu.	Dowolny tekst. Na przykład „Avis Union Square SF” Zalecana długość tekstu: maksymalnie 50 znaków
Zlokalizowany czas odbioru – sygnatura czasowa	Wymagany	Sygnatura czasowa epoki reprezentująca godzinę odbioru rezerwacji.	Joda-Time Instant
Zlokalizowany czas odbioru – strefa czasowa	Wymagany	Strefa czasowa godziny odbioru w rezerwacji.	Joda-Time DateTimeZone Wskazówki znajdziesz w sekcji Specyfikacje stref czasowych.
Zlokalizowany czas zwrotu – sygnatura czasowa	Opcjonalny	Sygnatura czasowa epoki reprezentująca godzinę wymeldowania w przypadku rezerwacji.	Joda-Time Instant
Zlokalizowany czas zwrotu – strefa czasowa	Opcjonalny	Strefa czasowa godziny wymeldowania w przypadku rezerwacji.	Joda-Time DateTimeZone Wskazówki znajdziesz w sekcji Specyfikacje stref czasowych.
Adres odbioru – kraj	Opcjonalny	Kraj miejsca odbioru.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – miasto	Opcjonalny	Miasto, w którym znajduje się miejsce odbioru.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – wyświetlany adres	Opcjonalny	Miejsce odbioru, które będzie wyświetlane użytkownikowi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – ulica	Opcjonalny	Adres ulicy (w odpowiednich przypadkach) miejsca odbioru.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – stan	Opcjonalny	Stan lub prowincja (w stosownych przypadkach) miejsca odbioru.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – kod pocztowy	Opcjonalny	Kod pocztowy (w odpowiednich przypadkach) miejsca odbioru.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – dzielnica	Opcjonalny	Okolica (w odpowiednich przypadkach) miejsca odbioru.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – kraj	Opcjonalny	Kraj lokalizacji zwrotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – miasto	Opcjonalny	Miasto, w którym znajduje się lokalizacja zwrotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – wyświetlany adres	Opcjonalny	Lokalizacja zwrotu, która będzie wyświetlana użytkownikowi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – adres	Opcjonalny	Adres (w odpowiednich przypadkach) lokalizacji zwrotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – stan	Opcjonalny	Stan lub prowincja (w stosownych przypadkach) lokalizacji zwrotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – kod pocztowy	Opcjonalny	Kod pocztowy (w odpowiednich przypadkach) lokalizacji zwrotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – dzielnica	Opcjonalny	dzielnica (w odpowiednich przypadkach) lokalizacji zwrotu;	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Dostawca usług – nazwa	Opcjonalny	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	Opcjonalny	Logo lub obraz usługodawcy. Uwaga: w przypadku usługodawcy wymagany jest tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Obrazy plakatu	Opcjonalny	Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalny	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 Zalecana długość tekstu: 180 znaków
Lista podtytułów	Opcjonalny	Maksymalnie 3 napisy, każdy w postaci jednego wiersza 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ść tekstu każdego podtytułu: maks. 50 znaków
Identyfikator potwierdzenia	Opcjonalny	Identyfikator potwierdzenia rezerwacji wypożyczenia pojazdu.	Dowolny tekst
Cena - CurrentPrice	Wymagane warunkowo	Obecna cena rezerwacji. Musisz podać tę wartość, jeśli podasz przekreśloną cenę.	Dowolny tekst
Cena – StrikethroughPrice	Opcjonalny	Pierwotna cena rezerwacji, która będzie przekreślona w interfejsie.	Dowolny tekst
Objaśnienie ceny	Opcjonalny	Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu, jeśli są dostępne.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na platformie.
Sygnatura czasowa rozpoczęcia	Opcjonalny	Sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą być wyświetlane na danej platformie.	Sygnatura czasowa epoki w milisekundach
Sygnatura czasowa zakończenia	Opcjonalny	Sygnatura czasowa epoki, po której treści nie będą już wyświetlane na danej platformie. Jeśli nie jest ustawiona, treści mogą być wyświetlane na danej platformie.	Sygnatura czasowa epoki w milisekundach

Specyfikacja obrazu

Wymagane specyfikacje komponentów z obrazem są wymienione 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 (4:5)	480 x 600	960 x 1200

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 (4:5)

480 x 600

960 x 1200

Obrazy muszą być hostowane w publicznych sieciach CDN, aby Google mógł uzyskać do nich 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żywaj 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ą przypisywane do niektórych wstępnie zdefiniowanych kategorii, takich 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ł uzyskać do nich dostęp.

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

Niektóre typy, 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.
W przypadku niektórych kategorii treści używaj konkretnego typu elementu zamiast kombinacji elementów ogólnych i kategorii treści:
- TYPE_MOVIES_AND_TV_SHOWS – przed użyciem ogólnych elementów sprawdź elementy z przewodnika po integracji z zegarkiem.
- TYPE_BOOKS – przed użyciem ogólnych elementów sprawdź EbookEntity.
- TYPE_AUDIOBOOKS – przed użyciem ogólnych elementów sprawdź AudiobookEntity.
- TYPE_SHOPPING – sprawdź ShoppingEntity przed użyciem ogólnych elementów.
- TYPE_FOOD_AND_DRINK – przed użyciem ogólnych elementów zapoznaj się z elementami z przewodnika po integracji z usługami związanymi z jedzeniem.
Pole ContentCategory jest opcjonalne i należy je pozostawić puste, jeśli treść nie należy do żadnej z wcześniej wymienionych kategorii.
Jeśli podasz kilka kategorii treści, podaj je w kolejności ich trafności w stosunku do treści. Najbardziej trafna 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 otworzy aplikację lub doda coś do koszyka).

AppEngageTravelClient odpowiada za publikowanie klastrów.

W klientach dostępne są te interfejsy API do publikowania klastrów:

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.

W przypadku pakietu Engage SDK w wersji 1.6.0 lub nowszej (zalecane)

Umiejętności związane z Androidem

Wyświetl w GitHubie

Integracja pakietu Engage SDK

Aby zainstalować umiejętność z interfejsu wiersza poleceń Androida, uruchom to polecenie:

android skills add engage-sdk-integration

Jeśli Twój zespół korzysta z narzędzi do kodowania opartych na AI (takich jak Gemini w Android Studio), możesz zautomatyzować tę migrację, prosząc asystenta AI o wykonanie tych czynności:

Use the engage-sdk-integration skill to use Engage SDK 1.6.0 and refactor isServiceAvailable to pass ServiceAvailabilityRequest for publishing all cluster types.

Możesz sprawdzić dostępność usługi dla każdego typu klastra, który chcesz opublikować. Interfejs isServiceAvailable API akceptuje obiekt żądania ServiceAvailabilityRequest, który zawiera typy klastrów, dla których należy sprawdzić dostępność usługi. W tabeli poniżej znajdziesz wartości wyliczeniowe ClusterType wymagane w przypadku ServiceAvailabilityRequest.

Typ klastra	Stała typu klastra	Wartość w formie liczby całkowitej
Nieznany	`TYPE_UNKNOWN`	0
Klaster rekomendacji	`TYPE_RECOMMENDATION`	1
Polecany klaster	`TYPE_FEATURED`	2
Klaster kontynuacji	`TYPE_CONTINUATION`	3
Klaster zarządzania użytkownikami	`TYPE_ENGAGEMENT`	8
Klaster subskrypcji	`TYPE_SUBSCRIPTION`	12
Klaster wyszukiwania	`TYPE_CONTINUE_SEARCH`	13
Klaster rezerwacji	`TYPE_RESERVATION`	14

Kotlin

val request = ServiceAvailabilityRequest.Builder()
    .addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
    .addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
    .build()

client.isServiceAvailable(request).addOnCompleteListener { task ->
    if (task.isSuccessful) {
        val availabilityMap = task.result
        if (availabilityMap[ClusterType.TYPE_CONTINUATION] == true) {
            // Proceed with publishing continuation content
        }
        if (availabilityMap[ClusterType.TYPE_RECOMMENDATION] == true) {
            // Proceed with publishing recommendation content
        }
    } else {
        // The IPC call itself fails, proceed with error handling logic here,
        // such as retry.
    }
}

Java

ServiceAvailabilityRequest request =
    new ServiceAvailabilityRequest.Builder()
        .addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
        .addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
        .build();

client.isServiceAvailable(request).addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        Map<Integer, Boolean> availabilityMap = task.getResult();
        if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_CONTINUATION))) {
            // Proceed with publishing continuation content
        }
        if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_RECOMMENDATION))) {
            // Proceed with publishing recommendation content
        }
    } else {
        // The IPC call itself fails, proceed with error handling logic here,
        // such as retry.
    }
});

Funkcja warunkowej dostępności usługi

Niektóre zintegrowane aplikacje wymagają specjalnej konfiguracji, która umożliwia okresowe włączanie i wyłączanie usługi Engage w celu zmniejszenia kosztów wyświetlania reklam. Ta strategia sporadycznego przetwarzania treści, choć możliwa, negatywnie wpływa na użytkownika i produkt – nie będą wyświetlane treści nieaktualne, a niektóre platformy nie będą w ogóle dostępne.

Od wersji 1.6.0 pakiet Engage SDK umożliwia sprawdzanie dostępności w przypadku określonych typów klastrów. Zapewnia to większą elastyczność, dzięki czemu w przypadku przyjęcia przez daną aplikację strategii dotyczącej treści przerywanego wyświetlania niektóre typy klastrów mogą stosować tę strategię, a inne typy klastrów mogą być zawsze włączone (np. klastry kontynuacji).

Jeśli usługa Engage nie powinna być „stale” włączona na wszystkich obsługiwanych urządzeniach z jakiegokolwiek powodu i jest skonfigurowana do przerywanego pozyskiwania danych na dowolnym zestawie urządzeń, wszystkie publikacje klastra kontynuacji (np. rezerwacja i kontynuacja wyszukiwania) będą nadal domyślnie włączone, a pozostałe typy klastrów będą włączane i wyłączane przerywanie. Jeśli przerywane przesyłanie danych ma zastosowanie w Twoim przypadku, ale ta domyślna konfiguracja nie odpowiada Twoim potrzebom, napisz na adres engage-developers@google.com.

W przypadku wersji pakietu SDK starszych niż 1.6.0 (wycofanych)

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 czynności:

Dotychczasowe dane RecommendationCluster od partnera 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 jest zachowywany.

`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 czynności:

Dotychczasowe dane FeaturedCluster od partnera 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 jest zachowywany.

`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 czynności:

Dotychczasowe dane ReservationCluster od partnera 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 jest zachowywany.

`publishContinueSearchCluster`

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

interfejsy API publikowania robią to z założenia.

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 czynności:

Dotychczasowe dane ContinueSearchCluster od partnera 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 jest zachowywany.

`publishUserAccountManagementRequest`

Ten interfejs API służy do publikowania karty logowania . Działanie logowania kieruje użytkowników na stronę logowania aplikacji, aby mogła ona publikować treści (lub dostarczać 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 na stronę logowania do aplikacji)
Obraz	Opcjonalny – jeśli nie zostanie podany, należy podać tytuł	Obraz wyświetlany na karcie Obrazy o współczynniku proporcji 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	Opcjonalny	Tekst wyświetlany w wezwaniu do działania (np. Zaloguj się)
Podtytuł	Opcjonalny	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 czynności:

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 jest zachowywany.

`updatePublishStatus`

Jeśli z jakiegokolwiek wewnętrznego powodu biznesowego żaden z klastrów nie jest opublikowany, zdecydowanie zalecamy zaktualizowanie stanu publikacji za pomocą interfejsu API updatePublishStatus. 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 wskaźnikach integracji.
Jeśli nie opublikowano żadnych treści, 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 oczekiwanej z punktu widzenia dostawcy sytuacji.
Pomaga deweloperom dostarczać informacji o tym, 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ł zobaczyć jej zawartość lub rozwiązać problem.

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ła prośba jest odrzucana i zachowywany jest dotychczasowy stan.

`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 prośbę, usunie dotychczasowe dane z wyróżnionego klastra. W przypadku błędu całe żądanie jest odrzucane i zachowywany jest dotychczasowy stan.

`deleteReservationCluster`

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

Kotlin

client.deleteReservationCluster()

Java

client.deleteReservationCluster();

Gdy usługa otrzyma prośbę, usunie istniejące dane z klastra rezerwacji. W przypadku błędu cała prośba jest odrzucana i zachowywany jest dotychczasowy stan.

`deleteUserManagementCluster`

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

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

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

`deleteContinueSearchCluster`

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

Kotlin

client.deleteContinueSearchCluster()

Java

client.deleteContinueSearchCluster();

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

`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 prośbę, usunie dotychczasowe 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 i zachowywany jest dotychczasowy stan.

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ę powodzeniem.

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`	Wykonanie zadania nie powiodło się z powodu problemów z wątkami. W takim przypadku można ponowić próbę.
`4`	`SERVICE_CALL_PERMISSION_DENIED`	Dzwoniący nie ma uprawnień do nawiązywania połączeń z usługą.
`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 transmisji 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:

Dynamicznie zarejestruj instancję 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. Umożliwia to aplikacji odbieranie intencji transmisji, gdy nie jest uruchomiona, a także publikowanie 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 publishFeaturedCluster połączenia 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 Proces integracji dla programistów w usłudze Engage.

Najczęstsze pytania

Odpowiedzi na najczęstsze pytania znajdziesz w Najczęstszych pytaniach dotyczących pakietu Engage SDK.

Kontakt

Jeśli podczas procesu integracji pojawią się pytania, skontaktuj się z zespołem 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 plik APK gotowy do testowania przez Google.
Google przeprowadza weryfikację i sprawdza wewnętrznie, czy integracja działa zgodnie z oczekiwaniami. Jeśli konieczne będą zmiany, skontaktujemy się z Tobą, aby przekazać Ci niezbędne informacje.
Gdy testowanie zostanie 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.

Engage SDK Travel: instrukcje integracji technicznej firm zewnętrznych Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Obsługa kategorii i platform

Szczegóły integracji

Terminologia

Przygotowanie

Podsumowanie

Krok 1. Podaj dane podmiotu

GenericFeaturedEntity

ArticleEntity

EventEntity

LodgingEntity

StoreEntity

PointOfInterestEntity

RestaurantReservationEntity

EventReservationEntity

LodgingReservationEntity

TransportationReservationEntity

VehicleRentalReservationEntity

Specyfikacja obrazu

Specyfikacje strefy czasowej

Kategoria treści

Krok 2. Podaj dane klastra

isServiceAvailable

W przypadku pakietu Engage SDK w wersji 1.6.0 lub nowszej (zalecane)

Kotlin

Java

Funkcja warunkowej dostępności usługi

W przypadku wersji pakietu SDK starszych niż 1.6.0 (wycofanych)

Kotlin

Java

publishRecommendationClusters

Kotlin

Java

publishFeaturedCluster

Kotlin

Java

publishReservationCluster

Kotlin

Java

publishContinueSearchCluster

Kotlin

Java

publishUserAccountManagementRequest

Kotlin

Java

updatePublishStatus

Kotlin

Java

deleteRecommendationClusters

Kotlin

Java

deleteFeaturedCluster

Kotlin

Java

deleteReservationCluster

Kotlin

Java

deleteUserManagementCluster

Kotlin

Java

deleteContinueSearchCluster

Kotlin

Java

deleteClusters

Kotlin

Java

Obsługa błędów

Kotlin

Java

Krok 3. Obsługa intencji transmisji

Kotlin

Java

Przepływ pracy integracji

Najczęstsze pytania

Kontakt

Dalsze kroki

Engage SDK Travel: instrukcje integracji technicznej firm zewnętrznych

`GenericFeaturedEntity`

`ArticleEntity`

`EventEntity`

`LodgingEntity`

`StoreEntity`

`PointOfInterestEntity`

`RestaurantReservationEntity`

`EventReservationEntity`

`LodgingReservationEntity`

`TransportationReservationEntity`

`VehicleRentalReservationEntity`

`isServiceAvailable`

`publishRecommendationClusters`

`publishFeaturedCluster`

`publishReservationCluster`

`publishContinueSearchCluster`

`publishUserAccountManagementRequest`

`updatePublishStatus`

`deleteRecommendationClusters`

`deleteFeaturedCluster`

`deleteReservationCluster`

`deleteUserManagementCluster`

`deleteContinueSearchCluster`

`deleteClusters`