이 페이지에서는 서버 SDK configure 메서드의 idMigrationEnabled에 대해 설명합니다. 웹 SDK에 대해서는 idMigrationEnabled.을(를) 참조하십시오.
idMigrationEnabled 속성을 사용하면 Server SDK에서 기존 Adobe 방문자 ID 서비스(VisitorAPI.js)가 방문자에게 할당한 ECID(Experience Cloud ID)를 다시 사용할 수 있습니다. 방문자 ID 서비스는 ECID를 AMCV_<orgId> 쿠키에 저장합니다. 이러한 ID를 재사용하면 방문자 ID 서비스에서 웹 SDK 또는 서버 SDK으로 이동할 때 고유 방문자 수가 급격히 증가하는 것을 방지할 수 있습니다.
서버에서 ID 마이그레이션이 작동하는 방식 how-it-works
SDK은 사용자가 forRequest에 전달하는 쿠키 서비스를 통해 쿠키를 읽고 씁니다. idMigrationEnabled이(가) true인 경우:
- 방문자에게
kndctr_<orgId>_identity쿠키가 없지만AMCV_<orgId>쿠키가 있는 경우 SDK이AMCV_쿠키에서 ECID를 읽고 이벤트의identityMap에 추가합니다. 그런 다음 Edge Network은 방문자에 대해 해당 ECID를 계속 사용합니다. - Edge Network이 방문자의 ID를 반환하면 SDK은
kndctr_<orgId>_identity쿠키와AMCV_<orgId>쿠키 모두에 ID를 기록하므로 여전히 방문자 ID 서비스를 사용하는 페이지는 동일한 방문자를 인식합니다.
ID 마이그레이션은 쿠키 서비스가 SDK에 방문자의 실제 브라우저 쿠키에 대한 액세스 권한을 제공하는 경우에만 작동하며 방문자 ID 서비스가 동일한 orgId을(를) 사용하는 동일한 도메인에서 실행된 경우에만 작동합니다. 방문자 ID 서비스 라이브러리는 브라우저에서만 실행되므로 서버 SDK에서 해당 ID 자체를 읽을 수 없습니다.
쿠키 서비스가 방문자의 브라우저 쿠키를 읽지 않거나 사이트에서 방문자 ID 서비스를 사용한 적이 없는 경우 ID 마이그레이션은 효과가 없습니다.
코드 예
configure을(를) 호출할 때 idMigrationEnabled 부울을 설정합니다. 생략하면 기본값은 true입니다. SDK에서 AMCV_ 쿠키를 읽고 쓰지 못하게 하려면 false(으)로 설정합니다.
await alloy.configure({
datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
edgeCredentials: {
clientId: process.env.ADOBE_CLIENT_ID,
clientSecret: process.env.ADOBE_CLIENT_SECRET,
scopes: process.env.ADOBE_SCOPES.split(",")
},
idMigrationEnabled: false
});