Web SDK의 자사 디바이스 ID

Adobe Experience Platform Web SDK는 Adobe Experience Cloud ID (ECID) 쿠키를 사용하여 웹 사이트 방문자에게 알리고 사용자 행동을 추적합니다. 쿠키 수명에 대한 브라우저 제한 사항을 고려하기 위해 대신 고유한 장치 식별자를 설정하고 관리하도록 선택할 수 있습니다. 이를 자사 디바이스 ID(FPID)라고 합니다.

이 문서에서는 Platform Web SDK 구현을 위한 자사 디바이스 ID를 구성하는 방법을 다룹니다.

전제 조건

이 안내서에서는 사용자가 ECID 및 의 역할을 포함하여 Platform Web SDK에 대해 ID 데이터가 작동하는 방식을 잘 알고 있다고 가정합니다. identityMap. 의 개요 보기 웹 SDK의 ID 데이터 추가 정보.

FPID 사용

FPID는 자사 쿠키를 사용하여 방문자를 추적합니다. 자사 쿠키는 DNS를 사용하는 서버를 사용하여 설정할 때 가장 효과적입니다 레코드 (IPv4의 경우) 또는 AAAA 레코드 DNS CNAME 또는 JavaScript 코드가 아닌 IPv6의 경우.

FPID 쿠키가 설정되면 해당 값을 가져와 이벤트 데이터가 수집될 때 Adobe으로 보낼 수 있습니다. 수집된 FPID는 시드로 사용되어 ECID를 생성하는데, 이 ECID는 Adobe Experience Cloud 애플리케이션에서 계속 기본 식별자가 됩니다.

웹 사이트 방문자에 대한 FPID를 Platform Edge Network로 보내려면 identityMap 해당 방문자에 대해. 이 문서의 뒷부분에서 섹션 참조 에서 FPID 사용 identityMap 추가 정보.

ID 형식 요구 사항

Platform Edge Network는 UUIDv4 형식. UUIDv4 형식이 아닌 장치 ID는 거부됩니다.

UUID를 생성하면 거의 항상 고유한 임의 ID가 생성되며 충돌이 발생할 확률은 무시할 수 있습니다. UUIDv4는 IP 주소 또는 기타 PII(개인 식별 정보)를 사용하여 시드할 수 없습니다. UUID는 어디에나 존재하며 거의 모든 프로그래밍 언어에 대해 라이브러리를 찾아 생성할 수 있습니다.

데이터스트림 UI에서 자사 ID 쿠키 설정 setting-cookie-datastreams

데이터 스트림 UI에서 쿠키 이름을 지정할 수 있습니다. 여기서, FPID 는 쿠키 값을 읽고 ID 맵에 FPID를 포함하지 않고 상주할 수 있습니다.

다음을 참조하십시오. 데이터스트림 설명서 데이터 스트림을 구성하는 방법에 대한 자세한 정보입니다.

데이터 스트림을 구성할 때 다음을 활성화합니다. 자사 ID 쿠키 옵션을 선택합니다. 이 설정은 Edge Network가 자사 디바이스 ID를 조회할 때에서 이 값을 조회하지 않고 지정된 쿠키를 참조하도록 합니다 ID 맵.

다음에서 설명서를 참조하십시오. 자사 쿠키 Adobe Experience Cloud에서 작동하는 방식에 대한 자세한 내용.

이 설정을 활성화할 때 ID가 저장될 쿠키의 이름을 제공해야 합니다.

자사 ID를 사용하는 경우 타사 ID 동기화를 수행할 수 없습니다. 타사 ID 동기화는 Visitor ID 서비스 및 UUID 생성된 서비스입니다. 자사 ID 기능을 사용하는 경우 를 사용하지 않고 ECID가 생성됩니다 Visitor ID 서드파티 ID 동기화를 불가능하게 하는 서비스.

자사 ID를 사용하는 경우, Audience Manager 파트너 ID 동기화가 대부분 를 기반으로 한다는 점에서 Audience Manager 플랫폼의 활성화를 대상으로 하는 파트너 기능은 지원되지 않습니다 UUIDs 또는 DIDs. 자사 ID에서 파생된 ECID가 UUID를 사용하여 주소를 지정할 수 없습니다.

자체 서버를 사용하여 쿠키 설정

소유한 서버를 사용하여 쿠키를 설정할 때 브라우저 정책으로 인해 쿠키가 제한되지 않도록 하기 위해 다양한 방법을 사용할 수 있습니다.

쿠키 설정 시기

FPID 쿠키는 Edge Network에 요청하기 전에 이상적으로 설정해야 합니다. 단, 그럴 수 없는 시나리오에서는 기존 메서드를 사용하여 ECID가 여전히 생성되고 쿠키가 존재하는 한 기본 식별자 역할을 합니다.

ECID가 결국 브라우저 삭제 정책의 영향을 받지만 FPID가 영향을 받지 않는다고 가정할 경우 FPID는 다음 방문에서 기본 식별자가 되고 각 후속 방문에서 ECID를 시드하는 데 사용됩니다.

쿠키 만료 설정

쿠키의 만료를 설정하는 것은 FPID 기능을 구현할 때 신중하게 고려해야 하는 사항입니다. 이를 결정할 때는 각 지역의 법률 및 정책과 함께 조직이 운영되는 국가 또는 지역을 고려해야 합니다.

이 결정의 일부로 회사 전체의 쿠키 설정 정책 또는 운영하는 각 로케일에서 사용자에 따라 달라지는 정책을 채택할 수 있습니다.

쿠키의 초기 만료에 대해 선택하는 설정에 관계없이 사이트를 새로 방문할 때마다 쿠키 만료를 확장하는 논리를 포함해야 합니다.

쿠키 플래그의 영향

다양한 브라우저에서 쿠키가 처리되는 방식에 영향을 주는 다양한 쿠키 플래그가 있습니다.

HTTPOnly http-only

를 사용하여 설정된 쿠키 HTTPOnly 클라이언트측 스크립트를 사용하여 플래그에 액세스할 수 없습니다. 즉, 다음을 설정하면 HTTPOnly flag fpid를 설정할 때 를 포함할 쿠키 값을 읽으려면 서버측 스크립팅 언어를 사용해야 합니다 identityMap.

Platform Edge Network가 FPID 쿠키의 값을 읽도록 선택한 경우 HTTPOnly 플래그를 사용하면 클라이언트측 스크립트가 해당 값에 액세스할 수 없지만 Platform Edge Network의 쿠키 읽기 기능에 부정적인 영향을 주지 않습니다.

Secure secure

로 설정된 쿠키 Secure 속성은 HTTPS 프로토콜을 통해 암호화된 요청을 통해 서버로만 전송됩니다. 이 플래그를 사용하면 중간자 공격자가 쿠키의 값에 쉽게 액세스할 수 없게 됩니다. 가능하면 항상 를 설정하는 것이 좋습니다. Secure 플래그.

SameSite same-site

다음 SameSite 속성을 사용하면 서버에서 쿠키가 사이트 간 요청으로 전송되는지 여부를 확인할 수 있습니다. 속성은 크로스 사이트 위조 공격으로부터 일부 보호를 제공합니다. 세 가지 가능한 값이 있습니다. Strict, Lax, 및 None. 조직에 적합한 설정을 결정하려면 내부 팀에 문의하십시오.

없는 경우 SameSite 속성을 지정했습니다. 이제 일부 브라우저의 기본 설정이 SameSite=Lax.

에서 FPID 사용 identityMap identityMap

아래는에서 FPID를 설정하는 방법의 예입니다. identityMap:

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

다른 ID 유형과 마찬가지로 FPID를 다른 ID와 함께 포함할 수 있습니다 identityMap. 다음은 인증된 CRM ID에 포함된 FPID의 예입니다.

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

자사 데이터 수집이 활성화될 때 Edge Network에서 읽는 쿠키에 FPID가 포함되어 있으면 인증된 CRM ID만 캡처해야 합니다.

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

다음 identityMap 가 누락되면 Edge Network에서 오류 응답이 발생합니다. primary FPID에 대한 표시기. 에 있는 ID 중 하나 이상 identityMap 은(는) (으)로 표시되어야 합니다. primary.

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

이 경우 Edge Network에서 반환하는 오류 응답은 다음과 비슷합니다.

{
    "type": "https://ns.adobe.com/aep/errors/EXEG-0306-400",
    "status": 400,
    "title": "No primary identity set in request (event)",
    "detail": "No primary identity found in the input event. Update the request accordingly to your schema and try again.",
    "report": {
        "requestId": "{REQUEST_ID}",
        "configId": "{CONFIG_ID}",
        "orgId": "{ORG_ID}"
    }
}

계층

ECID와 FPID가 모두 존재하는 경우, ECID는 사용자를 식별하는 데 우선 순위가 지정됩니다. 이렇게 하면 기존 ECID가 브라우저 쿠키 저장소에 있을 때 기본 식별자로 유지되며 기존 방문자 수가 영향을 받지 않습니다. 기존 사용자의 경우 FPID는 ECID가 만료되거나 브라우저 정책 또는 수동 프로세스의 결과로 삭제될 때까지 기본 ID가 되지 않습니다.

ID는 다음 순서로 우선 순위가 지정됩니다.

자사 디바이스 ID로 마이그레이션

이전 구현에서 FPID를 사용하여 마이그레이션하는 경우 낮은 수준에서 전환이 어떻게 보이는지 시각화하기 어려울 수 있습니다.

이 프로세스를 설명하는 데 도움이 되도록 이전에 사이트를 방문한 고객이 포함된 시나리오와 FPID 마이그레이션이 Adobe 솔루션에서 해당 고객을 식별하는 방법에 미칠 영향을 고려하십시오.

FAQ

다음은 자사 디바이스 ID에 대한 FAQ 응답 목록입니다.

ID 시드는 단순히 ID를 생성하는 것과 어떻게 다릅니까?

시드의 개념은 Adobe Experience Cloud에 전달된 FPID가 결정론적 알고리즘을 사용하여 ECID로 변환된다는 점에서 독특합니다. 동일한 FPID가 Adobe Experience Platform Edge Network로 전송될 때마다 동일한 ECID가 FPID에서 시드됩니다.

자사 디바이스 ID는 언제 생성해야 합니까?

잠재적 방문자 인플레이션을 줄이려면 Web SDK를 사용하여 첫 번째 요청을 수행하기 전에 FPID를 생성해야 합니다. 그러나 이렇게 할 수 없는 경우 해당 사용자에 대한 ECID가 계속 생성되고 기본 식별자로 사용됩니다. 생성된 FPID는 ECID가 더 이상 존재하지 않을 때까지 기본 식별자가 되지 않습니다.

자사 디바이스 ID를 지원하는 데이터 수집 방법

현재 Web SDK만 FPID를 지원합니다.

FPID가 플랫폼 또는 Experience Cloud 솔루션에 저장됩니까?

FPID를 사용하여 ECID를 시드하면 identityMap 및 가 생성된 ECID로 대체되었습니다. FPID는 Adobe Experience Platform 또는 Experience Cloud 솔루션에 저장되지 않습니다.