sonopto.

Uygulamalar

Web Sitesi Dinamik Adres Değişkenleri

Adreslere oynatıcıya özgü değerleri kendiliğinden yerleştirme: cihaz kimliği, seri numarası, üretici ve özel etiketler.

Not: Bu özellik Website/URL uygulamasıyla birlikte kullanılır. Bkz. Web Sitesi Uygulaması.

Dinamik adres değişkenleri, oynatıcıya özgü değerleri adreslerin içine kendiliğinden yerleştirmenizi sağlar. Cihaz bilgisini API’lere, içerik akışlarına, analiz sistemlerine ya da özel panolara göndermek için kullanın.

Böylece:

  • Oynatıcı bilgilerini elle girmeden aktarabilirsiniz.
  • Veri isteklerini cihaz cihaz özelleştirebilirsiniz.
  • Ekran bilgilerine göre içerik kuralları ya da API akışları tetikleyebilirsiniz.
  • İş mantığınızı özel etiketlerle tanımlayabilirsiniz (mağaza kodu, bölge, kanal vb.).

Kullanılabilir değişkenler

DeğişkenAçıklama
{player.id}Oynatıcının benzersiz kimliği
{player.serial}Cihazın seri numarası (varsa)
{player.name}Oynatıcı adı
{player.manufacturer}Cihaz üreticisi (Samsung, LG, Android vb.)
{player.osPlatform}İşletim sistemi / platform
{player.tags.all}Tüm etiketler, anahtar:değer biçiminde ve virgülle ayrılmış
{player.tags.key}Anahtara göre etiket değeri (örnek aşağıda)

Etiketler büyük/küçük harfe duyarlıdır. Mümkün olduğunca küçük harf kullanın.


Etiketleri kullanma

Etiketler, her oynatıcı için özel bilgi tanımlamanızı sağlar.

Bir oynatıcıya eklenmiş örnek etiketler:

store:TR-001
zone:MenuBoard
city:Ankara
ŞablonÇıktı
{player.tags.store}TR-001
{player.tags.zone}MenuBoard
{player.tags.city}Ankara
{player.tags.all}store:TR-001,zone:MenuBoard,city:Ankara

Etiketler anahtar:değer biçiminde yazılır. Bir oynatıcıya birden çok etiket ekleyebilirsiniz.

Oynatıcı etiketleri

Örnek kullanım

https://example.com/sync?player={player.id}&store={player.tags.store}

Birden çok etiket değişkeni

https://example.com/{player.tags.store}/{player.tags.zone}

Tüm etiketleri gönderme

https://example.com?tags={player.tags.all}

Değişkenleri sınama

Değişkenlerin nasıl açıldığını sınama aracıyla önizleyebilirsiniz:

https://url-variable-tester.ds-apps.net

Sınama örneği

Şablon:

https://url-variable-tester.ds-apps.net?device={player.id}&store={player.tags.store}

Örnek çıktı:

https://url-variable-tester.ds-apps.net?device=PL12345&store=TR-001

Yayına almadan önce adres biçimlerinizi bu araçla doğrulayın.


İyi uygulamalar

  • Etiket anahtarlarını küçük harfle yazın: store, zone, channel.
  • Boşluk kullanmayın; - ya da _ tercih edin: store-id:001.
  • Etiket değerlerini kısa ve sade tutun.
  • Adresleri sınama aracıyla doğrulayın.