Khi người dùng bắt đầu Hành động đối với nội dung đa phương tiện trên nội dung (ví dụ: người dùng nhấp vào biểu tượng của bạn trên Google Tìm kiếm), Google sẽ đưa người dùng đến thẳng nội dung trong ứng dụng hoặc nền tảng của bạn bằng cách sử dụng đường liên kết sâu của nội dung.
Liên kết sâu
Sau đây là các yêu cầu đối với đường liên kết sâu:
urlTemplate
(của đối tượng mục tiêu) cần có một đường liên kết sâu.- Đường liên kết sâu cần mở nội dung mà chúng nhắm đến trên mọi nền tảng đã chỉ định.
- Đường liên kết sâu có thể bao gồm các thông số (&) hoặc thẻ ký tự liên kết (#).
- Nếu tính năng tự động phát không được kích hoạt theo mặc định, thì bạn nên thêm một thông số, chẳng hạn như
&autoplay=true
, vào đường liên kết sâu để kích hoạt tính năng tự động phát trên ứng dụng hoặc nền tảng của mình.
- Nếu tính năng tự động phát không được kích hoạt theo mặc định, thì bạn nên thêm một thông số, chẳng hạn như
Ví dụ về @id
, url
và 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",
...
},
...
},
...
}
Sử dụng đường liên kết sâu để bắt đầu phát
Mã giả sau đây thể hiện hành vi mong muốn khi người dùng bắt đầu phát:
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
Để đạt được hành vi phát mong muốn, hãy tuân thủ những điều sau yêu cầu riêng của từng nền tảng:
- iOS
- Bạn phải sử dụng Đường liên kết phổ quát.
- Android và Android TV
- Bạn có thể sử dụng Đường liên kết trong ứng dụng Android hoặc đường liên kết lược đồ tuỳ chỉnh.
Đường liên kết lược đồ tuỳ chỉnh cho Android và Android TV
Trên Android và Android TV, bạn cũng có thể sử dụng đường liên kết lược đồ tuỳ chỉnh.
package_id
phải được đưa vào URI lược đồ tuỳ chỉnh. Điều này đảm bảo rằng
người dùng được đưa đến trang ứng dụng của bạn trên Cửa hàng Play nếu ứng dụng chưa được cài đặt.
Do đó, các định dạng URI sau đây là định dạng lược đồ tuỳ chỉnh duy nhất được chấp nhận
đối với Hành động đối với nội dung đa phương tiện:
android-app://{package_id}/{scheme}/{path}
-
Ví dụ:
android-app://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4
Để biết thêm chi tiết, hãy xem quy cách đầy đủ.
intent://{package_id}/{scheme}/{path}
-
Ví dụ:
intent://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4
Các định dạng URI khác, như ví dụ bên dưới, không được chấp nhận tuỳ chỉnh đường liên kết lược đồ cho Hành động đối với nội dung đa phương tiện:
scheme://{path}
-
Ví dụ:
mynetwork://play?series=20114&title=21141&media=e90c89fa4
Các phương pháp hay nhất
Trong trường hợp bạn chưa cài đặt ứng dụng và không có trình phát trên web, định cấu hình máy chủ web để tự động chuyển hướng người dùng đến Android hoặc App Store để cài đặt ứng dụng của bạn. Để chuyển hướng, hãy sử dụng đường liên kết động của Firebase hoặc các nền tảng đường liên kết thông minh bên thứ ba.
Trong trường hợp bạn chưa cài đặt ứng dụng và có trình phát trên web, cung cấp đường liên kết hoặc biểu ngữ thông minh cho Android hoặc App Store để người dùng cài đặt ứng dụng của bạn. Sau đây là ví dụ về một biểu ngữ thông minh đã được triển khai:
Tóm tắt các yêu cầu và hạn chế đối với đường liên kết sâu
Bảng sau đây trình bày các yêu cầu và hạn chế đối với đường liên kết sâu, vì chúng liên quan đến iOS, Android và Android TV:
iOS | Android và Android TV | |
---|---|---|
http:// hoặc https:// | Bắt buộc | Bạn nên dùng cách này nếu trang web dành cho thiết bị di động có hỗ trợ tính năng phát. |
android-app:// hoặc intent:// | Không áp dụng | Nên dùng nếu trang web dành cho thiết bị di động không hỗ trợ tính năng phát. |
foo:// (chuỗi tuỳ ý) | Không được phép | Không được phép |
Loại nền tảng
Để đảm bảo nội dung của bạn xuất hiện trên nhiều nền tảng của Google (Tìm kiếm, Trợ lý, Android TV và Chromecast), hãy tuân thủ những yêu cầu sau:
- Tất cả các nền tảng do đối tác hỗ trợ đều cần có một đường liên kết sâu đến nội dung của bạn.
- Đối với các nền tảng Chromecast, bạn cần tạo một bộ thu bằng cách sử dụng SDK Bộ thu Khung ứng dụng truyền (CAF) mới nhất.
- Đối với các nền tảng di động (Android và iOS), hãy xem các yêu cầu trong phần Sử dụng đường liên kết sâu để bắt đầu phát.
Bảng sau đây chứa danh sách các nền tảng hỗ trợ Hành động đối với nội dung đa phương tiện:
Nền tảng | Mô tả |
---|---|
http://schema.org/DesktopWebPlatform
|
Nền tảng tìm kiếm trên trình duyệt web dành cho máy tính. |
http://schema.org/MobileWebPlatform
|
Nền tảng tìm kiếm trên trình duyệt web dành cho thiết bị di động. |
http://schema.org/AndroidPlatform
|
Nền tảng Tìm kiếm và PlayGuide trên ứng dụng Android. |
http://schema.org/AndroidTVPlatform
|
Nền tảng Android TV trên ứng dụng Android TV. |
http://schema.org/IOSPlatform
|
Nền tảng tìm kiếm trên ứng dụng iOS. |
http://schema.googleapis.com/GoogleVideoCast
|
Nền tảng Truyền và Màn hình chính trên thiết bị Chromecast. |
http://schema.googleapis.com/GoogleAudioCast
|
Chỉ hành động nghe. Nền tảng Truyền và Màn hình chính trên thiết bị Chromecast. |
Ví dụ về một thực thể có 2 đường liên kết sâu khác nhau:
"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" ]
}
],
}
],
...
}
Hành vi phát
Đối với hầu hết nội dung, khi Google đưa người dùng đến ứng dụng hoặc nền tảng của bạn, chúng tôi đều yêu cầu bạn tự động phát nội dung đã chọn. Nhờ đó, người dùng có thể nhanh chóng bắt đầu xem hoặc nghe nội dung.
Hành vi phát của Hành động xem
Đối với Hành động xem, chúng tôi yêu cầu hành vi phát sau đây.
Tất cả đường liên kết sâu: Movie, TVEpisode, TV Series và TVSeason
Hành vi đăng nhập hoặc mua hàng: Nếu dịch vụ của bạn yêu cầu đăng nhập hoặc phải mua, phim hoặc tập phải phát, phù hợp với nhập, sau đó. Để biết thêm thông tin, hãy xem các nguyên tắc về đường liên kết sâu theo dõi.
Phát lại: Nếu dịch vụ của bạn theo dõi trạng thái của người dùng thì quá trình phát phải bắt đầu từ điểm đánh dấu trước đó của người dùng trên phim hoặc tập đó. Nếu không, việc phát lại phải bắt đầu từ phần đầu của nội dung.
Tự động phát: Tuỳ thuộc vào nền tảng, dịch vụ của bạn phải phát nội dung nổi bật sau khi người dùng chọn tập hoặc phim mục tiêu.
- Tìm kiếm: Bạn nên chọn tính năng Tự động phát nhưng không bắt buộc. Nếu chế độ tự động phát không được hỗ trợ, thì nội dung phải phát trong vòng một lượt nhấp sau khi người dùng được chuyển đến ứng dụng hoặc dịch vụ của bạn.
- Android TV: Phim và tập phim phải có tính năng tự động phát.
Chỉ các đường liên kết sâu của TV Series và TVSeason
Lựa chọn tập mục tiêu: Bạn phải chọn đúng tập đích. Nếu dịch vụ của bạn theo dõi trạng thái của người dùng, thì tập đích phải là tập đó mà người dùng đã dừng xem lần cuối. Hoặc nếu người dùng hoàn thành tập phim mà họ xem lần cuối, hãy biến tập đích thành tập tiếp theo thay thế. Nếu không, tập đích phải là một trong các tập sau theo ý mình:
TVSeries
- Tập đầu tiên của chương trình truyền hình dài tập. Nên dùng cho các chương trình chuyển đổi tuần tự.
- Tập đầu tiên của phần mới nhất. Đề xuất cho các chương trình dài tập được xuất bản theo loạt.
- Tập mới nhất. Nên dùng cho các chương trình hằng ngày hoặc chương trình liên quan đến tin tức.
TVSeason
- Tập đầu tiên của phần. Nên dùng cho các chương trình chuyển đổi tuần tự.
- Tập mới nhất. Nên dùng cho các chương trình hằng ngày hoặc chương trình liên quan đến tin tức.
Đường liên kết sâu cho
TVSeries
hoặcTVSeason
phải ở dạng tĩnh (không thay đổi) và chuyển sang tập đích. Đừng sử dụng đường liên kết sâu cho tập cụ thể.Bảng sau đây cung cấp một vài ví dụ minh hoạ các yêu cầu logic chọn tập mục tiêu cho
TVSeries
,TVSeason
và Các loại thực thểTVEpisode
:Nhắm đến tập mà người dùng xem S6E24 lần gần đây nhất Nhắm mục tiêu tập nếu người dùng chưa xem bất kỳ tập nào Đường liên kết sâu đến bộ sách - S6E24 (nếu người dùng chưa hoàn thành S6E24)
- S6E25 (nếu người dùng xem xong S6E24)
Một trong số sau:
- Tập đầu tiên của chương trình truyền hình dài tập
- Tập đầu tiên của phần mới nhất
- Tập mới nhất
Đường liên kết sâu của phần (S1–S5) - Bất kỳ tập nào người dùng xem lần cuối trong phần đó hoặc tập đầu tiên của phần nếu người dùng chưa xem bất kỳ tập nào các tập trong phần đó.
- Tập đầu tiên của phần
Đường liên kết sâu của phần (S6) - S6E24 (nếu người dùng chưa hoàn thành S6E24)
- S6E25 (nếu người dùng xem xong S6E24)
Một trong số sau:
- Tập đầu tiên của phần
- Tập mới nhất
Đường liên kết sâu của tập - Tập cụ thể mà người dùng nhấp vào.
- Tập cụ thể mà người dùng nhấp vào.
Hành vi phát của Hành động nghe
Đối với Hành động nghe, chúng tôi yêu cầu hành vi phát sau đây:
- Nội dung phải phát trong vòng một cú nhấp chuột sau khi người dùng được chuyển đến ứng dụng hoặc dịch vụ của bạn.
- Nếu ứng dụng hoặc nền tảng của bạn yêu cầu đăng nhập, thì ứng dụng hoặc nền tảng đó cần phải phát nội dung ngay lập tức hoặc phát trong vòng một lần nhấp sau khi đăng nhập.
- Ứng dụng hoặc nền tảng của bạn phải cung cấp ít nhất một cách để tất cả người dùng phát đúng bài hát, đĩa nhạc, nghệ sĩ hoặc danh sách phát.
- Đối với người dùng không đủ điều kiện để phát đúng nội dung (ví dụ: họ không có gói thuê bao cần thiết), dịch vụ của bạn phải giải thích những việc người dùng cần làm để đủ điều kiện phát đúng nội dung đó khi truy cập vào ứng dụng hoặc nền tảng của bạn.
Chúng tôi đề xuất các phương pháp hay nhất sau đây cho ứng dụng hoặc nền tảng của bạn:
- Đối với
MusicGroup
, phát nội dung khác nhau từ nghệ sĩ mỗi khi người dùng chọn nghệ sĩ. - Đối với
MusicAlbum
, hãy phát nội dung theo thứ tự xuất hiện trong album. - Đối với
MusicPlaylist
, hãy phát các nội dung khác nhau trong danh sách phát mỗi khi người dùng chọn danh sách phát đó.
Xác định các đường liên kết sâu
Hãy thực hiện như sau:
- Đối với mỗi nội dung, hãy kiểm tra xem nội dung đó có các đường liên kết sâu khác nhau dựa trên nền tảng hay không.
- Đối với mỗi đường liên kết sâu, hãy đặt những câu hỏi sau đây về điểm truy cập của đường liên kết sâu đó (trang trên ứng dụng hoặc nền tảng mà đường liên kết sâu sẽ đưa bạn đến):
- Điểm truy cập (không phải nội dung) có hỗ trợ nhiều ngôn ngữ không?
- Điểm truy cập có hỗ trợ nhiều ngôn ngữ phụ đề không?
- Điểm truy cập có hỗ trợ nhiều góc camera không?
- Điểm truy cập có hỗ trợ nhiều định dạng video không?
Nếu câu trả lời của bạn là có cho bất kỳ câu hỏi nào trong số này, bạn cần cung cấp thuộc tính additionalProperty
cho đường liên kết sâu đó. Xem ví dụ về additionalProperty.