Khi người dùng bắt đầu sử dụng Hành động đối với nội dung đa phương tiện (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 trực tiếp đến nội dung trong ứng dụng hoặc nền tảng của bạn bằ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 một đối tượng đích) yêu cầu một đường liên kết sâu.- Đường liên kết sâu cần mở nội dung mà đường liên kết đó nhắm đến trên tất cả các nền tảng được chỉ định.
- Đường liên kết sâu có thể bao gồm các tham số (&) hoặc thẻ liên kết (#).
- Nếu chế độ tự động phát không được kích hoạt theo mặc định, bạn nên thêm một tham 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 chế độ tự động phát không được kích hoạt theo mặc định, bạn nên thêm một tham 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ủ các yêu cầu sau đây theo 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 theo lược đồ tuỳ chỉnh. package_id của ứng dụng phải có trong URI lược đồ tuỳ chỉnh. Điều này đảm bảo rằng người dùng sẽ được chuyển đến trang của ứng dụng trên Cửa hàng Play nếu ứng dụng của bạn 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 cho 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 thông tin chi tiết, hãy xem toàn bộ quy cách.
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, chẳng hạn như ví dụ sau đây, không phải là đường liên kết theo lược đồ tuỳ chỉnh được chấp nhận 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 ứng dụng của bạn chưa được cài đặt và bạn không có trình phát web, hãy đị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 của bên thứ ba.
Trong trường hợp ứng dụng của bạn chưa được cài đặt và bạn có trình phát trên web, hãy cung cấp đường liên kết hoặc biểu ngữ thông minh đến Android hoặc Cửa hàng ứng dụng để người dùng cài đặt ứng dụng của bạn. Sau đây là ví dụ về 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 cho thấy các yêu cầu và giới hạn đố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 nếu trang web di động 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 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 có trên nhiều nền tảng của Google hỗ trợ Hành động đối với nội dung đa phương tiện, hãy tuân thủ các yêu cầu sau:
- Tất cả nền tảng được đối tác hỗ trợ đều yêu cầu đường liên kết sâu cho 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 trình nhận bằng cách sử dụng Cast Application Framework (CAF) Receiver SDK 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 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 cho 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 Cast và Home trên thiết bị Chromecast. |
http://schema.googleapis.com/GoogleAudioCast
|
Chỉ có thao tác nghe. Nền tảng Cast và Home trên thiết bị Chromecast. |
Ví dụ về một thực thể có hai đườ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 đưa người dùng đến ứng dụng hoặc nền tảng của bạn, Google 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 lại của Thao tác xem
Đối với Watch Actions, 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: Phim, TVEpisode, TVSeries 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 mua hàng, thì phim hoặc tập phim phải phát sau đó, tuỳ theo loại nội dung. Để biết thêm thông tin, hãy xem các nguyên tắc về đường liên kết sâu sau đây.
Phát: Nếu dịch vụ của bạn theo dõi trạng thái của người dùng, thì nội dung 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 phim. Nếu không, quá trình phát phải bắt đầu từ đầu 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 bật nội dung 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 sử dụng tính năng tự động phát nhưng không bắt buộc. Nếu không được hỗ trợ tính năng tự động phát, 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: Bạn phải bật tính năng tự động phát cho phim và tập.
Chỉ có đường liên kết sâu đến TVSeries và TVSeason
Chọn tập nhắm đến: Bạn phải chọn đúng tập nhắm đến. 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 phim mục tiêu phải là tập phim mà người dùng dừng xem gần đây nhất. Hoặc nếu người dùng xem xong hoàn toàn tập mà họ xem gần đây nhất, hãy chuyển tập mục tiêu thành tập tiếp theo. Nếu không, bạn có thể chọn một trong các tập sau đây làm tập mục tiêu:
TVSeries- Tập đầu tiên của loạt chương trình. Phù hợp với các chương trình có nhiều phần.
- Tập đầu tiên của phần mới nhất. Nên dùng cho các chương trình dài tập.
- Tập mới nhất. Phù hợp với 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 mùa. Phù hợp với các chương trình có nhiều phần.
- Tập mới nhất. Phù hợp với 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
TVSerieshoặcTVSeasonphải ở dạng tĩnh (không thay đổi) và chuyển đến tập mục tiêu. Không sử dụng đường liên kết sâu cho một tập cụ thể.Bảng sau đây cung cấp một số ví dụ minh hoạ logic lựa chọn tập cần thiết cho các loại thực thể
TVSeries,TVSeasonvàTVEpisode:Tập mục tiêu nếu người dùng xem tập S6E24 gần đây nhất Nhắm đến tập phim nếu người dùng chưa xem tập nào Đường liên kết sâu đến chương trình - S6E24 (nếu người dùng chưa xem xong S6E24)
- S6E25 (nếu người dùng đã xem xong S6E24)
Một trong các giấy tờ sau đây:
- Tập đầu tiên của loạt chương trình
- 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 đến phần (S1-S5) - Tập mà người dùng xem gần đây nhất trong phần đó hoặc tập đầu tiên của phần nếu người dùng chưa xem tập nào trong phần đó.
- Tập đầu tiên của phần
Đường liên kết sâu đến mùa (S6) - S6E24 (nếu người dùng chưa xem xong S6E24)
- S6E25 (nếu người dùng đã xem xong S6E24)
Một trong các giấy tờ sau đây:
- Tập đầu tiên của phần
- Tập mới nhất
Đường liên kết sâu đến 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 thao tác nghe
Đối với Thao tác nghe, chúng tôi yêu cầu hành vi phát như sau:
- Nội dung phải phát trong vòng một lượt nhấp sau khi người dùng được đưa đế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át nội dung ngay lập tức hoặc 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 chính xác bài hát, đĩa nhạc, nghệ sĩ hoặc danh sách phát.
- Đối với những người dùng không đủ điều kiện phát nội dung chính xác (ví dụ: họ không có gói thuê bao bắt buộc), dịch vụ của bạn phải giải thích những việc mà người dùng cần làm để đủ điều kiện phát nội dung chính xác khi truy cập vào ứng dụng hoặc nền tảng của bạn.
Bạn nên áp dụng các phương pháp hay nhất sau đây cho ứng dụng hoặc nền tảng của mình:
- Đối với
MusicGroup, hãy phát nội dung khác nhau của 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 đĩa nhạc. - Đối với
MusicPlaylist, hãy phát 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 đườ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 về điểm truy cập của đường liên kết đó (trang trên ứng dụng hoặc nền tảng mà đường liên kết sâu đư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 máy quay không?
- Điểm truy cập này có hỗ trợ nhiều định dạng video không?
Nếu trả lời 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.