Bu bölümde, İzleme İşlemlerinin ortak özellikleriyle ilgili ayrıntılar sunulmaktadır.
İşlem işaretleme özellikleri
Özellik | Beklenen tür | Açıklama |
---|---|---|
@type |
Metin | Zorunlu: Her zaman WatchAction olarak ayarlanır. |
target |
Giriş Noktası | Zorunlu: Derin bağlantıların çeşitli Google platformlarıyla eşleştirilmesini sağlayan bir hedef nesne. |
target.@type |
Metin | Zorunlu: Her zaman EntryPoint olarak ayarlanır. |
target.urlTemplate |
URL | Zorunlu: Kullanıcıları uygulamanıza veya platformunuza götüren ve içeriğin oynatılmasını sağlayan derin bağlantı. |
target.inLanguage |
Metin | İsteğe bağlı: BCP 47 biçiminde dizinin orijinal dili. |
target.actionPlatform |
Metin | Gerekli: urlTemplate ile eşlenen platformlar. Medya İşlemleri aşağıdakileri destekler:
|
target.additionalProperty |
PropertyValue | Varsa zorunludur - Derin bağlantının ek özelliklerini temsil eden özellik-değer çiftlerinin listesi. Buna şunlar dahildir:
|
actionAccessibilityRequirement |
İşleme ErişimSpesifikliği | Zorunlu: İçeriğin erişim gereksinimini açıklayan bir İşlem erişim belirtimi nesnesi. İşlem Erişimi Spesifikasyonları bölümüne bakın. |
İşlem işaretlemesiyle ilgili sayfalar
Bu mülklerle ilgili konular için aşağıdaki sayfalara göz atın:
İşlem erişim spesifikasyonu özellikleri
Özellik | Beklenen tür | Açıklama |
---|---|---|
actionAccessibilityRequirement.@type |
Metin | Zorunlu: Her zaman ActionAccessSpecification olarak ayarlanır. |
actionAccessibilityRequirement.category |
Metin | Gerekli: İçerik için erişim gereksinimi. Daha fazla bilgi için Ödeme duvarı türü bölümüne bakın. Varlık, bir içerik grubunu temsil ediyorsa
|
actionAccessibilityRequirement.availabilityStarts |
Tarih | Zorunlu: ISO 8601 biçiminde (saat dilimi dahil) işlemin kullanılabildiği tarih.
İlgili tüzel kişinin, feed'e availabilityStarts tarihinden en az 7 gün önce sağlanması gerekir. Böylece, içeriğin Google yüzeylerinde zamanında gösterilme olasılığı artacaktır. |
actionAccessibilityRequirement.availabilityEnds |
Tarih | Zorunlu: ISO 8601 biçiminde (saat dilimi dahil) işlemin artık kullanılamayacağı tarih.
Stok Durumu Bitiş Tarihinde yapılan güncellemelerin, feed'in bitiş tarihinden en az 7 gün önce feed'de yapılması gerekir. Bu sayede, içeriğin satın alınma durumunun ilgili Google Ads platformlarında görünme süresi sona erecek. |
actionAccessibilityRequirement.eligibleRegion |
Ülke, Şehir, Durum, GeoShape veya Metin | Gerekli: İçeriğin kullanıma sunulduğu bölgeler. İçerik tüm dünyada kullanılabiliyorsa EARTH özel dizesini kullanın. |
actionAccessibilityRequirement.ineligibleRegion |
Ülke, Şehir, Durum veya GeoShape | Geçerliyse: İçeriğin kısıtlandığı bölgeler. İçerik eligibleRegion içindeki her yerde mevcutsa bu özelliği sağlamanız gerekmez. |
actionAccessibilityRequirement.requiresSubscription |
MedyaAboneliği | Geçerliyse: Kullanıcıların içeriğe erişmek için ihtiyaç duyduğu aboneliğin ayrıntıları. Medya aboneliği özellikleri konusuna bakın.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
Teklif | İçeriğin satın alınması gerekiyorsa gereklidir - İçerikle ilişkili teklifin ayrıntıları. Aşağıdaki durumlar için fiyat bilgilerini sağlayın:
Offer nesnesini tamamen kaldırın ve category öğesini ActionAccessSpecification nesnesinden free değerine ayarlayın. Teklif özellikleri'ne bakın.
|
Medya aboneliği özellikleri
actionAccessibilityRequirement.category
, subscription
veya externalSubscription
ise gereklidir.
Özellik | Beklenen tür | Açıklama |
---|---|---|
requiresSubscription.@type |
Metin | Zorunlu: Her zaman MediaSubscription olarak ayarlanır |
requiresSubscription.@id |
URL | Zorunlu: Abonelik için benzersiz kimlik. İçeriğe farklı abonelikler üzerinden erişilebiliyorsa her aboneliğin benzersiz bir kimliği olmalıdır. |
requiresSubscription.name |
Metin | Zorunlu: Aboneliğin adı. Aşağıdakileri göz önünde bulundurun:
|
requiresSubscription.sameAs |
URL | Aboneliği açıklayan sayfa. |
requiresSubscription.identifier |
Metin | category değeri subscription ,
commonTier ise false ise
-
Bu abonelik için medya kataloğunuzdaki içerik grubuna erişimi temsil eden benzersiz bir dize.
|
requiresSubscription.authenticator |
Kuruluş | category değeri externalsubscription ise gereklidir: Harici sağlayıcının kimlik doğrulayıcısının ayrıntılarını sağlayan kapsayıcıdır. |
requiresSubscription.authenticator.@type |
Metin | category değeri externalsubscription ise zorunludur: Her zaman Organization olarak ayarlanır. |
requiresSubscription.authenticator.name |
Metin | category değeri externalsubscription ise zorunludur: Kimlik doğrulama hizmetinin adı. TVE sağlayıcılar için bu ayarı TVE olarak belirleyin |
requiresSubscription.commonTier |
Boole | Varsa gereklidir - Bu, kategori abonelik olarak ayarlanmışsa gereklidir. Genel katman gereksinimleri dokümanlarında CommonTier hakkında daha fazla bilgi edinin. |
Yararlanma Hakkı API'sı Gereksinimleri
actionAccessibilityRequirement.category
veya subscription
ise ve abonelik teklifiniz birden fazla paket veya katman içeriyorsa ya da eklenti desteğine sahipse yararlanma API'sini kullanmanız gerekir. Aboneliğiniz tek katmanlıysa ve kataloğunuzdaki tüm içeriğe erişim sağlıyorsa bunu eklemeyin.
- A Şirketi'nin, abone olan kullanıcılara mevcut tüm içeriğe erişmesini sağlayan tek bir abonelik teklifi vardır: Yararlanma Hakkı Tanımlayıcısı / API zorunlu değildir
- B Şirketi'nin bazı içeriklere erişim sağlayan bir temel aboneliği ve premium içeriğe erişim olanağı sunan premium bir aboneliği bulunmaktadır: Yararlanma Tanımlayıcısı / API gereklidir
- C Şirketi, bazı içeriklere erişim sağlayan ve üçüncü taraf içeriklere erişim sağlayan paketlere eklenen bir temel aboneliğe sahiptir: Yararlanma Tanımlayıcısı / API gereklidir
Medya aboneliğiyle ilgili sayfalar
Bu mülklerle ilgili konular için aşağıdaki sayfalara göz atın:
Teklif özellikleri
Özellik | Beklenen tür | Açıklama |
---|---|---|
expectsAcceptanceOf.@type |
Metin | Zorunlu: Her zaman Offer olarak ayarlanır. |
expectsAcceptanceOf.price |
Number | Zorunlu: İçeriğin satın alma fiyatı. Fiyat, sıfır olmayan pozitif bir değer olmalıdır. Fiyatı 0, 00 TL olan öğeler için lütfen kategoriyi "ücretsiz" olarak belirtin. |
expectsAcceptanceOf.priceCurrency |
Metin | Zorunlu: Fiyatın, 3 harfli ISO 4217 biçiminde para birimi. |
expectsAcceptanceOf.seller |
Kuruluş | İçerik satın alma olanağı sunan kuruluş. |
expectsAcceptanceOf.seller.@type |
Metin | Her zaman Organization olarak ayarlayın. |
expectsAcceptanceOf.seller.name |
Metin | Satıcının adı. |
expectsAcceptanceOf.seller.sameAs |
Metin | Satıcıyı tanımlayan web sayfasının URL'si; örneğin, satıcının ana sayfası. |
Fırsatla ilgili sayfa
Bu mülklerle ilgili konular için aşağıdaki sayfalara göz atın:
Tanımlayıcılar
Medya İşlemi feed'leri, bir varlığı açık bir şekilde tanımlamaya yardımcı olabilecek çeşitli tanımlayıcıları kabul eder. Bu tanımlayıcılar, feed'inizdeki içeriğin Google'ın veritabanındaki içerikle uzlaştırılması sürecini hızlandırmaya yardımcı olabilir. Bu tanımlayıcıların çoğu, çeşitli varlık türlerinde identifier
özelliği kullanılarak feed'e eklenebilir ancak EIDR'lerin kendi temsili özellikleri vardır. Bunların ikisi aşağıda açıklanmıştır.
Tanımlayıcı özellikleri
Özellik | Beklenen tür | Açıklama |
---|---|---|
identifier |
Metin | Önemle tavsiye edilir: Belirli bir varlığı açık bir şekilde tanımlayan bir tanımlayıcı (genellikle harici bir tanımlayıcıdır). Birden fazla tanımlayıcıya izin verilir. Bu özellik, tüm izleme işlemi varlık türlerinde kullanılabilir. Aşağıdaki tabloda, identifier özelliğinin kabul edilen tanımlayıcıları ve alt mülkleri listelenmiştir. İzleme İşlemleri feed'i örnekleri bölümündeki Tanımlayıcı/EIDR örneği bölümüne bakın. |
Özellik | Beklenen tür | Açıklama |
---|---|---|
@type |
Metin | Zorunlu: Her zaman PropertyValue olarak ayarlanır. |
propertyID |
Metin | Zorunlu: Aşağıdaki kimlik türlerini destekliyoruz:
|
value |
Metin | Gerekli: Belirtilen kimlik sisteminin değeri. |
EIDR mülkleri
EIDR (Eğlence Tanımlayıcı Kaydı anlamına gelir), hareketli resimler ve televizyon programları dahil olmak üzere çok çeşitli medya içeriği için küresel olarak benzersiz bir tanımlayıcı sistemdir. Kimlik tanımlama sistemi, bir tanımlayıcıyı üst düzey başlıklar, düzenlemeler ve diğer öğelerle ilişkili bir meta veri kaydıyla çözer. Aşağıdaki tabloda EIDR ile ilişkili özellikler ve bunların kullanımı listelenmektedir.
Özellik | Beklenen tür | Açıklama |
---|---|---|
titleEIDR |
Metin | Önemle Tavsiye Edilen - EIDR (Eğlence Tanımlayıcı Kaydı) tanımlayıcısı, en genel/soyut düzeyde film veya televizyon eserini temsil eder. Bu özellik, TVSeries, TVSeason, TVEpisode ve Film varlık spesifikasyonu sayfalarında kullanılabilir. Örneğin, "Hayalet Avcıları" olarak bilinen sinema filminin titleEIDR değeri, "10.5240/7EC7-228A-510A-053E-CBB8-J" şeklindedir. İzleme örneklerine göz atın. Örneklere göz atın{/11 |
editEIDR |
Metin | Önemle tavsiye edilir: EIDR (Eğlence Tanımlayıcı Kaydı) tanımlayıcısı, bir film veya televizyon eserinin belirli bir düzenlemesini/baskısını temsil eder. Bu özellik, TVEpisode ve Movie varlık spesifikasyonu sayfalarında kullanılabilir. Örneğin, "Hayalet Avcıları" olarak bilinen ve resmi kimliği "IDE" olan 10.5240/7F7-228A-510A-053E-CBB8-J bölümünün, 10.5240/7F7-228A. |
İçerik derecelendirmesi ajansları
Bu tabloda BroadcastService.contentRating
, Movie.contentRating
ve TVSeries.contentRating
değerlerini kullanın. Derecelendirme ajansı, puan değerinin başına eklenmelidir. Örnekler:
- ABD'de "R" olarak derecelendirilmiş bir filmin
Movie.contentRating
değeri "MPAA R" olmalıdır. - ABD'de "TV-MA" olarak derecelendirilen bir TV dizisinin
TVSeries.contentRating
değeri "TVPG TV-MA" olmalıdır.
Ülke | TV derecelendirme ajansı | Film derecelendirme ajansı |
---|---|---|
Arnavutluk (AL) | Kullanılamıyor | Kullanılamıyor |
Angola (AO) | Kullanılamıyor | İTŞ |
Antigua ve Barbuda (AG) | Kullanılamıyor | MPAA |
Arjantin (AR) | INCAA | INCAA |
Ermenistan (AM) | Kullanılamıyor | MKRF/RUSYA |
Aruba (AW) | Kullanılamıyor | Kullanılamıyor |
Avustralya (AU) | ACB TV | ACB Filmler |
Avusturya (AT) | TASLAK | TASLAK |
Azerbaycan (AZ) | Kullanılamıyor | MKRF/RUSYA |
Bahreyn (BH) | Kullanılamıyor | MPAA |
Beyaz Rusya (BY) | Kullanılamıyor | MKRF/RUSYA |
Belçika (BE) | Kullanılamıyor | MPAA |
Belize (BZ) | Kullanılamıyor | Kullanılamıyor |
Benin (BJ) | Kullanılamıyor | CNC |
Bolivya (BO) | Kullanılamıyor | MPAA |
Bosna Hersek (BA) | Kullanılamıyor | MPAA |
Botsvana (BW) | Kullanılamıyor | MPAA |
Brezilya (BR) | SINIFLANDI | SINIFLANDI |
Burkina Faso (BF) | Kullanılamıyor | CNC |
Kamboçya (KH) | Kullanılamıyor | Kullanılamıyor |
Kanada (CA) | Kanada_TV | KVR'ler |
Yeşil Burun Adaları (CV) | Kullanılamıyor | İTŞ |
Şili (CL) | Kullanılamıyor | MPAA |
Kolombiya (CO) | Kullanılamıyor | MPAA |
Kosta Rika (CR) | Kullanılamıyor | MPAA |
Hırvatistan (HR) | Kullanılamıyor | Kullanılamıyor |
Güney Kıbrıs Rum Yönetimi (CY) | Kullanılamıyor | TAŞI |
Çekya (CZ) | Kullanılamıyor | KZFILM |
Danimarka (DK) | Kullanılamıyor | MMYP |
Ekvador (EC) | Kullanılamıyor | MPAA |
Mısır (EG) | Kullanılamıyor | MPAA |
El Salvador (SV) | Kullanılamıyor | MPAA |
Estonya (EE) | Kullanılamıyor | KEŞİF |
Fiji (FJ) | Kullanılamıyor | Kullanılamıyor |
Finlandiya (FI) | Kullanılamıyor | MEKU |
Fransa (FR) | ÖAR | ÖAR |
Gabon (GA) | Kullanılamıyor | CNC |
Almanya (DE) | TASLAK | TASLAK |
Yunanistan (GR) | ESR | TAŞI |
Guatemala (GT) | Kullanılamıyor | MPAA |
Haiti (HT) | Kullanılamıyor | Kullanılamıyor |
Honduras (HN) | Kullanılamıyor | MPAA |
Hong Kong (HK) | Kanada | FCO |
Macaristan (HU) | Kullanılamıyor | MPAA |
İzlanda (IS) | Kullanılamıyor | KIJKWIJZER |
Hindistan (IN) | CBFC | CBFC |
Endonezya (ID) | TPG | LSF |
İrlanda (IE) | Kullanılamıyor | IFCO |
İtalya (IT) | ETKİLEŞİM | ETKİLEŞİM |
Fildişi Sahili (CI) | Kullanılamıyor | CNC |
Jamaika (JM) | Kullanılamıyor | MPAA |
Japonya (JP) | Yok | EİRİN |
Ürdün (JO) | Kullanılamıyor | MPAA |
Kazakistan (KZ) | Kullanılamıyor | MRKF |
Kore (KR) | KMRB | KMRB |
Kuveyt (KW) | Kullanılamıyor | MPAA |
Kırgızistan (KG) | Kullanılamıyor | MKRF/RUSYA |
Laos (LA) | Kullanılamıyor | Kullanılamıyor |
Letonya (LV) | Kullanılamıyor | NKCLV |
Lübnan (LB) | Kullanılamıyor | MPAA |
Litvanya (LT) | Kullanılamıyor | Kullanılamıyor |
Lüksemburg (LU) | Kullanılamıyor | KIJKWIJZER |
Makedonya (MK) | Kullanılamıyor | MPAA |
Malezya (MY) | Kullanılamıyor | İTÜ |
Mali (ML) | Kullanılamıyor | CNC |
Malta (MT) | Kullanılamıyor | MMAA |
Mauritius Adası (MU) | Kullanılamıyor | BBFC |
Meksika (MX) | RTC | RTC |
Moldova (MD) | Kullanılamıyor | Kullanılamıyor |
Namibya (NA) | Kullanılamıyor | Kullanılamıyor |
Nepal (NP) | Kullanılamıyor | MPAA |
Hollanda (NL) | KIJKWIJZER | KIJKWIJZER |
Yeni Zelanda (NZ) | BSA | OFLC |
Nikaragua (NI) | Kullanılamıyor | MPAA |
Nijer (NE) | Kullanılamıyor | CNC |
Norveç (NO) | Kullanılamıyor | MEDIETSİSTE |
Umman (OM) | Kullanılamıyor | MPAA |
Panama (PA) | Kullanılamıyor | MPAA |
Papua Yeni Gine (PG) | Kullanılamıyor | MPAA |
Paraguay (PY) | Kullanılamıyor | MPAA |
Peru (PE) | Kullanılamıyor | MPAA |
Filipinler (PH) | MTRCB | MTRCB |
Polonya | Kullanılamıyor | MPAA |
Portekiz (PT) | Kullanılamıyor | İTŞ |
Katar (KA) | Kullanılamıyor | MPAA |
Rusya (RU) | MKRF/RUSYA | MKRF/RUSYA |
Ruanda (RW) | Kullanılamıyor | CNC |
Suudi Arabistan (SA) | Kullanılamıyor | MPAA |
Senegal (SN) | Kullanılamıyor | MPAA |
Singapur (SG) | Kullanılamıyor | MDA |
Slovakya (SK) | Kullanılamıyor | MPAA |
Slovenya | Kullanılamıyor | MPAA |
Güney Afrika (ZA) | FPB | FPB |
İspanya (ES) | AYAR | ICAA |
Sri Lanka (LK) | Kullanılamıyor | Kullanılamıyor |
İsveç (SE) | Kullanılamıyor | SMS |
İsviçre (CH) | TASLAK | TASLAK |
Tayvan (Tayvan) | Kullanılamıyor | MoCTW |
Tacikistan (TJ) | Kullanılamıyor | MKRF/RUSYA |
Tanzanya (TZ) | Kullanılamıyor | MPAA |
Tayland (TH) | Kullanılamıyor | İşletme bilgileri |
Togo (TG) | Kullanılamıyor | CNC |
Trinidad ve Tobago (TT) | Kullanılamıyor | Kullanılamıyor |
Türkiye (TR) | RTÜK | EKBMCT |
Türkmenistan (TM) | Kullanılamıyor | MKRF/RUSYA |
Uganda (UG) | Kullanılamıyor | MPAA |
Ukrayna (UA) | Kullanılamıyor | Kullanılamıyor |
Birleşik Arap Emirlikleri (AE) | Kullanılamıyor | MPAA |
İngiltere (GB) | BBFC | BBFC |
Amerika Birleşik Devletleri (US) | TV_PG | MPAA |
Uruguay (UY) | Kullanılamıyor | MPAA |
Özbekistan (UZ) | Kullanılamıyor | MKRF/RUSYA |
Venezuela (VE) | Kullanılamıyor | RESORİVIOLENCIA |
Vietnam (VN) | Kullanılamıyor | MCST |
Zambiya (ZM) | Kullanılamıyor | MPAA |
Zimbabve (ZW) | Kullanılamıyor | MPAA |
GeoShape özellikleri
GeoShape nesnesi aşağıdaki veri türlerinden birini içerir:
- Posta kodu listesi (ör. ABD, Kanada veya diğer posta kodları)
- Kanada ileri seviye sıralama alanları listesi
- Tanımlanmış Pazar Alanı (TPA) Kimliği - ABD'de, kullanıcıların aynı televizyon kanallarını ve programları aldığı bir bölgenin tanımlayıcısı.
Özellik | Beklenen tür | Açıklama |
---|---|---|
@id |
URL | Gerekli: Coğrafi bölgenin URI biçimindeki tanımlayıcısı. |
@type |
Metin | Zorunlu: Her zaman GeoShape olarak ayarlanır. |
addressCountry |
Metin | Zorunlu: İki harfli ISO 3166-1 alfa-2 ülke kodu. |
postalCode |
Metin | İsteğe bağlı: Bir veya daha fazla posta kodu ve/veya FSA (gelişmiş sıralama alanı) kodunun listesidir. |
identifier |
PropertyValue | İsteğe bağlı: Tanımlanmış Pazar Alanı (TPA) kimliği, ABD'de kullanıcıların aynı televizyon kanallarını ve programlarını aldığı bir bölgenin tanımlayıcısıdır. |
identifier.@type |
Metin | Zorunlu: Her zaman PropertyValue olarak ayarlanır. |
identifier.propertyID |
Metin | Zorunlu: Her zaman DMA_ID olarak ayarlanır. |
identifier.value |
Metin | Gerekli: Bölgenin DMA kodu. |
Posta kodu listesini içeren GeoShape
nesnesi örneği:
{
"@type": "GeoShape",
"@id": "http://example.com/area1",
"addressCountry": "US",
"postalCode": [
"94118",
"94119"
]
}
FSA (ileri sıralama alanı) ve posta kodlarının bir kombinasyonunu içeren GeoShape
nesnesi örneği:
{
"@type": "GeoShape",
"@id": "http://example.com/area2",
"addressCountry": "CA",
"postalCode": [
"1A1",
"K1A",
"K1AOB1"
]
}
TPA kimliği içeren GeoShape
nesnesi örneği:
{
"@type": "GeoShape",
"@id": "http://example.com/area3",
"addressCountry": "US",
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "DMA_ID",
"value": "501"
}
]
}