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 integracji nowych treści, takich jak rezerwacje, wydarzenia, zakwaterowanie, ciekawe miejsca, osoby i inne treści, które mogą nie należeć do żadnej z tych kategorii.

Umiejętności związane z Androidem

Wyświetl na GitHubie

Integracja z pakietem Engage SDK

Użyj umiejętności Androida w pakiecie Engage SDK, aby zintegrować i debugować implementację oraz rozwiązywać problemy z nią związane.

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

android skills add engage-sdk-integration

Szczegóły integracji

W tej sekcji opisujemy kroki, modele danych i terminologię wymagane do integracji z pakietem Engage SDK w przypadku innych kategorii treści.

Terminologia

Ta integracja obejmuje 3 typy klastrów: Rekomendacja, Polecane 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 dewelopera.

  • ArticleEntity: ArticleEntity, który reprezentuje tekstową rekomendację treści pasujących do więcej niż 1 kategorii. Element ArticleEntity umożliwia deweloperom dostarczanie różnych 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. Np. treści marketingowe, fragment wiadomości

    

    Ilustracja 1. Interfejs przedstawiający pojedynczy element ArticleEntity w klastrze rekomendacji.

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

    

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

  • LodgingEntity: LodgingEntity reprezentuje zakwaterowanie, takie jak hotel, mieszkanie czy dom wakacyjny, na wynajem krótko- i długoterminowy.

    

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

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

    

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

  • PointOfInterestEntity: PointOfInterestEntity reprezentuje interesujące miejsce, takie jak stacja benzynowa, miejsce wydarzenia, park rozrywki, muzeum, atrakcja turystyczna, szlak pieszy itp. Wyróżnia treści, w których lokalizacja jest kluczową informacją, którą należy przekazać użytkownikom. Nie powinien być używany do noclegów, jako sklep ani lokal gastronomiczny.

    

    Rysunek 5. Interfejs przedstawiają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.

    

    Rysunek 5. Interfejs pokazujący pojedynczy element PersonEntity w klastrze rekomendacji.

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

  Treści kontynuacyjne mogą mieć następującą strukturę:

  • ArticleEntity: ArticleEntity, który reprezentuje tekstową rekomendację treści pasujących do więcej niż 1 kategorii. Ta encja może służyć do reprezentowania niedokończonych artykułów z wiadomościami lub innych treści, które użytkownik chciałby dalej czytać od miejsca, w którym przerwał. Np. treści marketingowe, fragment wiadomości

    

    Rysunek 6. Interfejs użytkownika wyświetlający pojedynczy element ArticleEntity w grupie Kontynuacja.

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

    

    Rysunek 7. Interfejs użytkownika wyświetlający pojedynczy element RestaurantReservationEntity w klastrze kontynuacji.

  • EventReservationEntity: EventReservationEntity reprezentuje rezerwację na wydarzenie i pomaga użytkownikom śledzić nadchodzące lub trwające rezerwacje na wydarzenia. Zdarzenia mogą obejmować m.in.:

    • wydarzenia sportowe, np. rezerwacja biletu na mecz piłki nożnej;
    • wydarzenia związane z grami, np. rezerwacja na e-sport;
    • wydarzenia rozrywkowe, takie jak rezerwacja biletów do kina, na koncert, do teatru czy na spotkanie autorskie;
    • rezerwacje podróży lub atrakcji, np. wycieczek z przewodnikiem, biletów do muzeum;
    • rezerwacje na spotkania towarzyskie, seminaria i konferencje;
    • Rezerwacje sesji edukacyjnych / szkoleniowych

    

    Rysunek 8. Interfejs pokazujący pojedynczy element EventReservationEntity w grupie Kontynuacja.

  • LodgingReservationEntity: LodgingEntityReservation reprezentuje rezerwację zakwaterowania 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 Kontynuacja.

  • TransportationReservationEntity: TransportationReservationEntity reprezentuje rezerwację transportu dowolnym środkiem i pomaga użytkownikom śledzić rezerwacje nadchodzących lub trwających lotów, rejsów promem, przejazdów pociągiem, autobusem, prywatnych przejazdów lub rejsów wycieczkowych.

    

    Rysunek 10. Interfejs użytkownika wyświetlający pojedynczy element TransportationReservationEntity w grupie Kontynuacja.

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

    

    Rysunek 11. Interfejs pokazujący pojedynczy obiekt VehicleRentalReservationEntity w klastrze kontynuacji.

• Grupa Polecane to widok interfejsu, który zawiera wybrane elementy GenericFeaturedEntity 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ć pojedynczy element obsługiwanego typu w sekcji Polecane, przy czym w klastrze Polecane może znajdować się wiele elementów (potencjalnie różnych typów) od wielu deweloperów aplikacji.

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

    

    Ilustracja 12. Interfejs pokazujący pojedynczą kartę 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 opublikować, podlegają tym limitom w przypadku różnych typów klastrów:

Typ klastra	Limity klastra	Minimalne limity elementów 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 (ArticleEntity, EventReservationEntity, LodgingReservationEntity, TransportationReservationEntity lub VehicleRentalReservationEntity)
Polecana grupa	Maksymalnie 1	Co najmniej 1	Maksymalnie 20 (GenericFeaturedEntity)

Krok 1. Podaj dane podmiotu

Pakiet SDK definiuje różne encje reprezentujące poszczególne typy produktów. W przypadku kategorii „Inne” obsługujemy te encje:

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

Poniższe tabele zawierają dostępne atrybuty i wymagania dotyczące każdego typu.

GenericFeaturedEntity

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do elementu w aplikacji dostawcy. 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 z nich. Zalecany format obrazu to 16:9. Uwaga: jeśli podano plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczny obszar o szerokości 24 dp.	Wskazówki znajdziesz w specyfikacji obrazu.
Tytuł	Opcjonalny	Tytuł podmiotu.	Dowolny tekst Zalecany rozmiar tekstu: 50 znaków
Opis	Opcjonalny	Pojedynczy akapit tekstu opisujący encję. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecana długość tekstu: 180 znaków
Lista napisów	Opcjonalny	Maksymalnie 3 podtytuły, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Plakietki	Opcjonalny	Każda plakietka to dowolny tekst (maks. 15 znaków) lub mały obraz. Specjalne traktowanie UX na obrazie lub filmie, na przykład jako nakładka plakietki na obrazie „Aktualizacja na żywo” Czas czytania artykułu
Plakietka – tekst	Opcjonalny	Tytuł plakietki Uwaga: plakietka musi zawierać tekst lub obraz.	Dowolny tekst Zalecane rozmiary tekstu: maks. 15 znaków
Plakietka – obraz	Opcjonalny	Mały obraz Specjalne traktowanie pod kątem wygody użytkownika, np. plakietka na miniaturze obrazu lub filmu. Uwaga: plakietka musi zawierać tekst lub obraz.	Wskazówki znajdziesz w specyfikacji 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.

ArticleEntity

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do elementu w aplikacji dostawcy. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Tytuł podmiotu.	Dowolny tekst Zalecana długość tekstu: maks. 50 znaków
Obrazy plakatu	Opcjonalny	Jeśli podasz kilka obrazów, wyświetlimy tylko 1 z nich. Zalecany format obrazu to 16:9. Uwaga: zdecydowanie zalecamy dodanie obrazu. Jeśli podano plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczny obszar o wielkości 24 dp.	Wskazówki znajdziesz w specyfikacji obrazu.
Źródło – tytuł	Opcjonalny	Imię i nazwisko autora, nazwa organizacji lub imię i nazwisko reportera	Dowolny tekst Zalecany rozmiar tekstu: poniżej 25 znaków
Źródło – obraz	Opcjonalny	obraz źródła, np. autora, organizacji, reportera;	Wskazówki znajdziesz w specyfikacji obrazu.
Opis	Opcjonalny	Pojedynczy akapit tekstu opisujący encję. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecana długość tekstu: 180 znaków
Lista napisów	Opcjonalny	Maksymalnie 3 podtytuły, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Plakietki	Opcjonalny	Każda plakietka to dowolny tekst (maks. 15 znaków) lub mały obraz. Specjalne traktowanie UX na obrazie lub filmie, na przykład jako nakładka plakietki na obrazie „Aktualizacja na żywo” Czas czytania artykułu
Plakietka – tekst	Opcjonalny	Tytuł plakietki Uwaga: plakietka musi zawierać tekst lub obraz.	Dowolny tekst Zalecane rozmiary tekstu: maks. 15 znaków
Plakietka – obraz	Opcjonalny	Mały obraz Specjalne traktowanie pod kątem wygody użytkownika, np. plakietka na miniaturze obrazu lub filmu. Uwaga: plakietka musi zawierać tekst lub obraz.	Wskazówki znajdziesz w specyfikacji obrazu.
Czas publikacji treści	Opcjonalny	Jest to sygnatura czasowa epoki w milisekundach, która wskazuje, kiedy treść została opublikowana lub zaktualizowana w aplikacji.	Sygnatura czasowa epoki w milisekundach
Czas ostatniego zaangażowania	Wymagane warunkowo	Sygnatura czasowa epoki w milisekundach, kiedy użytkownik ostatnio wszedł w interakcję z tym elementem. Uwaga: to pole jest wymagane, jeśli ta encja jest częścią klastra kontynuacji.	Sygnatura czasowa epoki w milisekundach
Procent postępu	Wymagane warunkowo	Odsetek pełnej treści wykorzystanej przez użytkownika do tej pory. Uwaga: to pole jest wymagane, jeśli ta encja jest częścią klastra kontynuacji.	Wartość 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.

EventEntity

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do elementu w aplikacji dostawcy. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Tytuł podmiotu.	Ciąg znaków Zalecana długość tekstu: maks. 50 znaków
Czas rozpoczęcia	Wymagany	Sygnatura czasowa epoki, kiedy wydarzenie ma się rozpocząć. Uwaga: ta wartość jest podawana w milisekundach.	Sygnatura czasowa epoki w milisekundach
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 z nich. Zalecany format obrazu to 16:9. Uwaga: zdecydowanie zalecamy dodanie obrazu. Jeśli podano plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczny obszar o wielkości 24 dp.	Wskazówki znajdziesz w specyfikacji obrazu.
Lokalizacja – kraj	Wymagane warunkowo	Kraj, w którym odbywa się wydarzenie. Uwaga: jest to wymagane w przypadku wydarzeń, które są IN_PERSON lub HYBRID.	Dowolny tekst Zalecany rozmiar 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ą IN_PERSON lub HYBRID.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlany adres	Wymagane warunkowo	Adres lub nazwa miejsca, w którym odbędzie się wydarzenie, które powinno być wyświetlane użytkownikowi. Uwaga: jest to wymagane w przypadku wydarzeń, które są IN_PERSON lub HYBRID.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalny	Adres (jeśli dotyczy) miejsca, w którym odbywa się wydarzenie.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalny	Stan lub prowincja (jeśli dotyczy), w której odbywa się wydarzenie.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalny	Kod pocztowy (w stosownych przypadkach) lokalizacji, w której odbywa się wydarzenie.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – dzielnica	Opcjonalny	Dzielnica (jeśli dotyczy), w której odbywa się wydarzenie.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Czas zakończenia	Opcjonalny	Sygnatura czasowa epoki, kiedy zdarzenie ma się zakończyć. Uwaga: ta wartość jest podawana w milisekundach.	Sygnatura czasowa epoki w milisekundach
Opis	Opcjonalny	Pojedynczy akapit tekstu opisujący encję. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecana długość tekstu: 180 znaków
Lista napisów	Opcjonalny	Maksymalnie 3 podtytuły, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Plakietki	Opcjonalny	Każda plakietka to dowolny tekst (maks. 15 znaków) lub mały obraz.
Plakietka – tekst	Opcjonalny	Tytuł plakietki Uwaga: plakietka musi zawierać tekst lub obraz.	Dowolny tekst Zalecane rozmiary tekstu: maks. 15 znaków
Plakietka – obraz	Opcjonalny	Mały obraz Specjalne traktowanie pod kątem wygody użytkownika, np. plakietka na miniaturze obrazu lub filmu. Uwaga: plakietka musi zawierać tekst lub obraz.	Wskazówki znajdziesz w specyfikacji obrazu.
Cena – CurrentPrice	Wymagane warunkowo	Aktualna cena biletu lub karnetu na wydarzenie. Należy podać, jeśli podano przekreśloną cenę.	Dowolny tekst
Price - StrikethroughPrice	Opcjonalny	Pierwotna cena biletu lub karnetu na wydarzenie.	Dowolny tekst
Objaśnienie ceny	Opcjonalny	Objaśnienie 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 (przykład: wycieczka, festiwal) TYPE_HEALTH_AND_FITENESS (np. zajęcia z jogi) TYPE_EDUCATION (przykład: klasa) TYPE_SPORTS (przykład: mecz piłki nożnej) TYPE_DATING (przykład: spotkanie) Wskazówki znajdziesz w sekcji dotyczącej kategorii treści.

LodgingEntity

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do elementu w aplikacji dostawcy. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Tytuł podmiotu.	Ciąg znaków Zalecana długość tekstu: maks. 50 znaków
Obrazy plakatu	Wymagany	Jeśli podasz kilka obrazów, wyświetlimy tylko 1 z nich. Zalecany format obrazu to 16:9. Uwaga: jeśli podano plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczny obszar o szerokości 24 dp.	Wskazówki znajdziesz w specyfikacji obrazu.
Lokalizacja – kraj	Wymagany	Kraj, w którym znajduje się miejsce zakwaterowania.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – miasto	Wymagany	Miasto, w którym znajduje się miejsce zakwaterowania.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlany adres	Wymagany	Adres miejsca zakwaterowania, który będzie wyświetlany użytkownikowi.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalny	Adres (jeśli dotyczy) miejsca zakwaterowania.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalny	Stan lub województwo (jeśli dotyczy), w którym znajduje się miejsce zakwaterowania.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalny	Kod pocztowy (jeśli dotyczy) miejsca zakwaterowania.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – dzielnica	Opcjonalny	Dzielnica (jeśli dotyczy), w której znajduje się kwatera.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Plakietki	Opcjonalny	Każda plakietka to dowolny tekst (maks. 15 znaków) lub mały obraz.
Plakietka – tekst	Opcjonalny	Tytuł plakietki Uwaga: plakietka musi zawierać tekst lub obraz.	Dowolny tekst Zalecane rozmiary tekstu: maks. 15 znaków
Plakietka – obraz	Opcjonalny	Mały obraz Specjalne traktowanie pod kątem wygody użytkownika, np. plakietka na miniaturze obrazu lub filmu. Uwaga: plakietka musi zawierać tekst lub obraz.	Wskazówki znajdziesz w specyfikacji obrazu.
Opis	Opcjonalny	Pojedynczy akapit tekstu opisujący encję. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecana długość tekstu: 180 znaków
Lista napisów	Opcjonalny	Maksymalnie 3 podtytuły, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
AvailabilityTimeWindow - Start Time	Opcjonalny	Sygnatura czasowa epoki w milisekundach, kiedy miejsce zakwaterowania ma być otwarte/dostępne.	Sygnatura czasowa epoki w milisekundach
AvailabilityTimeWindow - End Time	Opcjonalny	Sygnatura czasowa epoki w milisekundach, do której kwatera ma być otwarta/dostępna.	Sygnatura czasowa epoki w milisekundach
Ocena – wartość maksymalna	Opcjonalny	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też bieżącą wartość oceny.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalny	Bieżąca wartość skali ocen. Należy podać, jeśli podano też maksymalną wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalny	Liczba ocen miejsca zakwaterowania. 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 – liczba ocen	Opcjonalny	Liczba ocen miejsca zakwaterowania. Uwaga: wypełnij to pole, jeśli nie obsługujesz samodzielnie logiki wyświetlania skrótu. Jeśli podane są zarówno liczba, jak i wartość liczbowa, użytkownikom wyświetlana jest liczba.	Długi
Cena – CurrentPrice	Wymagane warunkowo	Aktualna cena noclegu. Jeśli podano przekreśloną cenę, należy podać tę wartość.	Dowolny tekst
Price - StrikethroughPrice	Opcjonalny	Pierwotna cena miejsca zakwaterowania, która jest przekreślona w interfejsie.	Dowolny tekst
Objaśnienie ceny	Opcjonalny	Objaśnienie 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)

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 specyfikacji obrazu.
Identyfikator URI działania	Wymagany	Precyzyjny link do elementu w aplikacji dostawcy. 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	Objaśnienie dotyczące promocji, wydarzenia lub aktualizacji 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)
Callout fine print	Opcjonalny	Tekst objaśnienia zapisany drobnym drukiem.	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)
Ocena – wartość maksymalna	Opcjonalny	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też bieżącą wartość oceny.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalny	Bieżąca wartość skali ocen. Należy podać, jeśli podano też maksymalną wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalny	Liczba ocen miejsca zakwaterowania. 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 – liczba ocen	Opcjonalny	Liczba ocen miejsca zakwaterowania. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skrótu wyświetlania. Jeśli podane są 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 elementu w aplikacji dostawcy. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Tytuł podmiotu.	Ciąg znaków Zalecana długość tekstu: maks. 50 znaków
Obrazy plakatu	Wymagany	Jeśli podasz kilka obrazów, wyświetlimy tylko 1 z nich. Zalecany format obrazu to 16:9. Uwaga: zdecydowanie zalecamy dodanie obrazu. Jeśli podano plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczny obszar o wielkości 24 dp.	Wskazówki znajdziesz w specyfikacji obrazu.
Lokalizacja – kraj	Wymagany	Kraj, w którym znajduje się ciekawe miejsce.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – miasto	Wymagany	Miasto, w którym znajduje się ciekawe miejsce.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlany adres	Wymagany	Adres interesującego miejsca, który będzie wyświetlany użytkownikowi.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalny	Adres (jeśli dotyczy) ciekawego miejsca.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalny	Stan lub prowincja (w odpowiednich przypadkach), w której znajduje się dany punkt orientacyjny.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalny	Kod pocztowy (jeśli dotyczy) ciekawego miejsca.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – dzielnica	Opcjonalny	Okolica (w odpowiednich przypadkach) ciekawego miejsca.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
AvailabilityTimeWindow - Start Time	Opcjonalny	Sygnatura czasowa epoki w milisekundach, gdy punkt zainteresowania powinien być otwarty/dostępny.	Sygnatura czasowa epoki w milisekundach
AvailabilityTimeWindow - End Time	Opcjonalny	Sygnatura czasowa epoki w milisekundach, do której dany punkt zainteresowania powinien być otwarty/dostępny.	Sygnatura czasowa epoki w milisekundach
Plakietki	Opcjonalny	Każda plakietka to dowolny tekst (maks. 15 znaków) lub mały obraz.
Plakietka – tekst	Opcjonalny	Tytuł plakietki Uwaga: plakietka musi zawierać tekst lub obraz.	Dowolny tekst Zalecane rozmiary tekstu: maks. 15 znaków
Plakietka – obraz	Opcjonalny	Mały obraz Specjalne traktowanie pod kątem wygody użytkownika, np. plakietka na miniaturze obrazu lub filmu. Uwaga: plakietka musi zawierać tekst lub obraz.	Wskazówki znajdziesz w specyfikacji obrazu.
Opis	Opcjonalny	Pojedynczy akapit tekstu opisujący encję. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecana długość tekstu: 180 znaków
Lista napisów	Opcjonalny	Maksymalnie 3 podtytuły, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Ocena – wartość maksymalna	Opcjonalny	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też bieżącą wartość oceny.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalny	Bieżąca wartość skali ocen. Należy podać, jeśli podano też maksymalną wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalny	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 – liczba ocen	Opcjonalny	Liczba ocen ciekawego miejsca. Uwaga: wypełnij to pole, jeśli nie obsługujesz samodzielnie logiki wyświetlania skrótów. Jeśli podane są zarówno liczba, jak i wartość liczbowa, użytkownikom wyświetlana jest liczba.	Długi
Cena – CurrentPrice	Wymagane warunkowo	Aktualna cena biletów lub karnetów do ciekawego miejsca. Należy podać, jeśli podano przekreśloną cenę.	Dowolny tekst
Price - StrikethroughPrice	Opcjonalny	Pierwotna cena biletów lub karnetów do ciekawego miejsca.	Dowolny tekst
Objaśnienie ceny	Opcjonalny	Objaśnienie 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 (np. szkoła) TYPE_SPORTS (przykład: stadion) Wskazówki znajdziesz w sekcji dotyczącej kategorii treści.

PersonEntity

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do elementu w aplikacji dostawcy. 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 Zalecana długość tekstu: maks. 50 znaków
Profil – awatar	Wymagany	Zdjęcie profilowe lub awatar użytkownika. Uwaga: musi to być obraz kwadratowy (1:1).	Wskazówki znajdziesz w specyfikacji obrazu.
Profil – dodatkowy tekst	Opcjonalny	Dowolny tekst, np. nick profilu.	Dowolny tekst Zalecany rozmiar tekstu: maks. 15 znaków
Profil – dodatkowe zdjęcie	Opcjonalny	Mały obraz, np. plakietka weryfikacyjna.	Wskazówki znajdziesz w specyfikacji obrazu.
Obraz w nagłówku	Opcjonalny	Jeśli podasz kilka obrazów, wyświetlimy tylko 1 z nich. Zalecany format obrazu to 16:9. Uwaga: zdecydowanie zalecamy dodanie obrazu. Jeśli podano plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczny obszar o wielkości 24 dp.	Wskazówki znajdziesz w specyfikacji obrazu.
Popularność – liczba	Opcjonalny	Podaj liczbę obserwujących lub wartość popularności, na przykład „3,7 mln”. Uwaga: jeśli podasz zarówno liczbę, jak i wartość liczby, użyjemy liczby.	Ciąg znaków Zalecane rozmiary tekstu: maksymalnie 20 znaków (liczba i etykieta łącznie)
Popularność – wartość liczby	Opcjonalny	Liczba obserwujących lub wartość popularności. Uwaga: podaj wartość liczby, jeśli Twoja aplikacja nie chce obsługiwać logiki dotyczącej sposobu optymalizacji dużej liczby pod kątem różnych rozmiarów wyświetlacza. Jeśli podano zarówno liczbę, jak i wartość liczbową, zostanie użyta liczba.	Długi
Popularność – etykieta	Opcjonalny	Wskaż, czym jest etykieta popularności. Na przykład „Polubienia”.	Ciąg znaków Zalecane rozmiary tekstu: maksymalnie 20 znaków (liczba i etykieta łącznie)
Popularność – wizualna	Opcjonalny	Wskaż, do czego służy interakcja. Na przykład obraz przedstawiający ikonę polubienia, emotikon. Możesz przesłać więcej niż 1 obraz, ale nie wszystkie mogą być wyświetlane na wszystkich formatach. Uwaga: musi to być obraz kwadratowy (1:1).	Wskazówki znajdziesz w specyfikacji obrazu.
Ocena – wartość maksymalna	Wymagane	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też bieżącą wartość oceny.	Liczba >= 0,0
Ocena – bieżąca wartość	Wymagane	Bieżąca wartość skali ocen. Należy podać, jeśli podano też maksymalną wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalny	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 – liczba ocen	Opcjonalny	Liczba ocen encji. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skrótu wyświetlania. Jeśli podane są zarówno liczba, jak i wartość liczby, użytkownikom wyświetlimy liczbę.	Długi
Lokalizacja – kraj	Opcjonalny	Kraj, w którym dana osoba przebywa lub pełni służbę.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – miasto	Opcjonalny	Miasto, w którym znajduje się lub działa dana osoba.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlany adres	Opcjonalny	Użytkownikowi wyświetli się adres, pod którym znajduje się lub świadczy usługi dana osoba.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalny	Adres (jeśli dotyczy), pod którym znajduje się lub pełni służbę dana osoba.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalny	Stan (jeśli dotyczy), w którym dana osoba się znajduje lub pełni służbę.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalny	Kod pocztowy (jeśli dotyczy) miejsca, w którym dana osoba się znajduje lub pełni służbę.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – dzielnica	Opcjonalny	Dzielnica (jeśli dotyczy), w której znajduje się lub świadczy usługi dana osoba.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Plakietki	Opcjonalny	Każda plakietka to dowolny tekst (maks. 15 znaków) lub mały obraz.
Plakietka – tekst	Opcjonalny	Tytuł plakietki Uwaga: plakietka musi zawierać tekst lub obraz.	Dowolny tekst Zalecane rozmiary tekstu: maks. 15 znaków
Plakietka – obraz	Opcjonalny	Mały obraz Specjalne traktowanie pod kątem wygody użytkownika, np. plakietka na miniaturze obrazu lub filmu. Uwaga: plakietka musi zawierać tekst lub obraz.	Wskazówki znajdziesz w specyfikacji obrazu.
Opis	Opcjonalny	Pojedynczy akapit tekstu opisujący encję. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecana długość tekstu: 180 znaków
Lista napisów	Opcjonalny	Maksymalnie 3 podtytuły, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Kategorie treści	Opcjonalny	Opisz kategorię treści w encji.	Lista kwalifikujących się typów wyliczeniowych TYPE_HEALTH_AND_FITENESS (przykład: trener jogi/fitnessu) TYPE_HOME_AND_AUTO (przykład: hydraulik) TYPE_SPORTS (przykład – zawodnik) TYPE_DATING Wskazówki znajdziesz w sekcji dotyczącej kategorii treści.

RestaurantReservationEntity

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do elementu w aplikacji dostawcy. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Tytuł podmiotu.	Ciąg znaków Zalecana długość 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 Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – miasto	Wymagany	Miasto, w którym znajduje się restauracja.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlany adres	Wymagany	Adres restauracji, który będzie wyświetlany użytkownikowi.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalny	Adres restauracji (jeśli dotyczy).	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalny	Stan lub województwo (jeśli dotyczy), w którym znajduje się restauracja.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalny	Kod pocztowy restauracji (jeśli dotyczy).	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – dzielnica	Opcjonalny	Dzielnica (jeśli dotyczy), w której znajduje się restauracja.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Obrazy plakatu	Opcjonalny	Jeśli podasz kilka obrazów, wyświetlimy tylko 1 z nich. Zalecany format obrazu to 16:9.	Wskazówki znajdziesz w specyfikacji obrazu.
Opis	Opcjonalny	Pojedynczy akapit tekstu opisujący encję. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecana długość tekstu: 180 znaków
Lista napisów	Opcjonalny	Maksymalnie 3 podtytuły, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Wielkość tabeli	Opcjonalny	Liczba osób w grupie rezerwacji	Liczba całkowita > 0

EventReservationEntity

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do elementu w aplikacji dostawcy. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Tytuł podmiotu.	Ciąg znaków Zalecana długość tekstu: maks. 50 znaków
Czas rozpoczęcia	Wymagany	Sygnatura czasowa epoki, kiedy wydarzenie ma się rozpocząć. Uwaga: ta wartość jest podawana w milisekundach.	Sygnatura czasowa epoki w milisekundach
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ą IN_PERSON lub HYBRID.	Dowolny tekst Zalecany rozmiar 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ą IN_PERSON lub HYBRID.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlany adres	Wymagane warunkowo	Adres lub nazwa miejsca, w którym odbędzie się wydarzenie, które powinno być wyświetlane użytkownikowi. Uwaga: jest to wymagane w przypadku wydarzeń, które są IN_PERSON lub HYBRID.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalny	Adres (jeśli dotyczy) miejsca, w którym odbywa się wydarzenie.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalny	Stan lub prowincja (jeśli dotyczy), w której odbywa się wydarzenie.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalny	Kod pocztowy (w stosownych przypadkach) lokalizacji, w której odbywa się wydarzenie.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – dzielnica	Opcjonalny	Dzielnica (jeśli dotyczy), w której odbywa się wydarzenie.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Obrazy plakatu	Opcjonalny	Jeśli podasz kilka obrazów, wyświetlimy tylko 1 z nich. Zalecany format obrazu to 16:9. Uwaga: zdecydowanie zalecamy dodanie obrazu. Jeśli podano plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczny obszar o wielkości 24 dp.	Wskazówki znajdziesz w specyfikacji obrazu.
Czas zakończenia	Opcjonalny	Sygnatura czasowa epoki, kiedy zdarzenie ma się zakończyć. Uwaga: ta wartość jest podawana w milisekundach.	Sygnatura czasowa epoki w milisekundach
Dostawca usług – nazwa	Opcjonalny	Nazwa dostawcy usługi. Uwaga: w przypadku dostawcy usług wymagany jest tekst lub obraz.	Dowolny tekst. Na przykład nazwa organizatora wydarzenia lub trasy koncertowej.
Dostawca usług – obraz	Opcjonalny	Logo lub obraz dostawcy usług. Uwaga: w przypadku dostawcy usług wymagany jest tekst lub obraz.	Wskazówki znajdziesz w specyfikacji obrazu.
Opis	Opcjonalny	Pojedynczy akapit tekstu opisujący encję. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecana długość tekstu: 180 znaków
Lista napisów	Opcjonalny	Maksymalnie 3 podtytuły, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Plakietki	Opcjonalny	Każda plakietka to dowolny tekst (maks. 15 znaków) lub mały obraz.
Plakietka – tekst	Opcjonalny	Tytuł plakietki Uwaga: plakietka musi zawierać tekst lub obraz.	Dowolny tekst Zalecane rozmiary tekstu: maks. 15 znaków
Plakietka – obraz	Opcjonalny	Mały obraz Specjalne traktowanie pod kątem wygody użytkownika, np. plakietka na miniaturze obrazu lub filmu. Uwaga: plakietka musi zawierać tekst lub obraz.	Wskazówki znajdziesz w specyfikacji obrazu.
Identyfikator rezerwacji	Opcjonalny	Identyfikator rezerwacji wydarzenia.	Dowolny tekst
Cena – CurrentPrice	Wymagane warunkowo	Aktualna cena biletu lub karnetu na wydarzenie. Należy podać, jeśli podano przekreśloną cenę.	Dowolny tekst
Price - StrikethroughPrice	Opcjonalny	Pierwotna cena biletu lub karnetu na wydarzenie.	Dowolny tekst
Objaśnienie ceny	Opcjonalny	Objaśnienie 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ż bieżącą wartość oceny.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalny	Bieżąca wartość skali ocen. Należy podać, jeśli podano też maksymalną 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 – liczba ocen	Opcjonalny	Liczba ocen zdarzenia. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skrótu wyświetlania. Jeśli podane są 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 (przykład: wycieczka, festiwal) TYPE_HEALTH_AND_FITENESS (np. zajęcia z jogi) TYPE_EDUCATION (przykład: klasa) TYPE_SPORTS (przykład: mecz piłki nożnej) TYPE_DATING (przykład: spotkanie) Wskazówki znajdziesz w sekcji dotyczącej kategorii treści.

LodgingReservationEntity

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do elementu w aplikacji dostawcy. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Tytuł podmiotu.	Dowolny tekst. Na przykład „Twój pobyt od 12 grudnia”. Zalecana długość 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ę miejsce zakwaterowania.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – miasto	Wymagany	Miasto, w którym znajduje się miejsce zakwaterowania.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – wyświetlany adres	Wymagany	Adres miejsca zakwaterowania, który będzie wyświetlany użytkownikowi.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – adres	Opcjonalny	Adres (jeśli dotyczy) miejsca zakwaterowania.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – stan	Opcjonalny	Stan lub województwo (jeśli dotyczy), w którym znajduje się miejsce zakwaterowania.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – kod pocztowy	Opcjonalny	Kod pocztowy (jeśli dotyczy) miejsca zakwaterowania.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja – dzielnica	Opcjonalny	Dzielnica (jeśli dotyczy), w której znajduje się kwatera.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Obrazy plakatu	Opcjonalny	Jeśli podasz kilka obrazów, wyświetlimy tylko 1 z nich. Zalecany format obrazu to 16:9. Uwaga: jeśli podano plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczny obszar o szerokości 24 dp.	Wskazówki znajdziesz w specyfikacji obrazu.
Opis	Opcjonalny	Pojedynczy akapit tekstu opisujący encję. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecana długość tekstu: 180 znaków
Lista napisów	Opcjonalny	Maksymalnie 3 podtytuły, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Identyfikator rezerwacji	Opcjonalny	Identyfikator rezerwacji noclegu.	Dowolny tekst
Ocena – wartość maksymalna	Opcjonalny	Maksymalna wartość skali ocen. Musisz podać tę wartość, jeśli podajesz też bieżącą wartość oceny.	Liczba >= 0,0
Ocena – bieżąca wartość	Opcjonalny	Bieżąca wartość skali ocen. Należy podać, jeśli podano też maksymalną wartość oceny.	Liczba >= 0,0
Ocena – liczba	Opcjonalny	Liczba ocen miejsca zakwaterowania. 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 – liczba ocen	Opcjonalny	Liczba ocen miejsca zakwaterowania. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki skrótu wyświetlania. Jeśli podane są zarówno liczba, jak i wartość liczby, użytkownikom wyświetlimy liczbę.	Długi
Cena – CurrentPrice	Wymagane warunkowo	Aktualna cena noclegu. Jeśli podano przekreśloną cenę, należy podać tę wartość.	Dowolny tekst
Price - StrikethroughPrice	Opcjonalny	Pierwotna cena miejsca zakwaterowania, która jest przekreślona w interfejsie.	Dowolny tekst
Objaśnienie ceny	Opcjonalny	Objaśnienie 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)

TransportationReservationEntity

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do elementu w aplikacji dostawcy. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Tytuł podmiotu.	Dowolny tekst. Na przykład „SFO do SAN” Zalecana długość tekstu: maks. 50 znaków
Typ transportu	Wymagany	Środek/typ 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 przybycia.	Sygnatura czasowa epoki w milisekundach
Miejsce wyjazdu – kraj	Opcjonalny	Kraj wyjazdu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja miejsca wylotu – miasto	Opcjonalny	Miasto wylotu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Miejsce wylotu – wyświetlany adres	Opcjonalny	Miejsce wylotu, które będzie wyświetlane użytkownikowi.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Miejsce wyjazdu – ulica i numer	Opcjonalny	Adres (jeśli dotyczy) miejsca wylotu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja miejsca wylotu – stan	Opcjonalny	Stan lub prowincja (jeśli dotyczy) miejsca wylotu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Miejsce wylotu – kod pocztowy	Opcjonalny	Kod pocztowy (jeśli dotyczy) miejsca wylotu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Miejsce wylotu – dzielnica	Opcjonalny	Dzielnica (jeśli dotyczy) miejsca wyjazdu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja przylotu – kraj	Opcjonalny	Kraj docelowy.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja przylotu – miasto	Opcjonalny	Miasto przylotu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja przyjazdu – wyświetlany adres	Opcjonalny	Miejsce przybycia, które będzie wyświetlane użytkownikowi.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja przyjazdu – adres	Opcjonalny	Adres (jeśli dotyczy) miejsca przybycia.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja przylotu – stan	Opcjonalny	Województwo lub region (jeśli dotyczy) miejsca przyjazdu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Lokalizacja docelowa – kod pocztowy	Opcjonalny	Kod pocztowy (jeśli dotyczy) miejsca przyjazdu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Miejsce przybycia – dzielnica	Opcjonalny	Dzielnica (jeśli dotyczy) miejsca przyjazdu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Dostawca usług – nazwa	Opcjonalny	Nazwa dostawcy usługi. Uwaga: w przypadku dostawcy usług wymagany jest tekst lub obraz.	Dowolny tekst. Na przykład nazwa linii lotniczych
Dostawca usług – obraz	Opcjonalny	Logo lub obraz dostawcy usług. Uwaga: w przypadku dostawcy usług wymagany jest tekst lub obraz.	Wskazówki znajdziesz w specyfikacji obrazu.
Obrazy plakatu	Opcjonalny	Jeśli podasz kilka obrazów, wyświetlimy tylko 1 z nich. Zalecany format obrazu to 16:9.	Wskazówki znajdziesz w specyfikacji obrazu.
Opis	Opcjonalny	Pojedynczy akapit tekstu opisujący encję. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecana długość tekstu: 180 znaków
Lista napisów	Opcjonalny	Maksymalnie 3 podtytuły, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Identyfikator rezerwacji	Opcjonalny	Identyfikator rezerwacji transportu.	Dowolny tekst
Cena – CurrentPrice	Wymagane warunkowo	Bieżąca cena rezerwacji. Jeśli podano przekreśloną cenę, należy podać tę wartość.	Dowolny tekst
Price - StrikethroughPrice	Opcjonalny	Pierwotna cena rezerwacji, która jest przekreślona w interfejsie.	Dowolny tekst
Objaśnienie ceny	Opcjonalny	Objaśnienie 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)
Numer transportu	Wymagane	Numer lotu, autobusu, pociągu lub promu/rejsu.	Dowolny tekst
Godzina wejścia na pokład	Wymagane	Sygnatura czasowa epoki, która reprezentuje 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 elementu w aplikacji dostawcy. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania.	Uri
Tytuł	Wymagany	Tytuł podmiotu.	Dowolny tekst. Na przykład „Avis Union Square SF”. Zalecana długość tekstu: maks. 50 znaków
Czas odbioru	Wymagany	Sygnatura czasowa epoki, która reprezentuje godzinę odbioru w rezerwacji.	Sygnatura czasowa epoki w milisekundach
Pora powrotu	Opcjonalny	Sygnatura czasowa epoki, która reprezentuje godzinę wymeldowania w rezerwacji.	Sygnatura czasowa epoki w milisekundach
Pickup Address - Country	Opcjonalny	Kraj, w którym znajduje się miejsce odbioru.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Adres odbioru – miasto	Opcjonalny	Miasto, w którym znajduje się miejsce odbioru.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Adres odbioru – wyświetlany adres	Opcjonalny	Lokalizacja odbioru, która będzie wyświetlana użytkownikowi.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Adres odbioru – ulica i numer	Opcjonalny	Adres (jeśli dotyczy) miejsca odbioru.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Adres odbioru – stan	Opcjonalny	Województwo lub region (jeśli dotyczy), w którym znajduje się miejsce odbioru.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Adres odbioru – kod pocztowy	Opcjonalny	Kod pocztowy (jeśli dotyczy) miejsca odbioru.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Adres odbioru – dzielnica	Opcjonalny	Okolica (jeśli dotyczy) miejsca odbioru.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Adres zwrotny – kraj	Opcjonalny	Kraj lokalizacji zwrotu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Adres zwrotny – miasto	Opcjonalny	Miasto, w którym znajduje się lokalizacja zwrotu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Adres zwrotny – wyświetlany adres	Opcjonalny	Lokalizacja zwrotu, która będzie wyświetlana użytkownikowi.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Adres zwrotny – ulica i numer domu	Opcjonalny	Adres (jeśli dotyczy) lokalizacji zwrotu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Adres zwrotny – stan	Opcjonalny	Województwo lub region (jeśli dotyczy) lokalizacji zwrotu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Adres zwrotny – kod pocztowy	Opcjonalny	Kod pocztowy (jeśli dotyczy) lokalizacji zwrotu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Adres zwrotny – dzielnica	Opcjonalny	Dzielnica (jeśli dotyczy) lokalizacji zwrotu.	Dowolny tekst Zalecany rozmiar tekstu: maks. ok. 20 znaków
Dostawca usług – nazwa	Opcjonalny	Nazwa dostawcy usługi. Uwaga: w przypadku dostawcy usług wymagany jest tekst lub obraz.	Dowolny tekst. Na przykład „Avis Car Rental”.
Dostawca usług – obraz	Opcjonalny	Logo lub obraz dostawcy usług. Uwaga: w przypadku dostawcy usług wymagany jest tekst lub obraz.	Wskazówki znajdziesz w specyfikacji obrazu.
Obrazy plakatu	Opcjonalny	Jeśli podasz kilka obrazów, wyświetlimy tylko 1 z nich. Zalecany format obrazu to 16:9.	Wskazówki znajdziesz w specyfikacji obrazu.
Opis	Opcjonalny	Pojedynczy akapit tekstu opisujący encję. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecana długość tekstu: 180 znaków
Lista napisów	Opcjonalny	Maksymalnie 3 podtytuły, każdy w jednym wierszu tekstu. Uwaga: użytkownikowi wyświetli się opis lub lista podtytułów, ale nie oba te elementy.	Dowolny tekst Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Identyfikator potwierdzenia	Opcjonalny	Identyfikator potwierdzenia rezerwacji wynajmu pojazdu.	Dowolny tekst
Cena – CurrentPrice	Wymagane warunkowo	Bieżąca cena rezerwacji. Jeśli podano przekreśloną cenę, należy podać tę wartość.	Dowolny tekst
Price - StrikethroughPrice	Opcjonalny	Pierwotna cena rezerwacji, która jest przekreślona w interfejsie.	Dowolny tekst
Objaśnienie ceny	Opcjonalny	Objaśnienie 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)

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 x 1) Preferowane	300 x 300	1200 x 1200
Poziomy (1,91 x 1)	600 x 314	1200 x 628
Orientacja pionowa (4 x 5)	480 x 600	960 x 1200

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

Formaty plików

PNG, JPG, statyczny GIF, WebP

Maksymalny rozmiar pliku

5120 KB

Dodatkowe zalecenia

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

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 ze wstępnie zdefiniowanych kategorii, czyli:

• 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 miało do nich dostęp.

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

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

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

   • TYPE_MOVIES_AND_TV_SHOWS – zanim użyjesz encji ogólnych, zapoznaj się z encjami z przewodnika po integracji z Google TV.
   • TYPE_BOOKS – zanim użyjesz encji ogólnych, zapoznaj się z EbookEntity.
   • TYPE_AUDIOBOOKS – zanim użyjesz encji ogólnych, sprawdź AudiobookEntity.
   • TYPE_SHOPPING – zanim użyjesz encji ogólnych, sprawdź ShoppingEntity.
   • TYPE_FOOD_AND_DRINK – zanim użyjesz encji ogólnych, zapoznaj się z encjami z przewodnika po integracji z usługami gastronomicznymi.

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

4. Jeśli podajesz kilka kategorii treści, podaj je w kolejności trafności, przy czym najbardziej trafna kategoria treści powinna być umieszczona na początku listy.

Krok 2. Podaj dane klastra

Zalecamy, aby zadanie publikowania treści było wykonywane w tle (np. za pomocą WorkManagera) i było zaplanowane regularnie lub na podstawie zdarzenia (np. za każdym razem, gdy użytkownik otwiera aplikację lub gdy doda coś do koszyka).

AppEngagePublishClient odpowiada za klastry publikujące.

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 mogą być wyświetlane na urządzeniu.

Pakiet Engage SDK w wersji 1.6.0 lub nowszej (zalecany)

Umiejętności związane z Androidem

Wyświetl na GitHubie

Integracja z pakietem Engage SDK

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

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 pomoc:

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 API isServiceAvailable akceptuje obiekt żądania ServiceAvailabilityRequest, który zawiera typy klastrów, dla których należy sprawdzić dostępność usługi. Wartości typu wyliczeniowego ClusterType wymagane w przypadku ServiceAvailabilityRequest znajdziesz w tabeli poniżej.

Typ klastra	Stała typu klastra	Wartość w formie liczby całkowitej
Nieznany	TYPE_UNKNOWN	0
Klaster rekomendacji	TYPE_RECOMMENDATION	1
Polecana grupa	TYPE_FEATURED	2
Klaster kontynuacji	TYPE_CONTINUATION	3
Grupa „Koszyk na zakupy”	TYPE_SHOPPING_CART	4
Grupa „Zamów ponownie” dotycząca jedzenia	TYPE_FOOD_REORDER	5
Grupa „Koszyk – 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ń zakupowych”	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 obniżyć koszty wyświetlania. Jednak ta strategia przerywanego przetwarzania treści negatywnie wpływa na wrażenia użytkowników: nieaktualne treści nie będą wyświetlane, a niektóre platformy nie będą obsługiwane.

Od wersji 1.6.0 pakiet Engage SDK umożliwia sprawdzanie dostępności określonych typów klastrów. Jeśli Twoja aplikacja korzysta z przetwarzania przerywanego:

• Klastry kontynuacji (takie jak Czytaj dalej i Rezerwacje) pozostają domyślnie włączone na wszystkich obsługiwanych urządzeniach.
• Inne typy klastrów (np. rekomendacje) są włączane i wyłączane okresowo.

Jeśli ta domyślna konfiguracja nie odpowiada Twoim potrzebom, skontaktuj się z nami pod adresem [e-mail].

Wersje pakietu SDK starsze niż 1.6.0 (wycofane)

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.
    }
});

Uwaga: zdecydowanie zalecamy, aby zadanie okresowe było nadal uruchamiane i sprawdzało, czy usługa stanie się dostępna w późniejszym czasie. Dostępność usługi może się zmieniać wraz z aktualizacjami wersji Androida, aktualizacjami aplikacji, instalacjami i odinstalowaniami. Dzięki okresowemu sprawdzaniu zadań w określonych odstępach czasu dane mogą być publikowane, gdy tylko usługa stanie się dostępna.

publishRecommendationClusters

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

Ważne: interfejsy API do publikowania to interfejsy API typu upsert, które zastępują istniejące treści. Nie wywołuj interfejsów API do usuwania i publikowania, aby zastąpić treść, ponieważ interfejsy API do publikowania robią to automatycznie.

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:

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

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

publishFeaturedCluster

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

Ważne: interfejsy API do publikowania to interfejsy API typu upsert, które zastępują istniejące treści. Nie wywołuj interfejsów API do usuwania i publikowania, aby zastąpić treść, ponieważ interfejsy API do publikowania robią to automatycznie.

Kotlin

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

Java

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

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

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

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

publishContinuationCluster

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

Ważne: interfejsy API do publikowania to interfejsy API typu upsert, które zastępują istniejące treści. Nie wywołuj interfejsów API do usuwania i publikowania, aby zastąpić treść, ponieważ interfejsy API do publikowania robią to automatycznie.

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:

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

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

publishUserAccountManagementRequest

Ten interfejs API służy do publikowania karty logowania . Działanie logowania kieruje użytkowników na stronę logowania aplikacji, dzięki czemu aplikacja może 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. przekierowuje na stronę logowania w aplikacji)
Obraz	Opcjonalny – jeśli nie zostanie podany, należy podać tytuł	Obraz wyświetlany na karcie obrazy o formacie obrazu 16:9 i rozdzielczości 1264 x 712,
Tytuł	Opcjonalny – jeśli nie zostanie podany, należy podać obraz	Tytuł na karcie
Tekst z opcją działania	Opcjonalny	Tekst wyświetlany w wezwaniu do działania (np. Zaloguj się)
Podtytuł	Opcjonalny	Opcjonalne napisy na karcie

Ważne: interfejsy API do publikowania to interfejsy API typu upsert, które zastępują istniejące treści. Nie wywołuj interfejsów API do usuwania i publikowania, aby zastąpić treść, ponieważ interfejsy API do publikowania robią to automatycznie.

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:

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

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

updatePublishStatus

Jeśli z jakiegoś powodu biznesowego żaden z klastrów nie zostanie opublikowany, zdecydowanie zalecamy zaktualizowanie stanu publikacji za pomocą interfejsu API updatePublishStatus. To ważne, ponieważ :

• Podawanie stanu we wszystkich scenariuszach, nawet gdy treść jest opublikowana (STATUS == PUBLISHED), ma kluczowe znaczenie dla wypełniania paneli, które używają tego stanu do przekazywania informacji o stanie i innych danych dotyczących integracji.
• Jeśli nie opublikowano żadnych treści, ale stan integracji nie jest uszkodzony (STATUS == NOT_PUBLISHED), Google może uniknąć wywoływania alertów w panelach stanu aplikacji. Potwierdza, że treści nie zostały opublikowane z powodu oczekiwanej sytuacji z punktu widzenia dostawcy.
• Pomaga deweloperom dostarczać informacje o tym, kiedy dane są publikowane, a kiedy nie.
• Google może używać kodów stanu, aby zachęcić użytkownika do wykonania określonych działań w aplikacji, dzięki czemu będzie on 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());

deleteRecommendationsClusters

Ten interfejs API służy do usuwania zawartości klastrów rekomendacji.

Ważne: interfejsy API do usuwania należy wywoływać tylko wtedy, gdy nie ma treści do opublikowania. Nie wywołuj interfejsów API do usuwania i publikowania, aby zastąpić treść, ponieważ interfejsy API do publikowania robią to automatycznie. Zanim użyjesz interfejsów API do usuwania, skontaktuj się z [e-mail].

Kotlin

client.deleteRecommendationsClusters()

Java

client.deleteRecommendationsClusters();

Gdy usługa otrzyma żądanie, usunie istniejące dane z klastrów rekomendacji. W przypadku błędu całe żądanie jest odrzucane i zachowywany jest dotychczasowy stan.

Uwaga: ten interfejs API jest dostępny od wersji 1.1.0.

deleteFeaturedCluster

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

Ważne: interfejsy API do usuwania należy wywoływać tylko wtedy, gdy nie ma treści do opublikowania. Nie wywołuj interfejsów API do usuwania i publikowania, aby zastąpić treść, ponieważ interfejsy API do publikowania robią to automatycznie. Zanim użyjesz interfejsów API do usuwania, skontaktuj się z [e-mail].

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

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

Uwaga: ten interfejs API jest dostępny od wersji 1.1.0.

deleteContinuationCluster

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

Ważne: interfejsy API do usuwania należy wywoływać tylko wtedy, gdy nie ma treści do opublikowania. Nie wywołuj interfejsów API do usuwania i publikowania, aby zastąpić treść, ponieważ interfejsy API do publikowania robią to automatycznie. Zanim użyjesz interfejsów API do usuwania, skontaktuj się z [e-mail].

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 jest odrzucane i zachowywany jest dotychczasowy stan.

Uwaga: ten interfejs API jest dostępny od wersji 1.1.0.

deleteUserManagementCluster

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

Ważne: interfejsy API do usuwania należy wywoływać tylko wtedy, gdy nie ma treści do opublikowania. Nie wywołuj interfejsów API do usuwania i publikowania, aby zastąpić treść, ponieważ interfejsy API do publikowania robią to automatycznie. Zanim użyjesz interfejsów API do usuwania, skontaktuj się z [e-mail].

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 i zachowywany jest dotychczasowy stan.

Uwaga: ten interfejs API jest dostępny od wersji 1.1.0.

deleteClusters

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

Ważne: interfejsy API do usuwania należy wywoływać tylko wtedy, gdy nie ma treści do opublikowania. Nie wywołuj interfejsów API do usuwania i publikowania, aby zastąpić treść, ponieważ interfejsy API do publikowania robią to automatycznie. Zanim użyjesz interfejsów API do usuwania, skontaktuj się z [e-mail].

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 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 się nie powiodło.

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 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 wywołania (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 spróbować ponownie.
4	SERVICE_CALL_PERMISSION_DENIED	Wywołujący nie ma uprawnień do 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	Wystąpił błąd po stronie usługi.
7	SERVICE_CALL_RESOURCE_EXHAUSTED	Wywołanie usługi jest wykonywane zbyt często.

Krok 3. Obsługa intencji rozgłaszania

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

Celem intencji rozgłaszania jest głównie reaktywacja aplikacji i wymuszenie synchronizacji danych. Intencje rozgłaszania nie są przeznaczone do częstego wysyłania. Jest wywoływana tylko wtedy, gdy usługa Engage określi, że treści mogą być nieaktualne (np. mają tydzień). Dzięki temu użytkownik może mieć pewność, że zobaczy aktualne treści, nawet jeśli aplikacja nie była uruchamiana przez dłuższy czas.

BroadcastReceiver należy skonfigurować na 2 sposoby:

• Zarejestruj dynamicznie 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);
}

• Zadeklaruj statycznie 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 tej intencji.
• com.google.android.engage.action.PUBLISH_FEATURED Po otrzymaniu tej intencji zalecamy rozpoczęcie połączenia publishFeaturedCluster.
• com.google.android.engage.action.PUBLISH_CONTINUATION Po otrzymaniu tej intencji zalecamy rozpoczęcie połączenia publishContinuationCluster.

Przepływ pracy integracji

Szczegółowe instrukcje dotyczące weryfikacji integracji po jej zakończeniu znajdziesz w artykule Proces integracji dla deweloperów Engage.

Najczęstsze pytania

Najczęstsze pytania znajdziesz w artykule Najczęstsze pytania dotyczące pakietu Engage SDK.

Kontakt

Jeśli masz pytania dotyczące procesu integracji, skontaktuj się z [e-mail].

Dalsze kroki

Po zakończeniu integracji wykonaj te czynności:

• Wyślij e-maila na adres [e-mail] i dołącz zintegrowany plik APK, który jest gotowy do przetestowania przez Google.
• Google przeprowadza weryfikację i sprawdza wewnętrznie, czy integracja działa zgodnie z oczekiwaniami. Jeśli konieczne będą zmiany, Google skontaktuje się z Tobą i poda niezbędne informacje.
• Gdy testy zostaną zakończone i nie będą potrzebne żadne zmiany, Google skontaktuje się z Tobą, aby poinformować, że możesz zacząć publikować zaktualizowany i zintegrowany pakiet APK w Sklepie Play.
• Gdy Google potwierdzi, że zaktualizowany plik APK został opublikowany w Sklepie Play, klastry Polecane, Wyróżnione i Kontynuacja mogą zostać opublikowane i stać się widoczne dla użytkowników.