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

Google tworzy na urządzeniu platformę, która porządkuje aplikacje według branż i umożliwia korzystanie ze spersonalizowanych treści w aplikacji. i odkrywania. Dzięki temu partnerzy mogą mają możliwość zaprezentowania swoich najlepszych, bogatych materiałów na specjalnym kanale do aplikacji.

Ten dokument zawiera instrukcje dla deweloperów dotyczące integracji nowych treści takie jak rezerwacje, wydarzenia, zakwaterowanie, interesujące miejsca, ludzie i inne treści. które mogą nie należeć do żadnej z tych kategorii za pomocą pakietu SDK dla Agencji aby zapełnić tę nową powierzchnię.

Szczegóły integracji

Terminologia

Ta integracja obejmuje te 3 typy klastrów: Recommendation, Polecane i Kontynuacja.

  • Klastry rekomendacji pokazują spersonalizowane sugestie od poszczególnych użytkowników partnera w programie. To jest widok interfejsu, który zawiera grupę rekomendacji od tego samego partnera dewelopera.

    • ArticleEntity (obiekt artykułu) reprezentujący obiekt oparty na tekście Rekomendowane treści pasujące do więcej niż jednej kategorii treści. Element ArticleEntity umożliwia programistom udostępnianie różnych tekst i obraz z dodatkowymi metadanymi ułatwiającymi przekazanie informacji w porównaniu z klasyfikatorem Ogólna polecanyEntity. Np. treści marketingowe, Fragment wiadomości

      Rysunek 1. Interfejs przedstawiający pojedynczy element ArticleEntity w rekomendacjach klastra.

    • EventEntity: EventEntity reprezentuje zdarzenie odbywające się w w przyszłości. Godzina rozpoczęcia wydarzenia to kluczowa informacja, które należy przedstawić użytkownikom.

      Rysunek 2. Interfejs przedstawiający pojedynczy element EventEntity Klaster rekomendacji.

    • LodgingEntity: obiekt LodgingEntity oznacza zakwaterowanie, np. jako hotel, mieszkanie, dom wakacyjny – zarówno krótko, jak i długoterminowy do wypożyczenia.

      Rysunek 3. Interfejs przedstawiający pojedynczą obiekt LodgingEntity. w klastrze rekomendacji.

    • StoreEntity: sklep, restauracja, kawiarnia. itp. Wyróżnia ona treści, w których restauracja lub sklep kluczowe informacje, które muszą zostać przekazane użytkowników.

      Rysunek 4. Interfejs przedstawiający pojedynczy element StoreEntity Klaster rekomendacji.

    • PointOfInterestEntity: PointOfInterestEntity oznacza ciekawe miejsce, np. stacja benzynowa, miejsce wydarzeń, park rozrywki, muzeum, atrakcja turystyczna, szlak pieszy itd. Podkreśla zawartość w których lokalizacja to kluczowa informacja, która musi zostać do użytkowników. Nie należy go używać w przypadku miejsc zakwaterowania, sklepu ani w restauracji.

      Rysunek 5. Interfejs przedstawiający jeden PointOfInterestEntity w klastrze rekomendacji.

    • PersonEntity: PersonEntity oznacza osobę. Rekomendacje może wyróżnić osobę w kategoriach takich jak zdrowie i fitness, sport, randki itp.

      Rysunek 5. Interfejs przedstawiający pojedynczą osobę w obiekcie Klaster rekomendacji.

  • Klaster Kontynuacja pokazuje treści, które ostatnio angażują użytkowników z: z kilkoma partnerami deweloperów w jednym grupowaniu interfejsu użytkownika. Każdy partner deweloperów zezwolono na transmitowanie maksymalnie 10 elementów w ramach kontynuacji klastra.

    Kontynuacja może mieć taką strukturę:

    • ArticleEntity (obiekt artykułu) reprezentujący obiekt oparty na tekście Rekomendowane treści pasujące do więcej niż jednej kategorii treści. Ten element może służyć do reprezentowania niedokończonych wiadomości artykuły lub inne treści, które użytkownik chce przeglądać. od miejsca, w którym je zostawiliśmy. Np.: treści marketingowe, fragment wiadomości

      Rysunek 6. Interfejs przedstawiający pojedynczy element ArticleEntity w obrębie. klaster kontynuacji.

    • RestaurantRestaurantEntity: Reprezentuje RestaurantRestaurantEntity rezerwacji w restauracji lub kawiarni i pomaga użytkownikom śledzić o trwałe rezerwacje w restauracjach.

      Rysunek 7. Interfejs przedstawiający jeden RestaurantLabelEntity w klastrze kontynuacji.

    • EventLocationEntity: EventreservationEntity reprezentuje rezerwacja na wydarzenie i pomaga użytkownikom śledzić nadchodzące lub trwające wydarzenie rezerwacji wydarzeń. Zdarzenia mogą obejmować m.in.: :

      • wydarzenia sportowe, np. rezerwacja meczu piłki nożnej.
      • wydarzenia związane z grami, np. rezerwacja meczów e-sportowych;
      • wydarzenia rozrywkowe, takie jak rezerwacje filmów w kinie, koncert, teatr, podpisywanie książek
      • Rezerwacje związane z podróżami lub ważne miejsca, np. oprowadzanie, muzeum bilety
      • Rezerwacje na spotkania towarzyskie / seminaria / konferencje
      • Rezerwacje sesji szkoleniowych / edukacyjnych
      Rys. 8. Interfejs przedstawiający jeden EventRezerwacjaEntity w klastrze kontynuacji.

    • LodgingEntityUpdate: zapewnia rezerwację noclegu zarezerwowanie noclegu i pomoże użytkownikom śledzić trwające rezerwacje hoteli lub kwater wakacyjnych.

      Rysunek 9. Interfejs przedstawiający jeden Obiekt rezerwacji noclegu w klastrze kontynuacji.

    • TransportationRezerwacjaEntity: TransportationRezerwacja przedstawia rezerwację transportu dowolnym środkiem transportu i pomaga użytkownikom śledź rezerwacje nadchodzących lub trwających lotów, promów, pociągów, autobusów, rejsów lub rejsów wycieczkowych.

      Rysunek 10. Interfejs przedstawiający jeden TransportationRezerwacja w klastrze kontynuacji.

    • RegistrationRentalComparisonEntity: Zarezerwowane pojazdy. przedstawia rezerwację wynajmu pojazdu i pomaga użytkownikom śledzić lub aktualne rezerwacje wynajmu pojazdów.

      Rysunek 11. Interfejs przedstawiający jeden RegistrationRental SelectionEntity, w klastrze kontynuacyjnej.

  • Klaster Polecane to widok interfejsu, który pokazuje wybranego bohatera GenericFeaturedEntity od wielu deweloperów w ramach 1 grupy UI. Istnieje 1 polecany klaster, który znajduje się u góry Interfejs użytkownika z priorytetowym miejscem docelowym nad wszystkimi klastrami rekomendacji. Każdy partner dewelopera może transmitować 1 podmiot obsługiwanego wpisz Polecane wraz z wieloma elementami (potencjalnie różnych typów) z wielu deweloperów aplikacji w klastrze Polecane.

    • OgólnapolecanaEntity: Ogólnapolecana różni się od Polecany element tego elementu powinien być stosowany najlepszych materiałów deweloperów i powinny reprezentować które będą interesujące i przydatne dla użytkowników.

      Rysunek 12. Interfejs przedstawiający pojedynczy element powitalny Karta GenerativeFeaturedEntity w klastrze Polecany

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 opiera się na implementacji powiązanej usługi.

Dane, które klient może publikować, podlegają następującym limitom dla różnych typy klastrów:

Typ klastra Limity klastra Minimalne limity encji w klastrze Maksymalne limity encji 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 ma zdefiniowane różne jednostki reprezentujące każdy typ elementu. Wspieramy następujące jednostki w kategorii Inne:

  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: na potrzeby atrybucji możesz używać precyzyjnych linków. Zapoznaj się z tymi odpowiedziami na najczęstsze pytania

Identyfikator URI
Plakat Wymagany

Jeśli prześlesz kilka obrazów, wyświetlimy tylko jeden obraz. Zalecany format obrazu to 16:9

Uwaga: jeśli masz identyfikator, umieść go w bezpiecznym miejscu 24 dps na górze i na dole obrazu

 Wskazówki znajdziesz w specyfikacjach obrazów.
Tytuł Opcjonalnie Tytuł elementu.

Dowolny tekst

Zalecany rozmiar tekstu: 50 znaków
Opis Opcjonalnie

Jeden akapit tekstu opisujący element.

Uwaga: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

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: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Odznaki Opcjonalnie

Każda plakietka ma postać dowolnego tekstu (maks. 15 znaków) lub małego obrazu.

Specjalne wrażenia dotyczące obrazów/filmów, np. plakietka na obraz

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

Tytuł plakietki

Uwaga: plakietka musi zawierać tekst lub obraz.

Dowolny tekst

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

Mały obraz

Specjalne wrażenia, np. nakładka z plakietką na obraz lub film. miniaturę.

Uwaga: plakietka musi zawierać tekst lub obraz.

Wskazówki znajdziesz w specyfikacjach obrazów.
Kategorie treści Opcjonalnie Opisz kategorię treści znajdujących się w danym elemencie.

Lista enum

Zobacz sekcję Kategoria treści. .

ArticleEntity

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 tymi odpowiedziami na najczęstsze pytania

Identyfikator URI
Tytuł Wymagany Tytuł elementu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 50 znaków
Plakat Opcjonalnie

Jeśli prześlesz kilka obrazów, wyświetlimy tylko jeden obraz. Zalecany format obrazu to 16:9

Uwaga: zdecydowanie zalecamy użycie obrazu. Jeśli plakietka to należy zapewnić wolną przestrzeń 24 dps u góry i u dołu obraz

 Wskazówki znajdziesz w specyfikacjach obrazów.
Źródło – tytuł Opcjonalnie Imię i nazwisko autora, organizacji lub reportera

Dowolny tekst

Zalecany rozmiar tekstu: poniżej 25 znaków
Źródło – obraz Opcjonalnie Obraz źródła, np. autor, organizacja czy reporter Wskazówki znajdziesz w specyfikacjach obrazów.
Opis Opcjonalnie

Jeden akapit tekstu opisujący element.

Uwaga: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

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: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Odznaki Opcjonalnie

Każda plakietka ma postać dowolnego tekstu (maks. 15 znaków) lub małego obrazu.

Specjalne wrażenia dotyczące obrazów/filmów, np. plakietka na obraz

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

Tytuł plakietki

Uwaga: plakietka musi zawierać tekst lub obraz.

Dowolny tekst

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

Mały obraz

Specjalne wrażenia, np. nakładka z plakietką na obraz lub film. miniaturę.

Uwaga: plakietka musi zawierać tekst lub obraz.

Wskazówki znajdziesz w specyfikacjach obrazów.
Czas publikacji treści Opcjonalnie To jest sygnatura czasowa epoki (w milisekundach) od momentu, gdy treść opublikowane / zaktualizowane w aplikacji. Sygnatura czasowa epoki w milisekundach
Czas ostatniego zaangażowania Wymagane warunkowo

Sygnatura czasowa epoki (w milisekundach), z którą użytkownik wszedł w interakcję po raz ostatni.

Uwaga: to pole jest wymagane, jeśli ten element jest częścią klaster kontynuacji.

 Sygnatura czasowa epoki w milisekundach
Procent postępów 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ą klaster kontynuacji.

 Wartość całkowita z zakresu od 0 do 100 włącznie.
Kategorie treści Opcjonalnie Opisz kategorię treści znajdujących się w danym elemencie.

Lista enum

Zobacz sekcję Kategoria treści. .

EventEntity

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 tymi 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 początku epoki.

Uwaga: wartość zostanie podana w milisekundach.

 Sygnatura czasowa epoki w milisekundach
Tryb zdarzenia Wymagany

Pole, które określa, czy wydarzenie odbędzie się online, stacjonarnie czy i jednym, i drugim.

 Enum: VIRTUAL, IN_PERSON lub HYBRID
Plakat Wymagany

Jeśli prześlesz kilka obrazów, wyświetlimy tylko jeden obraz. Zalecany format obrazu to 16:9

Uwaga: zdecydowanie zalecamy użycie obrazu. Jeśli plakietka to należy zapewnić wolną przestrzeń 24 dps u góry i u dołu obraz

 Wskazówki znajdziesz w specyfikacjach obrazów.
Lokalizacja – kraj Wymagane warunkowo

Kraj, w którym odbywa się wydarzenie.

Uwaga: to pole jest wymagane w przypadku wydarzeń o charakterze IN_PERSON lub HYBRYDOWE

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – miasto Wymagane warunkowo

Miasto, w którym odbywa się wydarzenie.

Uwaga: to pole jest wymagane w przypadku wydarzeń o charakterze IN_PERSON lub HYBRYDOWE

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – wyświetlany adres Wymagane warunkowo

Adres lub nazwa miejsca, w którym odbędzie się wydarzenie. Powinny które będą wyświetlane użytkownikowi.

Uwaga: to pole jest wymagane w przypadku wydarzeń o charakterze IN_PERSON lub HYBRYDOWE

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – adres Opcjonalnie Ulica i numer (jeśli dotyczy) miejsca, w którym odbywa się wydarzenie na serwerze Google Cloud.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – województwo Opcjonalnie Województwo (jeśli dotyczy), w którym odbywa się wydarzenie na serwerze Google.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – kod pocztowy Opcjonalnie Kod pocztowy (jeśli dotyczy) lokalizacji, w której odbywa się wydarzenie na serwerze Google.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – okolica Opcjonalnie Dzielnica (jeśli dotyczy), w której odbywa się wydarzenie.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Godzina zakończenia Opcjonalnie

Sygnatura czasowa epoki, w której zdarzenie ma się zakończyć.

Uwaga: wartość zostanie podana w milisekundach.

 Sygnatura czasowa epoki w milisekundach
Opis Opcjonalnie

Jeden akapit tekstu opisujący element.

Uwaga: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

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: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Odznaki Opcjonalnie

Każda plakietka ma postać dowolnego tekstu (maks. 15 znaków) lub małego obrazu.
Plakietka – tekst Opcjonalnie

Tytuł plakietki

Uwaga: plakietka musi zawierać tekst lub obraz.

Dowolny tekst

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

Mały obraz

Specjalne wrażenia, np. nakładka z plakietką na obraz lub film. miniaturę.

Uwaga: plakietka musi zawierać tekst lub obraz.

Wskazówki znajdziesz w specyfikacjach obrazów.
Cena – aktualna cena Wymagane warunkowo

Aktualna cena biletu na wydarzenie.

Wartość ta jest wymagana, jeśli podano przekreśloną cenę.

Dowolny tekst
Cena – przekreślona cena Opcjonalnie Pierwotna cena biletu na wydarzenie. Dowolny tekst
Objaśnienie dotyczące ceny Opcjonalnie Objaśnienie dotyczące ceny z informacją o promocji, wydarzeniu lub zniżce dla subskrybentów, jeśli jest dostępna.

Dowolny tekst

Zalecany rozmiar tekstu: poniżej 45 znaków (zbyt długi tekst) mogą wyświetlać wielokropki).
Kategorie treści Opcjonalnie Opisz kategorię treści znajdujących się w danym elemencie.

Lista odpowiednich wyliczenia

  • 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: zwiedzanie, festiwal)
  • TYPE_HEALTH_AND_FITENESS (przykład: zajęcia jogi)
  • TYPE_EDUCATION (przykład – klasa)
  • TYPE_SPORTS (przykład – mecz piłki nożnej)
  • TYPE_DATING (przykład: spotkanie)

Zobacz sekcję Kategoria treści. .

LodgingEntity

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 najczęstszymi pytaniami

Identyfikator URI
Tytuł Wymagany Tytuł elementu.

Ciąg znaków

Zalecany rozmiar tekstu: maks. 50 znaków
Plakat Wymagany

Jeśli prześlesz kilka obrazów, wyświetlimy tylko jeden obraz. Zalecane działania format obrazu to 16:9.

Uwaga: jeśli masz identyfikator, umieść go w bezpiecznym miejscu 24 dps na górze i na dole obrazu

Wskazówki znajdziesz w specyfikacjach obrazów.
Lokalizacja – kraj Wymagany Kraj, w którym znajduje się zakwaterowanie.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – miasto Wymagany Miasto, w którym znajduje się hotel.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 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. 20 znaków
Lokalizacja – adres Opcjonalnie Ulica i numer (jeśli dotyczy) miejsca zamieszkania.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – województwo Opcjonalnie stan lub województwo (jeśli dotyczy), w którym znajduje się zakwaterowanie; z siedzibą firmy.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – kod pocztowy Opcjonalnie Kod pocztowy miejsca zakwaterowania (jeśli jest wymagany).

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – okolica Opcjonalnie Dzielnica (jeśli dotyczy) hotelu,

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Odznaki Opcjonalnie

Każda plakietka ma postać dowolnego tekstu (maks. 15 znaków) lub małego obrazu.
Plakietka – tekst Opcjonalnie

Tytuł plakietki

Uwaga: plakietka musi zawierać tekst lub obraz.

Dowolny tekst

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

Mały obraz

Specjalne wrażenia, np. nakładka z plakietką na obraz lub film. miniaturę.

Uwaga: plakietka musi zawierać tekst lub obraz.

Wskazówki znajdziesz w specyfikacjach obrazów.
Opis Opcjonalnie

Jeden akapit tekstu opisujący element.

Uwaga: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

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: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
AvailabilityTimeWindow – czas rozpoczęcia Opcjonalnie Sygnatura czasowa epoki (w milisekundach), w której ma być zakwaterowanie otwarte/dostępne. Sygnatura czasowa epoki w milisekundach
AvailabilityTimeWindow – czas zakończenia Opcjonalnie Sygnatura czasowa epoki (w milisekundach), do której spodziewane jest zakwaterowanie że powinna być otwarta/dostępna. Sygnatura czasowa epoki w milisekundach
Ocena – wartość maksymalna Opcjonalnie

Maksymalna wartość skali ocen.

Ten atrybut musi być podany, jeśli bieżąca wartość oceny jest również

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

Bieżąca wartość skali ocen.

Ten atrybut musi być podany, jeśli maksymalna wartość oceny wynosi również

Liczba >= 0.0
Ocena – liczba Opcjonalnie

Liczba ocen hotelu.

Uwaga: wypełnij to pole, jeśli Twoja aplikacja określa sposób wyświetlania liczby użytkownikom. Używaj zwięzłego ciągu znaków. Jeśli np. liczba wynosi 1 000 000, możesz użyć skrótu np. 1 mln, aby w przypadku mniejszych wyświetlaczy liczba nie była obcinana.

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

Liczba ocen hotelu.

Uwaga: podaj to pole, jeśli nie zajmujesz się musisz samodzielnie stosować skróty klawiszowe. Jeśli zarówno liczba, jak i wartość liczby wartość jest wyświetlana użytkownikom.

 Długie
Cena – aktualna cena Wymagane warunkowo

Aktualna cena zakwaterowania.

Jeśli podano przekreśloną cenę, ta wartość jest wymagana.

Dowolny tekst
Cena – przekreślona cena Opcjonalnie Pierwotna cena zakwaterowania, która będzie przekreślona Interfejs. Dowolny tekst
Objaśnienie dotyczące ceny Opcjonalnie Objaśnienie dotyczące ceny z informacją o promocji, wydarzeniu lub zniżce dla subskrybentów, jeśli jest dostępna.

Dowolny tekst

Zalecany rozmiar tekstu: poniżej 45 znaków (zbyt długi tekst) mogą wyświetlać wielokropki).

StoreEntity

Obiekt StoreEntity reprezentuje konkretny sklep współpracujących z deweloperem. które chcesz opublikować, np. w restauracji lub sklepie spożywczym.

Atrybut Wymaganie Opis Format
Plakat Wymagany Musisz przesłać co najmniej 1 obraz. Wskazówki znajdziesz w specyfikacjach obrazów.
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 najczęstszymi pytaniami

Identyfikator URI
Tytuł Opcjonalnie Nazwa sklepu.

Dowolny tekst

Zalecany rozmiar tekstu: poniżej 45 znaków (tekst za długi tekst może zawierać wielokropki)
Lokalizacja Opcjonalnie Lokalizacja sklepu.

Dowolny tekst

Zalecany rozmiar tekstu: poniżej 45 znaków (tekst za długi tekst może zawierać wielokropki)
Objaśnienie Opcjonalnie Objaśnienie, które powinno zawierać promocję, wydarzenie lub aktualizację sklepu, jeśli i dostępności informacji.

Dowolny tekst

Zalecany rozmiar tekstu: poniżej 45 znaków (tekst za długi tekst może zawierać wielokropki)
Objaśnienie drobnym drukiem Opcjonalnie Drobny tekst objaśnienia.

Dowolny tekst

Zalecany rozmiar tekstu: poniżej 45 znaków (tekst za długi tekst może zawierać wielokropki)
Opis Opcjonalnie Opis sklepu.

Dowolny tekst

Zalecany rozmiar tekstu: poniżej 90 znaków (czyli za długi tekst może zawierać wielokropki)
Ocena – wartość maksymalna Opcjonalnie

Maksymalna wartość skali ocen.

Ten atrybut musi być podany, jeśli bieżąca wartość oceny jest również

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

Bieżąca wartość skali ocen.

Ten atrybut musi być podany, jeśli maksymalna wartość oceny wynosi również

Liczba >= 0.0
Ocena – liczba Opcjonalnie

Liczba ocen hotelu.

Uwaga: wypełnij to pole, jeśli aplikacja chce: kontrolować sposób wyświetlania informacji użytkownikom. Podaj zwięzły ciąg znaków które można wyświetlać użytkownikowi. Jeśli na przykład liczba to 1 000 000, rozważ użycie skrótów, takich jak 1M, aby uniknąć na mniejszych ekranach.

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

Liczba ocen hotelu.

Uwaga: podaj to pole, jeśli nie chcesz przetwarzać musisz samodzielnie stosować skróty klawiszowe. Jeśli zarówno liczba, jak i wartość liczby użyjemy liczby, aby wyświetlić je użytkownikom

 Długie

PointOfInterestEntity

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 najczęstszymi pytaniami

Identyfikator URI
Tytuł Wymagany Tytuł elementu.

Ciąg znaków

Zalecany rozmiar tekstu: maks. 50 znaków
Plakat Wymagany

Jeśli prześlesz kilka obrazów, wyświetlimy tylko jeden obraz. Zalecany format obrazu to 16:9

Uwaga: zdecydowanie zalecamy użycie obrazu. Jeśli plakietka to należy zapewnić wolną przestrzeń 24 dps u góry i u dołu obraz

 Wskazówki znajdziesz w specyfikacjach obrazów.
Lokalizacja – kraj Wymagany Kraj, w którym znajduje się dane miejsce.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – miasto Wymagany Miasto, w którym znajduje się dane miejsce.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – wyświetlany adres Wymagany Adres ciekawego miejsca, które będzie wyświetlane użytkownika.

Dowolny tekst

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 – województwo Opcjonalnie Województwo (jeśli dotyczy), w którym znajduje się ciekawe miejsce z siedzibą firmy.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – kod pocztowy Opcjonalnie Kod pocztowy (jeśli dotyczy) danego miejsca.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – okolica Opcjonalnie Dzielnica (jeśli dotyczy) interesującego Cię miejsca.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
AvailabilityTimeWindow – czas rozpoczęcia Opcjonalnie Sygnatura czasowa epoki (w milisekundach), gdy ciekawe miejsce to który powinien być otwarty i dostępny. Sygnatura czasowa epoki w milisekundach
AvailabilityTimeWindow – czas zakończenia Opcjonalnie Sygnatura czasowa epoki (w milisekundach), do której należy ciekawe miejsce który powinien być otwarty i dostępny. Sygnatura czasowa epoki w milisekundach
Odznaki Opcjonalnie

Każda plakietka ma postać dowolnego tekstu (maks. 15 znaków) lub małego obrazu.
Plakietka – tekst Opcjonalnie

Tytuł plakietki

Uwaga: plakietka musi zawierać tekst lub obraz.

Dowolny tekst

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

Mały obraz

Specjalne wrażenia, np. nakładka z plakietką na obraz lub film. miniaturę.

Uwaga: plakietka musi zawierać tekst lub obraz.

Wskazówki znajdziesz w specyfikacjach obrazów.
Opis Opcjonalnie

Jeden akapit tekstu opisujący element.

Uwaga: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

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: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Ocena – wartość maksymalna Opcjonalnie

Maksymalna wartość skali ocen.

Ten atrybut musi być podany, jeśli bieżąca wartość oceny jest również

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

Bieżąca wartość skali ocen.

Ten atrybut musi być podany, jeśli maksymalna wartość oceny wynosi również

Liczba >= 0.0
Ocena – liczba Opcjonalnie

Liczba ocen wybranego miejsca.

Uwaga: wypełnij to pole, jeśli Twoja aplikacja określa sposób wyświetlania liczby użytkownikom. Używaj zwięzłego ciągu znaków. Jeśli np. liczba wynosi 1 000 000, możesz użyć skrótu np. 1 mln, aby w przypadku mniejszych wyświetlaczy liczba nie była obcinana.

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

Liczba ocen wybranego miejsca.

Uwaga: podaj to pole, jeśli nie zajmujesz się wyświetlania skrótów. Jeśli zarówno liczba, jak i wartość liczby wartość jest widoczna, ale użytkownicy widzą liczbę.

 Długie
Cena – aktualna cena Wymagane warunkowo

Aktualna cena biletów wstępu do miejsca a interesem publicznym.

Wartość ta jest wymagana, jeśli podano przekreśloną cenę.

Dowolny tekst
Cena – przekreślona cena Opcjonalnie Pierwotna cena biletów wstępu do danego miejsca. Dowolny tekst
Objaśnienie dotyczące ceny Opcjonalnie Objaśnienie dotyczące ceny z informacją o promocji, wydarzeniu lub zniżce dla subskrybentów, jeśli jest dostępna.

Dowolny tekst

Zalecany rozmiar tekstu: poniżej 45 znaków (zbyt długi tekst może pokaż wielokropki).

Kategorie treści Opcjonalnie Opisz kategorię treści znajdujących się w danym elemencie.

Lista odpowiednich wyliczenia

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

Zobacz sekcję Kategoria treści. .

PersonEntity

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 najczęstszymi pytaniami

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ć kwadratowe zdjęcie o proporcjach 1:1.

 Wskazówki znajdziesz w specyfikacjach obrazów.
Profil – dodatkowy tekst Opcjonalnie Dowolny tekst, taki jak nick profilu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 15 znaków
Profil – dodatkowe zdjęcie Opcjonalnie Mały obraz, np. plakietka weryfikacyjna. Wskazówki znajdziesz w specyfikacjach obrazów.
Obraz w nagłówku Opcjonalnie

Jeśli prześlesz kilka obrazów, wyświetlimy tylko jeden obraz. Zalecany format obrazu to 16:9

Uwaga: zdecydowanie zalecamy użycie obrazu. Jeśli plakietka to należy zapewnić wolną przestrzeń 24 dps u góry i u dołu obraz

 Wskazówki znajdziesz w specyfikacjach obrazów.
Popularność – liczba Opcjonalnie

Reprezentuje obraz nagłówka. Musi różnić się od zdjęcia profilowego. Można go użyć, jeśli istnieje dodatkowe zdjęcie, które pomaga podkreślić cenią sobie jego pracę.

Uwaga: obraz musi mieć proporcje 16:9. Po udostępnieniu plakietki Zapewnij bezpieczną przestrzeń o wysokości 24 dps u góry i u dołu obrazu

Ciąg znaków

Zalecany rozmiar tekstu: maks. 20 znaków w przypadku liczby + etykiety łącznie
Popularność – wartość liczby Opcjonalnie

Liczba obserwatorów lub wartość popularności.

Uwaga: podaj wartość liczby, jeśli aplikacja nie chce która określa logikę optymalizacji dużych liczb różnych rozmiarów reklam displayowych. Jeśli podasz zarówno liczbę, jak i wartość liczby, Zostanie użyta liczba.

Długie
Popularność – etykieta Opcjonalnie Określ, jaka jest etykieta popularności. Na przykład „Polubione”.

Ciąg znaków

Zalecany rozmiar tekstu: maks. 20 znaków w przypadku liczby + etykiety łącznie
Popularność – treści wizualne Opcjonalnie

Wskaż, do czego służy dana interakcja. Na przykład: Obraz jest wyświetlany Ikona polubień, emotikony.

Można dodać więcej niż 1 obraz, ale nie wszystkie będą wyświetlane na wszystkich i formatów.

Uwaga: wymagany jest kwadratowy obraz w formacie 1:1.

 Wskazówki znajdziesz w specyfikacjach obrazów.
Ocena – wartość maksymalna Wymagane

Maksymalna wartość skali ocen.

Ten atrybut musi być podany, jeśli bieżąca wartość oceny jest również

Liczba >= 0.0
Ocena – bieżąca wartość Wymagane

Bieżąca wartość skali ocen.

Ten atrybut musi być podany, jeśli maksymalna wartość oceny wynosi również

Liczba >= 0.0
Ocena – liczba Opcjonalnie

Liczba ocen elementu.

Uwaga: wypełnij to pole, jeśli aplikacja chce: kontrolować sposób wyświetlania informacji użytkownikom. Podaj zwięzły ciąg znaków które można wyświetlać użytkownikowi. Jeśli na przykład liczba to 1 000 000, rozważ użycie skrótów, takich jak 1M, aby uniknąć na mniejszych ekranach.

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

Liczba ocen elementu.

Uwaga: podaj to pole, jeśli nie chcesz przetwarzać musisz samodzielnie stosować skróty klawiszowe. Jeśli zarówno liczba, jak i wartość liczby użyjemy liczby, aby wyświetlić je użytkownikom

 Długie
Lokalizacja – kraj Opcjonalnie Kraj, w którym znajduje się lub świadczy usługi.

Dowolny tekst

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.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – wyświetlany adres Opcjonalnie Adres, pod którym znajduje się osoba lub gdzie jest wyświetlana, będzie wyświetlany użytkownika.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – adres Opcjonalnie adres (w stosownych przypadkach) pod którym znajduje się dana osoba; wyświetlania reklam.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – województwo Opcjonalnie Województwo (jeśli dotyczy), w którym znajduje się lub działa dana osoba.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – kod pocztowy Opcjonalnie Kod pocztowy (jeśli dotyczy), pod którym znajduje się użytkownik lub pod którym działa.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – okolica Opcjonalnie Dzielnica (jeśli dotyczy), w której znajduje się lub działa dana osoba.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Odznaki Opcjonalnie

Każda plakietka ma postać dowolnego tekstu (maks. 15 znaków) lub małego obrazu.
Plakietka – tekst Opcjonalnie

Tytuł plakietki

Uwaga: plakietka musi zawierać tekst lub obraz.

Dowolny tekst

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

Mały obraz

Specjalne wrażenia, np. nakładka z plakietką na obraz lub film. miniaturę.

Uwaga: plakietka musi zawierać tekst lub obraz.

Wskazówki znajdziesz w specyfikacjach obrazów.
Opis Opcjonalnie

Jeden akapit tekstu opisujący element.

Uwaga: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

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: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Kategorie treści Opcjonalnie Opisz kategorię treści znajdujących się w danym elemencie.

Lista odpowiednich wyliczenia

  • TYPE_HEALTH_AND_FITENESS (przykład: joga/trener fitness)
  • TYPE_HOME_AND_AUTO (przykład: hydraulik)
  • TYPE_SPORTS (przykład – gracz)
  • TYPE_Randki

Zobacz sekcję Kategoria treści. .

RestaurantReservationEntity

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 najczęstszymi pytaniami

Identyfikator URI
Tytuł Wymagany Tytuł elementu.

Ciąg znaków

Zalecany rozmiar tekstu: maks. 50 znaków
Godzina rozpoczęcia rezerwacji Wymagany Sygnatura czasowa epoki (w milisekundach), w której spodziewana jest rezerwacja i rozpoczęcia odtwarzania. Sygnatura czasowa epoki w milisekundach
Lokalizacja – kraj Wymagany Kraj, w którym znajduje się restauracja.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – miasto Wymagany Miasto, w którym znajduje się restauracja.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – wyświetlany adres Wymagany Adres restauracji, który będzie wyświetlany użytkownika.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – adres Opcjonalnie Adres restauracji (jeśli jest dostępny).

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – województwo Opcjonalnie Województwo (jeśli dotyczy), w którym znajduje się restauracja z siedzibą firmy.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – kod pocztowy Opcjonalnie Kod pocztowy restauracji (jeśli jest wymagany).

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – okolica Opcjonalnie Dzielnica (jeśli jest dostępna) restauracji.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Plakat Opcjonalnie Jeśli prześlesz kilka obrazów, wyświetlimy tylko jeden obraz. Zalecane działania format obrazu to 16:9. Wskazówki znajdziesz w specyfikacjach obrazów.
Opis Opcjonalnie

Jeden akapit tekstu opisujący element.

Uwaga: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

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: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Rozmiar 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 najczęstszymi pytaniami

Identyfikator URI
Tytuł Wymagany Tytuł elementu.

Ciąg znaków

Zalecany rozmiar tekstu: maks. 50 znaków
Godzina rozpoczęcia Wymagany

Sygnatura czasowa początku epoki.

Uwaga: wartość zostanie podana w milisekundach.

 Sygnatura czasowa epoki w milisekundach
Tryb zdarzenia Wymagany

Pole, które określa, czy wydarzenie odbędzie się online, stacjonarnie czy i jednym, i drugim.

 Enum: VIRTUAL, IN_PERSON lub HYBRID
Lokalizacja – kraj Wymagane warunkowo

Kraj, w którym odbywa się wydarzenie.

Uwaga: to pole jest wymagane w przypadku wydarzeń o charakterze IN_PERSON lub HYBRYDOWE

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – miasto Wymagane warunkowo

Miasto, w którym odbywa się wydarzenie.

Uwaga: to pole jest wymagane w przypadku wydarzeń o charakterze IN_PERSON lub HYBRYDOWE

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – wyświetlany adres Wymagane warunkowo

Adres lub nazwa miejsca, w którym odbędzie się wydarzenie. Powinny które będą wyświetlane użytkownikowi.

Uwaga: to pole jest wymagane w przypadku wydarzeń o charakterze IN_PERSON lub HYBRYDOWE

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – adres Opcjonalnie Ulica i numer (jeśli dotyczy) miejsca, w którym odbywa się wydarzenie na serwerze Google Cloud.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – województwo Opcjonalnie Województwo (jeśli dotyczy), w którym odbywa się wydarzenie na serwerze Google.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – kod pocztowy Opcjonalnie Kod pocztowy (jeśli dotyczy) lokalizacji, w której odbywa się wydarzenie na serwerze Google.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – okolica Opcjonalnie Dzielnica (jeśli dotyczy), w której odbywa się wydarzenie.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Plakat Opcjonalnie

Jeśli prześlesz kilka obrazów, wyświetlimy tylko jeden obraz. Zalecany format obrazu to 16:9

Uwaga: zdecydowanie zalecamy użycie obrazu. Jeśli plakietka to należy zapewnić wolną przestrzeń 24 dps u góry i u dołu obraz

 Wskazówki znajdziesz w specyfikacjach obrazów.
Godzina zakończenia Opcjonalnie

Sygnatura czasowa epoki, w której zdarzenie ma się zakończyć.

Uwaga: wartość zostanie podana w milisekundach.

 Sygnatura czasowa epoki w milisekundach
Dostawca usług – nazwa Opcjonalnie

Nazwa dostawcy usług.

Uwaga: w przypadku usługi wymagane jest przesłanie zarówno tekstu, jak i obrazu. dostawcy usług.

Dowolny tekst. Na przykład nazwa organizatora wydarzenia lub wycieczki.
Dostawca usług – obraz Opcjonalnie

Logo/obraz dostawcy usług.

Uwaga: w przypadku usługi wymagane jest przesłanie zarówno tekstu, jak i obrazu. dostawcy usług.

Wskazówki znajdziesz w specyfikacjach obrazów.
Opis Opcjonalnie

Jeden akapit tekstu opisujący element.

Uwaga: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

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: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Odznaki Opcjonalnie

Każda plakietka ma postać dowolnego tekstu (maks. 15 znaków) lub małego obrazu.
Plakietka – tekst Opcjonalnie

Tytuł plakietki

Uwaga: plakietka musi zawierać tekst lub obraz.

Dowolny tekst

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

Mały obraz

Specjalne wrażenia, np. nakładka z plakietką na obraz lub film. miniaturę.

Uwaga: plakietka musi zawierać tekst lub obraz.

Wskazówki znajdziesz w specyfikacjach obrazów.
Identyfikator rezerwacji Opcjonalnie Identyfikator rezerwacji na wydarzenie. Dowolny tekst
Cena – aktualna cena Wymagane warunkowo

Aktualna cena biletu na wydarzenie.

Wartość ta jest wymagana, jeśli podano przekreśloną cenę.

Dowolny tekst
Cena – przekreślona cena Opcjonalnie Pierwotna cena biletu na wydarzenie. Dowolny tekst
Objaśnienie dotyczące ceny Opcjonalnie Objaśnienie dotyczące ceny z informacją o promocji, wydarzeniu lub zniżce dla subskrybentów, jeśli jest dostępna.

Dowolny tekst

Zalecany rozmiar tekstu: poniżej 45 znaków (zbyt długi tekst) mogą wyświetlać wielokropki).
Ocena – wartość maksymalna Opcjonalnie

Maksymalna wartość skali ocen.

Ten atrybut musi być podany, jeśli bieżąca wartość oceny jest również

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

Bieżąca wartość skali ocen.

Ten atrybut musi być podany, jeśli maksymalna wartość oceny wynosi również

Liczba >= 0.0
Ocena – liczba Opcjonalnie

Liczba ocen wydarzenia.

Uwaga: wypełnij to pole, jeśli aplikacja chce: kontrolować sposób wyświetlania informacji użytkownikom. Podaj zwięzły ciąg znaków które można wyświetlać użytkownikowi. Jeśli na przykład liczba to 1 000 000, rozważ użycie skrótów, takich jak 1M, aby uniknąć na mniejszych ekranach.

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

Liczba ocen wydarzenia.

Uwaga: podaj to pole, jeśli nie chcesz przetwarzać musisz samodzielnie stosować skróty klawiszowe. Jeśli zarówno liczba, jak i wartość liczby użyjemy liczby, aby wyświetlić je użytkownikom

 Długie
Kategorie treści Opcjonalnie Opisz kategorię treści znajdujących się w danym elemencie.

Lista odpowiednich wyliczenia

  • 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: zwiedzanie, festiwal)
  • TYPE_HEALTH_AND_FITENESS (przykład: zajęcia jogi)
  • TYPE_EDUCATION (przykład – klasa)
  • TYPE_SPORTS (przykład – mecz piłki nożnej)
  • TYPE_DATING (przykład: spotkanie)

Zobacz sekcję Kategoria treści. .

LodgingReservationEntity

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 najczęstszymi pytaniami

Identyfikator URI
Tytuł Wymagany Tytuł elementu.

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

Zalecany rozmiar tekstu: maks. 50 znaków
Godzina zameldowania Wymagany Sygnatura czasowa epoki (w milisekundach), która reprezentuje czas zameldowania za rezerwację. Sygnatura czasowa epoki w milisekundach
Godzina wymeldowania Wymagany Sygnatura czasowa epoki (w milisekundach), która reprezentuje godzinę wymeldowania za rezerwację. Sygnatura czasowa epoki w milisekundach
Lokalizacja – kraj Wymagany Kraj, w którym znajduje się zakwaterowanie.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – miasto Wymagany Miasto, w którym znajduje się hotel.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 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. 20 znaków
Lokalizacja – adres Opcjonalnie Ulica i numer (jeśli dotyczy) miejsca zamieszkania.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – województwo Opcjonalnie stan lub województwo (jeśli dotyczy), w którym znajduje się zakwaterowanie; z siedzibą firmy.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – kod pocztowy Opcjonalnie Kod pocztowy miejsca zakwaterowania (jeśli jest wymagany).

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja – okolica Opcjonalnie Dzielnica (jeśli dotyczy) hotelu,

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Plakat Opcjonalnie

Jeśli prześlesz kilka obrazów, wyświetlimy tylko jeden obraz. Zalecane działania format obrazu to 16:9.

Uwaga: jeśli masz plakietkę, umieść ją w bezpiecznej na 24 miejscach dps na górze i na dole obrazu

Wskazówki znajdziesz w specyfikacjach obrazów.
Opis Opcjonalnie

Jeden akapit tekstu opisujący element.

Uwaga: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

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: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Identyfikator rezerwacji Opcjonalnie Identyfikator rezerwacji miejsca zakwaterowania. Dowolny tekst
Ocena – wartość maksymalna Opcjonalnie

Maksymalna wartość skali ocen.

Ten atrybut musi być podany, jeśli bieżąca wartość oceny jest również

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

Bieżąca wartość skali ocen.

Ten atrybut musi być podany, jeśli maksymalna wartość oceny wynosi również

Liczba >= 0.0
Ocena – liczba Opcjonalnie

Liczba ocen hotelu.

Uwaga: wypełnij to pole, jeśli aplikacja chce: kontrolować sposób wyświetlania informacji użytkownikom. Podaj zwięzły ciąg znaków które można wyświetlać użytkownikowi. Jeśli na przykład liczba to 1 000 000, rozważ użycie skrótów, takich jak 1M, aby uniknąć na mniejszych ekranach.

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

Liczba ocen hotelu.

Uwaga: podaj to pole, jeśli nie chcesz przetwarzać musisz samodzielnie stosować skróty klawiszowe. Jeśli zarówno liczba, jak i wartość liczby użyjemy liczby, aby wyświetlić je użytkownikom

 Długie
Cena – aktualna cena Wymagane warunkowo

Aktualna cena zakwaterowania.

Jeśli podano przekreśloną cenę, ta wartość jest wymagana.

Dowolny tekst
Cena – przekreślona cena Opcjonalnie Pierwotna cena zakwaterowania, która będzie przekreślona Interfejs. Dowolny tekst
Objaśnienie dotyczące ceny Opcjonalnie Objaśnienie dotyczące ceny z informacją o promocji, wydarzeniu lub zniżce dla subskrybentów, jeśli jest dostępna.

Dowolny tekst

Zalecany rozmiar tekstu: poniżej 45 znaków (zbyt długi tekst) mogą wyświetlać 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 najczęstszymi pytaniami

Identyfikator URI
Tytuł Wymagany Tytuł elementu.

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

Zalecany rozmiar tekstu: maks. 50 znaków
Typ transportu Wymagany Środek lub typ transportu powiązany z rezerwacją. Enum: FLIGHT, TRAIN, BUS lub FERRY
Godzina wylotu Wymagany Sygnatura czasowa epoki wyrażona w milisekundach, która reprezentuje godzinę odjazdu. Sygnatura czasowa epoki w milisekundach
Godzina przyjazdu Wymagany Sygnatura czasowa epoki określająca czas przyjazdu (w milisekundach). Sygnatura czasowa epoki w milisekundach
Lokalizacja wyjazdu – kraj Opcjonalnie Kraj wyjazdu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja wyjazdu – miasto Opcjonalnie Miasto wylotu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja wyjazdu – wyświetlany adres Opcjonalnie Lokalizacja wyjazdu, która będzie wyświetlana użytkownikowi.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja wyjazdu – adres Opcjonalnie Adres miejsca wyjazdu (jeśli dotyczy).

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce wyjazdu – stan Opcjonalnie Województwo (jeśli dotyczy) miejsca wyjazdu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce wylotu – kod pocztowy Opcjonalnie Kod pocztowy (jeśli dotyczy) miejsca wylotu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja wyjazdu – okolica Opcjonalnie Dzielnica (jeśli jest dostępna) miejsca wyjazdu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce przyjazdu – kraj Opcjonalnie Kraj przyjazdu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce przyjazdu – miasto Opcjonalnie Miasto przybycia.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce przyjazdu – wyświetlany adres Opcjonalnie Lokalizacja przybycia, która będzie wyświetlana użytkownikowi.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce przyjazdu – adres Opcjonalnie Adres miejsca przyjazdu (jeśli dotyczy).

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce przyjazdu – stan Opcjonalnie Województwo (jeśli dotyczy) miejsca przyjazdu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Miejsce przyjazdu – kod pocztowy Opcjonalnie Kod pocztowy (jeśli dotyczy) miejsca przyjazdu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Lokalizacja przyjazdu – okolica Opcjonalnie Dzielnica (jeśli jest dostępna) miejsca przyjazdu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Dostawca usług – nazwa Opcjonalnie

Nazwa dostawcy usług.

Uwaga: w przypadku usługi wymagane jest przesłanie zarówno tekstu, jak i obrazu. dostawcy usług.

Dowolny tekst. Na przykład nazwa linii lotniczej
Dostawca usług – obraz Opcjonalnie

Logo/obraz dostawcy usług.

Uwaga: w przypadku usługi wymagane jest przesłanie zarówno tekstu, jak i obrazu. dostawcy usług.

Wskazówki znajdziesz w specyfikacjach obrazów.
Plakat Opcjonalnie

Jeśli prześlesz kilka obrazów, wyświetlimy tylko jeden obraz. Zalecane działania format obrazu to 16:9.

Wskazówki znajdziesz w specyfikacjach obrazów.
Opis Opcjonalnie

Jeden akapit tekstu opisujący element.

Uwaga: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

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: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Identyfikator rezerwacji Opcjonalnie Identyfikator rezerwacji transportu. Dowolny tekst
Cena – aktualna cena Wymagane warunkowo

Aktualna cena rezerwacji.

Jeśli podano przekreśloną cenę, ta wartość jest wymagana.

Dowolny tekst
Cena – przekreślona cena Opcjonalnie Pierwotna cena rezerwacji, która jest przekreślona Interfejs. Dowolny tekst
Objaśnienie dotyczące ceny Opcjonalnie Objaśnienie dotyczące ceny z informacją o promocji, wydarzeniu lub zniżce dla subskrybentów, jeśli jest dostępna.

Dowolny tekst

Zalecany rozmiar tekstu: poniżej 45 znaków (zbyt długi tekst) mogą wyświetlać wielokropki).
Numer transportowy Wymagane Numer lotu, numer autobusu, pociągu albo promu lub rejsu. Dowolny tekst
Wejście na pokład Wymagane Sygnatura czasowa epoki, która reprezentuje czas wejścia na pokład przy 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: na potrzeby atrybucji możesz używać precyzyjnych linków. Zapoznaj się z najczęstszymi pytaniami

Identyfikator URI
Tytuł Wymagany Tytuł elementu.

Dowolny tekst. 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 epoki w milisekundach
Godzina zwrotu Opcjonalnie Sygnatura czasowa epoki, która reprezentuje godzinę wymeldowania w przypadku rezerwacji. Sygnatura czasowa epoki w milisekundach
Adres odbioru – kraj Opcjonalnie Kraj miejsca odbioru.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Adres odbioru – miasto Opcjonalnie Miasto miejsca odbioru.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Adres odbioru – wyświetlany adres Opcjonalnie Miejsce odbioru, które będzie wyświetlane użytkownikowi.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Adres odbioru – ulica Opcjonalnie Adres miejsca odbioru (jeśli dotyczy).

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Adres odbioru – stan Opcjonalnie Stan lub prowincja (jeśli dotyczy) miejsca odbioru.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Adres odbioru – kod pocztowy Opcjonalnie Kod pocztowy (jeśli dotyczy) miejsca odbioru.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Adres odbioru – okolica Opcjonalnie Dzielnica (jeśli jest dostępna) miejsca odbioru.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Adres zwrotny – kraj Opcjonalnie Kraj zwrotu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Adres zwrotny – miasto Opcjonalnie Miejscowość zwrotu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Adres zwrotny – wyświetlany adres Opcjonalnie Lokalizacja zwrotu, która będzie wyświetlana użytkownikowi.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Adres zwrotny – ulica Opcjonalnie Adres (jeśli dotyczy) miejsca zwrotu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Adres zwrotny – stan Opcjonalnie Stan lub prowincja (jeśli dotyczy) miejsca zwrotu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Adres zwrotny – kod pocztowy Opcjonalnie Kod pocztowy (jeśli dotyczy) miejsca zwrotu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Adres zwrotny – okolica Opcjonalnie Dzielnica (jeśli jest dostępna) miejsca zwrotu.

Dowolny tekst

Zalecany rozmiar tekstu: maks. 20 znaków
Dostawca usług – nazwa Opcjonalnie

Nazwa dostawcy usług.

Uwaga: w przypadku usługi wymagane jest przesłanie zarówno tekstu, jak i obrazu. dostawcy usług.

Dowolny tekst. Na przykład „Avis Car Rental”
Dostawca usług – obraz Opcjonalnie

Logo/obraz dostawcy usług.

Uwaga: w przypadku usługi wymagane jest przesłanie zarówno tekstu, jak i obrazu. dostawcy usług.

Wskazówki znajdziesz w specyfikacjach obrazów.
Plakat Opcjonalnie

Jeśli prześlesz kilka obrazów, wyświetlimy tylko jeden obraz. Zalecane działania format obrazu to 16:9.

Wskazówki znajdziesz w specyfikacjach obrazów.
Opis Opcjonalnie

Jeden akapit tekstu opisujący element.

Uwaga: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

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: opis lub lista napisów zostaną wyświetlane użytkownikowi, a nie jedno i drugie.

Dowolny tekst

Zalecany rozmiar tekstu dla każdego podtytułu: maks. 50 znaków
Identyfikator potwierdzenia Opcjonalnie Identyfikator potwierdzenia rezerwacji wynajmu pojazdu. Dowolny tekst
Cena – aktualna cena Wymagane warunkowo

Aktualna cena rezerwacji.

Jeśli podano przekreśloną cenę, ta wartość jest wymagana.

Dowolny tekst
Cena – przekreślona cena Opcjonalnie Pierwotna cena rezerwacji, która jest przekreślona Interfejs. Dowolny tekst
Objaśnienie dotyczące ceny Opcjonalnie Objaśnienie dotyczące ceny z informacją o promocji, wydarzeniu lub zniżce dla subskrybentów, jeśli jest dostępna.

Dowolny tekst

Zalecany rozmiar tekstu: poniżej 45 znaków (zbyt długi tekst) mogą wyświetlać wielokropki).

Specyfikacja obrazu

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

Format obrazu Minimalny rozmiar w pikselach Zalecany rozmiar w pikselach

Kwadrat (1 x 1)

Preferowana

 300x300 1200x1200
Poziomy (1,91 x 1) 600x314 1200x628
Orientacja pionowa (4 x 5) 480 × 600 960x1200

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

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% .
  • Użyj przezroczystego tła, aby obraz był poprawnie wyświetlany Ustawienia ciemnego i jasnego motywu.

Kategoria treści

Kategoria treści pozwala aplikacjom publikować treści należące do wielu kategorii zainteresowań. Powoduje to mapowanie treści na niektóre ze wstępnie zdefiniowanych kategorii:

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

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

  1. Niektóre encje, takie jak ArticleEntity i GeneralFeaturedEntity, są które mogą być wykorzystywane w przypadku dowolnej kategorii treści. W przypadku innych podmiotów, takich jak Tylko EventEntity, EventreservationEntity, PointOfInterestEntity tylko część tych kategorii reklam spełnia wymagania. Sprawdź listę kategorii odpowiednie dla typu encji przed zapełnieniem listy.

  2. W przypadku niektórych kategorii treści używaj określonego typu elementu, a nie ich kombinacji. elementów ogólnych i kategorii treści:

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

  4. Jeśli podajesz kilka kategorii treści, podaj je w kolejności. trafności względem treści z najtrafniejszą kategorią treści pierwszej pozycji na liście.

Krok 2. Podaj dane klastra

Zaleca się, aby zadanie publikowania treści było wykonywane w tle (na przykład WorkManager). i zaplanowano je regularnie lub według konkretnego wydarzenia (np. za każdym razem, użytkownik otwiera aplikację lub właśnie dodał coś do koszyka).

Za publikowanie klastrów odpowiada AppEngagePublishClient.

Istnieją następujące interfejsy API do publikowania klastrów w kliencie:

  • 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 oraz czy treść może być prezentowana na urządzeniu.

Kotlin

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

Java

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

publishRecommendationClusters

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

Kotlin

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

Java

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

Gdy usługa otrzyma żądanie, w ramach jedna transakcja:

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

W przypadku błędu całe żądanie zostaje odrzucone, a obecny stan to i utrzymywane informacje.

publishFeaturedCluster

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

Kotlin

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

Java

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

Gdy usługa otrzyma żądanie, w ramach jedna transakcja:

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

W przypadku błędu całe żądanie zostaje odrzucone, a obecny stan to i utrzymywane informacje.

publishContinuationCluster

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

Kotlin

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

Java

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

Gdy usługa otrzyma żądanie, w ramach jedna transakcja:

  • Dotychczasowe dane ContinuationCluster pochodzące od partnera dewelopera zostaną usunięte.
  • Dane z żądania są analizowane i przechowywane w zaktualizowanej wersji kontynuacji Klaster.

W przypadku błędu całe żądanie zostaje odrzucone, a obecny stan to i utrzymywane informacje.

publishUserAccountManagementRequest

Ten interfejs API służy do publikowania karty logowania . Działanie związane z logowaniem kieruje użytkowników do stronie logowania, tak by aplikacja mogła publikować treści (lub udostępniać treści spersonalizowanej)

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 podano tytułu, należy podać tytuł

Obraz widoczny na karcie

Obrazy o współczynniku proporcji 16 x 9 i rozdzielczości 1264 x 712
Tytuł Opcjonalnie – jeśli nie podano, należy przesłać zdjęcie Tytuł na karcie
Tekst działania Opcjonalnie Tekst widoczny w wezwaniu do działania (np. „Zaloguj się”)
Podtytuł Opcjonalnie Opcjonalny tytuł na karcie

Kotlin

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

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

Java

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

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

Gdy usługa otrzyma żądanie, w ramach jedna transakcja:

  • Dotychczasowe dane UserAccountManagementCluster od partnera dewelopera są usunięto.
  • Dane z żądania są analizowane i przechowywane w zaktualizowanym Klaster zarządzania kontami użytkowników.

W przypadku błędu całe żądanie zostaje odrzucone, a obecny stan to i utrzymywane informacje.

updatePublishStatus

Jeśli z jakiegokolwiek wewnętrznego 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 sytuacjach, nawet po opublikowaniu treści (STATUS == PUBLISHED) – ma kluczowe znaczenie przy wypełnianiu paneli, które używają jawny stan, który przekazuje informacje o stanie i inne wskaźniki integracji.
  • Jeśli treści nie zostały opublikowane, ale stan integracji nie jest nieprawidłowy (STATUS == NOT_PUBLISHED), Google może uniknąć wywoływania alertów w aplikacji paneli stanu. Potwierdza ono, że treść nie została opublikowana z powodu jest oczekiwana z punktu widzenia dostawcy.
  • Pomaga 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ń aby wyświetlić jej zawartość lub rozwiązać problem.

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 zostaną opublikowane, ponieważ użytkownik nie jest zalogowany, Google zalecamy opublikowanie karty logowania. Jeśli z jakiegoś powodu usługodawcy nie mogą aby opublikować kartę logowania, zalecamy wywołanie metody Interfejs API updatePublishStatus z kodem stanu NOT_PUBLISHED_REQUIRES_SIGN_IN

Kotlin

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

Java

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

deleteRecommendationClusters

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

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

Gdy usługa otrzyma żądanie, usuwa istniejące dane z Klastry rekomendacji. W przypadku błędu całe żądanie jest odrzucane, obecny stan zostaje zachowany.

deleteFeaturedCluster

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

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

Gdy usługa otrzyma żądanie, usuwa istniejące dane z Polecany klaster. W przypadku błędu całe żądanie jest odrzucane, obecny stan zostaje zachowany.

deleteContinuationCluster

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

Kotlin

client.deleteContinuationCluster()

Java

client.deleteContinuationCluster();

Gdy usługa otrzyma żądanie, usuwa istniejące dane z Klaster kontynuacji. W przypadku błędu całe żądanie jest odrzucane, obecny stan zostaje zachowany.

deleteUserManagementCluster

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

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

Gdy usługa otrzyma żądanie, usuwa istniejące dane z Klaster zarządzania kontami użytkowników. W przypadku błędu całe żądanie jest odrzucono i zachowany zostanie obecny stan.

deleteClusters

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

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, usuwa istniejące dane ze wszystkich klastrów pasujących do określonych typów klastrów. Klienci mogą wybrać, czy chcą pozytywnie ocenić dla wielu typów klastrów. W przypadku błędu całe żądanie jest odrzucane, obecny stan zostaje zachowany.

Obsługa błędów

Zdecydowanie zalecamy wsłuchiwanie się w wyniki zadania z interfejsów API do publikowania, takich jak że można podjąć działania, aby odzyskać i ponownie przesłać udane zadanie.

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 z przyczyną podaną w atrybucie .

Kod błędu Uwaga:
SERVICE_NOT_FOUND Usługa jest niedostępna na danym urządzeniu.
SERVICE_NOT_AVAILABLE Usługa jest dostępna na danym urządzeniu, ale nie jest dostępna w momencie połączenia (np. funkcja jest wyraźnie wyłączona).
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.
SERVICE_CALL_PERMISSION_DENIED Rozmówca nie może nawiązać połączenia z usługą.
SERVICE_CALL_INVALID_ARGUMENT Żądanie zawiera nieprawidłowe dane (na przykład więcej niż dozwolone liczby klastrów).
SERVICE_CALL_INTERNAL Po stronie usługi wystąpił błąd.
SERVICE_CALL_RESOURCE_EXHAUSTED Dzwonienie do zespołu pomocy jest wykonywane zbyt często.

Krok 3. Obsługa intencji transmisji

Oprócz wykonywania wywołań interfejsu Content API w zadaniu wymagane do skonfigurowania BroadcastReceiver do otrzymania z prośbą o opublikowanie treści.

Celem intencji transmisji jest głównie ponowna aktywacja aplikacji i wymuszenie użycia danych synchronizację. Intencje związane z transmisją nie są przeznaczone do wysyłania zbyt często. Jest tylko uruchamianych, gdy usługa dla Agencji ustali, że zawartość może być nieaktualna (w przypadku np. tydzień). Dzięki temu będzie miała większą pewność, i otwierać nowe treści, nawet jeśli aplikacja nie była uruchamiana przez bardzo długi okres.

BroadcastReceiver trzeba skonfigurować na 2 sposoby:

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

}
  • Statycznie deklaruj implementację z tagiem <receiver> w sekcji AndroidManifest.xml. Zezwala to aplikacji na odbieranie komunikatów intencje, gdy nie jest uruchomiona, oraz umożliwia publikowanie aplikacji 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>

Te zamiary są wysyłane przez usługa:

  • com.google.android.engage.action.PUBLISH_RECOMMENDATION Zalecane aby rozpocząć wywołanie publishRecommendationClusters po otrzymaniu tej intencji.
  • com.google.android.engage.action.PUBLISH_FEATURED Zalecane: uruchomić wywołanie publishFeaturedCluster po otrzymaniu tej intencji.
  • com.google.android.engage.action.PUBLISH_CONTINUATION Zalecane: uruchomić wywołanie publishContinuationCluster po otrzymaniu tej intencji.

Proces integracji

Szczegółowy przewodnik dotyczący weryfikacji integracji po jej zakończeniu znajdziesz na stronie Przepływ pracy w zakresie integracji dla programistów

Najczęstsze pytania

Przeczytaj Najczęstsze pytania o pakiet SDK dla Agencji dotyczące: Najczęstsze pytania

Kontakt

Kontakt Engage-developers@google.com, jeśli są na ewentualne pytania w trakcie procesu integracji.

Dalsze kroki

Po zakończeniu integracji należy wykonać następujące czynności:

  • Wyślij e-maila do Engage-developers@google.com i dołącz zintegrowany plik APK gotowy do testowania przez Google.
  • Google przeprowadza wewnętrzną weryfikację i weryfikację, aby upewnić się, że jej integracja działa zgodnie z oczekiwaniami. Jeśli potrzebne będą zmiany, Google skontaktuje się z Tobą z niezbędnymi informacjami.
  • Gdy testy zostaną zakończone i nie trzeba będzie wprowadzać żadnych zmian, Google skontaktuje się z Tobą w sprawie: powiadomi Cię, że możesz zacząć publikować zaktualizowany i zintegrowany pakiet APK w Sklepie Play.
  • Gdy Google potwierdzi, że zaktualizowany pakiet APK został opublikowany w Sklep Play, Twoje Rekomendacje, Polecane i Kontynuacja klastry mogą być opublikowane i widoczne dla użytkowników.