找出內容的平台專屬深層連結

使用者對內容啟動媒體動作 (例如點按 Google 搜尋上的圖示) 時，Google 會使用內容的深層連結，直接將使用者帶往應用程式或平台中的內容。

深層連結

深層連結必須符合下列規定：

• urlTemplate (目標物件) 需要深層連結。
• 深層連結必須在所有指定平台上開啟目標內容。
• 深層連結可包含參數 (&) 或錨點標記 (#)。
  • 如果系統未預設啟用自動播放功能，建議您在深層連結中附加 &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 應用程式連結或自訂配置連結。

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 Dynamic Links 或第三方智慧連結平台。

如果使用者沒有安裝應用程式，但有網頁播放器，請提供 Android 或 App Store 的連結或智慧橫幅，讓使用者安裝應用程式。以下是已導入智慧橫幅的範例：

深層連結規定和限制摘要

下表列出深層連結的相關規定和限制，適用於 iOS、Android 和 AndroidTV：

平台類型

如要確保內容可在支援媒體動作的多個 Google 服務上使用，請遵守下列規定：

• 所有合作夥伴支援的平台都必須提供內容的深層連結。
• 如為 Chromecast 平台，請使用最新版的 Cast Application Framework (CAF) Receiver SDK 建構接收器。
• 如果是行動平台 (Android 和 iOS)，請參閱「使用深層連結啟動播放」一節中的規定。

下表列出支援媒體動作的平台：

以下是具有兩個不同深層連結的實體範例：

"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 將使用者帶往您的應用程式或平台時，我們要求您自動播放所選內容。使用者可以快速開始觀看或聆聽內容。

觀看動作播放行為

如為觀看動作，我們需要下列播放行為。

所有深層連結：電影、電視節目集數、電視節目和電視節目季

• 登入或購買行為：如果服務需要登入或購買，電影或劇集必須在之後播放，視其類型而定。詳情請參閱下方的深層連結指南。

• 播放：如果服務會追蹤使用者的狀態，播放功能必須從使用者先前在電影或劇集中的標記開始。否則必須從內容開頭開始播放。

• 自動播放：視平台而定，使用者選取目標劇集或電影後，服務必須顯眼地播放內容。

  • 搜尋：強烈建議開啟自動播放功能，但這並非必要條件。如果系統不支援自動播放，使用者前往應用程式或服務後，內容必須在一次點擊內播放。
  • Android TV：電影和劇集必須自動播放。

僅限 TVSeries 和 TVSeason 深層連結

• 選取目標集數：請務必選取正確的目標集數。如果服務會追蹤使用者狀態，目標集數必須是使用者上次停止觀看的集數。或者，如果使用者已完全看完上次觀看的劇集，請改為顯示後續劇集。否則，目標劇集必須由你自行斟酌，並符合下列其中一項條件：

  • TVSeries
    • 影集的劇集第一集。建議用於連續劇。
    • 最新一季的第一集。建議用於長期連載的節目。
    • 最新一集。適合每日或新聞相關節目。
  • TVSeason
    • 本季第一集。建議用於連續劇。
    • 最新一集。建議用於每日或新聞相關節目。

  TVSeries或TVSeason的深層連結必須是靜態 (不會變更)，且會解析為目標集數。請勿使用特定集數的深層連結。

  下表提供多個範例，說明 TVSeries、TVSeason 和 TVEpisode 實體類型所需的目標劇集選取邏輯：

  	如果使用者上次觀看的是第 6 季第 24 集，則以該集為目標	如果使用者尚未觀看任何劇集，則指定劇集
  影集深層連結	S6E24 (如果使用者尚未看完 S6E24) S6E25 (如果使用者已看完 S6E24)	下列其中一項： 系列第一集 最新一季的第一集 最新劇集
  影集季別深層連結 (S1-S5)	使用者在該季別中上次觀看的劇集，或該季別的第一集 (如果使用者尚未觀看該季別的任何劇集)。	本季第一集
  影集季別深層連結 (S6)	S6E24 (如果使用者尚未看完 S6E24) S6E25 (如果使用者已看完 S6E24)	下列其中一項： 本季第一集 最新劇集
  集數深層連結	使用者點選的特定集數。	使用者點選的特定集數。

「聽取動作」的播放行為

對於「聆聽動作」，我們要求以下播放行為：

• 使用者前往應用程式或服務後，必須在一次點擊內播放內容。
• 如果應用程式或平台需要登入，登入後必須立即播放內容，或在點選一次後播放。
• 應用程式或平台必須提供至少一種方式，讓所有使用者播放特定歌曲、專輯、藝人或播放清單。
  • 如果使用者不符合播放特定內容的資格 (例如未訂閱相關方案)，服務必須在使用者抵達應用程式或平台時，說明使用者需要採取哪些行動才能符合資格。

建議您為應用程式或平台採取下列最佳做法：

• 如果是 MusicGroup，請在使用者每次選取藝人時，播放該藝人的不同內容。
• 如果是 MusicAlbum，請按照專輯中的順序播放內容。
• 對於 MusicPlaylist，每次使用者選取播放清單時，都會播放播放清單中的不同內容。

找出深層連結

請完成下列步驟：

1. 針對各項內容，檢查是否會根據平台提供不同的深層連結。
2. 針對每個深層連結，請詢問下列有關進入點 (深層連結帶您前往的應用程式或平台頁面) 的問題：
   • 進入點 (而非內容) 是否支援多種語言？
   • 進入點是否支援多種字幕語言？
   • 進入點是否支援多個攝影機角度？
   • 進入點是否支援多種影片格式？

如果對任何問題的回答為「是」，請為該深層連結提供 additionalProperty 屬性。請參閱 additionalProperty 範例。