Engage SDK inne branże: instrukcje integracji technicznej firm zewnętrznych

Google tworzy platformę na urządzeniu, która porządkuje aplikacje użytkowników według branż i zapewnia nowe, immersyjne środowisko do przeglądania i odkrywania treści z aplikacji. Tryb pełnoekranowy daje partnerom deweloperom możliwość zaprezentowania swoich najlepszych treści w ramach dedykowanego kanału poza aplikacją.

Ten dokument zawiera instrukcje dla deweloperów dotyczące integrowania za pomocą pakietu SDK dla Agencji nowych treści, takich jak rezerwacje, wydarzenia, zakwaterowanie, ciekawe miejsca, ludzie i inne treści, które mogą nie należeć do żadnej z tych kategorii za pomocą pakietu SDK dla Agencji.

Szczegóły integracji

Terminologia

Ta integracja obejmuje 3 typy klastrów: Recommendation (Rekomendacje), Featured (Polecane) i Continuation (Kontynuacja).

• Klastry rekomendacji pokazują spersonalizowane sugestie od danego partnera deweloperów. Jest to widok interfejsu, który zawiera grupę rekomendacji od tego samego partnera deweloperskiego.

  • ArticleEntity: obiekt ArticleEntity, który reprezentuje tekstową rekomendację treści, która jest istotna dla więcej niż jednej kategorii treści. Element ArticleEntity pozwala deweloperom udostępniać zróżnicowane treści tekstowe i graficzne z większą liczbą metadanych umożliwiających przekazanie informacji użytkownikom w porównaniu z klasy TypowefeatureEntity. Przykład: treści marketingowe, fragment wiadomości

    

    Ilustracja 1. Interfejs pokazujący pojedynczą entość ArticleEntity w klastrze rekomendacji.

  • EventEntity: obiekt EventEntity reprezentuje zdarzenie, które ma nastąpić w przyszłości. Godzina rozpoczęcia zdarzenia to kluczowa informacja, która musi zostać przekazana użytkownikom.

    

    Rysunek 2. Interfejs przedstawiający pojedynczy element EventEntity w klastrze Recommendations.

  • LodgingEntity: obiekt zakwaterowania, np. hotel, apartament, dom wakacyjny na krótki lub długi okres wynajmu.

    

    Rysunek 3. Interfejs pokazujący pojedynczą instancję obiektu LodgingEntity w klastrze rekomendacji.

  • StoreEntity: StoreEntity reprezentuje sklep, restaurację, kawiarnię itp. Podkreśla treści, w których przypadku lokal gastronomiczny lub sklep jest kluczowym elementem informacji, który należy przekazać użytkownikom.

    

    Rysunek 4. Interfejs przedstawiający pojedynczy element składowy w klastrze Rekomendacje.

  • PointOfInterestEntity: obiekt PointOfInterestEntity reprezentuje miejsce, np. stację benzynową, miejsce wydarzenia, park rozrywki, muzeum, atrakcję turystyczną, szlak turystyczny itp. Podkreśla treści, w których przypadku lokalizacja jest istotną informacją, którą należy przekazać użytkownikom. Nie powinien on dotyczyć obiektu noclegowego, sklepu ani lokalu gastronomicznego.

    

    Rysunek 5. Interfejs z pojedynczym obiektem PointOfInterestEntity w klastrze rekomendacji.

  • PersonEntity: PersonEntity oznacza osobę. Rekomendacje mogą na przykład wyróżniać osobę w kategoriach takich jak zdrowie i fitness, sport czy randki.

    

    Rysunek 5.: interfejs pokazujący pojedynczy obiekt PersonEntity w klastrze rekomendacji.

• Klaster Kontynuacja w pojedynczym grupowaniu UI zawiera treści, które były ostatnio aktywne przez użytkowników pochodzących od wielu partnerów deweloperów. Każdy partner dewelopera będzie mógł rozgłaszać maksymalnie 10 encji w klastrze kontynuacji.

  Treści kontynuacji mogą mieć taką strukturę:

  • ArticleEntity (artykuł) reprezentujący opartą na tekście rekomendację dotyczącą treści, które mają zastosowanie w więcej niż jednej kategorii. Ten element może służyć do reprezentowania niedokończonych artykułów informacyjnych lub innych 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 przedstawiający pojedynczy element ArticleEntity w klastrze kontynuacji.

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

    

    Rysunek 7. Interfejs pokazujący pojedynczy obiekt RestaurantReservationEntity w klastrze kontynuacji.

  • EventReservationEntity: EventReservationEntity reprezentuje rezerwację wydarzenia i pomaga użytkownikom śledzić nadchodzące lub trwające rezerwacje wydarzeń. Do takich wydarzeń należą m.in.:

    • wydarzenia sportowe, takie jak rezerwacja biletu na mecz piłki nożnej;
    • wydarzenia związane z grami, np. rezerwacje na mecze e-sportowe;
    • wydarzenia rozrywkowe, takie jak rezerwacja biletów do kina, koncert, teatr, spotkanie autorskie;
    • Rezerwacje wycieczek lub ciekawych miejsc, np. wycieczki z przewodnikiem, bilety do muzeum
    • Rezerwacje na spotkania towarzyskie, seminaria i konferencje
    • Rezerwacje na zajęcia edukacyjne lub szkolenia

    

    Rysunek 8. Interfejs pokazujący pojedynczy obiekt EventReservationEntity w klastrze kontynuacji.

  • LodgingReservationEntity: obiekt zakwaterowania LodgingEntityReservation reprezentuje rezerwację miejsca zakwaterowania i pomaga użytkownikom śledzić nadchodzące lub trwające rezerwacje hoteli lub kwater wakacyjnych.

    

    Rysunek 9. Interfejs pokazujący pojedynczy obiekt typu LodgingReservationEntity w klastrze Continuation.

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

    

    Rysunek 10. Interfejs pokazujący pojedynczy obiekt TransportationReservationEntity w klastrze Continuation.

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

    

    Rysunek 11. UI przedstawiający pojedynczy obiekt VehicleRentalReservationEntity w klastrze Continuation.

• Grupa Polecane to widok interfejsu, który prezentuje wybrany elementGenericFeaturedEntity od wielu partnerów deweloperów w jednym układzie interfejsu. Jest jeden wyróżniony klaster, który wyświetla się u góry interfejsu użytkownika, w priorytetowym miejscu nad wszystkimi klastrami rekomendacji. Każdy partner deweloper może wyświetlać w sekcji Polecane pojedynczy element danego typu, a w każdym z tych klastrów może być wiele elementów (potencjalnie różnych typów) od wielu deweloperów aplikacji.

  • GenericFeaturedEntity: GenericFeaturedEntity różni się od elementu Rekomendacja tym, że element Featured powinien być używany do pojedynczego najlepszego elementu treści od dewelopera i powinien reprezentować jeden najważniejszy element treści, który będzie interesujący i trafny dla użytkowników.

    

    Rysunek 12. Interfejs użytkownika z pojedynczą kartą typu GenericFeaturedEntity w klastrze z elementami wyróżnionymi

Przygotowanie

Minimalny poziom interfejsu API: 19

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

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

Podsumowanie

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

Dane, które klient może publikować, podlegają następującym ograniczeniom 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 5	Co najmniej 5	Maksymalnie 25 (ArticleEntity, EventEntity, LodgingEntity, StoreEntity, PointOfInterestEntity lub PersonEntity)
Klaster kontynuacji	Maksymalnie 1	Co najmniej 1	Maksymalnie 10 (ArticleEntity, EventReservationEntity, LodgingReservationEntity, TransportationReservationEntity lub VehicleRentalReservationEntity)
Polecany klaster	Maksymalnie 1	Co najmniej 1	Maksymalnie 10 (GenericFeaturedEntity)

Krok 1. Podaj dane encji

Pakiet SDK definiuje różne elementy, które reprezentują poszczególne typy elementów. W kategorii Inne obsługujemy:

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 przedstawiają dostępne atrybuty i wymagania dla każdego z nich.

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	Identyfikator 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 w plakietce jest umieszczony obraz, należy pozostawić bezpieczny obszar o szerokości 24 dps u góry i u dołu obrazu.	Więcej informacji znajdziesz w specyfikacji zdjęć.
Tytuł	Opcjonalnie	Tytuł elementu.	Tekst otwarty Zalecany rozmiar tekstu: 50 znaków
Opis	Opcjonalnie	Jeden akapit tekstu opisujący daną encję. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	maksymalnie 3 napisy, z których każdy może zawierać jeden wiersz tekstu. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecane rozmiary tekstu dla każdego z napisów: maks. 50 znaków
Odznaki	Opcjonalnie	Każda plakietka może zawierać dowolny tekst (maksymalnie 15 znaków) lub mały obraz. specjalne wrażenia użytkownika na obrazie lub filmie, np. w postaci plakietki nałożonej na obraz „Aktualizacja na żywo” Czas czytania artykułu
Odznaka – tekst	Opcjonalnie	Tytuł plakietki Uwaga: na plakietce musi znajdować się tekst lub obraz.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 15 znaków
Plakietka – obraz	Opcjonalnie	Mały obraz specjalne wrażenia użytkownika, na przykład w postaci plakietki nałożonej na obrazie lub miniaturze filmu; Uwaga: na plakietce musi znajdować się tekst lub obraz.	Więcej informacji znajdziesz w specyfikacji zdjęć.
Kategorie treści	Opcjonalnie	Opisz kategorię treści znajdujących się w danym elemencie.	Lista wartości w polu enum Więcej informacji znajdziesz w sekcji Kategoria 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	Identyfikator URI
Tytuł	Wymagany	Tytuł elementu.	Dowolny tekst Zalecany rozmiar tekstu: maks. 50 znaków
obrazy plakatu,	Opcjonalnie	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 w ramach logo znajduje się plakietka, należy zapewnić bezpieczną odległość 24 dp od góry i dołu obrazu.	Więcej informacji znajdziesz w specyfikacji zdjęć.
Źródło – tytuł	Opcjonalnie	imię i nazwisko autora, organizacji lub reportera;	Tekst otwarty Zalecany rozmiar tekstu: mniej niż 25 znaków
Źródło – obraz	Opcjonalnie	Obraz źródła, np. autor, organizacja czy reporter	Więcej informacji znajdziesz w specyfikacji zdjęć.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący daną encję. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	maksymalnie 3 napisy, z których każdy może zawierać jeden wiersz tekstu. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecane rozmiary tekstu dla każdego z napisów: maks. 50 znaków
Odznaki	Opcjonalnie	Każda plakietka może zawierać dowolny tekst (maksymalnie 15 znaków) lub mały obraz. Specjalne wrażenia użytkownika na obrazie lub filmie, na przykład w postaci plakietki nałożonej na obraz „Aktualizacja na żywo” Czas czytania artykułu
Odznaka – tekst	Opcjonalnie	Tytuł plakietki Uwaga: na plakietce musi znajdować się tekst lub obraz.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 15 znaków
Plakietka – obraz	Opcjonalnie	Mały obraz specjalne wrażenia użytkownika, na przykład w postaci plakietki nałożonej na obrazie lub miniaturze filmu; Uwaga: na plakietce musi znajdować się tekst lub obraz.	Wskazówki znajdziesz w specyfikacjach obrazów.
Czas publikacji treści	Opcjonalnie	To sygnatura czasowa w epoce w milisekundach, w której treści zostały opublikowane lub zaktualizowane w aplikacji.	Sygnatura czasowa od początku epoki w milisekundach
Ostatni czas zaangażowania	Wymagane warunkowo	Sygnatura czasowa w epoce (w milisekundach) ostatniej interakcji użytkownika z tym elementem. Uwaga: to pole jest wymagane, jeśli ten element jest częścią klastra kontynuacji.	Sygnatura czasowa od początku epoki w milisekundach
Procent postępu	Wymagane warunkowo	Odsetek pełnych treści przetworzonych do tej pory przez użytkownika. Uwaga: to pole jest wymagane, jeśli ten element jest częścią klastra kontynuacji.	Wartość typu int z zakresu 0–100.
Kategorie treści	Opcjonalnie	Opisz kategorię treści znajdujących się w danym elemencie.	Lista wartości w polu enum Więcej informacji znajdziesz w sekcji Kategoria 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	Identyfikator URI
Tytuł	Wymagany	Tytuł elementu.	Ciąg znaków Zalecany rozmiar tekstu: maks. 50 znaków
Godzina rozpoczęcia	Wymagany	Sygnatura czasowa epoki, w której ma się rozpocząć zdarzenie. Uwaga: wartość ta jest podawana w milisekundach.	Sygnatura czasowa od początku epoki w milisekundach
Tryb zdarzenia	Wymagany	Pole, w którym należy wskazać, czy wydarzenie będzie wirtualne, stacjonarne czy obie te formy.	Enum: 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 w ramach logo znajduje się plakietka, należy zapewnić bezpieczną odległość 24 dp od góry i dołu obrazu.	Więcej informacji znajdziesz w specyfikacji zdjęć.
Lokalizacja – kraj	Wymagane warunkowo	Kraj, w którym odbywa się wydarzenie. Uwaga: pole wymagane w przypadku wydarzeń typu IN_PERSON lub HYBRID	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – miasto	Wymagane warunkowo	Miasto, w którym odbywa się wydarzenie. Uwaga: pole wymagane w przypadku wydarzeń typu IN_PERSON lub HYBRID	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Lokalizacja – wyświetlany adres	Wymagane warunkowo	Adres lub nazwa miejsca, w którym odbędzie się wydarzenie, który powinien być wyświetlany użytkownikowi. Uwaga: jest to wymagane w przypadku zdarzeń o typie IN_PERSON lub HYBRID.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – adres	Opcjonalnie	Adres (jeśli dotyczy) miejsca, w którym odbywa się wydarzenie.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – stan	Opcjonalnie	Stan lub prowincja (jeśli ma zastosowanie), w którym odbywa się wydarzenie.	Dowolny tekst Zalecany rozmiar tekstu: maksymalnie 20 znaków
Lokalizacja – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli występuje) miejsca, w którym odbywa się wydarzenie.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – okolica	Opcjonalnie	Dzielnica (jeśli dotyczy), w której odbywa się wydarzenie.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Godzina zakończenia	Opcjonalnie	Znak czasu w epoce, w której ma się zakończyć zdarzenie. Uwaga: wartość ta jest podawana w milisekundach.	Sygnatura czasowa od początku epoki w milisekundach
Opis	Opcjonalnie	Jeden akapit tekstu opisujący daną encję. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	maksymalnie 3 napisy, z których każdy może zawierać jeden wiersz tekstu. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecane rozmiary tekstu dla każdego z napisów: maks. 50 znaków
Odznaki	Opcjonalnie	Każda plakietka może zawierać dowolny tekst (maksymalnie 15 znaków) lub mały obraz.
Odznaka – tekst	Opcjonalnie	Tytuł plakietki Uwaga: na plakietce musi znajdować się tekst lub obraz.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 15 znaków
Plakietka – obraz	Opcjonalnie	Mały obraz specjalne wrażenia użytkownika, na przykład w postaci plakietki nałożonej na obrazie lub miniaturze filmu; Uwaga: plakietka musi zawierać tekst lub obraz.	Więcej informacji znajdziesz w specyfikacji zdjęć.
Price - CurrentPrice	Wymagane warunkowo	Aktualna cena biletu na wydarzenie. Jeśli podano przekreśloną cenę, ta wartość jest wymagana.	Tekst otwarty
Cena – przekreślona cena	Opcjonalnie	Pierwotna cena biletu na wydarzenie.	Tekst otwarty
Objaśnienie dotyczące ceny	Opcjonalnie	Podkreślenie ceny, aby poinformować o promocji, wydarzeniu lub rabacie dla członków programu lojalnościowego (jeśli są dostępne).	Tekst otwarty Zalecane rozmiary tekstu: poniżej 45 znaków (w przypadku zbyt długiego tekstu mogą być wyświetlane wielokropki)
Kategorie treści	Opcjonalnie	Opisz kategorię treści znajdujących się w danym elemencie.	Lista typów wyliczeniowych spełniających wymagania TYPE_MOVIES_AND_TV_SHOWS (np. Cinema) TYPE_DIGITAL_GAMES (np. e-sport) TYPE_MUSIC (np. koncert) TYPE_TRAVEL_AND_LOCAL (np. wycieczka, festiwal) TYPE_HEALTH_AND_FITENESS (np. zajęcia z jogi) TYPE_EDUCATION (np. Class) TYPE_SPORTS (np. gra Piłka nożna) TYPE_DATING (przykład: spotkanie) Więcej informacji znajdziesz w sekcji Kategoria 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	Identyfikator URI
Tytuł	Wymagany	Tytuł elementu.	Ciąg znaków Zalecany rozmiar tekstu: maks. 50 znaków
Plakat	Wymagany	Jeśli podasz kilka obrazów, wyświetlimy tylko 1 z nich. Zalecany format obrazu to 16:9 Uwaga: jeśli masz plakietkę, upewnij się, że u góry i u dołu obrazu jest bezpieczna przestrzeń o wartości 24 dps	Wskazówki znajdziesz w specyfikacjach obrazów.
Lokalizacja – kraj	Wymagany	Kraj, w którym jest zakwaterowanie.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – miasto	Wymagany	Miasto, w którym odbywa się zakwaterowanie.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Lokalizacja – wyświetlany adres	Wymagany	Adres obiektu zakwaterowania, który będzie wyświetlany użytkownikowi.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – adres	Opcjonalnie	Adres (jeśli dotyczy) obiektu noclegowego.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – stan	Opcjonalnie	Stan lub prowincja (jeśli ma zastosowanie), w których znajduje się obiekt zakwaterowania.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Lokalizacja – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli dotyczy) miejsca zakwaterowania.	Dowolny tekst Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – okolica	Opcjonalnie	Okolica (jeśli dotyczy) zakwaterowania.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Odznaki	Opcjonalnie	Każda plakietka może zawierać dowolny tekst (maksymalnie 15 znaków) lub mały obraz.
Odznaka – tekst	Opcjonalnie	Tytuł plakietki Uwaga: na plakietce musi znajdować się tekst lub obraz.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 15 znaków
Plakietka – obraz	Opcjonalnie	Mały obraz specjalne wrażenia użytkownika, na przykład w postaci plakietki nałożonej na obrazie lub miniaturze filmu; Uwaga: na plakietce musi znajdować się tekst lub obraz.	Wskazówki znajdziesz w specyfikacjach obrazów.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący daną encję. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	maksymalnie 3 napisy, z których każdy może zawierać jeden wiersz tekstu. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecane rozmiary tekstu dla każdego z napisów: maks. 50 znaków
AvailabilityTimeWindow – Start Time	Opcjonalnie	Sygnatura czasowa epoki (w milisekundach), w której hotel ma być otwarty i dostępny.	Sygnatura czasowa od początku epoki w milisekundach
AvailabilityTimeWindow – czas zakończenia	Opcjonalnie	Sygnatura czasowa epoki (w milisekundach), do której hotel ma być otwarty i dostępny.	Sygnatura czasowa od początku epoki w milisekundach
Ocena – wartość maksymalna	Opcjonalnie	Maksymalna wartość skali ocen. Musi być podana, jeśli podana jest też aktualna wartość oceny.	Liczba >= 0,0
Rating - Current value	Opcjonalnie	Bieżąca wartość skali ocen. Musi być podana, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0.0
Rating - Count (Liczba ocen)	Opcjonalnie	Liczba ocen obiektu zakwaterunkowego. 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 mniejszych rozmiarach wyświetlacza.	Ciąg znaków
Rating - Count Value	Opcjonalnie	Liczba ocen obiektu zakwaterunkowego. Uwaga: wypełnij to pole, jeśli nie obsługujesz samodzielnie logiki wyświetlania skrótu. Jeśli występują zarówno parametry Liczba, jak i Wartość liczby, użytkownikom wyświetlana jest liczba.	Długie
Price - CurrentPrice	Wymagane warunkowo	Aktualna cena zakwaterowania. Musi być podana, jeśli podano cenę z przekreśleniem.	Tekst otwarty
Cena – przekreślona cena	Opcjonalnie	Pierwotna cena zakwaterowania, która jest przekreślona w interfejsie.	Dowolny tekst
Objaśnienie dotyczące ceny	Opcjonalnie	Podkreślenie ceny, aby poinformować o promocji, wydarzeniu lub rabacie dla członków programu lojalnościowego (jeśli są dostępne).	Tekst otwarty Zalecane rozmiary tekstu: poniżej 45 znaków (w przypadku zbyt długiego tekstu mogą być wyświetlane wielokropki)

StoreEntity

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

Atrybut	Wymaganie	Opis	Format
Plakat	Wymagany	Musisz podać co najmniej 1 obraz.	Wskazówki znajdziesz w specyfikacjach obrazów.
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	Identyfikator URI
Tytuł	Opcjonalnie	Nazwa sklepu.	Tekst otwarty Zalecany rozmiar tekstu: poniżej 45 znaków (zbyt długi tekst może zawierać wielokropki)
Lokalizacja	Opcjonalnie	Lokalizacja sklepu.	Dowolny tekst Zalecane rozmiary tekstu: poniżej 45 znaków (za długi tekst może zawierać wielokropki)
Objaśnienie	Opcjonalnie	Ramka z informacją o promocji, wydarzeniu lub aktualizacji sklepu (jeśli jest dostępna).	Tekst otwarty Zalecane rozmiary tekstu: poniżej 45 znaków (za długi tekst może zawierać wielokropki)
Drobny druk w ramach objaśnienia	Opcjonalnie	Drobny druk objaśnienia.	Tekst otwarty Zalecany rozmiar tekstu: poniżej 45 znaków (zbyt długi tekst może zawierać wielokropki)
Opis	Opcjonalnie	Opis sklepu.	Tekst otwarty Zalecana długość tekstu: poniżej 90 znaków (za długi tekst może być wyświetlany z wielokropem)
Ocena – wartość maksymalna	Opcjonalnie	Maksymalna wartość skali ocen. Musi być podana, jeśli podana jest też aktualna wartość oceny.	Liczba >= 0,0
Rating - Current value	Opcjonalnie	Bieżąca wartość skali ocen. Musi być podana, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0.0
Rating - Count (Liczba ocen)	Opcjonalnie	Liczba ocen obiektu zakwaterunkowego. Uwaga: wypełnij to pole, jeśli aplikacja ma kontrolować sposób wyświetlania tego elementu użytkownikom. Podaj zwięzły ciąg znaków, który będzie wyświetlany użytkownikowi. Jeśli na przykład liczba wynosi 1 000 000, możesz użyć skrótów, takich jak 1 mln, aby nie została przycięta na mniejszych ekranach.	Ciąg znaków
Rating - Count Value	Opcjonalnie	Liczba ocen obiektu zakwaterunkowego. Uwaga: podaj to pole, jeśli nie chcesz samodzielnie obsługiwać wyświetlanych skrótów. Jeśli występują zarówno liczba, jak i wartość liczby, wyświetlimy użytkownikom liczbę.	Długie

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	Identyfikator URI
Tytuł	Wymagany	Tytuł elementu.	Ciąg znaków Zalecany rozmiar tekstu: maks. 50 znaków
Plakat	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 w ramach logo znajduje się plakietka, należy zapewnić bezpieczną odległość 24 dp od góry i dołu obrazu.	Więcej informacji znajdziesz w specyfikacji zdjęć.
Lokalizacja – kraj	Wymagany	Kraj, w którym znajduje się punkt zainteresowania.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – miasto	Wymagany	Miasto, w którym znajduje się ciekawe miejsce.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Lokalizacja – wyświetlany adres	Wymagany	Adres punktu zainteresowania, który będzie wyświetlany użytkownikowi.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – adres	Opcjonalnie	Adres (jeśli dotyczy) danego miejsca.	Dowolny tekst Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – stan	Opcjonalnie	Województwo, w którym znajduje się ciekawe miejsce (jeśli ma zastosowanie).	Dowolny tekst Zalecany rozmiar tekstu: maksymalnie 20 znaków
Lokalizacja – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli dotyczy) danego miejsca.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – okolica	Opcjonalnie	Okolica (jeśli występuje) ciekawego miejsca.	Dowolny tekst Zalecany rozmiar tekstu: maksymalnie 20 znaków
AvailabilityTimeWindow – Start Time	Opcjonalnie	Sygnatura czasowa w epoce w milisekundach, kiedy punkt zainteresowania ma być otwarty/dostępny.	Sygnatura czasowa od początku epoki w milisekundach
AvailabilityTimeWindow – czas zakończenia	Opcjonalnie	Sygnatura czasowa epoki w milisekundach, do której punkt zainteresowania ma być otwarty/dostępny.	Sygnatura czasowa epoki w milisekundach
Odznaki	Opcjonalnie	Każda plakietka może zawierać dowolny tekst (maksymalnie 15 znaków) lub mały obraz.
Odznaka – tekst	Opcjonalnie	Tytuł plakietki Uwaga: na plakietce musi znajdować się tekst lub obraz.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 15 znaków
Plakietka – obraz	Opcjonalnie	Mały obraz specjalne wrażenia użytkownika, na przykład w postaci plakietki nałożonej na obrazie lub miniaturze filmu; Uwaga: na plakietce musi znajdować się tekst lub obraz.	Więcej informacji znajdziesz w specyfikacji zdjęć.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący daną encję. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	maksymalnie 3 napisy, z których każdy może zawierać jeden wiersz tekstu. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Ocena – wartość maksymalna	Opcjonalnie	Maksymalna wartość skali ocen. Musi być podana, jeśli podana jest też aktualna wartość oceny.	Liczba >= 0,0
Rating - Current value	Opcjonalnie	Bieżąca wartość skali ocen. Musi być podana, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0.0
Rating - Count (Liczba ocen)	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 na przykład liczba wynosi 1 000 000, możesz użyć skrótu w postaci 1 mln, aby nie był on obcinany na mniejszych ekranach.	Ciąg znaków
Rating - Count Value	Opcjonalnie	Liczba ocen ciekawego miejsca. Uwaga: wypełnij to pole, jeśli nie obsługujesz samodzielnie logiki skrótu wyświetlania. Jeśli występują zarówno parametry Liczba, jak i Wartość liczby, użytkownikom wyświetlana jest liczba	Długie
Price - CurrentPrice	Wymagane warunkowo	Aktualna cena biletów lub kart wstępu do atrakcji. Musi być podana, jeśli podano cenę z przekreśleniem.	Tekst otwarty
Cena – przekreślona cena	Opcjonalnie	Pierwotna cena biletów/kart wstępu do atrakcji.	Dowolny tekst
Objaśnienie dotyczące ceny	Opcjonalnie	Podkreślenie ceny, aby poinformować o promocji, wydarzeniu lub rabacie dla członków programu lojalnościowego (jeśli są dostępne).	Tekst otwarty Zalecane rozmiary tekstu: poniżej 45 znaków (w przypadku zbyt długiego tekstu mogą być wyświetlane wielokropki)
Kategorie treści	Opcjonalnie	Opisz kategorię treści znajdujących się w danym elemencie.	Lista typów wyliczeniowych spełniających wymagania TYPE_TRAVEL_AND_LOCAL TYPE_MOVIES_AND_TV_SHOWS (np. teatr) TYPE_MEDICAL (np. szpital) TYPE_EDUCATION (np. 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 elementu w aplikacji dostawcy. Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania	Identyfikator URI
Profil – Nazwa	Wymagany	Nazwa profilu lub identyfikator albo 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ć kwadratowy obraz o proporcjach 1:1.	Wskazówki znajdziesz w specyfikacjach obrazów.
Profil – dodatkowy tekst	Opcjonalnie	dowolny tekst, np. nazwa profilu;	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 15 znaków
Profil – dodatkowe zdjęcie	Opcjonalnie	mały obraz, np. plakietka zweryfikowanego konta;	Więcej informacji znajdziesz w specyfikacji zdjęć.
Obraz w nagłówku	Opcjonalnie	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 w ramach logo znajduje się plakietka, należy zapewnić bezpieczną odległość 24 dp od góry i dołu obrazu.	Więcej informacji znajdziesz w specyfikacji zdjęć.
Popularność – liczba	Opcjonalnie	Wskaż liczbę obserwujących lub wartość popularności, np. „3,7 mln”. Uwaga: jeśli podasz zarówno wartość Liczba, jak i wartość Liczba, zostanie użyta liczba	Ciąg znaków Zalecane rozmiary tekstu: maksymalnie 20 znaków dla liczby i etykiety łącznie
Popularność – wartość liczby	Opcjonalnie	Liczba obserwatorów lub wartość popularności. Uwaga: podaj wartość zliczania, jeśli aplikacja nie ma obsługiwać logiki optymalizacji dużych liczb pod kątem różnych rozmiarów wyświetlacza. Jeśli podasz zarówno wartość Liczba, jak i Wartość liczby, zostanie użyta liczba.	Długie
Popularność – etykieta	Opcjonalnie	Wskazać, czym jest etykieta popularności. Na przykład „Lubię to”.	Ciąg znaków Zalecany rozmiar tekstu: maksymalnie 20 znaków dla liczby i etykiety łącznie
Popularność – wizualizacja	Opcjonalnie	Wskazać, do czego służy interakcja. Na przykład: obraz przedstawiający ikonę polubienia lub emotikony. Możesz przesłać więcej niż 1 obraz, ale nie wszystkie mogą być wyświetlane w różnych formatach. Uwaga: wymagany jest kwadratowy obraz w formacie 1:1.	Więcej informacji znajdziesz w specyfikacji zdjęć.
Ocena – wartość maksymalna	Wymagane	Maksymalna wartość skali ocen. Musi być podana, jeśli podana jest też aktualna wartość oceny.	Liczba >= 0,0
Rating - Current value	Wymagane	Bieżąca wartość skali ocen. Musi być podana, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0.0
Rating - Count (Liczba ocen)	Opcjonalnie	Liczba ocen danej 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 ona obcięta w mniejszych rozmiarach wyświetlacza.	Ciąg znaków
Rating - Count Value	Opcjonalnie	Liczba ocen danej encji. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki wyświetlania skrótów. Jeśli występują zarówno liczba, jak i wartość liczby, wyświetlimy użytkownikom liczbę.	Długie
Lokalizacja – kraj	Opcjonalnie	Kraj, w którym znajduje się dana osoba lub w którym pełni służbę.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – miasto	Opcjonalnie	Miasto, w którym znajduje się użytkownik lub w którym świadczy usługi.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Lokalizacja – wyświetlany adres	Opcjonalnie	Użytkownik zobaczy adres, pod którym znajduje się dana osoba lub do którego jest kierowana.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – adres	Opcjonalnie	Adres (jeśli dotyczy) ulicy, na której znajduje się osoba lub która obsługuje klienta.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – stan	Opcjonalnie	Stan (jeśli dotyczy), w którym znajduje się dana osoba lub w którym pełni służbę.	Dowolny tekst Zalecany rozmiar tekstu: maksymalnie 20 znaków
Lokalizacja – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli występuje) miejsca, w którym znajduje się lub pracuje dana osoba.	Dowolny tekst Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – okolica	Opcjonalnie	Dzielnica (jeśli dotyczy), w której znajduje się lub w której pełni służbę dana osoba.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Odznaki	Opcjonalnie	Każda plakietka może zawierać dowolny tekst (maksymalnie 15 znaków) lub mały obraz.
Odznaka – tekst	Opcjonalnie	Tytuł plakietki Uwaga: na plakietce musi znajdować się tekst lub obraz.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 15 znaków
Plakietka – obraz	Opcjonalnie	Mały obraz specjalne wrażenia użytkownika, na przykład w postaci plakietki nałożonej na obrazie lub miniaturze filmu; Uwaga: plakietka musi zawierać tekst lub obraz.	Więcej informacji znajdziesz w specyfikacji zdjęć.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący daną encję. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	maksymalnie 3 napisy, z których każdy może zawierać jeden wiersz tekstu. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecane rozmiary tekstu dla każdego z napisów: maks. 50 znaków
Kategorie treści	Opcjonalnie	Opisz kategorię treści znajdujących się w danym elemencie.	Lista typów wyliczeniowych spełniających wymagania TYPE_HEALTH_AND_FITENESS (Przykład: trener jogi/fitnessu) TYPE_HOME_AND_AUTO (przykład: hydraulik) TYPE_SPORTS (Przykład – Player) TYPE_DATING Więcej informacji znajdziesz w sekcji Kategoria 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	Identyfikator URI
Tytuł	Wymagany	Tytuł elementu.	Ciąg znaków Zalecany rozmiar tekstu: maks. 50 znaków
Czas rozpoczęcia rezerwacji	Wymagany	Sygnatura czasowa epoki spodziewana w milisekundach, w której ma się rozpocząć rezerwacja.	Sygnatura czasowa od początku epoki w milisekundach
Lokalizacja – kraj	Wymagany	Kraj, w którym znajduje się restauracja.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – miasto	Wymagany	Miasto, w którym znajduje się restauracja.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Lokalizacja – wyświetlany adres	Wymagany	Adres restauracji, który będzie wyświetlany użytkownikowi.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – adres	Opcjonalnie	Adres restauracji (jeśli jest dostępny).	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – stan	Opcjonalnie	Województwo (jeśli dotyczy), w którym znajduje się restauracja.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Lokalizacja – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli dotyczy) restauracji.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – okolica	Opcjonalnie	Dzielnica (jeśli dotyczy) restauracji.	Dowolny tekst Zalecany rozmiar tekstu: maks. 20 znaków
obrazy plakatu,	Opcjonalnie	Jeśli podasz kilka obrazów, wyświetlimy tylko 1 z nich. Zalecany format obrazu to 16:9	Więcej informacji znajdziesz w specyfikacji zdjęć.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący daną encję. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	maksymalnie 3 napisy, z których każdy może zawierać jeden wiersz tekstu. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecane rozmiary tekstu dla każdego z napisów: 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 elementu w aplikacji dostawcy. Uwaga: na potrzeby atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania	Identyfikator URI
Tytuł	Wymagany	Tytuł elementu.	Ciąg znaków Zalecany rozmiar tekstu: maks. 50 znaków
Godzina rozpoczęcia	Wymagany	Sygnatura czasowa epoki, w której ma się rozpocząć zdarzenie. Uwaga: wartość ta jest podawana w milisekundach.	Sygnatura czasowa od początku epoki w milisekundach
Tryb zdarzenia	Wymagany	Pole, w którym należy wskazać, czy wydarzenie będzie wirtualne, stacjonarne czy obie te formy.	Typ enumeracji: VIRTUAL, IN_PERSON lub HYBRID
Lokalizacja – kraj	Wymagane warunkowo	Kraj, w którym odbywa się wydarzenie. Uwaga: pole wymagane w przypadku wydarzeń typu IN_PERSON lub HYBRID	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – miasto	Wymagane warunkowo	Miasto, w którym odbywa się wydarzenie. Uwaga: pole wymagane w przypadku wydarzeń typu IN_PERSON lub HYBRID	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Lokalizacja – wyświetlany adres	Wymagane warunkowo	Adres lub nazwa miejsca, w którym odbędzie się wydarzenie, który powinien być wyświetlany użytkownikowi. Uwaga: jest to wymagane w przypadku zdarzeń o typie IN_PERSON lub HYBRID.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – adres	Opcjonalnie	Adres (jeśli dotyczy) miejsca, w którym odbywa się wydarzenie.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – stan	Opcjonalnie	Stan lub prowincja (jeśli ma zastosowanie), w którym odbywa się wydarzenie.	Dowolny tekst Zalecany rozmiar tekstu: maksymalnie 20 znaków
Lokalizacja – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli występuje) miejsca, w którym odbywa się wydarzenie.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – okolica	Opcjonalnie	Dzielnica (jeśli dotyczy), w której odbywa się wydarzenie.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
obrazy plakatu,	Opcjonalnie	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 w ramach logo znajduje się plakietka, należy zapewnić bezpieczną odległość 24 dp od góry i dołu obrazu.	Więcej informacji znajdziesz w specyfikacji zdjęć.
Godzina zakończenia	Opcjonalnie	Znak czasu w epoce, w której ma się zakończyć zdarzenie. Uwaga: wartość ta jest podawana w milisekundach.	Sygnatura czasowa od początku epoki w milisekundach
Dostawca usług – nazwa	Opcjonalnie	Nazwa dostawcy usług. Uwaga: dostawca usługi musi podać tekst lub obraz.	tekst swobodny, Na przykład nazwa organizatora wydarzenia lub wycieczki.
Dostawca usług – obraz	Opcjonalnie	Logo lub obraz dostawcy usługi. Uwaga: dostawca usługi musi podać tekst lub obraz.	Wskazówki znajdziesz w specyfikacjach obrazów.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący daną encję. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	maksymalnie 3 napisy, z których każdy może zawierać jeden wiersz tekstu. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecane rozmiary tekstu dla każdego z napisów: maks. 50 znaków
Odznaki	Opcjonalnie	Każda plakietka może zawierać dowolny tekst (maksymalnie 15 znaków) lub mały obraz.
Odznaka – tekst	Opcjonalnie	Tytuł plakietki Uwaga: na plakietce musi znajdować się tekst lub obraz.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 15 znaków
Plakietka – obraz	Opcjonalnie	Mały obraz specjalne wrażenia użytkownika, na przykład w postaci plakietki nałożonej na obrazie lub miniaturze filmu; Uwaga: na plakietce musi znajdować się tekst lub obraz.	Więcej informacji znajdziesz w specyfikacji zdjęć.
Identyfikator rezerwacji	Opcjonalnie	Identyfikator rezerwacji na wydarzenie.	Tekst otwarty
Price - CurrentPrice	Wymagane warunkowo	Aktualna cena biletu na wydarzenie. Jeśli podano przekreśloną cenę, ta wartość jest wymagana.	Tekst otwarty
Cena – przekreślona cena	Opcjonalnie	Pierwotna cena biletu na wydarzenie.	Tekst otwarty
Objaśnienie dotyczące ceny	Opcjonalnie	Podkreślenie ceny, aby poinformować o promocji, wydarzeniu lub rabacie dla członków programu lojalnościowego (jeśli są dostępne).	Tekst otwarty Zalecane rozmiary tekstu: poniżej 45 znaków (w przypadku zbyt długiego tekstu mogą być wyświetlane wielokropki)
Ocena – wartość maksymalna	Opcjonalnie	Maksymalna wartość skali ocen. Musi być podana, jeśli podana jest też aktualna wartość oceny.	Liczba >= 0,0
Rating - Current value	Opcjonalnie	Bieżąca wartość skali ocen. Musi być podana, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0.0
Rating - Count (Liczba ocen)	Opcjonalnie	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 ona obcięta w mniejszych rozmiarach wyświetlacza.	Ciąg znaków
Rating - Count Value	Opcjonalnie	Liczba ocen zdarzenia. Uwaga: wypełnij to pole, jeśli nie chcesz samodzielnie obsługiwać logiki wyświetlania skrótów. Jeśli występują zarówno liczba, jak i wartość liczby, wyświetlimy użytkownikom liczbę.	Długie
Kategorie treści	Opcjonalnie	Opisz kategorię treści znajdujących się w danym elemencie.	Lista typów wyliczeniowych spełniających wymagania TYPE_MOVIES_AND_TV_SHOWS (np. Cinema) TYPE_DIGITAL_GAMES (np. e-sport) TYPE_MUSIC (np. koncert) TYPE_TRAVEL_AND_LOCAL (np. wycieczka, festiwal) TYPE_HEALTH_AND_FITENESS (np. zajęcia z jogi) TYPE_EDUCATION (np. Class) TYPE_SPORTS (np. gra Piłka nożna) TYPE_DATING (przykład: spotkanie) Więcej informacji znajdziesz w sekcji Kategoria 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	Identyfikator URI
Tytuł	Wymagany	Tytuł elementu.	tekst swobodny, 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 rezerwacji.	Sygnatura czasowa od początku epoki w milisekundach
Godzina wymeldowania	Wymagany	Sygnatura czasowa epoki w milisekundach, która reprezentuje godzinę wymeldowania w przypadku rezerwacji.	Sygnatura czasowa od początku epoki w milisekundach
Lokalizacja – kraj	Wymagany	Kraj, w którym znajduje się obiekt zakwaterowania.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – miasto	Wymagany	Miasto, w którym znajduje się hotel.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Lokalizacja – wyświetlany adres	Wymagany	Adres obiektu zakwaterowania, który będzie wyświetlany użytkownikowi.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – adres	Opcjonalnie	Adres (jeśli dotyczy) obiektu noclegowego.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – stan	Opcjonalnie	Stan lub prowincja (jeśli ma zastosowanie), w których znajduje się obiekt zakwaterowania.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Lokalizacja – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli dotyczy) miejsca zakwaterowania.	Dowolny tekst Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – okolica	Opcjonalnie	Okolica (jeśli dotyczy) zakwaterowania.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
obrazy plakatu,	Opcjonalnie	Jeśli podasz kilka obrazów, wyświetlimy tylko 1 z nich. Zalecany format obrazu to 16:9 Uwaga: jeśli dodasz plakietkę, pamiętaj o pozostawieniu 24 dps wolnego miejsca u góry i u dołu obrazu.	Wskazówki znajdziesz w specyfikacjach obrazów.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący daną encję. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	maksymalnie 3 napisy, z których każdy może zawierać jeden wiersz tekstu. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecane rozmiary tekstu dla każdego z napisów: maks. 50 znaków
Identyfikator rezerwacji	Opcjonalnie	Identyfikator rezerwacji miejsca zakwaterowania.	Tekst otwarty
Ocena – wartość maksymalna	Opcjonalnie	Maksymalna wartość skali ocen. Musi być podana, jeśli podana jest też aktualna wartość oceny.	Liczba >= 0,0
Rating - Current value	Opcjonalnie	Bieżąca wartość skali ocen. Musi być podana, jeśli podana jest też maksymalna wartość oceny.	Liczba >= 0.0
Rating - Count (Liczba ocen)	Opcjonalnie	Liczba ocen obiektu zakwaterunkowego. Uwaga: wypełnij to pole, jeśli aplikacja ma kontrolować sposób wyświetlania tego elementu użytkownikom. Podaj zwięzły ciąg znaków, który będzie wyświetlany użytkownikowi. Jeśli na przykład liczba wynosi 1 000 000, możesz użyć skrótów, takich jak 1 mln, aby nie została przycięta na mniejszych ekranach.	Ciąg znaków
Rating - Count Value	Opcjonalnie	Liczba ocen obiektu zakwaterunkowego. Uwaga: podaj to pole, jeśli nie chcesz samodzielnie obsługiwać wyświetlanych skrótów. Jeśli występują zarówno liczba, jak i wartość liczby, wyświetlimy użytkownikom liczbę.	Długie
Price - CurrentPrice	Wymagane warunkowo	Aktualna cena zakwaterowania. Musi być podana, jeśli podano cenę z przekreśleniem.	Tekst otwarty
Cena – przekreślona cena	Opcjonalnie	Pierwotna cena zakwaterowania, która jest przekreślona w interfejsie.	Dowolny tekst
Objaśnienie dotyczące ceny	Opcjonalnie	Podkreślenie ceny, aby poinformować o promocji, wydarzeniu lub rabacie dla członków programu lojalnościowego (jeśli są dostępne).	Tekst otwarty Zalecany rozmiar tekstu: poniżej 45 znaków (zbyt długi tekst może zawierać wielokropki)

TransportationReservationEntity

Atrybut	Wymaganie	Opis	Format
Identyfikator URI działania	Wymagany	Precyzyjny link do elementu w aplikacji dostawcy. Uwaga: na potrzeby atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania	Identyfikator URI
Tytuł	Wymagany	Tytuł elementu.	Dowolny tekst. Przykład: „SFO to SAN” Zalecany rozmiar tekstu: maks. 50 znaków
Typ transportu	Wymagany	Środek lub typ transportu dla rezerwacji.	Enum: FLIGHT, TRAIN, BUS lub FERRY
Godzina wylotu	Wymagany	Sygnatura czasowa w milisekundach od początku epoki, która reprezentuje czas wyjazdu.	Sygnatura czasowa od początku epoki w milisekundach
Godzina przyjazdu	Wymagany	Sygnatura czasowa w milisekundach od początku epoki, która reprezentuje czas przybycia.	Sygnatura czasowa od początku epoki w milisekundach
Miejsce wylotu – kraj	Opcjonalnie	Kraj wyjazdu.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce wylotu – miasto	Opcjonalnie	Miasto wylotu.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Miejsce wyjazdu – adres wyświetlania	Opcjonalnie	Miejsce wylotu, które będzie wyświetlane użytkownikowi.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce wylotu – adres	Opcjonalnie	Adres miejsca wylotu (jeśli dotyczy).	Dowolny tekst Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce wylotu – stan	Opcjonalnie	Województwo (jeśli dotyczy) miejsca wyjazdu.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce wylotu – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli dotyczy) miejsca wylotu.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce wylotu – dzielnica	Opcjonalnie	Dzielnica (jeśli jest dostępna) miejsca wyjazdu.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce docelowe – kraj	Opcjonalnie	Kraj przyjazdu.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Miejsce docelowe – miasto	Opcjonalnie	Miasto przybycia.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Miejsce docelowe – adres wyświetlany	Opcjonalnie	Lokalizacja przybycia, która będzie wyświetlana użytkownikowi.	Dowolny tekst Zalecany rozmiar tekstu: maksymalnie 20 znaków
Miejsce przybycia – adres	Opcjonalnie	Adres (jeśli dotyczy) miejsca docelowego.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Miejsce docelowe – stan	Opcjonalnie	Województwo (jeśli ma zastosowanie) miejsca przylotu.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce przyjazdu – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli dotyczy) miejsca docelowego.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Miejsce docelowe – dzielnica	Opcjonalnie	Okolica (jeśli dotyczy) miejsca docelowego.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Dostawca usług – nazwa	Opcjonalnie	Nazwa dostawcy usług. Uwaga: dostawca usługi musi podać tekst lub obraz.	Dowolny tekst. Na przykład nazwa linii lotniczej
Dostawca usług – obraz	Opcjonalnie	Logo lub obraz dostawcy usługi. Uwaga: dostawca usługi musi podać tekst lub obraz.	Więcej informacji znajdziesz w specyfikacji zdjęć.
obrazy plakatu,	Opcjonalnie	Jeśli podasz kilka obrazów, wyświetlimy tylko 1 z nich. Zalecany format obrazu to 16:9	Więcej informacji znajdziesz w specyfikacji zdjęć.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący daną encję. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	maksymalnie 3 napisy, z których każdy może zawierać jeden wiersz tekstu. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecane rozmiary tekstu dla każdego z napisów: maks. 50 znaków
Identyfikator rezerwacji	Opcjonalnie	Identyfikator rezerwacji transportu.	Tekst otwarty
Price - CurrentPrice	Wymagane warunkowo	Obecna cena rezerwacji. Musi być podana, jeśli podano cenę z przekreśleniem.	Tekst otwarty
Cena – przekreślona cena	Opcjonalnie	Pierwotna cena rezerwacji, która jest przekreślona w interfejsie użytkownika.	Dowolny tekst
Objaśnienie dotyczące ceny	Opcjonalnie	Podkreślenie ceny, aby poinformować o promocji, wydarzeniu lub rabacie dla członków programu lojalnościowego (jeśli są dostępne).	Tekst otwarty Zalecane rozmiary tekstu: poniżej 45 znaków (w przypadku zbyt długiego tekstu mogą być wyświetlane wielokropki)
Numer transportowy	Wymagane	Numer lotu, numer autobusu, numer pociągu lub numer promu/statku wycieczkowego.	Tekst otwarty
Wejście na pokład	Wymagane	sygnatura czasowa epoki, która reprezentuje czas wsiadania (jeśli dotyczy);	Sygnatura czasowa od początku 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	Identyfikator URI
Tytuł	Wymagany	Tytuł elementu.	tekst swobodny, Na przykład „Avis Union Square SF” Zalecany rozmiar tekstu: maks. 50 znaków
Godzina odbioru	Wymagany	Sygnatura czasowa epoki, która reprezentuje czas odbioru rezerwacji.	Sygnatura czasowa od początku epoki w milisekundach
Czas powrotu	Opcjonalnie	Sygnatura czasowa epoki, która reprezentuje czas wymeldowania z rezerwacji.	Sygnatura czasowa od początku epoki w milisekundach
Adres odbioru – kraj	Opcjonalnie	Kraj miejsca odbioru.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Adres odbioru – miasto	Opcjonalnie	Miasto, w którym znajduje się miejsce odbioru.	Dowolny tekst Zalecany rozmiar tekstu: maksymalnie 20 znaków
Adres odbioru – wyświetlany adres	Opcjonalnie	Miejsce odbioru, które będzie wyświetlane użytkownikowi.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Adres odbioru – adres ulicy	Opcjonalnie	Adres (jeśli dotyczy) miejsca odbioru.	Dowolny tekst Zalecany rozmiar tekstu: maks. 20 znaków
Adres odbioru – stan	Opcjonalnie	Województwo (jeśli występuje) miejsca odbioru.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Adres odbioru – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli dotyczy) miejsca odbioru.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Adres odbioru – okolica	Opcjonalnie	Dzielnica (jeśli jest potrzebna) miejsca odbioru.	Dowolny tekst Zalecany rozmiar tekstu: maks. 20 znaków
Adres zwrotny – kraj	Opcjonalnie	Kraj miejsca zwrotu.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Adres zwrotny – miasto	Opcjonalnie	Miasto, w którym znajduje się miejsce zwrotu.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Adres zwrotny – adres wyświetlany	Opcjonalnie	Miejsce zwrotu, które będzie wyświetlane użytkownikowi.	Dowolny tekst Zalecany rozmiar tekstu: maksymalnie 20 znaków
Adres zwrotny – adres ulicy	Opcjonalnie	Adres (jeśli dotyczy) miejsca zwrotu.	Dowolny tekst Zalecany rozmiar tekstu: maksymalnie 20 znaków
Adres zwrotny – stan	Opcjonalnie	Stan lub prowincja (jeśli ma zastosowanie) miejsca zwrotu.	Dowolny tekst Zalecany rozmiar tekstu: maks. 20 znaków
Adres zwrotny – kod pocztowy	Opcjonalnie	Kod pocztowy (jeśli dotyczy) miejsca zwrotu.	Tekst otwarty Zalecany rozmiar tekstu: maksymalnie 20 znaków
Adres zwrotny – dzielnica	Opcjonalnie	Okolica (jeśli dotyczy) miejsca zwrotu.	Tekst otwarty Zalecany rozmiar tekstu: maks. 20 znaków
Dostawca usług – nazwa	Opcjonalnie	Nazwa dostawcy usług. Uwaga: dostawca usługi musi podać tekst lub obraz.	tekst swobodny, Na przykład „Avis Car Rental”.
Dostawca usług – obraz	Opcjonalnie	Logo lub obraz dostawcy usługi. Uwaga: dostawca usług wymaga zarówno tekstu, jak i obrazu.	Wskazówki znajdziesz w specyfikacjach obrazów.
obrazy plakatu,	Opcjonalnie	Jeśli prześlesz kilka obrazów, wyświetlimy tylko jeden obraz. Zalecany format obrazu to 16:9	Więcej informacji znajdziesz w specyfikacji zdjęć.
Opis	Opcjonalnie	Jeden akapit tekstu opisujący daną encję. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecany rozmiar tekstu: 180 znaków
Lista napisów	Opcjonalnie	maksymalnie 3 napisy, z których każdy może zawierać jeden wiersz tekstu. Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.	Tekst otwarty Zalecane rozmiary tekstu dla każdego z napisów: maks. 50 znaków
Identyfikator potwierdzenia	Opcjonalnie	Identyfikator potwierdzenia rezerwacji wynajmu pojazdu.	Dowolny tekst
Price - CurrentPrice	Wymagane warunkowo	Obecna cena rezerwacji. Musi być podana, jeśli podano cenę z przekreśleniem.	Tekst otwarty
Cena – przekreślona cena	Opcjonalnie	Pierwotna cena rezerwacji, która jest przekreślona w interfejsie użytkownika.	Dowolny tekst
Objaśnienie dotyczące ceny	Opcjonalnie	Podkreślenie ceny, aby poinformować o promocji, wydarzeniu lub rabacie dla członków programu lojalnościowego (jeśli są dostępne).	Tekst otwarty Zalecane rozmiary tekstu: poniżej 45 znaków (w przypadku zbyt długiego tekstu mogą być wyświetlane wielokropki)

Specyfikacja obrazu

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

Format obrazu	Minimalna liczba pikseli	Zalecany rozmiar w pikselach
Kwadrat (1 x 1) Preferowany	300 x 300	1200 x 1200
Prostokąt w orientacji poziomej (1,91 x 1)	600 x 314	1200 x 628
Orientacja pionowa (4 x 5)	480 x 600	960x1200

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

Formaty plików

PNG, JPG, statyczny GIF, WebP

Maksymalny rozmiar pliku

5120 KB

Dodatkowe rekomendacje

• Bezpieczny obszar obrazu: ważne treści umieść w środkowych 80% obrazu.
• Użyj przezroczystego tła, aby obraz 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ą przypisywane do niektórych wstępnie zdefiniowanych kategorii, takich jak:

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

Obrazy muszą być hostowane w publicznych sieciach CDN, aby umożliwić Google dostęp do nich.

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

1. Niektóre elementy, takie jak ArticleEntity i GeneralFeaturedEntity, mogą korzystać ze wszystkich kategorii treści. W przypadku innych podmiotów, takich jak EventEntity, Event SelectionEntity czy PointOfInterestEntity, dostępna jest tylko część z tych kategorii. Zanim wypełnisz listę, sprawdź listę kategorii kwalifikujących się dla danego typu encji.

2. W przypadku niektórych kategorii treści użyj konkretnego typu elementu zamiast kombinacji elementów typu Element ogólny i ContentCategory:

   • TYPE_MOVIES_AND_TV_SHOWS – Zanim zaczniesz korzystać z elementów ogólnych, przejrzyj elementy z tego przewodnika po integracji.
   • TYPE_BOOKS – przed użyciem elementów ogólnych zapoznaj się z elementem EbookEntity.
   • TYPE_AUDIOBOOKS – przed użyciem elementów ogólnych sprawdź element AudiobookEntity.
   • TYPE_SHOPPING – zapoznaj się z obiektem ShoppingEntity, zanim użyjesz jednostek ogólnych.
   • TYPE_FOOD_AND_DRINK – przed użyciem elementów ogólnych zapoznaj się z elementami z przewodnika po integracji z jedzeniem.

3. Pole ContentCategory jest opcjonalne i powinno być 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 od najbardziej do najmniej trafnych. Najtrafniejszą kategorię treści umieść na początku listy.

Krok 2. Podaj dane klastra

Zaleca się, aby zadanie publikowania treści było wykonywane w tle (np. za pomocą narzędzia WorkManager) i zaplanowane w regularnych odstępach czasu lub w określonych zdarzeniach (na przykład za każdym razem, gdy użytkownik otworzy aplikację lub gdy użytkownik 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 można wyświetlić treści na urządzeniu.

Kotlin

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

Java

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

Uwaga: zdecydowanie zalecamy okresowe wykonywanie zadań w celu sprawdzania, czy usługa stanie się dostępna w późniejszym czasie. Dostępność usługi może się zmieniać w zależności od aktualizacji wersji Androida, aktualizacji aplikacji, instalacji i odinstalowania. Dzięki okresowym sprawdzaniu zadań w określonym odstępie czasu dane mogą być publikowane, gdy usługa stanie się dostępna.

publishRecommendationClusters

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

Ważne: interfejsy API publikowania to interfejsy API do wprowadzania zmian i zastępowania treści. Nie wywołuj interfejsów API do usuwania i publikowania, aby zastąpić treści, 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 wykonywane są te działania:

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

W przypadku błędu cała prośba jest odrzucana, a obecny stan jest zachowany.

publishFeaturedCluster

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

Ważne: interfejsy API 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ści, 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 PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

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

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

W przypadku błędu cała prośba jest odrzucana, a obecny stan jest zachowany.

publishContinuationCluster

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

Ważne: interfejsy API publikowania to interfejsy API do wprowadzania zmian i zastępowania treści. Nie wywołuj interfejsów API do usuwania i publikowania, aby zastąpić treści, 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 wykona te działania:

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

W przypadku błędu żądanie w całości jest odrzucane, a obecny stan zostaje zachowany.

publishUserAccountManagementRequest

Ten interfejs API służy do publikowania karty logowania. Logowanie kieruje użytkowników na stronę logowania w aplikacji, na której aplikacja może publikować treści (lub udostępniać treści bardziej spersonalizowane).

Te metadane są częścią karty logowania:

Atrybut	Wymaganie	Opis
Identyfikator URI działania	Wymagane	Precyzyjny link do działania (np. otwiera stronę logowania w aplikacji)
Obraz	Opcjonalnie – jeśli nie zostanie podany, należy podać tytuł.	Obraz na karcie obrazy w formacie 16 x 9 o rozdzielczości 1264 x 712;
Tytuł	Opcjonalnie – jeśli nie zostanie podany, należy podać obraz	Tytuł na karcie
Tekst wezwania do działania	Opcjonalnie	Tekst widoczny w wezwaniu do działania (np. „Zaloguj się”)
Podtytuł	Opcjonalnie	Opcjonalny tekst na karcie

Ważne: interfejsy API publikowania to interfejsy API do wprowadzania zmian i zastępowania treści. Nie wywołuj interfejsów API do usuwania i publikowania, aby zastąpić treści, 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 wykonywane są te działania:

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

W przypadku błędu cała prośba jest odrzucana, a obecny stan jest zachowany.

updatePublishStatus

Jeśli z jakiegokolwiek wewnętrznego powodu biznesowego żaden z tych klastrów nie został opublikowany, zdecydowanie zalecamy zaktualizowanie stanu publikacji za pomocą interfejsu updatePublishStatus API. Jest to ważne, ponieważ:

• Podanie stanu we wszystkich scenariuszach, nawet po opublikowaniu treści (STATUS == PUBLISHED), ma kluczowe znaczenie przy wypełnianiu paneli, które używają tego stanu wprost do przekazywania danych o stanie i innych wskaźnikach związanych z integracją.
• Jeśli nie ma opublikowanych treści, ale integracja nie jest uszkodzona (STATUS = NOT_PUBLISHED), Google może nie uruchamiać alertów na panelach danych dotyczących zdrowia w aplikacji. Potwierdza, że treści nie są publikowane z powodu oczekiwanej sytuacji z punktu widzenia dostawcy.
• Pomaga on deweloperom określić, kiedy dane są publikowane, a kiedy nie.
• Google może używać kodów stanu, aby skłonić użytkownika do wykonania określonych działań w aplikacji, aby mógł on wyświetlić zawartość aplikacji lub ją rozwiązać.

Lista kodów stanu odpowiednich 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 jakiegokolwiek powodu dostawcy nie mogą opublikować karty logowania, zalecamy wywołanie interfejsu 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 zawartości klastrów rekomendacji.

Ważne: interfejsy API do usuwania treści należy wywoływać tylko wtedy, gdy nie ma treści do opublikowania. Nie wywołuj kolejno interfejsów API do usuwania i publikowania, aby zastąpić treści, ponieważ interfejsy API do publikowania wykonują to automatycznie. Zanim skorzystasz z interfejsu Delete API, skontaktuj się z firmąEngage-developers@.

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

Gdy usługa otrzyma prośbę, usunie istniejące dane z klastrów rekomendacji. W przypadku błędu cała prośba jest odrzucana, a istniejący stan jest zachowany.

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

deleteFeaturedCluster

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

Ważne: interfejsy API do usuwania treści należy wywoływać tylko wtedy, gdy nie ma treści do opublikowania. Nie wywołuj kolejno interfejsów API do usuwania i publikowania, aby zastąpić treści, ponieważ interfejsy API do publikowania wykonują to automatycznie. Zanim użyjesz interfejsów API do usuwania, skontaktuj się z działem engage-developers@.

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

Gdy usługa otrzyma żądanie, usunie istniejące dane z klastra wyróżnionego. W przypadku błędu cała prośba jest odrzucana, a istniejący stan jest zachowany.

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

deleteContinuationCluster

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

Ważne: interfejsy API do usuwania treści należy wywoływać tylko wtedy, gdy nie ma treści do opublikowania. Nie wywołuj kolejno interfejsów API do usuwania i publikowania, aby zastąpić treści, ponieważ interfejsy API do publikowania wykonują to automatycznie. Zanim użyjesz interfejsów API do usuwania, skontaktuj się z działem engage-developers@.

Kotlin

client.deleteContinuationCluster()

Java

client.deleteContinuationCluster();

Po otrzymaniu żądania usługa usuwa istniejące dane z klastra kontynuacji. W przypadku błędu cała prośba jest odrzucana, a istniejący stan jest zachowany.

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

deleteUserManagementCluster

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

Ważne: interfejsy Delete API powinny być wywoływane tylko wtedy, gdy nie ma żadnej treści do opublikowania. Nie wywołuj kolejno interfejsów API do usuwania i publikowania, aby zastąpić treści, ponieważ interfejsy API do publikowania wykonują to automatycznie. Zanim skorzystasz z interfejsu Delete API, skontaktuj się z firmąEngage-developers@.

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

Gdy usługa otrzyma żądanie, usuwa istniejące dane z klastra UserAccountManagement. W przypadku błędu cała prośba jest odrzucana, a obecny stan jest zachowany.

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

deleteClusters

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

Ważne: interfejsy API do usuwania treści należy wywoływać tylko wtedy, gdy nie ma treści do opublikowania. Nie wywołuj kolejno interfejsów API do usuwania i publikowania, aby zastąpić treści, ponieważ interfejsy API do publikowania wykonują to automatycznie. Zanim użyjesz interfejsów API do usuwania, skontaktuj się z działem engage-developers@.

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());

Po otrzymaniu żądania usługa usuwa 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 żądanie w całości jest odrzucane, a obecny stan zostaje zachowany.

Obsługa błędów

Zdecydowanie zalecamy wsłuchiwanie się w wyniki zadania z interfejsów API do publikowania, aby móc podjąć dalsze działania w celu odzyskania i ponownego przesłania udanego zadania.

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 w postaci kodu 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 (na przykład 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żesz spróbować ponownie.
4	SERVICE_CALL_PERMISSION_DENIED	Rozmówca nie może nawiązać połączenia z usługą.
5	SERVICE_CALL_INVALID_ARGUMENT	Żądanie zawiera nieprawidłowe dane (na przykład więcej niż dozwolona liczba klastrów).
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 przesyłania

Oprócz wykonywania wywołań interfejsu Publishing Content API za pomocą zadania musisz też skonfigurować BroadcastReceiver, aby otrzymywać żądanie publikacji treści.

Intencje przesyłania strumieniowego służą głównie do ponownego aktywowania aplikacji i wymuszania synchronizacji danych. Intencje dotyczące transmisji nie są przeznaczone do wysyłania bardzo często. Jest ona wywoływana tylko wtedy, gdy usługa Engage stwierdzi, że treści mogą być nieaktualne (np. mają tydzień). Dzięki temu użytkownik ma pewność, że będzie mieć dostęp do aktualnych treści, nawet jeśli aplikacja nie była uruchamiana przez długi czas.

BroadcastReceiver trzeba skonfigurować na 2 sposoby:

• Dynamicznie zarejestruj wystąpienie klasy BroadcastReceiver za pomocą Context.registerReceiver(). Umożliwia to komunikację z aplikacji, które wciąż są 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))

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_FEATURED))

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION))
}

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

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED));

// Register Continuation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION));

}

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

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      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 Gdy otrzymasz ten zamiar, zalecamy rozpoczęcie rozmowy publishRecommendationClusters.
• com.google.android.engage.action.PUBLISH_FEATURED Gdy otrzymasz ten zamiar, zalecamy rozpoczęcie rozmowy publishFeaturedCluster.
• com.google.android.engage.action.PUBLISH_CONTINUATION Po otrzymaniu tej intencji zalecamy uruchomienie wywołania publishContinuationCluster.

Proces integracji

Szczegółowy przewodnik dotyczący weryfikacji integracji po jej zakończeniu znajdziesz w artykule Przepływ pracy w procesie integracji dla programistów Google dla Agencji.

Najczęstsze pytania

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

Kontakt

Jeśli masz pytania dotyczące procesu integracji, wyślij e-maila na adres [e-mail].

Dalsze kroki

Po zakończeniu tej integracji wykonaj te czynności:

• Wyślij e-maila na adres [e-mail] i załącz zintegrowany pakiet APK, który jest gotowy do przetestowania przez Google.
• Google przeprowadza weryfikację i sprawdza integrację wewnętrznie, aby upewnić się, że działa ona zgodnie z oczekiwaniami. Jeśli będą potrzebne zmiany, Google skontaktuje się z Tobą, podając niezbędne informacje.
• Gdy testy zostaną zakończone i nie trzeba będzie wprowadzać żadnych zmian, skontaktujemy się z Tobą, aby poinformować, że możesz rozpocząć publikowanie zaktualizowanego i zintegrowanego pakietu APK w Sklepie Play.
• Gdy Google potwierdzi, że zaktualizowany plik APK został opublikowany w Sklepie Play, Twoje klastry Rekomendacja, Polecane i Kontynuacja mogą zostać opublikowane i staną się widoczne dla użytkowników.