Usar IDs de dispositivo primário na coleção de dados

O Experience Platform Edge Network usa Experience Cloud IDs (ECIDs) para identificar visitantes do site. Para melhorar a durabilidade da identidade em propriedades próprias, você pode definir e gerenciar seus próprios identificadores de dispositivo, conhecidos como IDs de dispositivo primário (FPIDs). O Edge Network usa o FPID para propagar a ECID que as soluções da Adobe usam.

Esta página supõe que você esteja familiarizado com ECIDs e identityMap. Consulte Identidade na Coleção de Dados para obter mais informações.

Quando usar FPIDs when-to-use

As restrições de navegador podem encurtar a vida útil dos cookies que o Adobe usa para reconhecer visitantes recorrentes. Se você precisar de identidade mais durável em sites que sua organização possui e controla, os FPIDs permitem gerenciar seu próprio identificador de dispositivo e usá-lo para propagar a ECID.

Os FPIDs são compatíveis com implementações da Web que usam o Web SDK, incluindo a extensão de tag da Web SDK. Eles são ideais quando o objetivo principal é uma persistência de identidade mais forte em domínios pertencentes a sua organização, ou quando você deseja uma continuidade melhor para relatórios e personalização em propriedades próprias da Web. Elas também permitem definir e gerenciar um cookie próprio da infraestrutura que você controla.

Os FPIDs não são a ferramenta correta quando seu objetivo principal é a entrega de aplicativo para Web ou a continuidade de identidade em vários domínios. Para estes cenários, consulte compartilhamento de identidade móvel para Web e compartilhamento entre domínios.

Os benefícios do uso de FPIDs incluem:

As compensações para o uso de FPIDs incluem:

Caminho de configuração de alto nível

Como os FPIDs funcionam how-fpids-work

O FPID transmitido ao Adobe Experience Cloud é convertido em uma ECID usando um algoritmo determinístico. Sempre que o mesmo FPID for enviado para o Edge Network, a mesma ECID será propagada do FPID. Depois que o FPID for usado para propagar uma ECID, ele será descartado de identityMap e substituído pela ECID gerada. O FPID não é armazenado nas soluções da Adobe Experience Platform ou da Experience Cloud.

Quando uma ECID e um FPID existem, a ECID é sempre usada para identificar o usuário primeiro. Essa priorização garante que, quando uma ECID existente estiver presente no armazenamento de cookies do navegador, ela permanecerá o identificador principal e as contagens de visitantes existentes não arriscarão a inflação. Para usuários existentes, o FPID não se torna a identidade principal até que o ECID expire ou seja excluído como resultado da política do navegador ou da ação manual.

As identidades são priorizadas na seguinte ordem:

Gerar e definir o cookie FPID set-fpid-cookie

O Edge Network só aceita IDs que estejam em conformidade com o formato UUIDv4. As IDs de dispositivo que não estão no formato UUIDv4 foram rejeitadas.

Configuração de cookie do lado do servidor set-cookie-server

Ao definir um cookie por meio do seu próprio servidor, você pode usar vários métodos para ajudar a impedir que o cookie seja restrito pelas políticas do navegador:

Os cookies próprios são mais eficazes quando definidos com um servidor que usa um registro A DNS (para IPv4) ou registro AAAA (para IPv6), em vez de um código DNS CNAME ou JavaScript.

Observe que os registros A ou AAAA só têm suporte para configuração e rastreamento de cookies. O método principal de coleta de dados é por meio de um DNS CNAME. Os FPIDs são definidos com um registro A ou AAAA e enviados para a Adobe com um CNAME. O Programa de Certificados Gerenciados pela Adobe permite configurar um CNAME para coleta de dados.

Quando definir o cookie when-to-set-cookie

Idealmente, o cookie FPID é definido antes de enviar dados para a Edge Network. Se sua implementação exigir consentimento antes de coletar dados, consulte Consentimento com IDs de dispositivo primário para obter orientação sobre como coordenar o cookie FPID com seu fluxo de consentimento. A inflação de visitante é reduzida quando você garante que o FPID esteja disponível para propagar a ECID a partir da primeira solicitação. Em cenários nos quais isso não é possível, uma ECID ainda é gerada usando métodos existentes e atua como o identificador principal, desde que o cookie exista. O FPID gerado não se torna o identificador principal até que a ECID não esteja mais presente. Supondo que a ECID seja afetada por uma política de exclusão do navegador, mas o FPID não, o FPID se torna o identificador principal na próxima visita e é usado para propagar a ECID em cada visita subsequente.

Definir a expiração set-expiration

A Adobe recomenda considerar cuidadosamente a duração do cookie FPID. Considere a política de privacidade de sua organização juntamente com as leis e políticas dos países ou regiões em que sua organização opera. Dependendo da configuração de sua organização, você pode adotar uma política de configuração de cookies em toda a empresa ou uma que varia para os usuários em cada local onde você opera. Independentemente da expiração inicial do cookie, inclua uma lógica que estenda a expiração sempre que ocorrer uma nova visita ao site.

Sinalizadores de cookie cookie-flags

Há vários sinalizadores de cookies que afetam como os cookies são tratados em navegadores diferentes:

Enviar o FPID para o Edge Network send-fpid

Você pode enviar FPIDs para a Edge Network de duas maneiras:

Método 1: configurar um CNAME e definir um cookie de ID próprio na sua sequência de dados setting-cookie-datastreams

Para definir um cookie FPID de seu próprio domínio, você deve configurar seu próprio CNAME para suas chamadas do Web SDK e, em seguida, habilitar a funcionalidade de cookie de ID primária na configuração da sequência de dados. Um registro CNAME no DNS permite criar um alias de um nome de domínio para outro. Este alias pode ajudar a fazer com que serviços de terceiros apareçam como se fossem parte de seu próprio domínio, fazendo com que seus cookies pareçam cookies primários. Quando a coleta de dados próprios é habilitada usando um CNAME, todos os cookies do seu domínio são enviados em solicitações feitas ao ponto de extremidade de coleta de dados.

Método 2: usar FPIDs em identityMap identityMap

Como alternativa ao armazenamento do FPID no seu próprio cookie, você pode enviar o FPID para a Edge Network por meio do mapa de identidade.

Veja abaixo um exemplo de como definir um FPID no identityMap:

{
  "identityMap": {
    "FPID": [
      {
        "id": "123e4567-e89b-42d3-9456-426614174000",
        "authenticatedState": "ambiguous",
        "primary": true
      }
    ]
  }
}

Assim como em outros tipos de identidade, você pode incluir o FPID com outras identidades em identityMap. O exemplo a seguir inclui o FPID com uma ID do CRM autenticada:

{
  "identityMap": {
    "FPID": [
      {
        "id": "123e4567-e89b-42d3-9456-426614174000",
        "authenticatedState": "ambiguous",
        "primary": false
      }
    ],
    "EMAIL": [
      {
        "id": "user@example.com",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

Se o FPID estiver contido em um cookie que está sendo lido pela Edge Network quando a coleta de dados primários estiver ativada, capture somente a ID do CRM autenticada:

{
  "identityMap": {
    "EMAIL": [
      {
        "id": "user@example.com",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

O seguinte identityMap resulta em uma resposta de erro do Edge Network porque o indicador primary para o FPID está ausente. Pelo menos uma das IDs presentes em identityMap deve ser marcada como primary.

{
  "identityMap": {
    "FPID": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "authenticatedState": "ambiguous"
      }
    ],
    "EMAIL": [
      {
        "id": "user@example.com",
        "authenticatedState": "authenticated"
      }
    ]
  }
}

Migração para FPIDs migrating-to-fpid

Se você estiver migrando de uma implementação anterior para IDs de dispositivo primário, pode ser difícil visualizar como a transição pode parecer em um nível baixo. Para ajudar a ilustrar esse processo, considere um cenário que envolva um cliente que visitou seu site anteriormente e qual impacto uma migração FPID teria em como esse cliente é identificado nas soluções da Adobe.