Najczęstsze pytania dotyczące pakietu SDK dla Agencji

Publikowanie najczęstszych pytań

Kto zarządza zadaniem publikowania treści?

Deweloper aplikacji zarządza zadaniem publikowania treści i wysyła żądania do usługi Engage. Dzięki temu deweloperzy będą mieli większą kontrolę nad tym, kiedy i jak publikować treści dla użytkowników. Dzięki temu aplikacja partnera nie będzie zbyt często budzić się, aby publikować treści.

Czy deweloper musi opublikować wszystkie typy klasterów?

Chociaż technicznie deweloperzy mogą opublikować tylko 1 klaster, zdecydowanie zalecamy uwzględnienie większej ich liczby. W przeciwnym razie tracą szansę na zwiększenie zaangażowania w treści. Zdecydowanie zalecamy publikowanie wszystkich typów klastrów w przypadku każdej branży.

Jak często deweloper partner powinien publikować dane za pomocą Work Managera, gdy aplikacja jest uruchomiona?

Decyzja należy do partnera dewelopera. Google zaleca publikowanie treści z ogólnymi rekomendacjami raz lub dwa razy dziennie oraz stosowanie metody opartej na zdarzeniach w przypadku koszyka, ponownego zamówienia i innych treści kontynuowanych (np. uruchomienie zadania wykonywanego w tle po dodaniu przez użytkownika elementów do koszyka lub po zatrzymaniu filmu w połowie). W przypadku aplikacji społecznościowych ważne jest, aby publikować zaktualizowane klastry rekomendacji po każdym użyciu aplikacji. Użytkownicy aplikacji społecznościowych są bardziej zainteresowani najnowszymi rekomendacjami i najchętniej widzieliby posty maksymalnie raz.

Kiedy deweloper powinien wywołać interfejsy API usuwania?

Interfejsy API do usuwania należy wywoływać tylko wtedy, gdy nie ma treści do opublikowania. Nie wywołuj API usuwania i publikowania, aby zastąpić treści. API publikowania automatycznie usuwają wcześniejsze treści.

Najczęstsze pytania dotyczące intencji przesyłania

Dlaczego deweloperzy aplikacji na Androida muszą rejestrować intencje transmisji?

Aby wyświetlać użytkownikowi aktualne treści, w przypadku gdy użytkownicy rzadko korzystają z aplikacji, należy użyć intencji przesyłania, aby wywołać synchronizację danych.

Wykonywanie w tle niedozwolone

Podczas rejestrowania intencji transmisji możesz napotkać ten błąd:

Background execution not allowed: receiving Intent
{ act=com.google.android.engage.action.PUBLISH_RECOMMENDATION .. }

Odbiorniki transmisji musisz zarejestrować dynamicznie.

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION 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));
...

}

Najczęściej zadawane pytania dotyczące Workflows

Podczas integracji z pakietem SDK możesz napotkać te błędy:

Precyzyjne linki są powiązane z nazwą pakietu. Dobrym sposobem na przetestowanie precyzyjnych linków jest użycie narzędzia adb.

adb shell am start -W -a android.intent.action.VIEW -d <DEEPLINK URI> <PACKAGE NAME>

Precyzyjne linki to świetny sposób na śledzenie atrybucji. Adresy URL precyzyjnych linków, które kierują użytkowników do Twojej aplikacji, mogą zawierać dodatkowe parametry śledzenia. Przykład: „http://xx/deeplink?source_tag=engage”.

Deweloperzy mogą dodawać własne parametry śledzenia i podać atrybucję, aby obliczyć wpływ.

Najczęstsze pytania dotyczące Engage for TV 2.0

Pytania ogólne

Czym jest Oglądaj dalej 2.0?

Kontynuuj oglądanie 2.0 (interfejs API do odkrywania filmów) przenosi „kontynuowanie przerwanego odtwarzania” na wyższy poziom. Jest to znaczna zmiana, która umożliwia widzom płynne wznawianie odtwarzania treści na większej liczbie urządzeń. Wyobraź sobie, że zaczynasz oglądać film na Google TV, a potem bez problemu kontynuujesz go na telefonie podczas dojazdu do pracy. To właśnie umożliwia funkcja „Oglądaj dalej 2.0”.

Ten nowy system ma zwiększać zaangażowanie widzów i zachęcać ich do pozostania na kanale dzięki bezproblemowej obsłudze w całym ekosystemie Google.

Jakie są zalety korzystania z funkcji Kontynuuj oglądanie 2.0?

Odpowiedź: dzięki funkcji Kontynuuj oglądanie 2.0 widzowie mogą łatwiej niż kiedykolwiek dokończyć oglądanie Twoich treści niezależnie od urządzenia, na którym je rozpoczęli. Jak to działa:

  • Bezproblemowe korzystanie z usług Google: możesz zacząć oglądać film na Google TV, a potem bezproblemowo kontynuować na telefonie z Androidem, iPhonie lub tablecie z Androidem. Działa nawet na urządzeniach, na których aplikacja nie została jeszcze zainstalowana.
  • Większe zaangażowanie i utrzymanie użytkowników: funkcja „Kontynuuj oglądanie 2.0” pomaga przyciągnąć użytkowników do Twojej aplikacji, nawet na nowych urządzeniach. Pozwalanie użytkownikom na wznowienie oglądania ulubionych programów zwiększa szanse na to, że będą oni kontynuować oglądanie.
  • Większy zasięg: Oglądaj dalej 2.0 działa nie tylko na Google TV, ale też w innych aplikacjach multimedialnych na Androida, takich jak Play Cubes i inne aplikacje multimedialne Google.
  • Wsteczna zgodność: jeśli korzystasz już z funkcji „Obejrzyj następny film”, nie ma problemu. Funkcja „Oglądaj dalej 2.0” jest zgodna wstecz, więc obecna integracja będzie nadal działać.

Ważna uwaga: wszystkie nowe integracje z kontynuacją oglądania muszą używać funkcji Kontynuuj oglądanie 2.0. Starszy system „Odtwarzaj dalej na wielu urządzeniach” jest wycofywany.

Które platformy obsługują Kontynuuj oglądanie 2.0?

  1. Google TV
  2. Android TV (tylko na urządzeniu, ale obsługuje pakiet Engage SDK)
  3. Aplikacja mobilna Google TV na Androida
  4. Aplikacja mobilna Google TV na iOS
  5. Play Cubes
  6. Pokój rozrywki w Google
  7. urządzenia z iOS (z integracją z interfejsem API REST);

Czy pakiet Engage SDK jest przeznaczony do obsługi funkcji Kontynuuj oglądanie 2.0?

Tak, pakiet Engage SDK jest przeznaczony do funkcji Kontynuuj oglądanie 2.0. Wymagana jest integracja z funkcją Kontynuuj oglądanie 2.0.

Czy funkcja „Oglądaj dalej 2.0” jest dostępna dla wszystkich?

Funkcja Kontynuuj oglądanie 2.0 jest wdrażana etapami.

  • Wczesna dostępność: początkowo dostęp do programu udostępniamy wybranej grupie partnerów w ramach programu wczesnego dostępu (EAP).
  • Rozszerzenie dostępu: pracujemy nad tym, aby wkrótce udostępnić funkcję Kontynuuj oglądanie 2.0 wszystkim deweloperom.

Aby zapewnić płynne i skuteczne wdrożenie, wdrożyliśmy zabezpieczenia, które pomogą nam w tym procesie. Obejmuje to zarówno listę dozwolonych w ramach Kontynuuj oglądanie 2.0, jak i oddzielną kontrolę w pakiecie Engage SDK. Jeśli jesteś partnerem w programie EAP lub chcesz dołączyć do niego w najbliższym czasie, skontaktuj się z nami, abyśmy mogli skonfigurować uprawnienia dostępu przed rozpoczęciem integracji pakietu Engage SDK.

W sekcji Tworzenie encji zaktualizowaliśmy wymagania dotyczące obrazów.

Czy dzięki nowej dokumentacji interfejsu API dane dotyczące kontynuowania oglądania będą pobierane przez serwer Google z klienta i czy będą widoczne na wszystkich urządzeniach?

Nowy interfejs API zapewnia istotne korzyści dla funkcji Kontynuuj oglądanie, w tym:

  • Bezproblemowe korzystanie z Google TV: użytkownicy mogą zacząć oglądać treści na jednym Google TV, a potem kontynuować na dowolnym innym Google TV, na którym zalogują się na to samo konto. Ta funkcja działa też w starszych wersjach Androida TV.

  • Integracja z aplikacją mobilną: funkcja Kontynuuj oglądanie jest dostępna w aplikacji mobilnej Google TV na Androida i iOS, dzięki czemu użytkownicy mogą płynnie przełączać się między telewizorem a urządzeniami mobilnymi.

  • Zwiększona retencja użytkowników: nawet na urządzeniach, na których nie ma zainstalowanej aplikacji lub na których użytkownik nie jest zalogowany, opcja „Dalej oglądaj” zachęca użytkowników do ponownego korzystania z aplikacji, co zwiększa ich retencję.

  • Rozszerzenie na inne platformy: ta integracja umożliwia korzystanie z funkcji Kontynuuj oglądanie na innych platformach mediów Google, takich jak Android, Play Cubes, tablety i inne aplikacje i interfejsy mediów Google na Androidzie, co pozwala zmaksymalizować zaangażowanie użytkowników na różnych urządzeniach.

Jaki jest limit liczby jednostek, które mogę opublikować w klastrze kontynuacji?

Każdy partner deweloper może utworzyć maksymalnie 5 podmiotów w klastrze Kontynuacji. Ten limit zapewnia sprawiedliwy podział treści w wierszu „Oglądaj dalej” w Google TV, który jest wspólną przestrzenią dla wielu dostawców mediów.

Co się stanie, jeśli spróbuję opublikować więcej niż 5 elementów?

Pakiet EngageSDK odrzuci prośbę o opublikowanie, jeśli przekroczy limit 5 elementów. Aby opublikować, musisz zmniejszyć liczbę elementów w żądaniu. Uwzględniaj tylko te elementy, które użytkownicy oglądali do końca, więc w większości przypadków będzie ich tylko kilka. Jeśli jest ich więcej niż 5, możesz opublikować te najnowsze.

Dlaczego obowiązuje limit liczby jednostek?

Wiersz „Oglądaj dalej” w Google TV wyświetla treści od różnych dostawców mediów. Ograniczenie liczby podmiotów na dostawcę zapewnia użytkownikom dostęp do zróżnicowanego wyboru treści ze wszystkich ich ulubionych źródeł, co sprzyja sprawiedliwemu i zrównoważonemu doświadczeniu.

Pytania dotyczące aplikacji weryfikacyjnej

Czy przed przesłaniem aplikacji muszę ją przetestować za pomocą aplikacji do weryfikacji?

Tak, przed przesłaniem pliku APK należy przetestować aplikację za pomocą aplikacji weryfikacyjnej.

Zdajemy sobie sprawę, że możesz być pewnym swojej implementacji, ale integracja Kontynuuj oglądanie 2.0 ma wiele skomplikowanych komponentów. Aplikacja do weryfikacji działa jak bufor bezpieczeństwa, który wcześnie wykrywa potencjalne problemy i w długim okresie czasu pozwala zaoszczędzić cenny czas i wysiłki.

Potraktuj to jako szybką kontrolę, która pomoże zagwarantować płynne wdrożenie i wrażenia użytkowników.

Wykrywając i rozwiązując wszelkie problemy z wyprzedzeniem, możesz uniknąć odrzuceń i ponownie przesyłanych wersji.

Aby przesłać plik APK, musisz dołączyć zrzut ekranu pokazujący, że aplikacja przeszła proces weryfikacji.

#### Jakie są typowe błędy, których należy unikać podczas integracji?

Aplikacja do weryfikacji została zaprojektowana tak, aby wykrywać potencjalne problemy z integracją z kontynuacją oglądania 2.0. Oto kilka typowych błędów, które często popełniają deweloperzy:

W przypadku wszystkich typów treści (filmów, odcinków programów telewizyjnych, transmisji na żywo, klipów wideo):

  • Brakujące linki: upewnij się, że podajesz prawidłowe identyfikatory URI (linki) do swoich treści na danej platformie. Te linki informują system, gdzie znaleźć Twoje treści na każdej platformie.
  • Brak tytułów: pamiętaj, aby dodać tytuły do wszystkich treści. Dzięki temu użytkownicy mogą sprawdzić, co oglądali.
  • Format obrazu: sprawdź, czy wszystkie obrazy powiązane z Twoimi treściami mają format zbliżony do 16:9. Dzięki temu obrazy będą wyświetlane prawidłowo na różnych ekranach.

W przypadku odcinków telewizyjnych:

  • Pełne informacje o odcinku: podaj tytuł programu, numer odcinka i numer sezonu. Pomaga to w porządkowaniu odcinków i ułatwia użytkownikom poruszanie się po serii.
  • Dokładna pozycja odtwarzania: sprawdź, czy ostatnia pozycja odtwarzania jest mniejsza lub równa łącznemu czasowi trwania odcinka. Dzięki temu użytkownicy mogą wznowić odtwarzanie w odpowiednim miejscu.

Filmy:

  • Dokładna pozycja odtwarzania: podobnie jak w przypadku odcinków seriali, sprawdź, czy ostatnia pozycja odtwarzania jest prawidłowa.

Transmisje na żywo:

  • Informacje o nadawcy: w przypadku transmisji na żywo podaj nazwę nadawcy.

Klipy wideo:

  • Informacje o twórcy: określ twórcę klipu wideo.

Pamiętaj: aplikacja do weryfikacji będzie sygnalizować te problemy, co pozwoli Ci je rozwiązać, zanim prześlesz aplikację. Pozwoli Ci to zaoszczędzić czas i zapewni płynniejsze działanie aplikacji dla użytkowników.

Pytania dotyczące konta i profilu

Moja aplikacja używa anonimowych logowań użytkowników. Czy profil użytkownika jest nadal wymagany w przypadku funkcji Kontynuuj oglądanie 2.0?

Usługa AccountProfile jest przeznaczona do aplikacji, które korzystają z kont poszczególnych użytkowników. Rozumiemy jednak, że niektóre aplikacje, takie jak Twoja, mogą korzystać z logowania anonimowego. Oto jak w tym scenariuszu działa Kontynuuj oglądanie 2.0:

  • Mimo że technicznie wymagane jest wywołanie metody AccountProfile, to i tak możesz zintegrować kontynuowanie oglądania 2.0, nawet jeśli Twoja aplikacja nie ma systemu kont użytkowników.
  • Ograniczenie do korzystania na urządzeniu: funkcje kontynuowania oglądania 2.0 na różnych urządzeniach wymagają identyfikowania użytkowników na różnych urządzeniach. Logowanie anonimowe nie zapewnia tych informacji, więc funkcja będzie ograniczona do bieżącego urządzenia użytkownika.
  • Jak skonfigurować: aby to zrobić, musisz wyłączyć synchronizację między urządzeniami. Dzięki temu pozycje w sekcji „Oglądanie dalej” będą wyświetlane tylko na konkretnym urządzeniu, na którym rozpoczęto odtwarzanie treści.

Podsumowując: możesz zintegrować funkcję Kontynuuj oglądanie 2.0 z logowaniem anonimowym, ale użytkownicy będą mogli wznowić oglądanie tylko na tym samym urządzeniu.

Czy mogę używać obiektu AccountProfile tylko z identyfikatorem accountId, a nie profileId, nawet jeśli moja aplikacja obsługuje oba te identyfikatory?

Aby działać prawidłowo, funkcja AccountProfile wymaga zarówno parametru accountId, jak i parametr profileId. Przyczyna jest następująca:

  • Konsekwentna identyfikacja: identyfikator accountId identyfikuje użytkownika, a identyfikator profileId rozróżnia różne profile na koncie tego użytkownika (w odpowiednich przypadkach). Dzięki temu funkcja Kontynuuj oglądanie będzie dokładnie śledzić i wyświetlać treści na poszczególnych profilach.
  • Zapobieganie błędom: używanie identyfikatorów accountId i profileId w niespójnych miejscach w różnych wywołaniach interfejsu API może powodować nieoczekiwane działanie i błędy. Jeśli na przykład podczas dodawania treści do sekcji Kontynuuj oglądanie uwzględnisz oba te parametry, ale podczas usuwania treści użyjesz tylko parametru accountId, system może nieprawidłowo zidentyfikować i usunąć żądane elementy.

Czy w przypadku Oglądaj dalej 2.0 wymagany jest identyfikator profilu?

  • Wymagane jest kontoId. Dzięki temu użytkownik jest rozpoznawany na różnych urządzeniach.
  • Identyfikator profileId ma kluczowe znaczenie dla wygody użytkowników. Chociaż technicznie jest to opcjonalne, zalecamy użycie parametru profileId, jeśli Twoja usługa obsługuje wiele profili (jak wiele usług przesyłania strumieniowego). Dlaczego jest to tak ważne? Ponieważ bez parametru profileId funkcja Kontynuuj oglądanie może wyświetlać treści z innych profili na tym samym koncie. Może to dezorientować i irytować użytkowników.
  • Krótko mówiąc: podanie profileId zapewnia, że opcja Oglądaj dalej będzie dokładnie odzwierciedlać historię oglądania każdego użytkownika. Jeśli tylko Twoja aplikacja nie obsługuje koncepcji profilu na koncie, powinna go zawierać.

Jak Google używa profileId po swojej stronie?

Jeśli usługa oferuje różne profile do oglądania treści, identyfikator accountId i profileId będą używane do kojarzenia treści oglądanych na urządzeniu z zalogowanym na nim kontem Google. Google rejestruje dane ContinueWatching na podstawie kombinacji identyfikatora konta i identyfikatora profilu. Każde urządzenie Google, na którym zalogowano to samo konto Google, będzie otrzymywać najnowsze zaktualizowane dane z tych samych powiązanych identyfikatorów accountId i profileId w wierszu Kontynuuj oglądanie.

Czy do wdrożenia funkcji Kontynuuj oglądanie 2.0 wymagane jest połączenie kont?

Połączenie kont nie jest wymagane. Jest ono odznaczane priorytetem, a wszystkie powiązane przypadki użycia będą obsługiwane przez nowy interfejs Device Entitlements API.

Pytania dotyczące synchronizacji na różnych urządzeniach

Gdy użytkownik wyrazi zgodę na „synchronizację na urządzeniach”, treści, które ogląda, będą zapisywane na serwerach Google TV. Dzięki temu będzie mógł bezproblemowo kontynuować oglądanie na dowolnym zalogowanym urządzeniu. Bez zgody historia oglądania pozostaje lokalna na urządzeniu.

Czy możemy ustawić wartość „sync across devices” na „false”?

Flaga UserConsentToSyncAcrossDevices określa, czy dane z ContinuationCluster użytkownika są synchronizowane na jego urządzeniach (telewizorze, telefonie, tablecie itp.).Jeśli ta flaga jest ustawiona na wartość false, kontynuowanie oglądania jest możliwe tylko na tym samym urządzeniu.

Aby w pełni korzystać z funkcji synchronizacji między urządzeniami, zalecamy, aby aplikacja uzyskała zgodę użytkownika i ustawiła wartość SyncAcrossDevices na „true”.

urządzeniach? Jakie punkty danych są udostępniane na serwery innych firm z urządzeń innych niż z Androidem?

Zgoda jest zbierana na poziomie użytkownika (profilu lub konta). Po uzyskaniu zgody na przetwarzanie danych można wysyłać ładunki danych dotyczące kontynuowania oglądania na podstawie zaangażowania w dowolnym miejscu, aby Google mogło odzwierciedlać stan wznowienia przez użytkowników w dowolnym miejscu we wszystkich elementach, z którymi mają one częściowe lub pełne zaangażowanie na dowolnym urządzeniu (bez konieczności ponownego proszenia o zgodę na każdym urządzeniu lub platformie). Partnerzy będą wysyłać najnowszy stan „kontynuuj oglądanie” (zgodnie ze specyfikacją) powiązany z identyfikatorem profilu (zdepozytowanym na Androidzie).

Pytania dotyczące interfejsu API REST

Czy istnieje dokumentacja interfejsu API REST?

Przewidywany termin udostępnienia interfejsu API REST to marzec 2025 r., co zostało udokumentowane w dokumentacji dla deweloperów dotyczącej funkcji „Kontynuuj oglądanie 2.0”.

Starsza wersja pytania „Warto obejrzeć”

Czy interfejs Video Discovery API zastępuje interfejs Watch Next API?

Interfejs API Video Discovery będzie zgodny wstecz na wszystkich urządzeniach z Androidem TV, które obsługują interfejs Watch Next API. Wszyscy deweloperzy powinni używać interfejsu API Video Discovery (Ciąg dalszego oglądania 2.0) do publikowania w wierszu „Ciąg dalszego oglądania”.

Pytania dotyczące testowania i integracji

Jaka jest różnica między wartościami LastPlayBackPositionTimeMillis i duration?

Wartość LastPlayBackPositionTimeMillis powinna odpowiadać długości odtwarzania w milisekundach, w której użytkownik zakończył oglądanie (np. 605 tys. ms przez 10 minut i 5 sekund). Nie może być dłuższy niż łączny czas trwania encji.

Natomiast LastEngagementTime to sygnatura czasowa ostatniego skontaktowania się użytkownika z treścią.

Jakie przypadki testowe należy przeprowadzić?

Poniżej znajdziesz przypadki testowe Google TV, które wykonuje nasz zespół ds. jakości. Podobne przypadki testowe można też przeprowadzać na innych platformach.

  1. Obejrzyj film dłuższy niż 20 minut przez około 5 minut. Zamknij aplikację. Karta filmu powinna się wyświetlić w wierszu „Kontynuuj oglądanie”. Uwaga: w CW wyświetlamy tylko 5 kart na aplikację innej firmy.
  2. Wybranie nowo wyświetlonej karty w wierszu „Kontynuuj oglądanie” powinno wznowić odtwarzanie filmu od odpowiedniego miejsca. Uwaga: odtwarzanie nowych i starych treści powinno zostać wznowione od miejsca, w którym zostało przerwane.
  3. Zmiana kont na urządzeniu Google TV powinna zmienić karty w wierszu „Kontynuuj oglądanie”. Powinny wyświetlać się tylko filmy z bieżącego konta. Posortowane według daty. Profile aplikacji innych firm w CW będą mieszane. Uwaga: CW dla GoogleAccount2 będzie zawierać treści innych firm, które GoogleAccount2 oglądał.
  4. Zamknij aplikację za pomocą przycisku Wstecz > upewnij się, że karta jest wyświetlana w wierszu „Kontynuuj oglądanie”
  5. Ukryj film w wierszu „Oglądaj dalej”. Nie powinien się on już wyświetlać. Testuj, czy ukryte treści pozostają ukryte przez ponad 24 godziny i nawet po otwarciu aplikacji po upływie 24 godzin. Sprawdź, czy ukrycie jednego elementu nie powoduje ukrycia wielu elementów.
    1. Dostępność treści w sekcji „Oglądaj dalej” z pełnymi metadanymi: obraz na karcie, nazwa aplikacji, tytuł, numer odcinka w sezonie (w przypadku treści telewizyjnych).
  6. Sprawdzanie postępu wyświetla się na pasku postępu
  7. Użytkownik obejrzał treści do końca – nie wyświetlają się one w sekcji Kontynuuj oglądanie
  8. Sprawdź, czy w wierszu „Kontynuuj oglądanie” nie wyświetlają się nieoglądane treści
  9. Sprawdź, czy elementy CW są uporządkowane chronologicznie na podstawie tego, kiedy nastąpiła aktywność związana z oglądaniem, a nie na podstawie tego, kiedy aplikacja została ostatnio otwarta lub w którym dniu została otwarta po raz ostatni.
  10. Sprawdź, czy szczegóły odcinka i sezonu na karcie CW są zgodne z tym, co zostało obejrzane w treściach epizodycznych.
  11. Potwierdź, że ukończone (elementy z kredytami lub bez) nie pojawiają się w opcji kontynuuj oglądanie
  12. Wyłącz urządzenie w połowie oglądania odcinka, filmu lub programu. „Wyłącz urządzenie w połowie oglądania odcinka, filmu lub programu. Sprawdź, czy po włączeniu urządzenia i na innym telewizorze CW wyświetla odpowiednią kartę , w prawidłowej pozycji i z paskiem postępu.
  13. Wyłącz urządzenie po obejrzeniu odcinka 1 i potwierdź.
    1. odcinek 1 znika i nie pojawia się ponownie w wierszu Oglądaj dalej [na drugim urządzeniu i po włączeniu urządzenia testowego]
    2. odcinek 2 (jeśli jest dostępny) powinien pojawić się w wierszu Kontynuuj oglądanie [na drugim urządzeniu i po włączeniu urządzenia testowego]
  14. Pierwszy scenariusz: TV1: GoogleAccount: mom, 3p account / profile: account 1 / profile_1. Oglądanie treści i weryfikowanie danych CW wyświetlających treści oglądane przez zewnętrzne konto account_1/profile_1

    1. TV2: GoogleAccount: mom. Sprawdź dane CW z pierwszego scenariusza. Teraz zaloguj się w aplikacji innej firmy, używając innego konta. Konto / profil zewnętrzny: account_2 / profile_2. Oglądanie treści i weryfikowanie danych CW wyświetlających treści oglądane przez konto zewnętrzne account_2/profile_2
  15. GoogleAccount: mama. Nowe urządzenie /aplikacja innej firmy nie jest zainstalowana. Na nowym urządzeniu(FDR) Verify CW wyświetla dane z ostatniej aplikacji innej firmy, która była używana przez konto Google. Uwaga: wiersz CW nie powinien zawierać treści zewnętrznych, jeśli konto Google Assistant nie jest jeszcze powiązane z profilem zewnętrznym na innym urządzeniu

    1. GoogleAccount: mama. Nowe urządzenie /zainstalowana aplikacja innej firmy, ale nie zalogowano się. Na nowym urządzeniu(po przywróceniu urządzenia z fabrycznych ustawień) funkcja weryfikacji kont Google wyświetla dane z ostatniej aplikacji innej firmy, która była używana przez konto Google.
    2. Uwaga: gdy aplikacja jest zainstalowana i użytkownik zaloguje się w niej, stan CW będzie odzwierciedlał aktywnego użytkownika aplikacji zewnętrznej, który zalogował się w tej aplikacji.
    3. Uwaga: wiersz „Oglądaj dalej” nie powinien wyświetlać treści innych firm, jeśli konto Google nie jest jeszcze powiązane z profilem innej firmy

Nie widzimy opcji „Oglądaj dalej” w aplikacji Google TV na iOS. Co się stało?

Aby na urządzeniach z iOS wyświetlały się rekomendacje Kontynuuj oglądanie, musisz wysłać linki do treści na iOS.

Jak często należy aktualizować informacje o kontynuowaniu oglądania? Czy informacje o kontynuowaniu oglądania powinny być często aktualizowane, np. co 15 sekund?

Nie, częste aktualizacje nie są zalecane. Przyczyna jest następująca:

  • Wpływ na wydajność: ciągłe wysyłanie aktualizacji powoduje niepotrzebne obciążenie naszych serwerów, co może spowolnić działanie systemu dla wszystkich użytkowników.
  • Niezbędne dane: podczas aktywnego oglądania pozycja odtwarzania użytkownika zmienia się stale. Wysyłanie aktualizacji co kilka sekund powoduje powstawanie dużej ilości danych nadmiarowych, które nie są przydatne do wznowienia odtwarzania.

Kiedy aktualizować informacje o kontynuowaniu oglądania:

Skup się na rejestrowaniu istotnych zmian w postępach użytkownika w oglądaniu treści. Oto najważniejsze scenariusze:

  • Odtwarzanie wstrzymane lub zatrzymane: gdy użytkownik wstrzyma odtwarzanie lub przestanie oglądać film, wyślij aktualizację, aby zapisać jego bieżącą pozycję.
  • Aplikacja zamknięta lub działająca w tle: jeśli użytkownik zamknie aplikację lub przełączy się na inną aplikację podczas oglądania filmu, wyślij aktualizację, aby zapisać postęp.
  • Gdy użytkownik usuwa element z rzędu „Kontynuuj oglądanie” w aplikacji

Jak efektywnie aktualizować:

Zamiast aktualizacji o zdefiniowanym czasie, użyj zdarzeń w odtwarzaczu lub cyklu życia aplikacji, aby wywoływać aktualizacje. Przykład:

  • onPause, onStop: gdy odtwarzanie filmu zostanie wstrzymane lub zatrzymane.
  • onAppClose, onAppBackgrounded: gdy aplikacja zamyka się lub przechodzi do działania w tle.

Dzięki przestrzeganiu tych wytycznych będziesz wykorzystywać zasoby w sposób efektywny, a jednocześnie zapewnisz użytkownikom płynne korzystanie z funkcji „Kontynuuj oglądanie”.