Integrasi pelacakan iklan sisi klien - AWS Elemental MediaTailor
Pengukuran Terbuka SDKRAFTheoPlayerMediaTailor SDK

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Integrasi pelacakan iklan sisi klien

Bagian ini menjelaskan integrasi antara MediaTailor dan berbagai server pelacakan iklan sisi klien.

Kit Pengembangan Perangkat Lunak Pengukuran Terbuka (SDK)

Interactive Advertising Bureau (IAB) Open Measurement SDK (OMSDK) memfasilitasi keterlihatan pihak ketiga dan pengukuran verifikasi untuk iklan yang ditayangkan ke lingkungan web-video dan aplikasi asli.

Untuk dokumen VAST versi 3 yang lebih lama, kode verifikasi harus dimuat dengan simpul Ekstensi, dengan jenis ekstensiAdVerifications. Akar node ekstensi adalah AdVerifications simpul dengan skema yang sama dengan elemen VAST 4.1.

catatan

MediaTailor saat ini hanya mendukung VAST versi 3.

contoh : Node verifikasi di VAST 3, sebelum Versi 4.1
...
<Extensions>
    <Extension type="AdVerifications">
        <AdVerifications>
            <Verification vendor="company.com-omid">
                <JavaScriptResource apiFramework="omid" browserOptional="true">
                    <![CDATA[https://verification.com/omid_verification.js]]>
                </JavaScriptResource>
                <TrackingEvents>
                    <Tracking event="verificationNotExecuted">
                        <![CDATA[https://verification.com/trackingurl]]>
                    </Tracking>
                </TrackingEvents>
                <VerificationParameters>
                    <![CDATA[verification params key/value pairs]]>
                </VerificationParameters>
            </Verification>
        </AdVerifications>
    </Extension>
</Extensions>

MediaTailor mengekstrak AdVerifications data dari <Extensions> node dan menempatkannya ke dalam adVerifications array dalam respons pelacakan sisi klien.

contoh : adVerifications array dalam respons pelacakan sisi klien
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "3062770",
          "adParameters": "",
          "adProgramDateTime": "2023-08-23T16:25:40.914Z",
          "adSystem": "2.0",
          "adTitle": "AD-polarbear-15",
          "adVerifications": [
            {
              "executableResource": [],
              "javaScriptResource": [
                {
                  "apiFramework": "omid",
                  "browserOptional": "true",
                  "uri": "https://verification.com/omid_verification.js"
                }
              ],
              "trackingEvents": [
                {
                  "event": "verificationNotExecuted",
                  "uri": "https://verification.com/trackingurl"
                }
              ],
              "vendor": "company.com-omid",
              "verificationParameters": "verification params key value pairs"
            }
          ],
          "companionAds": [],
          "creativeId": "00006",
          "creativeSequence": "1",
          "duration": "PT14.982S",
          "durationInSeconds": 14.982,
          "extensions": [
            {
              "content": "<AdVerifications>\n\t\t\t\t\t\t<Verification vendor=\"company.com-omid\">\n\t\t\t\t\t\t\t<JavaScriptResource apiFramework=\"omid\" browserOptional=\"true\"><![CDATA[https://verification.com/omid_verification.js;]]></JavaScriptResource>\n\t\t\t\t\t\t\t<TrackingEvents>\n\t\t\t\t\t\t\t\t<Tracking event=\"verificationNotExecuted\"><![CDATA[;https://verification.com/trackingurl;]]></Tracking>\n\t\t\t\t\t\t\t</TrackingEvents>\n\t\t\t\t\t\t\t<VerificationParameters><![CDATA[verification params key/value pairs;]]></VerificationParameters>\n\t\t\t\t\t\t</Verification>\n\t\t\t\t\t</AdVerifications>",
              "type": "AdVerifications"
            }
          ],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": null,
          "startTime": "PT10.11S",
          "startTimeInSeconds": 10.11,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://n8ljfs0h09.execute-api.us-west-2.amazonaws.com/v1/impression"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "3062770",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT10.11S",
              "startTimeInSeconds": 10.11
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "3062770",
      "availProgramDateTime": "2023-08-23T16:25:40.914Z",
      "duration": "PT14.982S",
      "durationInSeconds": 14.982,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT10.11S",
      "startTimeInSeconds": 10.11
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQxMC4xMVNfMjAyMy0wOC0yM1QxNjoyNjoyNC4yNDYxMDIxOTBaXzE%3D",
  "nonLinearAvails": []
}
catatan

Terlibat dengan IAB Tech Lab untuk memastikan bahwa aplikasi disertifikasi setiap tahun untuk memastikan kepatuhan.

Untuk informasi selengkapnya tentang OMSDK, lihat Pengukuran Terbuka SDK di situs web IAB Tech Lab.

Kerangka Periklanan Roku () RAF

Roku Ad Framework (RAF) mempertahankan pengalaman iklan yang konsisten di seluruh platform Roku. Semua saluran, termasuk iklan video, harus memenuhi persyaratan sertifikasi Roku untuk. RAF Khususnya, aplikasi harus selalu menggunakan penembakan peristiwa sisi klien. RAF MediaTailor, sebagai penyedia penyisipan iklan sisi server (SSAI), mendukung pengaktifan peristiwa sisi klien. RAFXSSAIAdapter menyediakan antarmuka ke kedua server SSAI manifes, atau stitcher, dan. RAF Antarmuka ini meliputi:

  • Mengurai masterURL respons dan mengekstraksiplayURL,AdURL, dan metadata iklan.

  • Mengubah metadata MediaTailor SSAI iklan menjadi metadata iklan RAF yang dapat digunakan, dan mengonfigurasi untuk pemutaran. RAF

  • Mengamati peristiwa aliran dan metadata berjangka waktu.

  • Mencocokkan peristiwa streaming, metadata iklan, dan piksel peristiwa penembakan tepat waktu.

  • Pinging/pollingAdURL, seperti yang dipersyaratkan oleh server MediaTailor SSAI manifes, lalu mengurai dan mengonfigurasi ulang. RAF

Untuk informasi selengkapnya tentang SSAI adaptorRAF, lihat Menerapkan Penyisipan Iklan Sisi Server Menggunakan Adaptor Roku di situs web Roku.

TheoPlayer

TheoPlayer integrasi dengan MediaTailor melakukan hal berikut:

  • Menyediakan fungsionalitas untuk mendukung pelacakan MediaTailor peristiwa sisi klien untuk HLS dan DASH untuk keduanya VOD dan alur kerja langsung.

  • Mendukung pengiriman suar pelacakan hanya untuk iklan linier.

  • Menonaktifkan pencarian selama iklan. Namun, tidak ada logika untuk memutar iklan saat pengguna mencari melewati jeda iklan.

Untuk informasi selengkapnya tentang SSAI in TheoPlayer, dan untuk meninjau web, Android, iOS, dan tvOS SDKs MediaTailor, lihat MediaTailordi situs web. TheoPlayer

MediaTailor Kit Pengembangan Perangkat Lunak (SDK)

AWS Elemental memelihara kit pengembangan perangkat lunak JavaScript berbasis (). SDK AWS Elemental menyediakan SDK apa adanya, tanpa garansi tersirat. Gunakan demonstrasi SDK sebagai referensi untuk merampingkan orientasi Anda untuk menggunakan. MediaTailor Ini SDK menunjukkan cara berinteraksi dengan pelacakan MediaTailor sisi klien. API Ini SDK mengimplementasikan pelacakan dan pelaporan iklan sisi klien untuk HTML5 pemain berbasis. Ini SDK menginisialisasi sesi pelaporan MediaTailor sisi klien, lalu meminta informasi pelacakan iklan secara berkala. Selama pemutaran, acara pelacakan iklan akan SDK dipancarkan saat peristiwa iklan baru terdeteksi.

MediaTailor SDKMendukung fitur-fitur ini:

  • Langsung dan daftar VOD putar

  • DASHdan HLS spesifikasi

  • Penanganan acara klik-tayang

  • Dispatcher Ad-Event

  • Kait acara khusus

  • Beaconing iklan sisi klien. Untuk informasi selengkapnya tentang mengirim suar iklan, lihat. Beaconing sisi klien

catatan

Kirim AWS Support tiket untuk menerima sampel JavaScript SDK untuk MediaTailor. Anda akan menerima tautan unduhan untuk paket dan file-filenya.