게시 관련 FAQ
콘텐츠 게시 작업은 누가 관리하나요?
앱 개발자가 콘텐츠 게시 작업을 관리하고 참여 서비스에 요청을 보냅니다. 이렇게 하면 개발자 파트너가 사용자에게 콘텐츠를 게시하는 시점과 방법을 더 효과적으로 제어할 수 있습니다. 따라서 콘텐츠 게시를 위해 파트너 앱이 너무 자주 절전 모드에서 해제되지 않게 됩니다.
개발자가 모든 클러스터 유형을 게시해야 하나요?
기술적으로 개발자는 클러스터 한 개만 게시할 수 있지만 다른 클러스터를 추가하는 것이 좋습니다. 그러지 않으면 개발자가 더 나은 콘텐츠 참여를 유도할 기회를 놓칠 수 있습니다. 카테고리마다 모든 클러스터 유형을 게시하는 것이 좋습니다.
앱이 실행되는 동안 개발자 파트너가 작업 관리자를 사용하여 데이터를 얼마나 자주 게시해야 하나요?
이는 개발자 파트너가 결정합니다. 일반적인 맞춤 콘텐츠의 경우 하루에 한두 번 게시하고 장바구니, 재주문, 기타 연속 콘텐츠에는 이벤트 기반 방법을 사용하는 것이 좋습니다 (예: 사용자가 장바구니에 상품을 추가하거나 영화를 중간에 중지하는 콜백으로 작업자를 시작). 소셜 앱의 경우 앱을 사용할 때마다 업데이트된 맞춤 콘텐츠 클러스터를 게시하는 것이 중요합니다. 소셜 앱 사용자는 최신 추천에 더 관심이 있으며 게시물은 최대 한 번만 보는 것이 좋습니다.
개발자는 언제 삭제 API를 호출해야 하나요?
삭제 API는 게시할 콘텐츠가 없는 경우에만 호출해야 합니다. 이후에 삭제 및 게시 API를 호출하여 콘텐츠를 대체하지 마세요. 게시 API가 이전 콘텐츠를 자동으로 삭제합니다.
브로드캐스트 인텐트 FAQ
Android 앱 개발자가 브로드캐스트 인텐트를 등록해야 하는 이유는 무엇인가요?
사용자에게 최신 콘텐츠를 제공하려면 사용자가 앱을 자주 사용하지 않는 경우에 브로드캐스트 인텐트를 사용하여 데이터 동기화를 트리거해야 합니다.
백그라운드 실행이 허용되지 않음
브로드캐스트 인텐트를 등록하는 동안 다음과 같은 오류가 발생할 수 있습니다.
Background execution not allowed: receiving Intent
{ act=com.google.android.engage.action.PUBLISH_RECOMMENDATION .. }
Broadcast receiver를 동적으로 등록해야 합니다.
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));
...
}
워크플로 FAQ
SDK와 통합하는 동안 다음과 같은 오류가 발생할 수 있습니다.
딥 링크 테스트
딥 링크는 패키지 이름과 결합됩니다. 딥 링크를 테스트하는 좋은 방법은 adb 도구를 사용하는 것입니다.
adb shell am start -W -a android.intent.action.VIEW -d <DEEPLINK URI> <PACKAGE NAME>
통합의 영향은 어떻게 계산하나요?
딥 링크는 기여 분석을 추적하는 데 좋은 방법입니다. 사용자를 앱으로 연결하는 딥 링크 URL을 추가 추적 매개변수와 함께 사용할 수 있습니다. 예: 'http://xx/deeplink?source_tag=engage'
개발자는 자체 추적 매개변수를 추가하고 기여 분석을 제공하여 영향을 계산할 수 있습니다.
TV용 참여 2.0 FAQ
일반적인 질문
이어서 시청하기 2.0이란 무엇인가요?
이어서 시청 2.0 (Video Discovery API)은 '중단한 부분부터 이어서 시청' 환경을 한 단계 업그레이드합니다. 시청자가 더 다양한 기기에서 콘텐츠를 원활하게 재개할 수 있는 중요한 업그레이드입니다. Google TV에서 영화를 시작한 후 출퇴근길에 휴대전화에서 간편하게 이어서 시청할 수 있다면 얼마나 좋을까요? 이게 바로 이어서 시청하기 2.0의 강력한 기능입니다.
이 새로운 시스템은 전체 Google 생태계에서 원활하고 문제 없는 환경을 제공하여 시청자 참여도와 유지율을 높이도록 설계되었습니다.
이어서 볼만한 동영상 2.0을 사용하면 어떤 이점이 있나요?
보기 지속 2.0을 사용하면 시청자가 어떤 기기를 사용하든 이전에 시청한 부분부터 콘텐츠를 이어서 시청할 수 있습니다. 작동 방식은 다음과 같습니다.
- Google 서비스 전반에서 원활한 환경: Google TV에서 시청을 시작하고 Android 휴대전화, iPhone 또는 Android 태블릿에서 원활하게 이어서 시청할 수 있습니다. 아직 앱을 설치하지 않은 기기에서도 작동합니다.
- 참여도 및 유지율 향상: '이어서 볼만한 동영상' 2.0을 사용하면 새 기기에서도 사용자가 앱으로 돌아오도록 유도할 수 있습니다. 사용자가 좋아하는 프로그램을 다시 시작할 수 있도록 하면 계속 시청할 가능성이 높아집니다.
- 더 넓은 도달범위: Google TV 외에도 Play Cubes 및 기타 Google 미디어 앱과 같은 다른 Android 미디어 환경에서 '이어서 시청하기' 2.0이 작동합니다.
- 하위 호환성: 이전의 '다음 볼만한 동영상' 기능을 이미 사용하고 있다면 문제 없습니다. 이어서 시청 2.0은 이전 버전과 호환되므로 기존 통합은 계속 작동합니다.
중요사항: 모든 새로운 이어서 시청 통합은 이어서 시청 2.0을 사용해야 합니다. 이전의 '교차 기기 관심 목록' 시스템이 단계적으로 지원 중단됩니다.
계속 시청 2.0을 지원하는 표시 경로는 무엇인가요?
- Google TV
- Android TV (기기 내에서만 지원하지만 Engage SDK 지원)
- Google TV Android 모바일 앱
- Google TV iOS 모바일 앱
- Play Cubes
- Google Entertainment Space
- iOS 기기 (REST API 통합 포함)
Engage SDK가 이어서 시청 2.0용인가요?
예, Engage SDK는 '계속 시청' 2.0용입니다. '계속 시청' 2.0과 통합해야 합니다.
이어서 시청 2.0은 모든 사용자에게 제공되나요?
'이어서 볼만한 동영상' 2.0은 단계적으로 출시되고 있습니다.
- 사전 체험판: 처음에는 사전 체험 프로그램 (EAP)을 통해 일부 파트너 그룹에 액세스 권한이 부여됩니다.
- 액세스 범위 확대: YouTube는 곧 모든 개발자가 '이어서 볼만한 동영상' 2.0을 사용할 수 있도록 노력하고 있습니다.
원활하고 성공적인 출시를 위해 출시를 관리하는 안전 장치가 마련되어 있습니다. 여기에는 '이어서 볼만한 동영상' 2.0 측의 허용 목록과 Engage SDK 내의 별도 확인이 모두 포함됩니다. EAP 파트너이거나 곧 온보딩하려는 경우 Engage SDK 통합을 시작하기 전에 액세스 권한을 설정할 수 있도록 Google에 문의하세요.
제공해야 하는 권장 이미지 크기가 있나요?
항목 만들기 섹션에서 이미지 요구사항이 업데이트되었습니다.
이 새로운 API 문서를 사용하면 Google 서버에서 클라이언트에서 이어서 볼 데이터를 가져와 모든 기기에 반영하나요?
새 API는 다음과 같은 주요 이점을 제공합니다.
Google TV 전반에서 원활한 환경: 사용자는 한 Google TV에서 시청을 시작하고 동일한 계정으로 로그인한 다른 Google TV에서 다시 시작할 수 있습니다. 이 기능은 이전 Android TV 버전에서도 작동합니다.
모바일 앱 통합: Android 및 iOS용 Google TV 모바일 앱에서 이어서 시청을 사용할 수 있으므로 사용자가 TV와 휴대기기를 원활하게 전환할 수 있습니다.
사용자 유지율 향상: 앱이 설치되어 있지 않거나 사용자가 로그인하지 않은 기기에서도 '계속 시청'을 통해 사용자가 앱을 다시 사용하도록 유도하여 유지율을 높일 수 있습니다.
다른 플랫폼으로 확장: 이 통합을 통해 Android, Play Cubes, 태블릿, Android의 기타 Google 미디어 앱 및 표시 경로와 같은 다른 Google 미디어 플랫폼으로 이어서 시청한 항목을 확장하여 여러 기기에서 사용자 참여도를 극대화할 수 있습니다.
연속 클러스터에 게시할 수 있는 항목 수에는 제한이 있나요?
각 개발자 파트너는 연속 클러스터에서 최대 5개의 항목으로 제한됩니다. 이 제한은 여러 미디어 제공업체가 공유하는 공간인 Google TV의 '이어서 시청하기' 행에 콘텐츠를 공정하게 배포합니다.
항목을 5개 이상 게시하려고 하면 어떻게 되나요?
게시 요청이 항목 5개 한도를 초과하면 EngageSDK에서 게시 요청을 거부합니다. 게시를 완료하려면 요청의 항목 수를 줄여야 합니다. 사용자가 시청을 중단한 항목만 포함해야 하므로 대부분의 경우 이러한 항목은 몇 개 되지 않습니다. 이러한 항목이 5개를 초과하는 경우 더 최근 항목을 선택하여 게시할 수 있습니다.
항목 수에 제한이 있는 이유는 무엇인가요?
Google TV의 '이어서 시청하기' 행에는 다양한 미디어 제공업체의 콘텐츠가 표시됩니다. 제공업체당 항목 수를 제한하면 사용자가 좋아하는 모든 소스의 다양한 콘텐츠를 볼 수 있으므로 공정하고 균형 잡힌 사용자 환경을 제공할 수 있습니다.
인증 앱 질문
제출하기 전에 인증 앱으로 앱을 테스트해야 하나요?
예. APK를 제출하기 전에 인증 앱으로 앱을 테스트하는 것이 중요합니다.
구현에 자신이 있을 수 있지만, '시청한 부분부터 다시 시작' 2.0 통합에는 복잡한 구성요소가 많습니다. 인증 앱은 안전망 역할을 하여 잠재적인 문제를 조기에 포착하고 장기적으로는 소중한 시간과 노력을 절약해 줍니다.
원활한 출시와 우수한 사용자 환경을 보장하는 데 도움이 되는 빠른 진단이라고 생각하면 됩니다.
문제를 미리 파악하고 해결하면 거부 및 재제출의 불편을 피할 수 있습니다.
APK를 제출하려면 앱이 인증 절차를 통과했음을 보여주는 스크린샷을 포함해야 합니다.
#### 통합 중에 주의해야 할 일반적인 실수는 무엇인가요?
인증 앱은 '시청한 부분부터 다시 시작' 2.0 통합과 관련된 잠재적 문제를 포착하도록 설계되었습니다. 다음은 개발자가 자주 겪는 일반적인 실수입니다.
모든 콘텐츠 유형 (영화, TV 에피소드, 라이브 스트림, 동영상 클립):
- 누락된 링크: 콘텐츠에 유효한 플랫폼별 URI (링크)를 제공해야 합니다. 이러한 링크는 시스템에 각 플랫폼에서 콘텐츠를 찾을 위치를 알려줍니다.
- 제목 누락: 모든 콘텐츠의 제목을 포함해야 합니다. 이렇게 하면 사용자가 시청 중인 콘텐츠를 쉽게 식별할 수 있습니다.
- 이미지 가로세로 비율: 콘텐츠와 연결된 모든 이미지의 가로세로 비율이 16:9에 가까워야 합니다. 이렇게 하면 이미지가 다양한 화면에 올바르게 표시됩니다.
TV 에피소드의 경우:
- 에피소드 정보 작성: 프로그램 제목, 에피소드 번호, 시즌 번호를 포함해야 합니다. 이렇게 하면 에피소드를 구성하고 사용자가 시리즈 내에서 탐색할 수 있습니다.
- 정확한 재생 위치: 마지막 재생 위치가 에피소드의 총 재생 시간과 같거나 그보다 작은지 다시 확인합니다. 이렇게 하면 사용자가 올바른 위치에서 다시 시작할 수 있습니다.
영화의 경우:
- 정확한 재생 위치: TV 에피소드와 마찬가지로 마지막 재생 위치가 정확해야 합니다.
라이브 스트리밍 동영상의 경우:
- 방송자 정보: 라이브 스트림의 경우 방송자 이름을 포함합니다.
동영상 클립의 경우:
- 크리에이터 정보: 동영상 클립의 크리에이터를 지정합니다.
인증 앱에서 이러한 문제를 신고하므로 앱을 제출하기 전에 문제를 해결할 수 있습니다. 이렇게 하면 시간을 절약하고 사용자에게 더 원활한 환경을 제공할 수 있습니다.
계정 및 프로필 관련 질문
앱에서 익명의 사용자 로그인을 사용합니다. '이어서 볼만한 동영상' 2.0에도 AccountProfile이 여전히 필요한가요?
AccountProfile은 개별 사용자 계정을 사용하는 앱을 위해 설계되었습니다. 하지만 개발자님의 앱과 같이 일부 앱에서는 익명 로그인을 사용해야 할 수도 있습니다. 이 시나리오에서 '이어서 볼만한 동영상' 2.0이 작동하는 방식은 다음과 같습니다.
- AccountProfile은 기술적으로 필요하지만... 앱에 사용자 계정 시스템이 없어도 계속 시청 2.0을 통합할 수 있습니다.
- 기기 내 사용으로 제한됨: 이어서 시청 2.0의 교차 기기 기능은 여러 기기에서 사용자를 식별하는 데 의존합니다. 익명 로그인은 이를 제공하지 않으므로 이 기능은 사용자의 현재 기기로 제한됩니다.
- 구성 방법: 이를 설정하려면 교차 기기 동기화를 사용 중지해야 합니다. 이렇게 하면 '이어서 시청' 항목이 콘텐츠가 시작된 특정 기기에만 표시됩니다.
요약: '시청한 콘텐츠' 2.0을 익명 로그인과 통합할 수는 있지만 사용자는 동일한 기기에서만 콘텐츠를 재개할 수 있습니다.
앱에서 accountId와 profileId를 모두 지원하는 경우에도 accountId만 있고 profileId가 없는 AccountProfile을 사용할 수 있나요?
AccountProfile이 올바르게 작동하려면 accountId와 profileId가 모두 필요합니다. 이유는 다음과 같습니다.
- 일관된 식별: accountId는 사용자를 식별하고 profileId는 해당 사용자의 계정 내 여러 프로필을 구분합니다 (해당하는 경우). 둘 다 제공하면 '이어서 볼만한 동영상'이 각 개별 프로필의 콘텐츠를 정확하게 추적하고 표시할 수 있습니다.
- 오류 방지: 여러 API 호출에서 accountId 및 profileId를 일관되게 사용하지 않으면 예기치 않은 동작과 오류가 발생할 수 있습니다. 예를 들어 '관심 목록'에 콘텐츠를 추가할 때는 둘 다 포함하고 콘텐츠를 삭제할 때는 accountId만 사용하는 경우 시스템에서 의도한 항목을 올바르게 식별하고 삭제하지 못할 수 있습니다.
이어서 시청하기 2.0에 profileId가 필요한가요?
- accountId는 필수 항목입니다. 이렇게 하면 여러 기기에서 사용자를 식별할 수 있습니다.
- profileId는 우수한 사용자 환경을 제공하는 데 매우 중요합니다. 기술적으로는 선택사항이지만 서비스에서 여러 프로필을 지원하는 경우(예: 많은 스트리밍 서비스) profileId를 사용하는 것이 좋습니다. 니즈 평가/BANT 설문조사가 왜 중요한가요? profileId가 없으면 '계속 시청'에 동일한 계정의 다른 프로필의 콘텐츠가 표시될 수 있기 때문입니다. 이로 인해 사용자에게 혼란스럽고 불편한 경험을 제공할 수 있습니다.
- 요약: profileId를 제공하면 이어서 시청하기가 각 개인의 시청 기록을 정확하게 반영합니다. 앱에서 계정 내 프로필 개념을 지원하지 않는 한 프로필을 제공해야 합니다.
Google은 profileId를 어떻게 사용하나요?
서비스에서 콘텐츠를 시청할 수 있는 다양한 프로필을 제공하는 경우 기기에서 시청한 콘텐츠를 기기에서 로그인한 Google 계정에 연결하는 데 accountId 및 profileId가 사용됩니다. Google은 accountId-profileId 조합에 대해 ContinueWatching 데이터를 기록합니다. 동일한 Google 계정으로 로그인한 모든 Google 기기는 '계속 시청' 행에서 동일한 연결된 accountId-profileId에서 업데이트된 최신 데이터를 가져옵니다.
'시청한 콘텐츠' 2.0을 구현하려면 계정 연결이 필요한가요?
계정 연결은 필요하지 않습니다. 우선순위가 낮아지고 있으며 모든 관련 사용 사례는 새 Device Entitlements API로 처리됩니다.
기기 간 동기화 관련 질문
사용자가 동의하는 경우 '기기 간 동기화'는 무엇을 의미하나요?
사용자의 '기기 간 동기화' 동의를 통해 시청 중인 콘텐츠가 Google TV 서버에 저장되므로 로그인한 모든 기기에서 중단한 지점부터 원활하게 이어서 시청할 수 있습니다. 동의하지 않으면 시청 기록은 현재 기기에 로컬로 유지됩니다.
'기기 간 동기화'를 false로 설정할 수 있나요?
UserConsentToSyncAcrossDevices 플래그는 사용자의 ContinuationCluster 데이터가 여러 기기 (TV, 휴대전화, 태블릿 등)에서 동기화되는지 여부를 제어합니다. 이 플래그가 false로 설정되면 동영상을 이어서 시청하는 기능이 동일한 기기에서만 실행됩니다.
교차 기기 기능을 최대한 활용하려면 앱에서 사용자 동의를 얻고 SyncAcrossDevices를 true로 설정하는 것이 좋습니다.
Android 이외의 기기에서 시청 기록 공유에 대한 사용자 동의를 얻는 방법
기기에서 Android가 아닌 기기에서 서드 파티 서버에 공유되는 데이터 포인트는 무엇인가요?
동의는 사용자 수준 (프로필 또는 계정 수준)에서 수집됩니다. 동의를 얻은 후에는 참여도에 기반한 이어서 시청 페이로드를 어디서나 전송할 수 있으므로 Google은 모든 기기에서 부분적으로 또는 다음에 참여하는 모든 항목에 걸쳐 사용자의 '범용성 재개' 상태를 반영할 수 있습니다(모든 기기 또는 플랫폼에서 동의를 다시 요청하지 않아도 됨). 파트너는 Android에 저장된 프로필 ID와 연결된 최신 계속 시청 상태(사양에 따라)를 사용자에게 전송합니다.
REST API 질문
REST API에 관한 문서가 있나요?
REST API의 예상 완료 시간은 2025년 3월이며 이는 '시청한 콘텐츠' 2.0 개발자 문서에 설명되어 있습니다.
기존의 다음 볼만한 동영상 관련 질문
Video Discovery API가 Watch Next API를 대체하나요?
Video Discovery API는 Watch Next API를 지원하는 모든 Android TV 기기에서 하위 호환됩니다. 모든 개발자는 Video Discovery API(계속 시청 2.0)를 사용하여 '계속 시청' 행에 게시해야 합니다.
테스트 및 통합 관련 질문
LastPlayBackPositionTimeMillis와 duration의 차이점은 무엇인가요?
LastPlayBackPositionTimeMillis는 사용자가 시청을 중지한 재생 시간을 밀리초 단위로 반영해야 합니다 (예: 10분 5초의 경우 605,000밀리초) 항목의 총 재생 시간보다 커서는 안 됩니다.
반면 LastEngagementTime은 사용자가 콘텐츠에 마지막으로 참여한 타임스탬프입니다.
실행해야 하는 테스트 사례는 무엇인가요?
다음은 Google의 QA팀에서 실행하는 Google TV 테스트 사례입니다. 다른 플랫폼에서도 유사한 테스트 사례를 실행할 수 있습니다.
- 20분이 넘는 동영상을 약 5분 동안 시청합니다. 앱을 종료합니다. 동영상 카드가 '계속 시청' 행에 표시됩니다. 참고: CW에서는 서드 파티 앱당 카드 5개만 표시됩니다.
- '계속 시청' 행에 새로 표시된 카드를 선택하면 동영상의 적절한 지점부터 동영상이 계속 재생됩니다. 참고: 새 콘텐츠 또는 기존 콘텐츠는 마지막으로 중단한 지점부터 재생이 재개되어야 합니다.
- GTV 기기에서 계정을 변경하면 '계속 시청' 행의 카드가 변경됩니다. 현재 계정의 동영상만 표시됩니다. 최근 순으로 정렬됩니다. 서드 파티 앱 프로필 CW가 혼합됩니다. 참고: GoogleAccount2의 CW에는 GoogleAccount2가 시청한 서드 파티 콘텐츠가 표시됩니다.
- 뒤로 버튼을 사용하여 앱을 종료하고 '시청한 부분부터 다시 시작' 행에 카드가 표시되는지 확인합니다.
- '계속 시청' 행에서 동영상을 숨깁니다. 숨겨진 콘텐츠가 24시간이 지나도 앱이 24시간 후에 열려도 다시 표시되지 않아야 합니다. 하나의 항목을 숨겨도 여러 항목이 숨겨지지 않는지 확인합니다.
- 전체 메타데이터(카드 이미지, 앱 이름, 제목, TV 콘텐츠의 시즌 에피소드 번호)가 포함된 '시청한 항목'의 콘텐츠 사용 가능 여부
- 진행률 표시줄에 진행률 확인 표시
- 사용자가 콘텐츠를 엔딩 크레딧까지 시청함 - '이어서 볼만한 동영상'에 콘텐츠가 표시되지 않음
- '시청한 항목 계속' 행에 시청하지 않은 항목이 표시되지 않는지 확인
- CW 항목이 앱이 마지막으로 열렸을 때 또는 마지막 날이 아니라 시청 활동이 발생한 시점을 기준으로 시간순으로 정렬되는지 확인합니다.
- CW 카드의 에피소드 및 시즌 세부정보가 에피소드 콘텐츠에서 시청한 내용과 일치하는지 확인
- 완료된 항목 (크레딧 이후 항목)이 이어서 시청에 표시되지 않는지 확인
- 에피소드/영화/프로그램을 시청하는 도중에 기기를 끕니다. '에피소드/영화/프로그램을 시청하는 도중에 기기를 끄면 기기를 켜고 다른 TV에서 CW가 올바른 위치와 진행률 표시줄에 올바른 카드를 표시하는지 확인합니다."
- 에피소드 1을 완전히 시청한 후 기기를 끄고 다음을 확인합니다.
- 에피소드 1이 중단되고 이어서 시청하기 행에 다시 표시되지 않음[두 번째 기기 및 테스트 기기 사용 시]
- 에피소드 2 (제공되는 경우)가 [두 번째 기기 및 테스트 기기 사용 설정 시] '계속 시청' 행에 표시됩니다.
첫 번째 시나리오: TV1: GoogleAccount: mom, 서드 파티 계정 / 프로필: 계정 1/profile_1 콘텐츠를 시청하고 CW 데이터에 서드 파티 account_1/profile_1이 시청한 콘텐츠가 표시되는지 확인합니다.
- TV2: Google 계정: 엄마. 첫 번째 시나리오의 CW 데이터를 확인합니다. 이제 다른 계정으로 서드 파티 앱에 로그인합니다. 서드 파티 계정 / 프로필: account_2 / profile_2 콘텐츠를 시청하고 CW 데이터에 서드 파티 account_2/profile_2가 시청한 콘텐츠가 표시되는지 확인합니다.
GoogleAccount: mom. 새 기기 케이스 /서드 파티 앱이 설치되지 않았습니다. 새 기기(기기 FDR)에서 CW가 Google 계정에서 사용한 마지막으로 사용된 서드 파티 앱의 데이터를 표시하는지 확인합니다. 참고: GAIA가 아직 다른 기기의 서드 파티 프로필과 연결되어 있지 않으면 CW 행에 서드 파티 콘텐츠가 표시되어서는 안 됩니다.
- GoogleAccount: mom. 새 기기 케이스 /서드 파티 앱이 설치되었지만 로그인하지 않음 새 기기(기기 FDR)에서 CW가 Google 계정에서 사용한 마지막 서드 파티 앱의 데이터를 표시하는지 확인합니다.
- 참고: 앱이 설치되고 로그인되면 CW 상태는 서드 파티 앱에 로그인한 활성 서드 파티 사용자를 반영합니다.
- 참고: Google 계정이 아직 서드 파티 프로필과 연결되지 않은 경우 이어서 시청하기 행에 서드 파티 콘텐츠가 표시되어서는 안 됩니다.
Google TV iOS 앱에 '이어서 시청'이 표시되지 않습니다. 어떻게 된 건가요?
iOS 기기에 '이어서 볼만한 동영상'이 표시되도록 하려면 iOS 딥 링크를 전송해야 합니다.
'이어서 볼만한 동영상' 정보를 얼마나 자주 업데이트해야 하나요? 15초마다 계속 시청한 동영상 정보를 자주 업데이트해야 하나요?
아니요. 자주 업데이트하는 것은 권장하지 않습니다. 이유는 다음과 같습니다.
- 성능 영향: 업데이트를 계속 전송하면 서버에 불필요한 부담이 가해져 모든 사용자의 시스템 속도가 느려질 수 있습니다.
- 불필요한 데이터: 사용자가 시청하는 동안 재생 위치가 계속 변경됩니다. 몇 초마다 업데이트를 전송하면 재생을 재개하는 데 도움이 되지 않는 중복 데이터가 많이 생성됩니다.
'시청한 번호' 정보를 업데이트해야 하는 경우:
사용자의 시청 진행 중 의미 있는 변화를 포착하는 데 중점을 둡니다. 다음은 주요 시나리오입니다.
- 재생 일시중지 또는 중지: 사용자가 시청을 일시중지하거나 중지하면 업데이트를 전송하여 현재 위치를 저장합니다.
- 앱이 닫히거나 백그라운드로 전환됨: 사용자가 동영상을 시청하는 중에 앱을 종료하거나 다른 앱으로 전환하는 경우 진행 상황을 저장하는 업데이트를 전송합니다.
- 사용자가 앱 내에서 이어서 시청하기 행에서 항목을 삭제할 때
효율적으로 업데이트하는 방법:
시간 기반 업데이트 대신 동영상 플레이어 또는 앱 수명 주기 내의 이벤트를 활용하여 업데이트를 트리거합니다. 예를 들면 다음과 같습니다.
- onPause, onStop: 동영상 재생이 일시중지되거나 중지될 때
- onAppClose, onAppBackgrounded: 앱이 닫히거나 백그라운드로 이동할 때
이 가이드라인을 따르면 리소스를 효율적으로 사용하면서도 사용자에게 원활한 이어서 시청 환경을 제공할 수 있습니다.