Integrações de rastreamento de anúncios do lado do cliente - AWS Elemental MediaTailor
Medição aberta SDKRAFTheoPlayerMediaTailor 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á.

Integrações de rastreamento de anúncios do lado do cliente

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

Kit de desenvolvimento de software de medição aberto (SDK)

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

Para documentos da VAST versão 3 mais antigos, 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.

nota

MediaTailor atualmente suporta somente a VAST versão 3.

exemplo : nó de verificação em 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 : adVerifications matriz 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 OMSDK, consulte Open Measurement SDK no site do IAB Tech Lab.

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. RAF Notavelmente, o aplicativo deve sempre usar o disparo de eventos do lado do cliente. RAF MediaTailor, como provedor de inserção de anúncios (SSAI) do lado do servidor, oferece suporte ao disparo de eventos do lado do cliente. Os RAFX SSAI adaptadores fornecem interfaces tanto para servidores de SSAI manifestos quanto para costuradores e. RAF Essas interfaces incluem:

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

  • Transformação de metadados de MediaTailor SSAI anúncios em metadados RAF de anúncios utilizáveis e configuração para reprodução. RAF

  • 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.

  • Executando ping/pesquisando oAdURL, conforme exigido pelo servidor de MediaTailor SSAI manifesto, depois analisando e reconfigurando. RAF

Para obter mais informações sobre SSAI adaptadores paraRAF, consulte Implementando a inserção de anúncios no lado do servidor 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 VOD e DASH para 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 SSAI e para analisar a web, o Android, o iOS e o SDKs tvOS MediaTailor, consulte MediaTailorno TheoPlayer site. TheoPlayer

MediaTailor Kit de desenvolvimento de software (SDK)

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

O MediaTailor SDK suporta esses recursos:

  • Ao vivo e VOD playlists

  • DASHe HLS especificações

  • Manipulação de eventos por clique

  • Expedidores de eventos publicitários

  • Ganchos de eventos personalizados

  • Balizamento de anúncios do lado do cliente. Para obter mais informações sobre o envio de beacons de anúncios, consulte. Sinalização do lado do cliente

nota

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