View a markdown version of this page

Client-side integrações de rastreamento de anúncios - AWS Elemental MediaTailor
SDK de medição abertoSDKs de reprodutores gratuitos do DatazoomRAFTheoPlayerMediaTailor SDK

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Client-side integrações de rastreamento de anúncios

Esta seção descreve as integrações entre MediaTailor e vários servidores de rastreamento de anúncios do lado do cliente.

SDK de medição aberto

O SDK de Medição Aberta (OM SDK) do Interactive Advertising Bureau (IAB) facilita a medição de visibilidade e verificação de anúncios veiculados em ambientes de vídeo na web e aplicativos nativos.

Para documentos mais antigos da versão 3 do VAST, o código de verificação deve ser carregado com o nó de extensão, com o tipo de extensãoAdVerifications. A raiz do nó de extensão é um AdVerifications nó com o mesmo esquema do elemento VAST 4.1.

Para facilitar a adoção do SDK do OM, MediaTailor fez uma parceria com a Datazoom para fornecer SDKs gratuitos para jogadores que são configurados e verificados para o Open Measurement. Para obter mais informações, consulte SDKs de reprodutores gratuitos do Datazoom.

nota

MediaTailor atualmente suporta apenas a versão 3 do VAST.

exemplo: nó de verificação no VAST 3, antes da versão 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 extrai os AdVerifications dados do <Extensions> nó e os coloca na adVerifications matriz na resposta de rastreamento do lado do cliente.

exemplo: matriz AdVerifications na resposta de rastreamento do lado do cliente
{
  "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": []
}
nota

Interaja com o IAB Tech Lab para garantir que os aplicativos sejam certificados anualmente para garantir a conformidade.

Para obter mais informações sobre o OM SDK, consulte Open Measurement SDK no site do IAB Tech Lab.

SDKs de reprodutores gratuitos do Datazoom

Para facilitar a adoção dos SDKs do player, MediaTailor fez uma parceria com a Datazoom para fornecer SDKs gratuitos para jogadores que são configurados e testados com o e o IAB Tech. Client-side AWS Elemental MediaTailor integração com o Google Ad Manager SDK de medição aberto

O SDK do Datazoom player é compatível com os seguintes recursos:

  • Playlists ao vivo e VOD

  • Especificações DASH e HLS

  • Suporte do fornecedor do player para Bitmovin, exoplayer, reprodutor de mídia Android, Apple AVPlayer, Brightcove, Chromecast Receiver, hls.js, JWPlayer, Shaka player, THEO player Dash.js, Roku e muito mais Video.js

  • Certificação de medição aberta do IAB Tech Lab, quando disponível em dispositivos selecionados

  • Click-through tratamento de eventos

  • Ad-event expedidores, como cronômetros de contagem regressiva de anúncios, eventos não lineares e de sobreposição de anúncios, início de intervalo de anúncio, fim de intervalo de anúncio

  • Client-side e balizamento

  • SDK da Biblioteca de Acesso Programático (PAL) do Google, como uma configuração opcional

O Datazoom também oferece um serviço pago de análise e telemetria compatível com os SDKs do player. Os clientes podem optar e controlar a telemetria do SDK do player a partir do console de gerenciamento do Datazoom. Para acessar os SDKs do Datazoom player e saber mais sobre o serviço de telemetria e análise de valor agregado, use as informações de contato no site do Datazoom.

Estrutura de publicidade Roku (RAF)

O Roku Ad Framework (RAF) mantém uma experiência publicitária consistente em toda a plataforma Roku. Todos os canais, incluindo anúncios em vídeo, devem atender aos requisitos de certificação da Roku para a RAF. Notavelmente, o aplicativo deve sempre usar o disparo de eventos do lado do cliente por meio do RAF. MediaTailor, como provedor de inserção de anúncios do lado do servidor (SSAI), oferece suporte ao disparo de eventos do lado do cliente. Os adaptadores RAFX SSAI fornecem interfaces tanto para servidores de manifestos SSAI, ou stitchers, quanto para RAF. Essas interfaces incluem:

  • Análise e extração da masterURL resposta e dos playURL metadados AdURL do anúncio.

  • Transformando metadados de anúncios MediaTailor SSAI em metadados de RAF-usable anúncios e configurando RAF para reprodução.

  • Observando eventos de stream e metadados cronometrados.

  • Combinando os eventos de transmissão, os metadados do anúncio e os pixels do evento de disparo em tempo hábil.

  • Pinging/polling oAdURL, conforme exigido pelo servidor de manifesto MediaTailor SSAI, analisando e reconfigurando o RAF.

Para obter mais informações sobre adaptadores SSAI para RAF, consulte Implementando a inserção de Server-Side anúncios usando adaptadores Roku no site da Roku.

TheoPlayer

TheoPlayer a integração com MediaTailor faz o seguinte:

  • Fornece funcionalidade para oferecer suporte ao rastreamento de eventos MediaTailor do lado do cliente para HLS e DASH para VOD e fluxos de trabalho ao vivo.

  • Suporta o envio de beacons de rastreamento somente para anúncios lineares.

  • Desativa a busca durante um anúncio. No entanto, não há lógica para reproduzir um anúncio quando o usuário busca além do intervalo publicitário.

Para obter mais informações sobre a SSAI e analisar os SDKs para web, Android, iOS e tvOS MediaTailor, consulte MediaTailorno site. TheoPlayer TheoPlayer

MediaTailor SDK

AWS A Elemental mantém um kit de JavaScript-based desenvolvimento de software (SDK). AWS A Elemental fornece o SDK no estado em que se encontra, sem garantia implícita. Use o SDK como uma demonstração de referência para agilizar sua integração e uso. MediaTailor O SDK mostra como interagir com a API de rastreamento do MediaTailor lado do cliente. O SDK implementa o rastreamento e os relatórios de anúncios do lado do cliente para os jogadores. HTML5-based O SDK inicializa uma sessão de relatórios do MediaTailor lado do cliente e, em seguida, solicita periodicamente informações de rastreamento de anúncios. Durante a reprodução, o SDK emite eventos de rastreamento de anúncios quando novos eventos publicitários são detectados.

O MediaTailor SDK oferece suporte aos seguintes recursos:

  • Playlists ao vivo e VOD

  • Especificações DASH e HLS

  • Click-through tratamento de eventos

  • Ad-event despachantes

  • Ganchos de eventos personalizados

  • Client-side e faróis. Para obter mais informações sobre o envio de beacons de anúncios, consulte. Client-side balizamento

nota

Envie um ticket de AWS Support para receber uma amostra de JavaScript SDK para MediaTailor. Você receberá um link para download do pacote e seus arquivos.