Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Engage SDK inne branże: 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 dokument zawiera instrukcje dla partnerów deweloperów dotyczące integrowania nowych treści, takich jak rezerwacje, wydarzenia, obiekty noclegowe, miejsca warte uwagi, osoby i inne treści, które mogą nie należeć do żadnej z tych kategorii.

Szczegóły integracji

Terminologia

Ta integracja obejmuje 3 typy klastrów: Rekomendacje, Wyróżnione i Kontynuacja.

Rekomendacje to grupy zawierające spersonalizowane sugestie od konkretnego partnera deweloperskiego. Jest to widok interfejsu, który zawiera grupę rekomendacji od tego samego partnera dewelopera.
- ArticleEntity: ArticleEntity, która reprezentuje rekomendację tekstową dotyczącą treści odpowiednich dla więcej niż 1 kategorii. Element ArticleEntity umożliwia deweloperom dostarczanie różnorodnych treści tekstowych i graficznych z większą ilością metadanych, aby przekazywać użytkownikom informacje w bardziej szczegółowy sposób niż w przypadku elementu GenericFeaturedEntity. Przykład: treści marketingowe, fragment wiadomości
  
  Ilustracja 1. Interfejs pokazujący pojedynczy element ArticleEntity w klastrze Rekomendacje.
- EventEntity: EventEntity reprezentuje wydarzenie, które odbędzie się w przyszłości. Czas rozpoczęcia wydarzenia to kluczowa informacja, którą należy przekazać użytkownikom.
  
  Ilustracja 2. Interfejs pokazujący pojedynczy element EventEntity w klastrze Rekomendacje.
- LodgingEntity: LodgingEntity reprezentuje obiekt noclegowy, taki jak hotel, apartament lub dom wakacyjny na wynajem krótkoterminowy 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 pokazujący pojedynczy element PointOfInterestEntity w klastrze rekomendacji.
- PersonEntity: PersonEntity reprezentuje osobę. Rekomendacje mogą dotyczyć wyróżnienia osoby w kategoriach takich jak zdrowie i fitness, sport, randki itp.
  
  Ilustracja 5. Interfejs pokazujący pojedynczy element PersonEntity w klastrze Rekomendacje.
Grupa Kontynuacja 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 Kontynuacja.

Treści kontynuacyjne mogą mieć taką strukturę:
- ArticleEntity: ArticleEntity, która reprezentuje rekomendację tekstową dotyczącą treści odpowiednich dla więcej niż 1 kategorii. Może ona reprezentować niedokończone artykuły informacyjne lub inne treści, które użytkownik chce kontynuować od miejsca, w którym je przerwał. Przykład: treści marketingowe, fragment wiadomości
  
  Rysunek 6. Interfejs użytkownika przedstawiający pojedynczy element ArticleEntity w grupie Continuation.
- RestaurantReservationEntity: RestaurantReservationEntity reprezentuje rezerwację w restauracji lub kawiarni i pomaga użytkownikom śledzić zbliżające się lub trwające rezerwacje w restauracjach.
  
  Rysunek 7. Interfejs użytkownika pokazujący pojedynczy element RestaurantReservationEntity w klastrze Continuation.
- 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 na film w kinie, koncert, spektakl teatralny czy spotkanie autorskie;
  - rezerwacje podróży lub miejsc wartych odwiedzenia, np. wycieczek z przewodnikiem czy biletów do muzeum;
  - Rezerwacje miejsc na spotkania towarzyskie, seminaria i konferencje
  - Rezerwacje sesji edukacyjnych i szkoleniowych
  Rysunek 8. Interfejs pokazujący pojedynczy element EventReservationEntity w grupie Continuation.
- LodgingReservationEntity: LodgingEntityReservation reprezentuje rezerwację noclegu w podróży i pomaga użytkownikom śledzić nadchodzące lub trwające rezerwacje hoteli lub kwater wakacyjnych.
  
  Rysunek 9. Interfejs użytkownika wyświetlający pojedynczy element LodgingReservationEntity w grupie Continuation.
- TransportationReservationEntity: TransportationReservationEntity reprezentuje rezerwację transportu dowolnym środkiem lokomocji i pomaga użytkownikom śledzić rezerwacje nadchodzących lub trwających lotów, promów, pociągów, autobusów, przejazdów taksówką lub rejsów.
  
  Rysunek 10. Interfejs pokazujący pojedynczy element TransportationReservationEntity w grupie Continuation.
- VehicleRentalReservationEntity: VehicleRentalReservationEntity reprezentuje rezerwację wypożyczenia pojazdu i pomaga użytkownikom śledzić nadchodzące lub trwające rezerwacje wypożyczenia pojazdu.
  
  Rysunek 11. Interfejs użytkownika przedstawiający pojedynczy element VehicleRentalReservationEntity w klastrze Continuation.
Grupa Polecane to widok interfejsu, który wyświetla wybrane elementyGenericFeaturedEntity 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ć w sekcji Polecane 1 element obsługiwanego typu. W sekcji Polecane może się znajdować wiele elementów (potencjalnie różnych typów) od wielu deweloperów aplikacji.
- GenericFeaturedEntity: GenericFeaturedEntity różni się od elementu rekomendacji tym, że element polecany powinien być używany w przypadku pojedynczych najlepszych treści od deweloperów, które są najważniejsze i mogą być interesujące i przydatne dla użytkowników.
  
  Ilustracja 12. Interfejs użytkownika z jedną kartą banera powitalnego GenericFeaturedEntity w wyróżnionym klastrze

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 elementów w klastrze
Klastry rekomendacji	Maksymalnie 7	Co najmniej 1	Maksymalnie 50 (`ArticleEntity`, `EventEntity`,`LodgingEntity`, `StoreEntity`,`PointOfInterestEntity` lub `PersonEntity`)
Klaster kontynuacji	Maksymalnie 1	Co najmniej 1	Maksymalnie 20 znaków (`ArticleEntity`,`EventReservationEntity`,`LodgingReservationEntity`,`TransportationReservationEntity` lub`VehicleRentalReservationEntity`)
Polecany klaster	Maksymalnie 1	Co najmniej 1	Maksymalnie 20 osób (`GenericFeaturedEntity`)

Krok 1. Podaj dane podmiotu

Pakiet SDK ma zdefiniowane różne obiekty reprezentujące każdy typ produktu. W kategorii „Inne” obsługujemy te typy podmiotów:

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
PersonEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity

W tabelach poniżej znajdziesz listę dostępnych atrybutów i wymagań dotyczących poszczególnych typów.

`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 na górze i na dole obrazu jest bezpieczna przestrzeń o wielkości 24 dps.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Tytuł	Opcjonalnie	Nazwa podmiotu.	Dowolny tekst Zalecany rozmiar tekstu: 50 znaków
Opis	Opcjonalnie	Jeden akapit tekstu opisujący encję. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	Maksymalnie 3 napisy, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecana długość każdego podtytułu: maks. 50 znaków
Odznaki	Opcjonalnie	Każda plakietka to tekst (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	Opcjonalnie	Tytuł plakietki Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Plakietka – obraz	Opcjonalnie	Mały obraz Specjalne traktowanie pod względem UX, np. nakładka w postaci plakietki na miniaturę obrazu lub filmu. Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Kategorie treści	Opcjonalnie	Opisz kategorię treści w jednostce.	Lista wartości w polu enum Wskazówki znajdziesz w sekcji Kategoria treści.

`ArticleEntity`

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do podmiotu w aplikacji dla usługodawców. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Nazwa podmiotu.	Dowolny tekst Zalecany rozmiar tekstu: maks. 50 znaków
Obrazy plakatu	Opcjonalnie	Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9. Uwaga: zdecydowanie zalecamy dodanie obrazu. Jeśli podasz plakietkę, upewnij się, że u góry i u dołu obrazu znajduje się bezpieczny obszar o wielkości 24 dps.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Źródło – tytuł	Opcjonalnie	imię i nazwisko autora, nazwę organizacji lub imię i nazwisko reportera;	Dowolny tekst Zalecana długość tekstu: poniżej 25 znaków
Źródło – obraz	Opcjonalnie	obraz źródła, np. autora, organizacji lub reportera;	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący encję. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	Maksymalnie 3 napisy, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecana długość każdego podtytułu: maks. 50 znaków
Odznaki	Opcjonalnie	Każda plakietka to tekst (maks. 15 znaków) lub mały obraz. Specjalne traktowanie UX na obrazie lub filmie, np. jako plakietka nakładana na obraz „Aktualizacja na żywo” Czas czytania artykułu
Plakietka – tekst	Opcjonalnie	Tytuł plakietki Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Plakietka – obraz	Opcjonalnie	Mały obraz Specjalne traktowanie pod względem UX, np. nakładka w postaci plakietki na miniaturę obrazu lub filmu. Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacje obrazów.
Czas publikacji treści	Opcjonalnie	Jest to sygnatura czasowa epoki w milisekundach, która określa, kiedy treści zostały opublikowane lub zaktualizowane w aplikacji.	Sygnatura czasowa epoki w milisekundach
Czas ostatniego działania związanego z zaangażowaniem	Wymagane warunkowo	Sygnatura czasowa epoki w milisekundach, kiedy użytkownik ostatnio wchodził w interakcję z tym elementem. Uwaga: to pole jest wymagane, jeśli ten podmiot jest częścią klastra kontynuacji.	Sygnatura czasowa epoki w milisekundach
Procent postępu	Wymagane warunkowo	Procent pełnej treści, który użytkownik wykorzystał do tej pory. Uwaga: to pole jest wymagane, jeśli ten podmiot jest częścią klastra kontynuacji.	Wartość int z zakresu od 0 do 100 (włącznie).
Kategorie treści	Opcjonalnie	Opisz kategorię treści w jednostce.	Lista wartości w polu enum Wskazówki znajdziesz w sekcji Kategoria treści.

`EventEntity`

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do podmiotu w aplikacji dla usługodawców. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Nazwa podmiotu.	Ciąg znaków Zalecany rozmiar tekstu: maks. 50 znaków
Czas rozpoczęcia	Wymagany	Sygnatura czasowa w formacie epoki, kiedy ma się rozpocząć wydarzenie. Uwaga: ta wartość będzie podana w milisekundach.	Sygnatura czasowa epoki w milisekundach
Tryb zdarzenia	Wymagany	Pole wskazujące, czy wydarzenie będzie wirtualne, stacjonarne czy w obu tych formach.	Enum: 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 znajduje się bezpieczny obszar o wielkości 24 dps.	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świetlanie adresu	Wymagane warunkowo	Adres lub nazwa miejsca, w którym odbędzie się wydarzenie, które powinny być wyświetlane użytkownikowi. Uwaga: jest to wymagane w przypadku wydarzeń, które są STACJONARNE lub HYBRYDOWE.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalnie	Adres ulicy (w odpowiednich przypadkach) miejsca, w którym odbywa się wydarzenie.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalnie	Stan lub województwo (jeśli ma zastosowanie), w którym odbywa się wydarzenie.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli występuje) lokalizacji, w której odbywa się wydarzenie.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – okolica	Opcjonalnie	Dzielnica (w stosownych przypadkach), w której odbywa się wydarzenie.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Czas zakończenia	Opcjonalnie	Sygnatura czasowa w formacie epoki, kiedy wydarzenie ma się zakończyć. Uwaga: ta wartość będzie podana w milisekundach.	Sygnatura czasowa epoki w milisekundach
Opis	Opcjonalnie	Jeden akapit tekstu opisujący encję. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	Maksymalnie 3 napisy, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecana długość każdego podtytułu: maks. 50 znaków
Odznaki	Opcjonalnie	Każda plakietka to tekst (maks. 15 znaków) lub mały obraz.
Plakietka – tekst	Opcjonalnie	Tytuł plakietki Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Plakietka – obraz	Opcjonalnie	Mały obraz Specjalne traktowanie pod względem UX, np. nakładka w postaci plakietki na miniaturę obrazu lub filmu. Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Cena - CurrentPrice	Wymagane warunkowo	Obecna cena biletu lub karnetu na wydarzenie. Musisz podać cenę, jeśli podajesz cenę przekreśloną.	Dowolny tekst
Cena – StrikethroughPrice	Opcjonalnie	Pierwotna cena biletu na wydarzenie.	Dowolny tekst
Objaśnienie dotyczące ceny	Opcjonalnie	Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu (jeśli są dostępne).	Dowolny tekst Zalecana długość tekstu: mniej niż 45 znaków (za długi tekst może być wyświetlany z wielokropkiem)
Kategorie treści	Opcjonalnie	Opisz kategorię treści w jednostce.	Lista kwalifikujących się typów wyliczeniowych TYPE_MOVIES_AND_TV_SHOWS (przykład: kino) TYPE_DIGITAL_GAMES (przykład: e-sport) TYPE_MUSIC (przykład: koncert) TYPE_TRAVEL_AND_LOCAL (przykład: wycieczka, festiwal) TYPE_HEALTH_AND_FITENESS (np. zajęcia z jogi) TYPE_EDUCATION (przykład: zajęcia) TYPE_SPORTS (przykład: mecz piłki nożnej) TYPE_DATING (przykład: spotkanie) Wskazówki znajdziesz w sekcji Kategoria treści.

`LodgingEntity`

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do podmiotu w aplikacji dla usługodawców. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Nazwa podmiotu.	Ciąg znaków Zalecany rozmiar tekstu: maks. 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 dps.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Lokalizacja – kraj	Wymagany	Kraj, w którym znajduje się obiekt noclegowy.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – miasto	Wymagany	Miasto, w którym znajduje się obiekt noclegowy.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlanie adresu	Wymagany	Adres obiektu noclegowego, który będzie wyświetlany użytkownikowi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalnie	Adres (jeśli dotyczy) obiektu noclegowego.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalnie	Stan lub województwo (jeśli ma zastosowanie), w którym znajduje się obiekt noclegowy.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli występuje) obiektu noclegowego.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – okolica	Opcjonalnie	Okolica (w odpowiednich przypadkach), w której znajduje się obiekt.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Odznaki	Opcjonalnie	Każda plakietka to tekst (maks. 15 znaków) lub mały obraz.
Plakietka – tekst	Opcjonalnie	Tytuł plakietki Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Plakietka – obraz	Opcjonalnie	Mały obraz Specjalne traktowanie pod względem UX, np. nakładka w postaci plakietki na miniaturę obrazu lub filmu. Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący encję. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	Maksymalnie 3 napisy, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecana długość każdego podtytułu: maks. 50 znaków
AvailabilityTimeWindow – czas rozpoczęcia	Opcjonalnie	Sygnatura czasowa epoki w milisekundach, kiedy obiekt noclegowy ma być otwarty lub dostępny.	Sygnatura czasowa epoki w milisekundach
AvailabilityTimeWindow - End Time	Opcjonalnie	Sygnatura czasowa epoki w milisekundach, do której obiekt noclegowy ma być otwarty lub dostępny.	Sygnatura czasowa epoki w milisekundach
Ocena – wartość maksymalna	Opcjonalnie	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalnie	Bieżąca wartość skali ocen. Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalnie	Liczba ocen obiektu. Uwaga: wypełnij to pole, jeśli Twoja aplikacja kontroluje sposób wyświetlania liczby użytkownikom. Użyj zwięzłego ciągu znaków. Jeśli np. liczba wynosi 1 000 000, rozważ użycie skrótu, np. 1 mln, aby liczba nie była obcinana w przypadku mniejszych rozmiarów wyświetlanych elementów.	Ciąg znaków
Ocena – wartość liczby	Opcjonalnie	Liczba ocen obiektu. Uwaga: wypełnij to pole, jeśli nie obsługujesz samodzielnie logiki skrótu wyświetlania. Jeśli występują zarówno parametr Liczba, jak i Wartość liczby, użytkownikom wyświetlana jest wartość parametru Liczba.	Długi
Cena – CurrentPrice	Wymagane warunkowo	Obecna cena obiektu. Musisz podać cenę, jeśli podasz cenę przekreśloną.	Dowolny tekst
Cena – StrikethroughPrice	Opcjonalnie	Pierwotna cena obiektu noclegowego, która będzie przekreślona w interfejsie.	Dowolny tekst
Objaśnienie dotyczące ceny	Opcjonalnie	Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu (jeśli są dostępne).	Dowolny tekst Zalecana długość tekstu: mniej niż 45 znaków (za długi tekst może być wyświetlany z wielokropkiem)

`StoreEntity`

Obiekt StoreEntity reprezentuje pojedynczy sklep, który partnerzy deweloperzy chcą opublikować, np. restaurację lub sklep spożywczy.

Atrybut	Wymaganie	Opis	Format
Obrazy plakatu	Wymagany	Musisz podać co najmniej 1 obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Identyfikator URI działania	Wymagany	Precyzyjny link do podmiotu w aplikacji dla usługodawców. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Opcjonalnie	Nazwa sklepu.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek).
Lokalizacja	Opcjonalnie	Lokalizacja sklepu.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
Objaśnienie	Opcjonalnie	Wywołanie, które wyróżnia promocję, wydarzenie lub aktualizację w sklepie, jeśli jest dostępne.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
Drobny druk w wywołaniu	Opcjonalnie	Tekst drobnego druku objaśnienia.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropek)
Opis	Opcjonalnie	Opis sklepu.	Dowolny tekst Zalecana długość tekstu: mniej niż 90 znaków (za długi tekst może być wyświetlany z wielokropkiem)
Ocena – wartość maksymalna	Opcjonalnie	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalnie	Bieżąca wartość skali ocen. Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalnie	Liczba ocen obiektu. Uwaga: wypełnij to pole, jeśli aplikacja ma kontrolować sposób wyświetlania tego elementu użytkownikom. Podaj krótki ciąg znaków, który może być wyświetlany użytkownikowi. Jeśli np. liczba wynosi 1 000 000, rozważ użycie skrótu, np. 1 mln, aby nie została obcięta w przypadku mniejszych rozmiarów wyświetlanych elementów.	Ciąg znaków
Ocena – wartość liczby	Opcjonalnie	Liczba ocen obiektu. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skracania wyświetlania. Jeśli występują zarówno liczba, jak i wartość liczby, użytkownikom wyświetlimy liczbę.	Długi

`PointOfInterestEntity`

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do podmiotu w aplikacji dla usługodawców. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Nazwa podmiotu.	Ciąg znaków Zalecany rozmiar tekstu: maks. 50 znaków
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 znajduje się bezpieczny obszar o wielkości 24 dps.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Lokalizacja – kraj	Wymagany	Kraj, w którym znajduje się ciekawe miejsce.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – miasto	Wymagany	Miasto, w którym znajduje się interesujące miejsce.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlanie adresu	Wymagany	Adres ważnego miejsca, który będzie wyświetlany użytkownikowi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalnie	Adres (jeśli występuje) ciekawego miejsca.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalnie	Stan lub województwo (jeśli ma zastosowanie), w którym znajduje się ważne miejsce.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli występuje) danego miejsca.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – okolica	Opcjonalnie	Okolica (jeśli występuje), w której znajduje się dane miejsce.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
AvailabilityTimeWindow – czas rozpoczęcia	Opcjonalnie	Sygnatura czasowa epoki w milisekundach, kiedy ważne miejsce ma być otwarte lub dostępne.	Sygnatura czasowa epoki w milisekundach
AvailabilityTimeWindow - End Time	Opcjonalnie	Sygnatura czasowa epoki w milisekundach, do której ważne miejsce ma być otwarte lub dostępne.	Sygnatura czasowa epoki w milisekundach
Odznaki	Opcjonalnie	Każda plakietka to tekst (maks. 15 znaków) lub mały obraz.
Plakietka – tekst	Opcjonalnie	Tytuł plakietki Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Plakietka – obraz	Opcjonalnie	Mały obraz Specjalne traktowanie pod względem UX, np. nakładka w postaci plakietki na miniaturę obrazu lub filmu. Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący encję. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	Maksymalnie 3 napisy, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecana długość każdego podtytułu: maks. 50 znaków
Ocena – wartość maksymalna	Opcjonalnie	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalnie	Bieżąca wartość skali ocen. Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalnie	Liczba ocen ciekawego miejsca. Uwaga: wypełnij to pole, jeśli Twoja aplikacja kontroluje sposób wyświetlania liczby użytkownikom. Użyj zwięzłego ciągu znaków. Jeśli np. liczba wynosi 1 000 000, rozważ użycie skrótu, np. 1 mln, aby liczba nie była obcinana w przypadku mniejszych rozmiarów wyświetlanych elementów.	Ciąg znaków
Ocena – wartość liczby	Opcjonalnie	Liczba ocen ciekawego miejsca. Uwaga: wypełnij to pole, jeśli nie obsługujesz samodzielnie logiki skracania wyświetlania. Jeśli występują zarówno parametr Count, jak i Count Value, użytkownikom wyświetlany jest parametr Count.	Długi
Cena – CurrentPrice	Wymagane warunkowo	Aktualna cena biletów lub karnetów do danego miejsca. Musisz podać cenę, jeśli podajesz cenę przekreśloną.	Dowolny tekst
Cena – StrikethroughPrice	Opcjonalnie	Pierwotna cena biletów lub karnetu do ważnego miejsca.	Dowolny tekst
Objaśnienie dotyczące ceny	Opcjonalnie	Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu (jeśli są dostępne).	Dowolny tekst Zalecana długość tekstu: mniej niż 45 znaków (za długi tekst może być wyświetlany z wielokropkiem)
Kategorie treści	Opcjonalnie	Opisz kategorię treści w jednostce.	Lista kwalifikujących się typów wyliczeniowych TYPE_TRAVEL_AND_LOCAL TYPE_MOVIES_AND_TV_SHOWS (przykład: kino) TYPE_MEDICAL (przykład: szpital) TYPE_EDUCATION (przykład: szkoła) TYPE_SPORTS (przykład: stadion) Wskazówki znajdziesz w sekcji Kategoria treści.

`PersonEntity`

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
Profil – nazwa	Wymagany	Nazwa profilu, identyfikator lub nick, np. „Jan Kowalski”, „@TeamPixel” itp.	Ciąg znaków Zalecany rozmiar tekstu: maks. 50 znaków
Profil – awatar	Wymagany	Zdjęcie profilowe lub awatar użytkownika. Uwaga: musi to być obraz kwadratowy o proporcjach 1:1.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Profil – dodatkowy tekst	Opcjonalnie	Dowolny tekst, np. uchwyt profilu.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Profil – dodatkowe zdjęcie	Opcjonalnie	Mały obraz, np. odznaka weryfikacyjna.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Obraz w nagłówku	Opcjonalnie	Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9. Uwaga: zdecydowanie zalecamy dodanie obrazu. Jeśli podasz plakietkę, upewnij się, że u góry i u dołu obrazu znajduje się bezpieczny obszar o wielkości 24 dps.	Wskazówki znajdziesz w sekcji Specyfikacje obrazów.
Popularność – liczba	Opcjonalnie	Podaj liczbę obserwujących lub wartość popularności, np. „3,7 mln”. Uwaga: jeśli podasz zarówno liczbę, jak i wartość liczby, użyta zostanie liczba.	Ciąg znaków Zalecany rozmiar tekstu: maksymalnie 20 znaków w przypadku połączonej liczby i etykiety
Popularność – wartość liczbowa	Opcjonalnie	Liczba obserwujących lub wartość popularności. Uwaga: podaj wartość Count Value, jeśli aplikacja nie ma obsługiwać logiki optymalizacji dużej liczby pod kątem różnych rozmiarów wyświetlacza. Jeśli podasz zarówno liczbę, jak i wartość liczby, zostanie użyta liczba.	Długi
Popularność – etykieta	Opcjonalnie	Określ, czym jest etykieta popularności. Na przykład „Polubienia”.	Ciąg znaków Zalecany rozmiar tekstu: maksymalnie 20 znaków w przypadku liczby i etykiety łącznie
Popularność – wizualna	Opcjonalnie	Określ, do czego służy interakcja. Na przykład obraz przedstawiający ikonę polubienia i emotikony. Możesz przesłać więcej niż 1 obraz, ale nie wszystkie mogą być wyświetlane na urządzeniach o różnych formatach. Uwaga: musi to być obraz kwadratowy o formacie 1:1.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Ocena – wartość maksymalna	Wymagane	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.	Liczba >= 0,0
Ocena – bieżąca wartość	Wymagane	Bieżąca wartość skali ocen. Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalnie	Liczba ocen encji. Uwaga: wypełnij to pole, jeśli aplikacja ma kontrolować sposób wyświetlania tego elementu użytkownikom. Podaj krótki ciąg znaków, który może być wyświetlany użytkownikowi. Jeśli np. liczba wynosi 1 000 000, rozważ użycie skrótu, np. 1 mln, aby nie została obcięta w przypadku mniejszych rozmiarów wyświetlanych elementów.	Ciąg znaków
Ocena – wartość liczby	Opcjonalnie	Liczba ocen encji. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skracania wyświetlania. Jeśli występują zarówno liczba, jak i wartość liczby, użytkownikom wyświetlimy liczbę.	Długi
Lokalizacja – kraj	Opcjonalnie	Kraj, w którym znajduje się dana osoba lub w którym pełni służbę.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – miasto	Opcjonalnie	Miasto, w którym znajduje się dana osoba lub w którym świadczy ona usługi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlanie adresu	Opcjonalnie	Użytkownik zobaczy adres, pod którym znajduje się osoba lub pod którym świadczy ona usługi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalnie	Adres (w stosownych przypadkach) miejsca, w którym znajduje się lub pracuje dana osoba.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalnie	Stan (jeśli ma zastosowanie), w którym znajduje się dana osoba lub w którym pełni służbę.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalnie	Kod pocztowy (w stosownych przypadkach) miejsca, w którym znajduje się dana osoba lub w którym świadczy usługi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – okolica	Opcjonalnie	Dzielnica (w stosownych przypadkach), w której znajduje się osoba lub w której świadczy usługi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Odznaki	Opcjonalnie	Każda plakietka to tekst (maks. 15 znaków) lub mały obraz.
Plakietka – tekst	Opcjonalnie	Tytuł plakietki Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Plakietka – obraz	Opcjonalnie	Mały obraz Specjalne traktowanie pod względem UX, np. nakładka w postaci plakietki na miniaturę obrazu lub filmu. Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący encję. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	Maksymalnie 3 napisy, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecana długość każdego podtytułu: maks. 50 znaków
Kategorie treści	Opcjonalnie	Opisz kategorię treści w jednostce.	Lista kwalifikujących się typów wyliczeniowych TYPE_HEALTH_AND_FITENESS (np. trener jogi lub fitnessu) TYPE_HOME_AND_AUTO (przykład: hydraulik) TYPE_SPORTS (przykład: zawodnik) TYPE_DATING Wskazówki znajdziesz w sekcji Kategoria treści.

`RestaurantReservationEntity`

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do podmiotu w aplikacji dla usługodawców. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Nazwa podmiotu.	Ciąg znaków Zalecany rozmiar tekstu: maks. 50 znaków
Godzina rozpoczęcia rezerwacji	Wymagany	Sygnatura czasowa epoki w milisekundach, kiedy rezerwacja ma się rozpocząć.	Sygnatura czasowa epoki w milisekundach
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świetlanie adresu	Wymagany	Adres restauracji, który będzie wyświetlany użytkownikowi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalnie	Adres pocztowy restauracji (w odpowiednich przypadkach).	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalnie	Stan lub województwo (jeśli ma zastosowanie), w którym znajduje się restauracja.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalnie	Kod pocztowy restauracji (w stosownych przypadkach).	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – okolica	Opcjonalnie	Okolica (w odpowiednich przypadkach), w której znajduje się restauracja.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Obrazy plakatu	Opcjonalnie	Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący encję. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	Maksymalnie 3 napisy, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecana długość każdego podtytułu: maks. 50 znaków
Wielkość tabeli	Opcjonalnie	Liczba osób w grupie rezerwacji	Liczba całkowita > 0

`EventReservationEntity`

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do podmiotu w aplikacji dla usługodawców. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Nazwa podmiotu.	Ciąg znaków Zalecany rozmiar tekstu: maks. 50 znaków
Czas rozpoczęcia	Wymagany	Sygnatura czasowa w formacie epoki, kiedy ma się rozpocząć wydarzenie. Uwaga: ta wartość będzie podana w milisekundach.	Sygnatura czasowa epoki w milisekundach
Tryb zdarzenia	Wymagany	Pole wskazujące, czy wydarzenie będzie wirtualne, stacjonarne czy w obu tych formach.	Enum: 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świetlanie adresu	Wymagane warunkowo	Adres lub nazwa miejsca, w którym odbędzie się wydarzenie, które powinny być wyświetlane użytkownikowi. Uwaga: jest to wymagane w przypadku wydarzeń, które są STACJONARNE lub HYBRYDOWE.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalnie	Adres ulicy (w odpowiednich przypadkach) miejsca, w którym odbywa się wydarzenie.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalnie	Stan lub województwo (jeśli ma zastosowanie), w którym odbywa się wydarzenie.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli występuje) lokalizacji, w której odbywa się wydarzenie.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – okolica	Opcjonalnie	Dzielnica (w stosownych przypadkach), w której odbywa się wydarzenie.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Obrazy plakatu	Opcjonalnie	Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9. Uwaga: zdecydowanie zalecamy dodanie obrazu. Jeśli podasz plakietkę, upewnij się, że u góry i u dołu obrazu znajduje się bezpieczny obszar o wielkości 24 dps.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Czas zakończenia	Opcjonalnie	Sygnatura czasowa w formacie epoki, kiedy wydarzenie ma się zakończyć. Uwaga: ta wartość będzie podana w milisekundach.	Sygnatura czasowa epoki w milisekundach
Dostawca usług – nazwa	Opcjonalnie	Nazwa dostawcy usługi. Uwaga: w przypadku usługodawcy wymagany jest tekst lub obraz.	Dowolny tekst. np. nazwa organizatora wydarzenia lub wycieczki.
Usługodawca – obraz	Opcjonalnie	Logo lub obraz usługodawcy. Uwaga: w przypadku usługodawcy wymagany jest tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący encję. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	Maksymalnie 3 napisy, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecana długość każdego podtytułu: maks. 50 znaków
Odznaki	Opcjonalnie	Każda plakietka to tekst (maks. 15 znaków) lub mały obraz.
Plakietka – tekst	Opcjonalnie	Tytuł plakietki Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Plakietka – obraz	Opcjonalnie	Mały obraz Specjalne traktowanie pod względem UX, np. nakładka w postaci plakietki na miniaturę obrazu lub filmu. Uwaga: w przypadku plakietki wymagany jest tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Identyfikator rezerwacji	Opcjonalnie	Identyfikator rezerwacji biletu na wydarzenie.	Dowolny tekst
Cena - CurrentPrice	Wymagane warunkowo	Obecna cena biletu lub karnetu na wydarzenie. Musisz podać cenę, jeśli podajesz cenę przekreśloną.	Dowolny tekst
Cena – StrikethroughPrice	Opcjonalnie	Pierwotna cena biletu na wydarzenie.	Dowolny tekst
Objaśnienie dotyczące ceny	Opcjonalnie	Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu (jeśli są dostępne).	Dowolny tekst Zalecana długość tekstu: mniej niż 45 znaków (za długi tekst może być wyświetlany z wielokropkiem)
Ocena – wartość maksymalna	Opcjonalnie	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalnie	Bieżąca wartość skali ocen. Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalnie	Liczba ocen wydarzenia. Uwaga: wypełnij to pole, jeśli aplikacja ma kontrolować sposób wyświetlania tego elementu użytkownikom. Podaj krótki ciąg znaków, który może być wyświetlany użytkownikowi. Jeśli np. liczba wynosi 1 000 000, rozważ użycie skrótu, np. 1 mln, aby nie została obcięta w przypadku mniejszych rozmiarów wyświetlanych elementów.	Ciąg znaków
Ocena – wartość liczby	Opcjonalnie	Liczba ocen wydarzenia. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skracania wyświetlania. Jeśli występują zarówno liczba, jak i wartość liczby, użytkownikom wyświetlimy liczbę.	Długi
Kategorie treści	Opcjonalnie	Opisz kategorię treści w jednostce.	Lista kwalifikujących się typów wyliczeniowych TYPE_MOVIES_AND_TV_SHOWS (przykład: kino) TYPE_DIGITAL_GAMES (przykład: e-sport) TYPE_MUSIC (przykład: koncert) TYPE_TRAVEL_AND_LOCAL (przykład: wycieczka, festiwal) TYPE_HEALTH_AND_FITENESS (np. zajęcia z jogi) TYPE_EDUCATION (przykład: zajęcia) TYPE_SPORTS (przykład: mecz piłki nożnej) TYPE_DATING (przykład: spotkanie) Wskazówki znajdziesz w sekcji Kategoria treści.

`LodgingReservationEntity`

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do podmiotu w aplikacji dla usługodawców. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Nazwa podmiotu.	Dowolny tekst. Na przykład „Twój pobyt od 12 grudnia”. Zalecany rozmiar tekstu: maks. 50 znaków
Godzina zameldowania	Wymagany	Sygnatura czasowa epoki w milisekundach, która reprezentuje czas zameldowania w przypadku rezerwacji.	Sygnatura czasowa epoki w milisekundach
Godzina wymeldowania	Wymagany	Sygnatura czasowa epoki w milisekundach, która reprezentuje czas wymeldowania w przypadku rezerwacji.	Sygnatura czasowa epoki w milisekundach
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świetlanie adresu	Wymagany	Adres obiektu noclegowego, który będzie wyświetlany użytkownikowi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalnie	Adres (jeśli dotyczy) obiektu noclegowego.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalnie	Stan lub województwo (jeśli ma zastosowanie), w którym znajduje się obiekt noclegowy.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli występuje) obiektu noclegowego.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja – okolica	Opcjonalnie	Okolica (w odpowiednich przypadkach), w której znajduje się obiekt.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Obrazy plakatu	Opcjonalnie	Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9. Uwaga: jeśli podano plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczna przestrzeń o wielkości 24 dp.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący encję. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	Maksymalnie 3 napisy, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecana długość każdego podtytułu: maks. 50 znaków
Identyfikator rezerwacji	Opcjonalnie	Identyfikator rezerwacji obiektu noclegowego.	Dowolny tekst
Ocena – wartość maksymalna	Opcjonalnie	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też aktualną ocenę.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalnie	Bieżąca wartość skali ocen. Musisz podać tę wartość, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalnie	Liczba ocen obiektu. Uwaga: wypełnij to pole, jeśli aplikacja ma kontrolować sposób wyświetlania tego elementu użytkownikom. Podaj krótki ciąg znaków, który może być wyświetlany użytkownikowi. Jeśli np. liczba wynosi 1 000 000, rozważ użycie skrótu, np. 1 mln, aby nie została obcięta w przypadku mniejszych rozmiarów wyświetlanych elementów.	Ciąg znaków
Ocena – wartość liczby	Opcjonalnie	Liczba ocen obiektu. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skracania wyświetlania. 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ć cenę, jeśli podasz cenę przekreśloną.	Dowolny tekst
Cena – StrikethroughPrice	Opcjonalnie	Pierwotna cena obiektu noclegowego, która będzie przekreślona w interfejsie.	Dowolny tekst
Objaśnienie dotyczące ceny	Opcjonalnie	Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu (jeśli są dostępne).	Dowolny tekst Zalecana długość tekstu: mniej niż 45 znaków (za długi tekst może być wyświetlany z wielokropkiem)

`TransportationReservationEntity`

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do podmiotu w aplikacji dla usługodawców. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Nazwa podmiotu.	Dowolny tekst. Na przykład „SFO to SAN”. Zalecany rozmiar tekstu: maks. 50 znaków
Rodzaj transportu	Wymagany	Rodzaj/tryb środka transportu w rezerwacji.	Enum: FLIGHT, TRAIN, BUS lub FERRY
Godzina odjazdu	Wymagany	Sygnatura czasowa epoki w milisekundach, która reprezentuje czas odjazdu.	Sygnatura czasowa epoki w milisekundach
Godzina przyjazdu	Wymagany	Sygnatura czasowa epoki w milisekundach, która reprezentuje czas przyjazdu.	Sygnatura czasowa epoki w milisekundach
Miejsce wyjazdu – kraj	Opcjonalnie	Kraj wyjazdu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce wylotu – miasto	Opcjonalnie	Miasto wylotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce wylotu – wyświetlany adres	Opcjonalnie	Miejsce wylotu, które będzie wyświetlane użytkownikowi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce wylotu – adres	Opcjonalnie	Adres (jeśli dotyczy) miejsca wylotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja wyjazdu/wylotu – stan	Opcjonalnie	Województwo (lub jego odpowiednik w innych krajach), w którym znajduje się miejsce wylotu (jeśli ma zastosowanie).	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce wylotu – kod pocztowy	Opcjonalnie	Kod pocztowy (w odpowiednich przypadkach) miejsca wylotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja początkowa – okolica	Opcjonalnie	Okolica (jeśli dotyczy) miejsca wylotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja przyjazdu – kraj	Opcjonalnie	Kraj przyjazdu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja przylotu – miasto	Opcjonalnie	Miasto docelowe.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce docelowe – wyświetlany adres	Opcjonalnie	Miejsce docelowe, które będzie wyświetlane użytkownikowi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce docelowe – ulica i numer	Opcjonalnie	Adres (jeśli dotyczy) miejsca docelowego.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja docelowa – stan	Opcjonalnie	Województwo lub jego odpowiednik w innym kraju (jeśli ma zastosowanie), w którym znajduje się miejsce docelowe.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Miejsce docelowe – kod pocztowy	Opcjonalnie	Kod pocztowy (w odpowiednich przypadkach) miejsca docelowego.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Lokalizacja docelowa – dzielnica	Opcjonalnie	Okolica (w odpowiednich przypadkach) miejsca docelowego.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Dostawca usług – nazwa	Opcjonalnie	Nazwa dostawcy usługi. Uwaga: w przypadku usługodawcy wymagany jest tekst lub obraz.	Dowolny tekst. Na przykład nazwa linii lotniczych
Usługodawca – obraz	Opcjonalnie	Logo lub obraz usługodawcy. Uwaga: w przypadku usługodawcy wymagany jest tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Obrazy plakatu	Opcjonalnie	Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący encję. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	Maksymalnie 3 napisy, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecana długość każdego podtytułu: maks. 50 znaków
Identyfikator rezerwacji	Opcjonalnie	Identyfikator rezerwacji środka transportu.	Dowolny tekst
Cena - CurrentPrice	Wymagane warunkowo	Obecna cena rezerwacji. Musisz podać cenę, jeśli podasz cenę przekreśloną.	Dowolny tekst
Cena – StrikethroughPrice	Opcjonalnie	Pierwotna cena rezerwacji, która jest przekreślona w interfejsie.	Dowolny tekst
Objaśnienie dotyczące ceny	Opcjonalnie	Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu (jeśli są dostępne).	Dowolny tekst Zalecana długość tekstu: mniej niż 45 znaków (za długi tekst może być wyświetlany z wielokropkiem)
Numer transportu	Wymagane	Numer lotu, autobusu, pociągu lub promu/statku wycieczkowego.	Dowolny tekst
Godzina wejścia na pokład	Wymagane	Sygnatura czasowa epoki reprezentująca czas wejścia na pokład w przypadku rezerwacji (jeśli dotyczy).	Sygnatura czasowa epoki w milisekundach

`VehicleRentalReservationEntity`

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do podmiotu w aplikacji dla usługodawców. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Nazwa podmiotu.	Dowolny tekst. Na przykład „Avis Union Square SF” Zalecany rozmiar tekstu: maks. 50 znaków
Godzina odbioru	Wymagany	Sygnatura czasowa epoki reprezentująca godzinę odbioru w przypadku rezerwacji.	Sygnatura czasowa epoki w milisekundach
Pora powrotu	Opcjonalnie	Sygnatura czasowa epoki reprezentująca czas wymeldowania z rezerwacji.	Sygnatura czasowa epoki w milisekundach
Adres odbioru – kraj	Opcjonalnie	Kraj miejsca odbioru.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – miasto	Opcjonalnie	Miasto, w którym znajduje się miejsce odbioru.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – wyświetlany adres	Opcjonalnie	Miejsce odbioru, które będzie wyświetlane użytkownikowi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – ulica	Opcjonalnie	Adres (jeśli dotyczy) miejsca odbioru.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – stan	Opcjonalnie	Województwo (lub jego odpowiednik w innych krajach), w którym znajduje się miejsce odbioru (jeśli ono występuje).	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli występuje) miejsca odbioru.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres odbioru – dzielnica	Opcjonalnie	Okolica (w odpowiednich przypadkach), w której znajduje się miejsce odbioru.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – kraj	Opcjonalnie	Kraj lokalizacji zwrotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – miasto	Opcjonalnie	Miasto lokalizacji zwrotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – wyświetlany adres	Opcjonalnie	Lokalizacja zwrotu, która będzie wyświetlana użytkownikowi.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – adres	Opcjonalnie	Adres (jeśli dotyczy) lokalizacji zwrotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – stan	Opcjonalnie	Województwo lub jego odpowiednik w innym kraju (jeśli ma zastosowanie), w którym znajduje się lokalizacja zwrotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – kod pocztowy	Opcjonalnie	Kod pocztowy (w odpowiednich przypadkach) lokalizacji zwrotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Adres zwrotny – dzielnica	Opcjonalnie	Okolica (w stosownych przypadkach) lokalizacji zwrotu.	Dowolny tekst Zalecana długość tekstu: maks. ok. 20 znaków
Dostawca usług – nazwa	Opcjonalnie	Nazwa dostawcy usługi. Uwaga: w przypadku usługodawcy wymagany jest tekst lub obraz.	Dowolny tekst. Na przykład „Wypożyczalnia samochodów Avis”.
Usługodawca – obraz	Opcjonalnie	Logo lub obraz usługodawcy. Uwaga: w przypadku usługodawcy wymagany jest tekst lub obraz.	Wskazówki znajdziesz w sekcji Specyfikacja obrazu.
Obrazy plakatu	Opcjonalnie	Jeśli podasz kilka obrazów, wyświetlimy tylko 1. Zalecany format obrazu to 16:9.	Wskazówki znajdziesz w sekcji Specyfikacje obrazów.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący encję. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	Maksymalnie 3 napisy, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi będzie wyświetlana lista opisów lub lista napisów, ale nie obie jednocześnie.	Dowolny tekst Zalecana długość każdego podtytułu: maks. 50 znaków
Identyfikator potwierdzenia	Opcjonalnie	Identyfikator potwierdzenia rezerwacji wypożyczenia pojazdu.	Dowolny tekst
Cena - CurrentPrice	Wymagane warunkowo	Obecna cena rezerwacji. Musisz podać cenę, jeśli podasz cenę przekreśloną.	Dowolny tekst
Cena – StrikethroughPrice	Opcjonalnie	Pierwotna cena rezerwacji, która jest przekreślona w interfejsie.	Dowolny tekst
Objaśnienie dotyczące ceny	Opcjonalnie	Wywołanie ceny, aby wyróżnić promocję, wydarzenie lub rabat dla uczestników programu (jeśli są dostępne).	Dowolny tekst Zalecana długość tekstu: mniej niż 45 znaków (za długi tekst może być wyświetlany z wielokropkiem)

Specyfikacja obrazu

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

Format obrazu	Minimalny rozmiar w pikselach	Zalecany rozmiar w pikselach
Kwadrat (1:1) Preferowane	300 x 300	1200 x 1200
Poziomy (1,91 x 1)	600 x 314	1200 x 628
Orientacja pionowa (4x5)	480 x 600	960 x 1200

Format obrazu

Minimalny rozmiar w pikselach

Zalecany rozmiar w pikselach

Kwadrat (1:1)

Preferowane

300 x 300

1200 x 1200

Poziomy (1,91 x 1)

600 x 314

1200 x 628

Orientacja pionowa (4x5)

480 x 600

960 x 1200

Obrazy muszą być hostowane w publicznych sieciach CDN, aby Google mogło 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żyj przezroczystego tła, aby obraz mógł być prawidłowo wyświetlany w ustawieniach motywu ciemnego i jasnego.

Kategoria treści

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

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

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

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

Niektóre typy obiektów, takie jak ArticleEntity i GenericFeaturedEntity, mogą używać dowolnej kategorii treści. W przypadku innych 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 jednostki zamiast kombinacji jednostek ogólnych i kategorii treści:
- TYPE_MOVIES_AND_TV_SHOWS – przed użyciem ogólnych elementów zapoznaj się z elementami z przewodnika po integracji z zegarkiem.
- TYPE_BOOKS – przed użyciem ogólnych elementów sprawdź EbookEntity.
- TYPE_AUDIOBOOKS – sprawdź AudiobookEntity przed użyciem ogólnych elementów.
- TYPE_SHOPPING – sprawdź ShoppingEntity przed użyciem ogólnych elementów.
- TYPE_FOOD_AND_DRINK – przed użyciem ogólnych elementów sprawdź elementy 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. Najtrafniejsza kategoria treści powinna być pierwsza na liście.

Krok 2. Podaj dane klastra

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

AppEngagePublishClient odpowiada za publikowanie klastrów.

Do publikowania klastrów w kliencie służą te interfejsy API:

isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishContinuationCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteContinuationCluster
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 i nowszej (zalecane)

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 wyliczenia 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
Grupa koszyków na zakupy	`TYPE_SHOPPING_CART`	4
Grupa „Zamów ponownie” dotycząca jedzenia	`TYPE_FOOD_REORDER`	5
Grupa „Koszyk na zakupy – jedzenie”	`TYPE_FOOD_SHOPPING_CART`	6
Grupa „Lista zakupów – jedzenie”	`TYPE_FOOD_SHOPPING_LIST`	7
Klaster zarządzania użytkownikami	`TYPE_ENGAGEMENT`	8
Grupa „Lista zakupów”	`TYPE_SHOPPING_LIST`	9
Grupa „Ponowne zamówienie w Zakupach”	`TYPE_SHOPPING_REORDER`	10
Grupa „Śledzenie zamówień”	`TYPE_SHOPPING_ORDER_TRACKING`	11
Klaster subskrypcji	`TYPE_SUBSCRIPTION`	12
Kontynuuj wyszukiwanie klastra	`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 okresowo włącza i wyłącza usługę Engage, aby zmniejszyć koszty wyświetlania reklam. Ta strategia sporadycznego przetwarzania treści, choć możliwa, negatywnie wpływa na użytkownika i usługę – 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 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. Kontynuuj czytanie i Rezerwacje) będą nadal włączone zgodnie z domyślną konfiguracją, 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, skontaktuj się z nami, wysyłając e-maila 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 działania:

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

W przypadku błędu całe żądanie jest odrzucane, 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 działania:

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

W przypadku błędu całe żądanie jest odrzucane, a dotychczasowy stan jest zachowywany.

`publishContinuationCluster`

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

Kotlin

client.publishContinuationCluster(
    PublishContinuationClusterRequest.Builder()
      .setContinuationCluster(
        ContinuationCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

Java

client.publishContinuationCluster(
            new PublishContinuationClusterRequest.Builder()
                .setContinuationCluster(
                    new ContinuationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

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

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

W przypadku błędu całe żądanie jest odrzucane, a dotychczasowy stan jest zachowywany.

`publishUserAccountManagementRequest`

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

Karta logowania zawiera te metadane:

Atrybut	Wymaganie	Opis
Identyfikator URI działania	Wymagane	Precyzyjny link do działania (np. przenosi na stronę logowania do aplikacji)
Obraz	Opcjonalny – jeśli nie zostanie podany, należy podać tytuł	Obraz wyświetlany na karcie Obrazy o formacie 16:9 i rozdzielczości 1264 x 712
Tytuł	Opcjonalny – jeśli nie zostanie podany, należy podać obraz	Tytuł na karcie
Tekst działania	Opcjonalnie	Tekst wyświetlany w wezwaniu do działania (np. Zaloguj się)
Podtytuł	Opcjonalnie	Opcjonalny podtytuł na karcie

Kotlin

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

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

Java

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

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

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

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

W przypadku błędu całe żądanie jest odrzucane, a dotychczasowy stan jest zachowywany.

`updatePublishStatus`

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

Podawanie stanu we wszystkich scenariuszach, nawet gdy treść jest opublikowana (STATUS == PUBLISHED), jest kluczowe do wypełniania paneli, które używają tego stanu do przekazywania informacji o kondycji i innych danych integracji.
Jeśli żadne treści nie są publikowane, ale stan integracji nie jest przerwany (STATUS == NOT_PUBLISHED), Google może uniknąć wywoływania alertów na panelach stanu aplikacji. Potwierdza, że treści nie są publikowane z powodu przewidywanej sytuacji z punktu widzenia dostawcy.
Pomaga deweloperom 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ł wyświetlać jej zawartość lub rozwiązywać problemy.

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

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

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

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

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

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

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

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

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

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

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

Kotlin

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

Java

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

`deleteRecommendationClusters`

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

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

Gdy usługa otrzyma prośbę, usunie dotychczasowe dane z klastrów rekomendacji. W przypadku błędu całe żądanie zostanie odrzucone i zachowany zostanie 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 żądanie, usunie dotychczasowe dane z wyróżnionego klastra. W przypadku błędu całe żądanie jest odrzucane, a dotychczasowy stan pozostaje bez zmian.

`deleteContinuationCluster`

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

Kotlin

client.deleteContinuationCluster()

Java

client.deleteContinuationCluster();

Gdy usługa otrzyma żądanie, usunie istniejące dane z klastra kontynuacji. W przypadku błędu całe żądanie zostanie odrzucone i zachowany zostanie 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 żądanie, usunie istniejące dane z klastra UserAccountManagement. W przypadku błędu całe żądanie jest odrzucane, a dotychczasowy stan jest zachowywany.

`deleteClusters`

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

Kotlin

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

Java

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

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

Obsługa błędów

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

Kotlin

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

Java

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

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

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

Krok 3. Obsługa intencji transmisji

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

Celem intencji rozgłaszania jest głównie ponowna aktywacja aplikacji i wymuszenie synchronizacji danych. Intencje rozgłaszania 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 continuation cluster publish when PUBLISH_CONTINUATION broadcast is
  // received
}

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

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(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(Intents.ACTION_PUBLISH_FEATURED),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION),
                           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 continuation cluster publish when PUBLISH_CONTINUATION 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 Continuation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);
}

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

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

Usługa wysyła te intencje:

com.google.android.engage.action.PUBLISH_RECOMMENDATION Zalecamy rozpoczęcie połączenia publishRecommendationClusters po otrzymaniu tego zamiaru.
com.google.android.engage.action.PUBLISH_FEATURED Zalecamy rozpoczęcie połączenia publishFeaturedCluster po otrzymaniu tego zamiaru.
com.google.android.engage.action.PUBLISH_CONTINUATION Zalecamy rozpoczęcie połączenia publishContinuationCluster po otrzymaniu tego zamiaru.

Przepływ pracy integracji

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

Najczęstsze pytania

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

Kontakt

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

Dalsze kroki

Po zakończeniu integracji wykonaj te czynności:

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

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

Szczegóły integracji

Terminologia

Przygotowanie

Podsumowanie

Krok 1. Podaj dane podmiotu

GenericFeaturedEntity

ArticleEntity

EventEntity

LodgingEntity

StoreEntity

PointOfInterestEntity

PersonEntity

RestaurantReservationEntity

EventReservationEntity

LodgingReservationEntity

TransportationReservationEntity

VehicleRentalReservationEntity

Specyfikacja obrazu

Kategoria treści

Krok 2. Podaj dane klastra

isServiceAvailable

W przypadku pakietu Engage SDK w wersji 1.6.0 i 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

publishContinuationCluster

Kotlin

Java

publishUserAccountManagementRequest

Kotlin

Java

updatePublishStatus

Kotlin

Java

deleteRecommendationClusters

Kotlin

Java

deleteFeaturedCluster

Kotlin

Java

deleteContinuationCluster

Kotlin

Java

deleteUserManagementCluster

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 inne branże: instrukcje integracji technicznej firm zewnętrznych

`GenericFeaturedEntity`

`ArticleEntity`

`EventEntity`

`LodgingEntity`

`StoreEntity`

`PointOfInterestEntity`

`PersonEntity`

`RestaurantReservationEntity`

`EventReservationEntity`

`LodgingReservationEntity`

`TransportationReservationEntity`

`VehicleRentalReservationEntity`

`isServiceAvailable`

`publishRecommendationClusters`

`publishFeaturedCluster`

`publishContinuationCluster`

`publishUserAccountManagementRequest`

`updatePublishStatus`

`deleteRecommendationClusters`

`deleteFeaturedCluster`

`deleteContinuationCluster`

`deleteUserManagementCluster`

`deleteClusters`