[Alpha]{class="badge informative"}

appendIdentityToUrl(서버 SDK)

이 페이지에서는 Server SDK appendIdentityToUrl 메서드를 설명합니다. 웹 SDK에 대해서는 appendIdentityToUrl.​을(를) 참조하십시오.

appendIdentityToUrl 메서드는 방문자의 ID를 URL에 adobe_mc(이)라는 쿼리 문자열 매개 변수로 추가합니다. 방문자가 소유한 다른 도메인의 URL을 따라가면 해당 도메인의 웹 SDK 또는 서버 SDK이 매개 변수를 읽고 동일한 Experience Cloud ID(ECID)를 유지합니다. 이렇게 하면 방문자가 두 도메인을 모두 포함하는 데이터 세트에서 두 번 계산되지 않습니다.

서버에서 일반적인 용도는 방문자의 ID를 다른 도메인으로 리디렉션하는 것입니다.

const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });

const { url } = await visitor.appendIdentityToUrl({
  url: "https://shop.example.net/checkout"
});

res.writeHead(302, { Location: url });
res.end();

결과 URL은 다음과 유사합니다.

https://shop.example.net/checkout?adobe_mc=TS%3D1792711449%7CMCMID%3D34567890123456789012345678901234567890%7CMCORGID%3DADB3LETTERSANDNUMBERS%2540AdobeOrg

SDK에 아직 방문자의 ECID가 없는 경우 Edge Network에서 먼저 요청합니다. 해당 요청은 인증되지 않았습니다. 데이터 스트림 액세스 형식 설정을 참조하십시오.

방문자가 옵트아웃했거나 defaultConsent이(가) "out"이고 방문자가 옵트인하지 않은 경우 메서드는 URL을 변경하지 않고 반환합니다. 또한 예를 들어 네트워크 오류로 인해 방문자의 ID를 가져올 수 없는 경우 거부하지 않고 URL을 반환합니다. 디버깅이 켜져 있으면 SDK에서 Unable to append identity to url을(를) 포함하는 경고를 기록합니다.

옵션 options

appendIdentityToUrl 메서드는 다음 속성을 가진 개체를 허용합니다.

결과 개체 result

appendIdentityToUrl 메서드가 약속을 반환합니다. 확인되는 경우 결과 개체에 adobe_mc 쿼리 문자열 매개 변수가 추가된 URL이 url​이(가) 포함되어 있습니다.