appendIdentityToUrl
appendIdentityToUrl 명령을 사용하면 URL에 사용자 식별자를 쿼리 문자열로 추가할 수 있습니다. 이 작업을 사용하면 도메인 간에 방문자의 ID를 전달할 수 있으므로 도메인 또는 채널을 모두 포함하는 데이터 세트에 대해 방문자 수가 중복되지 않도록 합니다. 웹 SDK 버전 2.11.0 이상에서 사용할 수 있습니다.
URL에 추가되고 생성된 쿼리 문자열은 adobe_mc입니다. 웹 SDK에서 ECID를 찾을 수 없으면 /acquire 끝점을 호출하여 ECID를 생성합니다.
웹 SDK 확장을 사용하여 URL에 ID 추가 extension
URL에 ID 추가는 Adobe Experience Platform 데이터 수집 태그 인터페이스의 규칙 내에서 작업으로 수행됩니다.
- Adobe ID 자격 증명을 사용하여 experience.adobe.com에 로그인합니다.
- 데이터 수집 > 태그(으)로 이동합니다.
- 원하는 태그 속성을 선택합니다.
- 규칙(으)로 이동한 다음 원하는 규칙을 선택합니다.
- 작업에서 기존 작업을 선택하거나 작업을 만드십시오.
- 확장 드롭다운 필드를 Adobe Experience Platform Web SDK(으)로 설정하고 작업 유형을(를) ID로 리디렉션(으)로 설정합니다.
- 변경 내용 유지 를 클릭한 다음 게시 워크플로우를 실행하십시오.
이 명령은 일반적으로 클릭을 수신하고 원하는 도메인을 확인하는 특정 규칙과 함께 사용됩니다.
href 속성이 있는 앵커 태그를 클릭하면 트리거됩니다.
- 확장: 코어
- 이벤트 유형: 클릭
- 사용자가 클릭할 때: 특정 요소
- CSS 선택기와 일치하는 요소:
a[href]
원하는 도메인에서만 트리거됩니다.
- 논리 유형: 보통
- 확장: 코어
- 조건 유형: 값 비교
- 왼쪽 피연산자:
%this.hostname% - 연산자: Regex와 일치
- 오른쪽 피연산자: 원하는 도메인과 일치하는 정규 표현식입니다. 예,
adobe.com$|behance.com$
URL에 ID를 추가합니다.
- 확장: Adobe Experience Platform 웹 SDK
- 작업 유형: ID를 사용하여 리디렉션
웹 SDK JavaScript 라이브러리를 사용하여 URL에 ID 추가
URL을 매개 변수로 사용하여 appendIdentityToUrl 명령을 실행합니다. 이 메서드는 식별자가 추가된 URL을 쿼리 문자열로 반환합니다.
alloy("appendIdentityToUrl",document.location);
페이지에서 받은 모든 클릭에 대한 이벤트 리스너를 추가하고 URL이 원하는 도메인과 일치하는지 확인할 수 있습니다. 이 경우 ID를 URL에 추가하고 사용자를 리디렉션합니다.
document.addEventListener("click", event => {
// Check if the click was a link
const anchor = event.target.closest("a");
if (!anchor || !anchor.href) return;
// Check if the link points to the desired domain
const url = new URL(anchor.href);
if (!url.hostname.endsWith(".adobe.com") && !url.hostname.endsWith(".behance.com")) return;
// Append the identity to the URL, then direct the user to the URL
event.preventDefault();
alloy("appendIdentityToUrl", {url: anchor.href}).then(result => {document.location = result.url;});
});
응답 개체
이 명령을 사용하여 응답을 처리하기로 결정하는 경우 응답 개체에는 ID 정보가 쿼리 문자열 매개 변수로 추가된 새 URL인 url 이(가) 포함됩니다.