이 페이지는 Cloud Translation API를 통해 번역되었습니다.

콘텐츠의 플랫폼별 딥 링크를 파악하세요.

사용자가 콘텐츠에서 미디어 작업을 시작하면 (예: 사용자가 Google 검색에서 아이콘을 클릭) Google은 콘텐츠의 딥 링크를 사용하여 사용자를 앱 또는 플랫폼의 콘텐츠로 바로 연결합니다.

딥 링크

딥 링크의 요구사항은 다음과 같습니다.

대상 객체의 urlTemplate에는 딥 링크가 필요합니다.
딥 링크는 지정된 모든 플랫폼에서 타겟팅하는 콘텐츠를 열어야 합니다.
딥 링크에는 매개변수 (&) 또는 앵커 태그 (#)가 포함될 수 있습니다. <ph type="x-smartling-placeholder">
- 자동재생이 기본적으로 활성화되어 있지 않다면 딥 링크에 매개변수(예: &autoplay=true)를 추가하여 앱 또는 플랫폼에서 자동재생을 활성화하는 것이 좋습니다.

@id, url, urlTemplate의 예:

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "Movie",
   "@id": "http://www.example.com/my_favorite_movie",
   "url": "http://www.example.com/my_favorite_movie",
   "name": "My Favorite Movie",
   "potentialAction": {
     "@type": "WatchAction",
     "target": {
       "@type": "EntryPoint",
       "urlTemplate": "http://www.example.com/my_favorite_movie&autoplay=true",
       ...
     },
   ...
   },
   ...
}

딥 링크를 사용하여 재생 시작

다음 의사 코드는 사용자가 시작할 때 원하는 동작을 나타냅니다. 재생:

if your app is installed
  open app and initiate playback
elseif your website supports playback
  open your website and initiate playback
else
  take user to your app's install page on the Play or App store and then
  initiate playback after your app is installed

원하는 재생 동작을 얻으려면 다음 사항을 준수하세요. 플랫폼별 요구사항:

iOS: 범용 링크를 사용해야 합니다.
Android 및 Android TV: Android App Links를 사용하거나 또는 맞춤 스키마 링크를 사용합니다.

를 통해 개인정보처리방침을 정의할 수 있습니다.

Android 및 Android TV용 맞춤 스키마 링크

Android 및 Android TV에서는 맞춤 스키마 링크를 사용할 수도 있습니다. 앱의 package_id는 커스텀 스킴 URI에 포함되어야 합니다. 이렇게 하면 사용자가 Play 스토어의 앱 페이지로 이동하게 됩니다. 따라서 다음 URI 형식이 유일하게 허용되는 사용자 지정 스키마 형식입니다. 미디어 작업:

android-app://{package_id}/{scheme}/{path}

예를 들면 다음과 같습니다.

android-app://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

자세한 내용은 전체 사양을 참고하세요.

intent://{package_id}/{scheme}/{path}

예를 들면 다음과 같습니다.

intent://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

다음에 나오는 예와 같은 다른 URI 형식은 커스텀으로 사용할 수 없습니다. 미디어 작업에 대한 스키마 링크:

scheme://{path}: 예를 들면 다음과 같습니다.
mynetwork://play?series=20114&title=21141&media=e90c89fa4

권장사항

앱이 설치되어 있지 않고 웹 플레이어가 없는 경우 사용자를 자동으로 리디렉션하도록 웹 서버를 Android 또는 App Store로 이동하여 앱을 설치합니다. 리디렉션하려면 Firebase 동적 링크를 사용하세요. 서드 파티 스마트 링크 플랫폼을 사용하는 것이 좋습니다

앱이 설치되어 있지 않고 웹 플레이어가 있는 경우 사용자가 Android 또는 App Store로 연결되는 링크 또는 스마트 배너를 앱을 설치해야 합니다. 다음은 구현된 스마트 배너의 예입니다.

구현된 스마트 배너의 예

딥 링크 요구사항 및 제한사항 요약

다음 표에는 딥 링크의 요구사항 및 제한사항이 나와 있습니다. iOS, Android 및 AndroidTV와 관련이 있습니다.

	iOS	Android 및 Android TV
http:// 또는 https://	필수	모바일 웹사이트에서 재생을 지원하는 경우에 권장됩니다.
android-app:// 또는 intent://	해당 사항 없음	모바일 웹사이트에서 재생을 지원하지 않는 경우에 권장됩니다.
foo:// (임의의 문자열)	허용되지 않음	허용되지 않음

플랫폼 유형

Google의 여러 플랫폼 (Google 검색, 어시스턴트, Android TV, Chromecast)에서 콘텐츠를 사용하려면 다음 요구사항을 준수해야 합니다.

모든 파트너 지원 플랫폼에는 콘텐츠에 대한 딥 링크가 필요합니다.
Chromecast 플랫폼의 경우 최신 Cast 애플리케이션 프레임워크 (CAF) 수신기 SDK를 사용하여 수신기를 빌드해야 합니다.
모바일 플랫폼 (Android 및 iOS)의 경우 딥 링크를 사용하여 재생 시작 섹션의 요구사항을 참조하세요.

다음 표에는 미디어 작업을 지원하는 플랫폼 목록이 나와 있습니다.

플랫폼	설명
`http://schema.org/DesktopWebPlatform`	데스크톱 웹브라우저의 검색 플랫폼입니다.
`http://schema.org/MobileWebPlatform`	모바일 웹브라우저의 검색 플랫폼입니다.
`http://schema.org/AndroidPlatform`	Android 앱의 검색 및 PlayGuide 플랫폼
`http://schema.org/AndroidTVPlatform`	Android TV 앱의 Android TV 플랫폼
`http://schema.org/IOSPlatform`	iOS 앱의 검색 플랫폼
`http://schema.googleapis.com/GoogleVideoCast`	Chromecast 기기의 전송 및 홈 플랫폼
`http://schema.googleapis.com/GoogleAudioCast`	듣기 작업만. Chromecast 기기의 전송 및 홈 플랫폼

서로 다른 두 개의 딥 링크가 있는 항목의 예:

"potentialAction": {
  "@type": "WatchAction",
  "target": [
    {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/standardView",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform"
      ]
    },
    {
      "@type":"EntryPoint",
      "urlTemplate":"http://example.com/multipleViews",
      "actionPlatform": [
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "videoFormat",
          "value": [ "HD", "4K" ]
        }
      ],
    }
  ],
  ...
}

재생 동작

대부분의 콘텐츠는 Google이 사용자를 앱이나 플랫폼으로 안내할 때 선택한 콘텐츠를 자동재생할 수 있습니다. 이를 통해 사용자는 콘텐츠를 시청하거나 청취할 때 발생합니다

시청 작업 재생 동작

시청 작업의 경우 다음 재생 동작이 필요합니다.

모든 딥 링크: Movie, TVEpisode, TVSeries, TVSeason

로그인 또는 구매 동작: 서비스에 로그인이 필요하거나 영화나 에피소드가 재생되기 위해서는 입력합니다. 자세한 내용은 있습니다.
재생: 서비스에서 사용자 상태를 추적하는 경우 다음 위치에서 재생을 시작해야 합니다. 영화나 에피소드에 대한 사용자의 이전 마커입니다. 그렇지 않으면 재생은 콘텐츠의 처음부터 시작합니다
자동재생: 플랫폼에 따라 사용자가 타겟 에피소드나 영화를 선택한 후 서비스에서 콘텐츠를 눈에 띄게 재생해야 합니다.
- 검색: 자동재생을 사용하는 것이 좋지만 필수는 아닙니다. 자동재생이 지원되지 않는 경우 사용자가 앱 또는 서비스로 이동한 후 클릭 한 번으로 콘텐츠가 재생되어야 합니다.
- Android TV: 영화 및 에피소드를 자동재생해야 합니다.

TVSeries 및 TVSeason 딥 링크만 해당

타겟 에피소드 선택: 올바른 타겟 에피소드를 선택해야 합니다. 만약 서비스가 사용자의 상태를 추적하는 경우 타겟 에피소드는 사용자가 마지막으로 시청을 중단한 시간입니다 또는 사용자가 사용자가 마지막으로 시청한 에피소드를 다음 에피소드로 설정 에피소드를 시청하시기 바랍니다. 그 외의 경우 타겟 에피소드는 다음 중 하나여야 합니다. 다음 사항을 선택할 수 있습니다.

TVSeries
- 시리즈의 첫 번째 에피소드입니다. 연재 프로그램에 권장됩니다.
- 최신 시즌의 첫 번째 에피소드 추천 대상 한 편으로는 충분하지 않습니다.
- 최신 에피소드 일일 또는 뉴스 관련 프로그램에 권장됩니다.
TVSeason
- 시즌의 첫 번째 에피소드입니다. 연재 프로그램에 권장됩니다.
- 최신 에피소드 일일 또는 뉴스 관련 프로그램에 권장됩니다.

TVSeries 또는 TVSeason의 딥 링크는 변경되지 않는 정적 링크여야 합니다. 타겟 에피소드로 연결됩니다. 확인할 수 있습니다.

다음 표는 필수 명령을 보여주는 몇 가지 예를 보여줍니다. TVSeries, TVSeason, TVEpisode 항목 유형:

	사용자가 S6E24를 마지막으로 시청한 경우 타겟 에피소드	사용자가 시청한 에피소드가 없는 경우 타겟팅 에피소드
시리즈 딥 링크	S6E24 (사용자가 S6E24를 완료하지 않은 경우) S6E25 (사용자가 S6E24 시청을 완료한 경우)	다음 중 하나입니다. 시리즈의 첫 번째 에피소드 최신 시즌의 첫 번째 에피소드 최신 에피소드
시즌 딥 링크 (S1-S5)	사용자가 해당 시즌에서 마지막으로 시청한 에피소드 사용자가 아직 시청하지 않은 시즌의 첫 번째 에피소드 그 시즌의 에피소드를 보여줍니다.	시즌 첫 번째 에피소드
시즌 딥 링크 (S6)	S6E24 (사용자가 S6E24를 완료하지 않은 경우) S6E25 (사용자가 S6E24 시청을 완료한 경우)	다음 중 하나입니다. 시즌 첫 번째 에피소드 최신 에피소드
에피소드 딥 링크	클릭된 특정 에피소드입니다.	클릭된 특정 에피소드입니다.

듣기 작업 재생 동작

청취 작업의 경우 다음 재생 동작이 필요합니다.

사용자가 앱 또는 서비스로 이동한 후 클릭 한 번으로 콘텐츠가 재생되어야 합니다.
로그인이 필요한 앱 또는 플랫폼의 경우 콘텐츠를 즉시 재생하거나 로그인 후 클릭 한 번으로 콘텐츠를 재생해야 합니다.
앱 또는 플랫폼은 모든 사용자가 정확한 노래, 앨범, 아티스트 또는 재생목록을 재생할 수 있는 방법을 하나 이상 제공해야 합니다.
- 정확한 콘텐츠를 재생할 수 없는 사용자 (예: 필수 구독이 없는 사용자)의 경우, 사용자가 앱이나 플랫폼에 도착한 후 정확한 콘텐츠를 재생하기 위해 취해야 할 조치를 설명해야 합니다.

앱 또는 플랫폼에 관한 다음 권장사항을 따르는 것이 좋습니다.

MusicGroup의 경우 사용자가 아티스트를 선택할 때마다 아티스트의 다른 콘텐츠가 재생됩니다.
MusicAlbum의 경우 앨범에 표시된 순서대로 콘텐츠를 재생합니다.
MusicPlaylist의 경우 사용자가 재생목록을 선택할 때마다 재생목록에서 다른 콘텐츠를 재생합니다.

딥 링크 식별

다음 단계를 따르세요.

콘텐츠마다 플랫폼에 따라 딥 링크가 다른지 확인합니다.
각 딥 링크의 진입점 (딥 링크를 통해 연결되는 앱 또는 플랫폼의 페이지)에 대해 다음과 같은 질문을 합니다. <ph type="x-smartling-placeholder">
- 콘텐츠가 아닌 진입점이 여러 언어를 지원하나요?
- 진입점에서 여러 자막 언어를 지원하나요?
- 진입점이 다양한 카메라 각도를 지원하나요?
- 진입점에서 여러 동영상 형식을 지원하나요?

이러한 질문에 대한 대답이 '예'라면 해당 딥 링크에 대해 additionalProperty 속성을 제공해야 합니다. additionalProperty 예시를 참고하세요.

메타데이터 수집

액세스 요구사항 파악하기