Início rápido

1. Obtenha os dados padrão e necessários do Adobe Analytics e do visitante que você deve fornecer para executar qualquer um dos aplicativos da Experience Cloud:

   • ID da organização da Experience Cloud do visitante
   • ID do usuário da Experience Cloud do visitante
   • ID de conjunto de relatórios do Analytics
   • URL do servidor de rastreamento do Analytics

2. Crie um objeto JSON para o corpo da solicitação sessions contendo os dados mínimos necessários para uma chamada bem-sucedida. Por exemplo:

   {
       "playerTime": {
           "playhead": 0,
           "ts": 1234560890123
       },
       "eventType": "sessionStart",
       "params": {
           "media.playerName": "sample-html5-api-player",
           "analytics.trackingServer": "[YOUR_TS]",
           "analytics.reportSuite": "[YOUR_RSID]",
           "media.contentType": "VOD",
           "media.length": 60.39333333333333,
           "media.id": "MA Collection API Sample Player",
           "visitor.marketingCloudOrgId": "[YOUR_ORG_ID]",
           "visitor.marketingCloudUserId": "[YOUR_ECID]",
           "media.name": "ClickMe",
           "media.channel": "sample-channel",
           "media.sdkVersion": "va-api-0.0.0",
           "analytics.enableSSL": false
       }
   }
   

   OBSERVAÇÃO

   Você deve usar os tipos de dados corretos no corpo da solicitação JSON. Por exemplo, analytics.enableSSL exige um booleano, media.length é numérico, etc. Você pode verificar os tipos de parâmetros e requisitos de obrigatoriedade nos esquemas de validação JSON.

3. Envie Solicitações de sessões para o endpoint da API da coleção do MA. Se a carga da sua solicitação for inválida, identifique o problema e tente novamente até obter uma resposta 201 Created. Neste exemplo curl, o corpo da solicitação JSON está em um arquivo denominado sample_data_session:

   $ curl -i -d \
     @sample_data_session https://{uri}/api/v1/sessions \
     > curl.sessions.out
   
   $ cat curl.sessions.out
   HTTP/1.1 201 Created
   Server: nginx/1.13.5
   Date: Mon, 18 Dec 2017 22:34:12 GMT
   Content-Type: application/octet-stream
   Content-Length: 0
   Connection: keep-alive
   Location: /api/v1/sessions/a39c037641f[...]  # <== Session ID
   Access-Control-Allow-Origin: *
   Access-Control-Allow-Methods: OPTIONS,POST,PUT
   Access-Control-Allow-Headers: Content-Type
   Access-Control-Expose-Headers: Location
   

Se a Solicitação de sessões tiver êxito, você receberá uma resposta 201 Created semelhante à mostrada acima. A resposta inclui uma ID de sessão no cabeçalho Local. A ID de sessão é uma parte essencial das informações na resposta, pois é necessária para todas as chamadas de rastreamento subsequentes. Depois de um retorno bem-sucedido de uma Solicitação de sessões, você pode prosseguir com a implementação do rastreamento de vídeo usando a API do MA no reprodutor de vídeo.