Pelacakan iklan sisi klien

Menggunakan AWS Elemental MediaTailor pelacakan sisi klienAPI, Anda dapat menggabungkan kontrol pemain selama jeda iklan dalam alur kerja streaming. Dalam pelacakan sisi klien, pemain atau klien memancarkan peristiwa pelacakan, seperti tayangan dan suar iklan kuartil, ke Server Keputusan Iklan () dan entitas verifikasi iklan lainnya. ADS Untuk informasi selengkapnya tentang tayangan dan suar iklan kuartil, lihat. Beaconing sisi klien Untuk informasi selengkapnya tentang ADS dan entitas verifikasi iklan lainnya, lihatIntegrasi pelacakan iklan sisi klien.

Pelacakan sisi klien memungkinkan fungsionalitas seperti berikut:

Dengan menggunakan pelacakan MediaTailor sisi klienAPI, Anda dapat mengirim metadata ke perangkat pemutaran yang memungkinkan fungsionalitas selain pelacakan sisi klien:

Mengaktifkan pelacakan sisi klien

Anda mengaktifkan pelacakan sisi klien untuk setiap sesi. Pemain membuat titik HTTP POST akhir awalan sesi inisialisasi MediaTailor konfigurasi. Secara opsional, pemain dapat mengirim metadata tambahan MediaTailor untuk digunakan saat melakukan panggilan iklan, memanggil asal untuk manifes, dan memanggil atau menonaktifkan MediaTailor fitur di tingkat sesi.

Contoh berikut menunjukkan struktur JSON metadata:

{
  "adsParams": {                  # 'adsParams' is case sensitive
    "param1": "value1",           # key is not case sensitive
    "param2": "value2",           # Values can contain spaces. For example, 'value 2' is an allowed value. 
    },
  "origin_access_token":"abc123", # this is an example of a query parameter designated for the origin
  "overlayAvails":"on"            # 'overlayAvails' is case sensitive. This is an example of a feature that is enabled at the session level.
}

Gunakan MediaTailor konsol atau API untuk mengonfigurasi templat ADS permintaan URL untuk mereferensikan parameter ini. Dalam contoh berikut, player_params.param1 adalah parameter pemain untukparam1, dan player_params.param2 merupakan parameter pemain untukparam2.

https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

Parameter server iklan

Pada tingkat paling atas dari JSON struktur adalah adsParams JSON objek. Di dalam objek ini terdapat pasangan kunci/nilai yang MediaTailor dapat membaca dan mengirim ke server iklan di semua permintaan sesi. MediaTailor mendukung server iklan berikut:

Parameter kueri interaksi asal

Setiap pasangan kunci/nilai cadangan dalam tingkat paling atas JSON struktur, sepertiadParams,, dan availSuppressionoverlayAvails, tidak ditambahkan ke permintaan asal URL dalam bentuk parameter kueri. Setiap permintaan manifes sesi yang MediaTailor dibuat ke asal berisi parameter kueri ini. Asal mengabaikan parameter kueri asing. Misalnya, MediaTailor dapat menggunakan pasangan kunci/nilai untuk mengirim token akses ke asal.

Fitur yang dikonfigurasi sesi

Gunakan JSON struktur inisialisasi sesi untuk mengaktifkan, menonaktifkan, atau mengganti MediaTailor fitur sepertioverlayAvails,, dan. availSuppression adSignaling Konfigurasi fitur apa pun yang diteruskan selama inisialisasi sesi mengesampingkan pengaturan pada tingkat konfigurasi. MediaTailor

POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.m3u8

        {
            "adsParams": {
               "deviceType": "ipad"   # This value does not change during the session.
               "uid": "abdgfdyei-2283004-ueu"                     
           }
        }

POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.mpd

        {
            "adsParams": {
               "deviceType": "androidmobile",
               "uid": "xjhhddli-9189901-uic" 
           }
        }

Respons yang sukses adalah HTTP 200 dengan badan respons. Tubuh berisi JSON benda dengan kunci manifestUrl dan trackingUrl kunci. Nilainya relatif URLs yang dapat digunakan pemain untuk tujuan pemutaran dan pelacakan acara iklan.

{
  "manifestUrl": "/v1/dashmaster/hashed-account-id/origin-id/asset-id.m3u8?aws.sessionId=session-id",
  "trackingUrl": "/v1/tracking/hashed-account-id/origin-id/session-id"
}

Untuk informasi selengkapnya tentang skema pelacakan sisi klien, lihat. Skema dan properti pelacakan iklan sisi klien

Praktik terbaik untuk pelacakan sisi klien

Bagian ini menguraikan praktik terbaik untuk pelacakan sisi klien baik MediaTailor untuk live maupun alur kerja. VOD

Alur kerja langsung

Polling titik akhir pelacakan pada interval yang cocok dengan setiap durasi target untukHLS, atau periode pembaruan minimum untukDASH, agar selalu memiliki metadata pelacakan iklan terbaru. Pencocokan interval ini sangat penting dalam alur kerja di mana materi iklan mungkin memiliki komponen interaktif atau overlay.

VODalur kerja

Setelah inisialisasi sesi berhasil, dan setelah MediaTailor menerima manifes pertama yang berisi media, Anda hanya perlu memanggil titik akhir pelacakan sekali.

Paging melalui suar iklan dengan GetTracking

Gunakan GetTracking titik akhir untuk mempersempit jumlah iklan yang dikembalikan ke pemain. Misalnya, jika jendela manifes lebar, mencakup banyak waktu, jumlah suar iklan yang dikembalikan dapat memengaruhi kinerja pemain.

GetTrackingmengembalikan NextToken nilai yang dapat Anda gunakan untuk mempersempit jumlah suar yang dikembalikan dengan paging melalui daftar suar yang dikembalikan. Anda dapat menelusuri NextToken nilai untuk menemukan nilai yang diinginkan dari bidang suar iklan. StartTimeInSeconds

Urutan panggilan umum dari GetTracking dari pemain

Dari pemain klien, GetTracking permintaan adalah POST dengan badan permintaan yang berisi NextToken dan iklan dan suar yang terkait dengan token.

https://YouMediaTailorUrl/v1/tracking
{

     "NextToken": "value"
     .
     .
     .
}      
    

Urutan umum untuk menggunakan GetTracking dengan NextToken adalah sebagai berikut:

Contoh yang diperluas

Contoh ini menunjukkan cara menggunakan GetTracking's NextToken untuk membatasi jumlah suar iklan yang dikembalikan ke pemain.

MediaTailor menerima GetTracking permintaan. Respons berisi iklan dengan ID 9935407 dan dua beacon dengan StartTimeInSeconds nilai 52.286 dan 48,332 detik, seperti yang ditunjukkan pada diagram ini.

MediaTailor mengirimkan JSON respons dengan NextToken sebagai berikut:

  {
  "NextToken": JF57ITe48t1441mv7TmLKuZLroxDzfIslp6BiSNL1IJmzPVMDN0lqrBYycgMbKEb
  "avails": [
    {
      "ads": [
        {
          "adId": "9935407",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "",
          "creativeSequence": "",
          "duration": "PT15S",
          "durationInSeconds": 15,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "startTime": "PT30S",
          "StartTimeInSeconds": 45,
          "trackingEvents": [
            {
              "beaconUrls": [
                "http://adserver.com/tracking?event=Impression "
              ],
              "duration": "PT0S",
              "durationInSeconds": 0,
              "eventId": "9935414",
              "eventType": "secondQuartile",
              "startTime": "PT52.286S",
              "StartTimeInSeconds": 52.286
            },
            {
              "beaconUrls": [
                "http://adserver.com/tracking?event=firstQuartile"
              ],
              "duration": "PT0S",
              "durationInSeconds": 0,
              "eventId": "9935412",
              "eventType": "firstQuartile",
              "startTime": "PT48.332S",
              "StartTimeInSeconds": 48.332
            }
          ],
          "vastAdId": ""
        }
      ],
      "startTime": "PT46.47S",
      "StartTimeInSeconds": 46.47
    }
  ]
}      
    

Pada GetTracking permintaan berikutnya, MediaTailor merespons dengan NextToken nilai,: JF57ITe48t1441mv7TmLKuZLroxDzfIslp6BiSNL1IJmzPVMDN 0 lqrBYycg MbKEb.

MediaTailor merespons dengan iklan dan beacon yang cocok dengan StartTimeInSeconds yang ditetapkan dalam panggilan NextToken sebelumnya.

Asumsikan bahwa sekarang respons menyertakan iklan lain dengan ID 9235407 selain iklan sebelumnya dengan ID 9935407. Beacon ID iklan 9235407 memiliki StartTimeInSeconds s 132,41 dan 70,339 seperti yang ditunjukkan pada diagram ini.

MediaTailor mengulangi semua beacon dalam sesi untuk memilih yang StartTimeInSeconds lebih besar dari 52.286 detik, yaitu beacon 3 dan beacon 4 dari iklan dengan ID 9235407:

{
  "NextToken": ZkfknvbfsdgfbsDFRdffg12EdffecFRvhjyjfhdfhnjtsg5SDGN
  "avails": [
    {
      "ads": [
        {
          "adId": "9235407",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "",
          "creativeSequence": "",
          "duration": "PT15.816S",
          "durationInSeconds": 19.716,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "startTime": "PT2M0S",
          "StartTimeInSeconds": 120.0,
          "trackingEvents": [
            {
              "beaconUrls": [
                "http://adserver.com/tracking?event=complete"
              ],
              "duration": "PT0S",
              "durationInSeconds": 0,
              "eventId": "8935414",
              "eventType": "firstQuartile",
              "startTime": "PT1M10.330S",
              "StartTimeInSeconds": 70.339
            },
            {
              "beaconUrls": [
                "http://adserver.com/tracking?event=thirdQuartile"
              ],
              "duration": "PT0S",
              "durationInSeconds": 0,
              "eventId": "8935412",
              "eventType": "secondQuartile",
              "startTime": "PT2M12.41S",
              "StartTimeInSeconds": 132.41
            }
          ],
          "vastAdId": ""
        },   
      ],
      "startTime": "PT36.47S",
      "StartTimeInSeconds": 36.47
    }
  ]
}