View a markdown version of this page

Client-side integrações de rastreamento de anúncios - AWS Elemental MediaTailor
Abra o SDK de mediçãoSDKs de players 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.

Abra o SDK de medição

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

Para documentos mais antigos do VAST versão 3, 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 OM SDK, firmou MediaTailor uma parceria com a Datazoom para fornecer SDKs de jogadores gratuitos que são configurados e verificados para Open Measurement. Para obter mais informações, consulte SDKs de players gratuitos do Datazoom.

nota

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

exemplo: Nó de verificação no VAST 3, anterior à 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 de verificações de anúncios 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

Entre em contato 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 players gratuitos do Datazoom

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

O SDK do Datazoom player oferece suporte aos seguintes recursos:

  • Playlists ao vivo e VOD

  • Especificações DASH e HLS

  • Suporte do fornecedor de players 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 Open Measurement do IAB Tech Lab, quando disponível em dispositivos selecionados

  • Click-through tratamento de eventos

  • Ad-event despachantes, como temporizadores de contagem regressiva de anúncios, sobreposição de anúncios e eventos não lineares, início do intervalo de anúncios, fim do intervalo de anúncios

  • Client-side e balizamento

  • SDK da Biblioteca de Acesso Programático (PAL) do Google, como 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 ativar e controlar a telemetria do SDK do player no console de gerenciamento do Datazoom. Para acessar os SDKs do player Datazoom 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. https://www.datazoom.io/partner-aws

Estrutura de publicidade Roku (RAF)

O Roku Ad Framework (RAF) mantém uma experiência de anúncio 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 manifesto SSAI, ou stitchers, quanto para RAF. Essas interfaces incluem:

  • Análise da masterURL respostaplayURL, AdURL extração e metadados do anúncio.

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

  • Observando eventos de stream e metadados cronometrados.

  • Combinando os eventos do stream, os metadados do anúncio e os pixels do evento de disparo dentro do prazo.

  • 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 Implementação da 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 fluxos de trabalho VOD e 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 após o intervalo do anúncio.

Para obter mais informações sobre o SSAI em TheoPlayer, e para revisar os SDKs da Web, Android, iOS e tvOS MediaTailor, consulte o MediaTailor site. 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 ao uso. MediaTailor O SDK mostra como interagir com a API de rastreamento do MediaTailor lado do cliente. O SDK implementa rastreamento e relatórios de anúncios do lado do cliente para 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 de anúncios 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 balizamento. Para obter mais informações sobre o envio de sinalizadores de anúncios, consulte. Client-side balizamento

nota

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