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

當使用者在內容上執行媒體動作時 (例如在 Google 搜尋上點選您的圖示),Google 會使用內容深層連結,直接將使用者導向應用程式或平台上的內容。

深層連結規定如下:

  • urlTemplate (目標物件) 需要深層連結。
  • 深層連結必須開啟自己在所有指定平台上指定的內容。
  • 深層連結可包含參數 (&) 或錨定標記 (#)。
    • 如果自動播放功能預設為啟用,建議您在深層連結中加入參數 (例如 &autoplay=true),以便在應用程式或平台上啟用自動播放功能

@idurlurlTemplate 的範例:

{
   "@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 上,你也可以使用自訂配置連結。應用程式的 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) 上播放,請遵守以下規定:

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

平台 說明
http://schema.org/DesktopWebPlatform 電腦版網路瀏覽器的搜尋平台。
http://schema.org/MobileWebPlatform 行動網路瀏覽器的搜尋平台。
http://schema.org/AndroidPlatform Android 應用程式的 Google 搜尋和 PlayGuide 平台。
http://schema.org/AndroidTVPlatform Android TV 應用程式的 Android TV 平台。
http://schema.org/IOSPlatform iOS 應用程式中的搜尋平台。
http://schema.googleapis.com/GoogleVideoCast Chromecast 裝置上的投放和 Google Home 平台。
http://schema.googleapis.com/GoogleAudioCast 僅限聆聽動作。Chromecast 裝置上的投放和 Google Home 平台。

具有兩個不同深層連結的實體範例:

"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 將使用者導向您的應用程式或平台時,我們會要求 即可自動播放所選內容這可讓使用者 觀看或聆聽內容

觀看動作播放行為

針對「觀看動作」,我們需要下列播放行為。

所有深層連結:電影、TVEpisode、TVSeries 和 TVSeason

  • 登入或購買行為:如果服務需要登入或 購買,該電影或劇集必須視情況播放 之後的符記詳情請參閱深層連結規範 後續追蹤。

  • 播放:如果服務會追蹤使用者的狀態,播放必須來自於 使用者先前在電影或劇集上的標記。否則,播放必須 從頭開始

  • 自動播放:視平台而定,你必須在使用者選取目標劇集或電影後,讓服務明顯播放內容。

    • 搜尋:強烈建議您採用自動播放,但並非必要。如果不支援自動播放,則內容必須在使用者導向您的應用程式或服務後按一下播放。
    • Android TV:電影和劇集必須啟用自動播放功能。

僅限 TVSeries 和 TVSeason 深層連結

  • 選取目標劇集:您必須選取正確的目標劇集。如果 您的服務會追蹤使用者的狀態,因此目標劇集必須是單集節目 使用者上次停止觀看的內容或者,如果使用者已經完成 是他們上次觀看的劇集,讓目標劇集接續播放 影片。否則目標劇集必須是下列其中一個值 請自行斟酌:

    • TVSeries
      • 系列叢書的第一集。建議用於序列化節目。
      • 最新一季的第一集。適用對象 。
      • 最新一集。建議用於每日或新聞相關節目。
    • TVSeason
      • 該季第一集。建議用於序列化節目。
      • 最新一集。建議用於每日或新聞相關節目。

    TVSeriesTVSeason 的深層連結必須是靜態連結 (不可變更) 並解析為目標劇集請勿將深層連結用於 特定集數。

    下表提供數個範例,以說明 TVSeriesTVSeasonTVEpisode 實體類型:

    如果使用者上次觀看 S6E24,則指定該集節目 如果使用者尚未觀看任何劇集,則指定該集節目
    系列叢書深層連結
    • S6E24 (如果使用者尚未完成 S6E24)
    • S6E25 (使用者已看完 S6E24)

    可以是下列其中一項:

    • 系列叢書第一集
    • 最新一季的第一集
    • 最新劇集
    季別深層連結 (S1-S5)
    • 無論使用者上次觀看該季的哪集內容,還是 或是某一季的第一集 (如果尚未觀看) 各季節目集數。
    • 本季第一集
    季別深層連結 (S6)
    • S6E24 (如果使用者尚未完成 S6E24)
    • S6E25 (使用者已看完 S6E24)

    可以是下列其中一項:

    • 本季第一集
    • 最新劇集
    單集節目深層連結
    • 獲得點擊的特定單集節目。
    • 獲得點擊的特定單集節目。

監聽動作播放行為

監聽動作需要下列播放行為:

  • 系統會將使用者導向您的應用程式或服務,在使用者按下後一鍵播放內容。
  • 如果您的應用程式或平台需要登入,必須立即播放內容,或是在登入後一鍵內按一下。
  • 您的應用程式或平台必須至少為所有使用者提供一種播放歌曲、專輯、演出者或播放清單的方法。
    • 如果使用者不符合播放確切內容的資格 (例如沒有必要的訂閱方案),您的服務必須說明使用者在抵達您的應用程式或平台時,需要採取哪些行動,才能獲得確切內容。

為應用程式或平台推薦下列最佳做法:

  • 如果是 MusicGroup,每當使用者選取演出者時,播放不同演出者的內容。
  • 如為 MusicAlbum,則依照專輯中的呈現順序播放內容。
  • MusicPlaylist:每當使用者選取播放清單時,播放來自播放清單的不同內容。

請完成下列步驟:

  1. 根據平台檢查每個內容是否有不同的深層連結。
  2. 請針對每個深層連結詢問下列有關其進入點的問題 (應用程式或平台中,深層連結會將您導向到的網頁):
    • 進入點 (非內容) 是否支援多種語言?
    • 進入點是否支援多種字幕語言?
    • 進入點是否支援多個鏡頭角度?
    • 進入點是否支援多種影片格式?

如果上述任一問題的回答為「是」,則需要提供該深層連結的 additionalProperty 屬性。請參閱 additionalProperty 範例。