เมื่อผู้ใช้เริ่มการใช้สื่อกับเนื้อหา (เช่น ผู้ใช้คลิกไอคอนของคุณใน Google Search) Google จะนำผู้ใช้ไปยังเนื้อหาในแอปหรือแพลตฟอร์มของคุณโดยตรงโดยใช้ Deep Link ของเนื้อหา
Deep Link
ข้อกำหนดสำหรับ Deep Link มีดังนี้
urlTemplate(ของออบเจ็กต์เป้าหมาย) ต้องมี Deep Link- Deep Link ต้องเปิดเนื้อหาที่กำหนดเป้าหมายในแพลตฟอร์มทั้งหมดที่ระบุ
- Deep Link อาจมีพารามิเตอร์ (&) หรือแท็ก Anchor (#)
- หากไม่ได้เปิดใช้งานการเล่นอัตโนมัติโดยค่าเริ่มต้น เราขอแนะนำให้คุณเพิ่มพารามิเตอร์ เช่น
&autoplay=trueลงใน Deep Link เพื่อเปิดใช้งานการเล่นอัตโนมัติในแอปหรือแพลตฟอร์ม
- หากไม่ได้เปิดใช้งานการเล่นอัตโนมัติโดยค่าเริ่มต้น เราขอแนะนำให้คุณเพิ่มพารามิเตอร์ เช่น
ตัวอย่างของ @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",
...
},
...
},
...
}
ใช้ Deep Link เพื่อเริ่มการเล่น
รหัสเทียมต่อไปนี้แสดงลักษณะการทำงานที่ต้องการเมื่อผู้ใช้เริ่มเล่น
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
- คุณต้องใช้ Universal Link
- Android และ Android TV
- คุณสามารถใช้ Android App Link หรือลิงก์ Scheme ที่กำหนดเอง
ลิงก์ Scheme ที่กำหนดเองสำหรับ Android และ Android TV
ใน Android และ Android TV คุณยังใช้ลิงก์ Scheme ที่กำหนดเองได้ด้วย ต้องรวม
package_idของแอปไว้ใน URI ของ Scheme ที่กำหนดเอง ซึ่งจะช่วยให้มั่นใจได้ว่าระบบจะนำผู้ใช้ไปยังหน้าแอปของคุณใน Play Store หากยังไม่ได้ติดตั้งแอป
ดังนั้น รูปแบบ URI ต่อไปนี้จึงเป็นรูปแบบ Scheme ที่กำหนดเองที่ยอมรับได้เพียงรูปแบบเดียว
สำหรับ การใช้สื่อ
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 หรือแพลตฟอร์ม Smart Link ของบุคคลที่สาม
ในกรณีที่ไม่ได้ติดตั้งแอปและคุณมีเว็บเพลเยอร์ ให้ลิงก์หรือแบนเนอร์อัจฉริยะไปยัง Android หรือ App Store เพื่อให้ผู้ใช้ติดตั้งแอปของคุณ ตัวอย่างแบนเนอร์อัจฉริยะที่ใช้งานมีดังนี้

สรุปข้อกำหนดและข้อจำกัดของ Deep Link
ตารางต่อไปนี้แสดงข้อกำหนดและข้อจำกัดสำหรับ Deep Link ที่เกี่ยวข้องกับ iOS, Android และ AndroidTV
| iOS | Android และ Android TV | |
|---|---|---|
| http:// หรือ https:// | ต้องระบุ | แนะนำหากเว็บไซต์บนอุปกรณ์เคลื่อนที่รองรับการเล่น |
| android-app:// หรือ intent:// | ไม่มี | แนะนำในกรณีที่เว็บไซต์บนอุปกรณ์เคลื่อนที่ไม่รองรับการเล่น |
| foo:// (สตริงที่กำหนดเอง) | ไม่อนุญาต | ไม่อนุญาต |
ประเภทแพลตฟอร์ม
โปรดปฏิบัติตามข้อกำหนดต่อไปนี้เพื่อให้เนื้อหาพร้อมใช้งานในแพลตฟอร์มต่างๆ ของ Google ที่รองรับการใช้สื่อ
- แพลตฟอร์มทั้งหมดที่พาร์ทเนอร์รองรับกำหนดให้ต้องมี Deep Link สำหรับเนื้อหาของคุณ
- สำหรับแพลตฟอร์ม Chromecast คุณต้องสร้างตัวรับโดยใช้ Cast Application Framework (CAF) Receiver SDK เวอร์ชันล่าสุด
- สำหรับแพลตฟอร์มอุปกรณ์เคลื่อนที่ (Android และ iOS) โปรดดูข้อกำหนดในส่วนใช้ Deep Link เพื่อเริ่มการเล่น
ตารางต่อไปนี้แสดงรายการแพลตฟอร์มที่รองรับการใช้สื่อ
| แพลตฟอร์ม | คำอธิบาย |
|---|---|
http://schema.org/DesktopWebPlatform
|
แพลตฟอร์มการค้นหาในเว็บเบราว์เซอร์บนเดสก์ท็อป |
http://schema.org/MobileWebPlatform
|
แพลตฟอร์มการค้นหาในเว็บเบราว์เซอร์บนอุปกรณ์เคลื่อนที่ |
http://schema.org/AndroidPlatform
|
แพลตฟอร์มค้นหาและ PlayGuide ในแอป Android |
http://schema.org/AndroidTVPlatform
|
แพลตฟอร์ม Android TV ในแอป Android TV |
http://schema.org/IOSPlatform
|
แพลตฟอร์มการค้นหาในแอป iOS |
http://schema.googleapis.com/GoogleVideoCast
|
แพลตฟอร์ม Cast และ Home ในอุปกรณ์ Chromecast |
http://schema.googleapis.com/GoogleAudioCast
|
การดำเนินการเพื่อฟังเท่านั้น แพลตฟอร์ม Cast และ Home ในอุปกรณ์ Chromecast |
ตัวอย่างเอนทิตีที่มี Deep Link 2 รายการที่แตกต่างกัน
"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 นำผู้ใช้ไปยังแอปหรือแพลตฟอร์มของคุณ เรากำหนดให้คุณเล่นเนื้อหาที่เลือกโดยอัตโนมัติ ซึ่งช่วยให้ผู้ใช้เริ่มดูหรือฟังเนื้อหาได้อย่างรวดเร็ว
พฤติกรรมการเล่นของการดำเนินการเพื่อรับชม
สำหรับการดำเนินการดู เรากำหนดให้มีลักษณะการเล่นต่อไปนี้
Deep Link ทั้งหมด: ภาพยนตร์, TVEpisode, TVSeries และ TVSeason
พฤติกรรมการลงชื่อเข้าใช้หรือการซื้อ: หากบริการของคุณกำหนดให้ต้องลงชื่อเข้าใช้หรือซื้อ ภาพยนตร์หรือตอนจะต้องเล่นตามประเภทของภาพยนตร์หรือตอนนั้นๆ ดูรายละเอียดเพิ่มเติมได้ที่หลักเกณฑ์เกี่ยวกับ Deep Link ที่ ระบุไว้
การเล่น: หากบริการติดตามสถานะของผู้ใช้ การเล่นต้องเริ่มจาก เครื่องหมายก่อนหน้าของผู้ใช้ในภาพยนตร์หรือตอน มิฉะนั้น การเล่นจะต้อง เริ่มตั้งแต่ต้นของเนื้อหา
เล่นอัตโนมัติ: แพลตฟอร์มบางแห่งกำหนดให้บริการของคุณเล่นเนื้อหาอย่างชัดเจนหลังจากที่ผู้ใช้เลือกตอนหรือภาพยนตร์เป้าหมาย
- ค้นหา: ขอแนะนำให้ใช้การเล่นอัตโนมัติ แต่ไม่บังคับ หากไม่รองรับการเล่นอัตโนมัติ เนื้อหาต้องเล่นภายใน 1 คลิกหลังจากที่ระบบนำผู้ใช้ไปยังแอปหรือบริการของคุณ
- Android TV: ต้องเปิดใช้การเล่นอัตโนมัติสำหรับภาพยนตร์และตอน
Deep Link ของ TVSeries และ TVSeason เท่านั้น
การเลือกตอนเป้าหมาย: คุณต้องเลือกตอนเป้าหมายที่ถูกต้อง หากบริการของคุณติดตามสถานะของผู้ใช้ ตอนเป้าหมายต้องเป็นตอนที่ผู้ใช้หยุดดูครั้งล่าสุด หรือหากผู้ใช้ดูตอนที่ดูครั้งล่าสุดจบแล้ว ให้เปลี่ยนตอนเป้าหมายเป็นตอนถัดไปแทน ไม่เช่นนั้น ตอนเป้าหมายต้องเป็นตอนใดตอนหนึ่งต่อไปนี้ ตามที่คุณเห็นสมควร
TVSeries- ตอนแรกของซีรีส์ แนะนำสำหรับรายการทีวีแบบต่อเนื่อง
- ตอนแรกของซีซันล่าสุด แนะนำสำหรับ รายการแบบซีรีส์ที่ออกอากาศมาอย่างยาวนาน
- ตอนล่าสุด แนะนำสำหรับรายการที่ออกอากาศทุกวันหรือรายการข่าว
TVSeason- ตอนแรกของซีซัน แนะนำสำหรับรายการทีวีแบบต่อเนื่อง
- ตอนล่าสุด แนะนำสำหรับรายการที่ออกอากาศทุกวันหรือรายการข่าว
Deep Link สำหรับ
TVSeriesหรือTVSeasonต้องเป็นแบบคงที่ (ไม่เปลี่ยนแปลง) และนำไปยังตอนเป้าหมาย อย่าใช้ Deep Link สำหรับ ตอนใดตอนหนึ่งตารางต่อไปนี้แสดงตัวอย่างหลายรายการที่สาธิตตรรกะการเลือกตอนเป้าหมายที่จำเป็นสำหรับเอนทิตีประเภท
TVSeries,TVSeasonและTVEpisodeกำหนดเป้าหมายตอนหากผู้ใช้ดู S6E24 เป็นตอนล่าสุด กำหนดเป้าหมายตอนหากผู้ใช้ยังไม่ได้ดูตอนใดเลย Deep Link ของซีรีส์ - S6E24 (หากผู้ใช้ยังดู S6E24 ไม่จบ)
- S6E25 (หากผู้ใช้ดู S6E24 จบแล้ว)
อย่างใดอย่างหนึ่งต่อไปนี้
- ตอนแรกของซีรีส์
- ตอนแรกของซีซันล่าสุด
- ตอนล่าสุด
Deep Link ของซีซัน (S1-S5) - ตอนใดก็ตามที่ผู้ใช้ดูเป็นตอนสุดท้ายในซีซันนั้น หรือตอนแรกของซีซันหากผู้ใช้ยังไม่ได้ดูตอนใดเลยในซีซันนั้น
- ตอนแรกของซีซัน
Deep Link ของซีซัน (S6) - S6E24 (หากผู้ใช้ยังดู S6E24 ไม่จบ)
- S6E25 (หากผู้ใช้ดู S6E24 จบแล้ว)
อย่างใดอย่างหนึ่งต่อไปนี้
- ตอนแรกของซีซัน
- ตอนล่าสุด
Deep Link ของตอน - ตอนที่เฉพาะเจาะจงที่มีการคลิก
- ตอนที่เฉพาะเจาะจงที่มีการคลิก
ลักษณะการทำงานของการเล่นการดำเนินการฟัง
สำหรับการดำเนินการฟัง เรากำหนดให้มีลักษณะการเล่นต่อไปนี้
- เนื้อหาต้องเล่นภายใน 1 คลิกหลังจากที่ระบบนำผู้ใช้ไปยังแอปหรือบริการของคุณ
- หากแอปหรือแพลตฟอร์มของคุณกำหนดให้ลงชื่อเข้าใช้ ก็ต้องเล่นเนื้อหาทันทีหรือภายใน 1 คลิกหลังจากลงชื่อเข้าใช้
- แอปหรือแพลตฟอร์มของคุณต้องมีวิธีอย่างน้อย 1 วิธีเพื่อให้ผู้ใช้ทุกคนเล่นเพลง อัลบั้ม ศิลปิน หรือเพลย์ลิสต์ที่ต้องการได้
- สำหรับผู้ใช้ที่ไม่มีสิทธิ์เล่นเนื้อหาที่ต้องการ (เช่น ไม่ได้สมัครใช้บริการที่จำเป็น) บริการของคุณต้องอธิบายสิ่งที่ผู้ใช้ต้องทำเพื่อให้มีสิทธิ์เล่นเนื้อหาที่ต้องการเมื่อมาถึงแอปหรือแพลตฟอร์มของคุณ
เราขอแนะนำแนวทางปฏิบัติแนะนำต่อไปนี้สำหรับแอปหรือแพลตฟอร์มของคุณ
- สำหรับ
MusicGroupให้เล่นเนื้อหาที่แตกต่างกันจากศิลปินทุกครั้งที่ผู้ใช้เลือกศิลปิน - สำหรับ
MusicAlbumให้เล่นเนื้อหาตามลำดับที่ปรากฏในอัลบั้ม - สำหรับ
MusicPlaylistให้เล่นเนื้อหาที่แตกต่างกันจากเพลย์ลิสต์ทุกครั้งที่ผู้ใช้เลือกเพลย์ลิสต์
ระบุ Deep Link
ทำสิ่งต่อไปนี้:
- สำหรับเนื้อหาแต่ละรายการ ให้ตรวจสอบว่ามี Deep Link ที่แตกต่างกันตามแพลตฟอร์มหรือไม่
- สำหรับ Deep Link แต่ละรายการ ให้ถามคำถามต่อไปนี้เกี่ยวกับจุดแรกเข้า (หน้าในแอปหรือแพลตฟอร์มที่ Deep Link นำคุณไป)
- จุดแรกเข้า (ไม่ใช่เนื้อหา) รองรับหลายภาษาไหม
- จุดแรกเข้ารองรับคำบรรยายหลายภาษาไหม
- จุดแรกเข้ารองรับมุมกล้องหลายมุมไหม
- จุดแรกเข้ารองรับวิดีโอหลายรูปแบบไหม
หากตอบว่าใช่สำหรับคำถามใดก็ตาม คุณจะต้องระบุพร็อพเพอร์ตี้ additionalProperty สำหรับ Deep Link นั้น ดูตัวอย่าง additionalProperty