Show Menu
TOPICS×

Início rápido

Obtenha os dados de solicitação necessários para concluir uma Solicitação de sessão bem-sucedida no servidor do back-end da API da coleção do Media Analytics (MA). Você pode verificar rapidamente seus dados de solicitação enviando solicitações manualmente (com
curl
, Postman, etc.). Você terá feedback imediato se você tiver algum problema com tipos de dados incorretos ou informações incorretas em sua solicitação. Use os esquemas de validação JSON para verificar se você está fornecendo dados de solicitação adequados.
  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 } }
    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.