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.). Isso fornecerá feedback imediato sobre se você tem problemas de 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 os dados de solicitação adequados.
  1. Reúna os dados padrão do Adobe Analytics e do Visitante que você precisa 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
    • 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 Localização. A ID de sessão é a parte crucial das informações na resposta, pois é necessária para todas as chamadas 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.