Web SDK의 자사 디바이스 ID

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

이 문서에서는 웹 SDK 구현을 위한 자사 디바이스 ID를 구성하는 방법을 설명합니다.

전제 조건

이 안내서에서는 사용자가 ECID 및 identityMap의 역할을 포함하여 Platform Web SDK에서 ID 데이터가 작동하는 방식을 잘 알고 있다고 가정합니다. 자세한 내용은 Web SDK의 ID 데이터에 대한 개요를 참조하십시오.

자사 디바이스 ID(FPID) 사용 using-fpid

자사 장치 ID(FPIDs)는 자사 쿠키를 사용하여 방문자를 추적합니다. 자사 쿠키는 DNS CNAME 또는 JavaScript 코드와 반대로 DNS A 레코드(IPv4의 경우) 또는 AAAA 레코드(IPv6의 경우)을 사용하는 서버를 사용하여 설정할 때 가장 효과적입니다.

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

웹 사이트 방문자의 FPID을(를) Edge Network에 보내려면 해당 방문자의 identityMap에 FPID을(를) 포함해야 합니다. 자세한 내용은 이 문서의 아래쪽에서 identityMap🔗에서 FPID 사용 에 대한 섹션을 참조하십시오.

자사 디바이스 ID 형식 요구 사항 formatting-requirements

Edge Network은 UUIDv4 형식을(를) 준수하는 IDs만 허용합니다. UUIDv4 형식이 아닌 장치 ID가 거부됩니다.

UUID을(를) 생성하면 거의 항상 고유한 임의 ID가 생성되며 충돌이 발생할 가능성은 거의 없습니다. IP 주소 또는 기타 개인 식별 정보(PII)를 사용하여 UUIDv4을(를) 시드할 수 없습니다. UUIDs은(는) 어디서나 사용할 수 있으며, 대부분의 프로그래밍 언어에서 라이브러리를 생성할 수 있습니다.

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

쿠키 값을 읽고 ID 맵에 FPID을(를) 포함하는 대신 FPID이(가) 있을 수 있는 Datastreams 사용자 인터페이스에서 쿠키 이름을 지정할 수 있습니다.

데이터 스트림을 구성하는 방법에 대한 자세한 내용은 데이터 스트림 설명서를 참조하십시오.

데이터 스트림을 구성할 때 자사 ID 쿠키 옵션을 사용하도록 설정하십시오. 이 설정은 Edge Network에게 ID 맵에서 이 값을 조회하는 대신 자사 장치 ID를 조회할 때 지정된 쿠키를 참조하도록 지시합니다.

Adobe Experience Cloud 사용 방법에 대한 자세한 내용은 자사 쿠키에 대한 설명서를 참조하십시오.

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

자사 ID를 사용하는 경우 타사 ID 동기화를 수행할 수 없습니다. 타사 ID 동기화는 Visitor ID 서비스와 해당 서비스에서 생성한 UUID을(를) 사용합니다. 자사 ID 기능을 사용하는 경우 Visitor ID 서비스를 사용하지 않고 ECID이(가) 생성되므로 타사 ID를 동기화할 수 없습니다.

자사 ID를 사용하는 경우 Audience Manager 파트너 ID 동기화가 대부분 UUIDs 또는 DIDs을(를) 기반으로 하는 경우 Audience Manager 플랫폼에서 활성화되도록 타깃팅된 파트너 기능이 지원되지 않습니다. 자사 ID에서 파생된 ECID이(가) UUID에 연결되어 있지 않으므로 주소를 지정할 수 없습니다.

자체 서버를 사용하여 쿠키 설정 set-cookie-server

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

쿠키 설정 시기 when-to-set-cookie

Edge Network에 요청하기 전에 FPID 쿠키를 설정하는 것이 좋습니다. 그러나 불가능한 시나리오에서는 여전히 기존 메서드를 사용하여 ECID이(가) 생성되고 쿠키가 존재하는 한 기본 식별자 역할을 합니다.

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

쿠키 만료 설정 set-expiration

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

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

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

쿠키 플래그의 영향 cookie-flag-impact

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

HTTPOnly http-only

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

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

Secure secure

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

SameSite same-site

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

SameSite 특성이 지정되지 않은 경우 일부 브라우저의 기본 설정은 이제 SameSite=Lax입니다.

identityMap에서 FPID 사용 identityMap

다음은 identityMap에서 FPID을(를) 설정하는 방법의 예입니다.

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

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

{
  "identityMap": {
    "FPID": [
      {
        "id": "123e4567-e89b-42d3-9456-426614174000",
        "authenticatedState": "ambiguous",
        "primary": false
      }
    ],
    "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은(는) FPID에 대한 primary 표시기가 없으므로 Edge Network에서 오류 응답을 생성합니다. identityMap에 있는 ID 중 적어도 하나는 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}"
    }
}

자체 도메인에서 FPID 설정 setting-fpid-domain

ID 맵에서 FPID을(를) 설정하는 것 외에도 자사 데이터 컬렉션 CNAME이(가) 구성되어 있는 경우 자체 도메인에 FPID 쿠키를 설정할 수 있습니다.

CNAME을(를) 사용하여 자사 데이터 수집을 사용하도록 설정하면 데이터 수집 끝점에 대한 요청 시 도메인에 대한 모든 쿠키가 전송됩니다.

Adobe의 데이터 수집 목적과 관련이 없는 모든 쿠키가 삭제됩니다. FPID의 경우 데이터 스트림 구성에서 FPID 쿠키의 이름을 지정할 수 있습니다. 이렇게 하면 Edge Network이 ID 맵에서 FPID을(를) 찾는 대신 FPID 쿠키의 내용을 읽게 됩니다.

이 기능을 사용하려면 특정 하위 도메인 대신 도메인의 최상위 수준에서 FPID을(를) 설정해야 합니다. 하위 Edge Network에 설정하면 쿠키 값이 도메인으로 전송되지 않으며 FPID 솔루션이 의도한 대로 작동하지 않습니다.

계층 id-hierarchy

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

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

자사 디바이스 ID로 마이그레이션 migrating-to-fpid

이전 구현에서 자사 디바이스 ID로 마이그레이션하는 경우 낮은 수준에서 전환이 어떻게 보이는지 시각화하기 어려울 수 있습니다.

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

FAQ faq

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

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

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

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

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

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

현재 Web SDK만 자사 디바이스 ID를 지원합니다.

자사 디바이스 ID가 플랫폼 또는 Experience Cloud 솔루션에 저장됩니까?

FPID을(를) 사용하여 ECID을(를) 시드하면 identityMap에서 삭제되고 생성된 ECID (으)로 대체됩니다. FPID이(가) Adobe Experience Platform 또는 Experience Cloud 솔루션에 저장되지 않았습니다.