Client-side rastreamento de anúncios

Usando a API de rastreamento AWS Elemental MediaTailor do lado do cliente, você pode incorporar controles de player durante intervalos de anúncios em fluxos de trabalho de streaming. No rastreamento do lado do cliente, o player ou cliente emite eventos de rastreamento, como impressão e sinalização quartil de anúncios, para o Ad Decision Server (ADS) e outras entidades de verificação de anúncios. Esses eventos monitoram o status geral do intervalo do anúncio e os anúncios individuais disponíveis em cada intervalo. Para obter mais informações sobre impressão e quartil (ADS) e outras entidades de verificação de anúncios. Para obter mais informações sobre impressão, quartil e sinalização, consulte. Client-side balizamento Para obter mais informações sobre o ADS e outras entidades de verificação de anúncios, consulte. Client-side integrações de rastreamento de anúncios

Para obter informações sobre como transmitir parâmetros do jogador e dados da sessão ao ADS para rastreamento do lado do cliente, consulte e. MediaTailor variáveis de player para solicitações de ADS MediaTailor variáveis de sessão para solicitações do ADS

Client-side o rastreamento permite funcionalidades como as seguintes:

Usando a API de rastreamento MediaTailor do lado do cliente, você pode enviar metadados para o dispositivo de reprodução que habilita a funcionalidade além do rastreamento do lado do cliente:

Client-side fluxo de trabalho de relatórios

O diagrama a seguir mostra o fluxo de trabalho completo de relatórios do lado do cliente, desde a inicialização da sessão até a reprodução de anúncios e o beaconing:

O fluxo de trabalho de relatórios do lado do cliente inclui as seguintes etapas:

Esse fluxo de trabalho permite recursos avançados, como temporizadores de contagem regressiva de anúncios, funcionalidade de cliques, anúncios complementares, anúncios ignoráveis e exibição de ícones VAST para conformidade com a privacidade.

Habilitando o rastreamento do lado do cliente

Você ativa o rastreamento do lado do cliente para cada sessão. O player cria um HTTP POST para o endpoint do MediaTailor prefixo de inicialização da sessão da configuração. Opcionalmente, o player pode enviar metadados adicionais para usar MediaTailor ao fazer chamadas publicitárias, chamar a origem de um manifesto e invocar ou desativar MediaTailor recursos no nível da sessão.

O exemplo a seguir mostra a estrutura dos metadados JSON:

{
  "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.
}

Use o MediaTailor console ou a API para configurar a URL do modelo de solicitação do ADS para referenciar esses parâmetros. No exemplo a seguir, player_params.param1 são os parâmetros do player paraparam1, e player_params.param2 são os parâmetros do player paraparam2.

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

Parâmetros do servidor de anúncios

No nível mais alto da estrutura JSON está um objeto adsParams JSON. Dentro desse objeto estão key/value pares que MediaTailor podem ler e enviar para o servidor de anúncios em todas as solicitações de sessão. MediaTailor suporta os seguintes servidores de anúncios:

Parâmetros de consulta de interação de origem

Todos os key/value pares reservados no nível mais alto da estrutura JSON, como, e adsParams availSuppressionoverlayAvails, não são adicionados ao URL da solicitação de origem na forma de parâmetros de consulta. Cada solicitação de manifesto de MediaTailor sessão feita à origem contém esses parâmetros de consulta. A origem ignora parâmetros de consulta estranhos. Por exemplo, MediaTailor pode usar os key/value pares para enviar tokens de acesso à origem.

Session-configured features

Use a estrutura JSON de inicialização de sessão para ativar, desativar ou substituir MediaTailor recursos como, e. overlayAvails availSuppression adSignaling Qualquer configuração de recurso passada durante a inicialização da sessão substitui a configuração no nível da configuração. 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" 
           }
        }

Parâmetro do modo de relatório

Você pode especificar o modo de relatório ao inicializar uma sessão incluindo o reportingMode parâmetro no corpo da solicitação. Esse parâmetro controla se MediaTailor executa o rastreamento de anúncios do lado do cliente ou do servidor para a sessão.

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

        {
            "adsParams": {
               "deviceType": "ipad",
               "uid": "abdgfdyei-2283004-ueu"                     
           },
           "reportingMode": "server"
        }

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

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

Uma resposta bem-sucedida é um HTTP 200 com um corpo de resposta. O corpo contém um objeto JSON com uma trackingUrl chave manifestUrl e uma. Os valores são URLs relativos que o player pode usar para fins de reprodução e rastreamento de eventos publicitários.

{
  "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"
}

Para obter mais informações sobre o esquema de rastreamento do lado do cliente, consulte. Client-side esquema e propriedades de rastreamento de anúncios

Práticas recomendadas para rastreamento do lado do cliente

Esta seção descreve as melhores práticas para o rastreamento do lado do cliente em fluxos de trabalho ao vivo e MediaTailor de VOD.

Fluxos de trabalho ao vivo

Pesquise o endpoint de rastreamento em um intervalo correspondente a cada duração desejada para o HLS ou ao período mínimo de atualização do DASH, para ter sempre os metadados de rastreamento de anúncios mais atuais. Combinar esse intervalo é especialmente importante em fluxos de trabalho em que os criativos podem ter um componente interativo ou de sobreposição.

Fluxos de trabalho de VOD

Após a inicialização bem-sucedida da sessão e depois de MediaTailor receber o primeiro manifesto contendo mídia, você só precisa chamar o endpoint de rastreamento uma vez.

Server-guided inserção de anúncios

Server-guided As sessões de inserção de anúncios (SGAI) não usam a GetTracking API. Em vez disso, quando você usaaws.reportingMode=CLIENT, MediaTailor fornece informações de rastreamento na TRACKING seção de cada resposta da lista de ativos quando os jogadores solicitam o conteúdo do anúncio. A resposta de inicialização da sessão não inclui a. trackingUrl

A resposta da lista de ativos para sessões SGAI rastreadas pelo lado do cliente tem a seguinte estrutura:

{
  "ASSETS": [
    { "DURATION": 20.0, "URI": "https://cdn.example.com/ad1/master.m3u8" },
    { "DURATION": 10.0, "URI": "https://cdn.example.com/ad2/master.m3u8" }
  ],
  "TRACKING": {
    ...VAST tracking events and beacon URLs for each ad...
  }
}

Ao implementar o rastreamento do lado do cliente para métodos SGAI:

Paginação por meio de sinalizadores de anúncios com GetTracking

Use o GetTracking endpoint para reduzir o número de anúncios devolvidos a um jogador. Por exemplo, se uma janela de manifesto for ampla, abrangendo muito tempo, o número de sinalizadores de anúncios retornados pode afetar o desempenho do jogador.

GetTrackingretorna um NextToken valor que você pode usar para reduzir o número de beacons retornados paginando a lista de beacons retornados. Você pode percorrer os NextToken valores para encontrar o valor desejado do campo de um ad StartTimeInSeconds beacon.

Sequência de chamada generalizada GetTracking do jogador

Do player do cliente, uma GetTracking solicitação é um POST com um corpo de solicitação que contém os anúncios NextToken e beacons relacionados ao token.

https://YouMediaTailorUrl/v1/tracking
{

     "NextToken": "value"
     .
     .
     .
}      
    

A sequência geral para usar GetTracking com NextToken é a seguinte:

Exemplo estendido

Este exemplo mostra como usar GetTracking's NextToken para restringir o número de ad beacons devolvidos a um jogador.

MediaTailor recebe uma GetTracking solicitação. A resposta contém um anúncio com ID 9935407 e dois beacons com StartTimeInSeconds valores de 52,286 e 48,332 segundos.

MediaTailor envia a resposta JSON da NextToken seguinte forma:

  {
  "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
    }
  ]
}      
    

Na próxima GetTracking solicitação, MediaTailor responde com o NextToken valor: JF57ITe48t1441mv7TmLKuZLroxDzfIslp6BiSNL1IJmzPVMDN0lqrBYycgMbKEb.

MediaTailor responde com anúncios e beacons que correspondem aos StartTimeInSeconds definidos na chamada NextToken anterior.

Suponha que agora a resposta inclua outro anúncio com ID 9235407 além do anúncio anterior com ID 9935407. Os beacons do anúncio ID 9235407 são 132,41 e 70,339. StartTimeInSeconds

MediaTailor itera sobre todos os beacons da sessão para selecionar aqueles com StartTimeInSeconds mais de 52.286 segundos, que são o beacon 3 e o beacon 4 do anúncio com 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
    }
  ]
}