Show Menu
TOPICS×

getVisitorValues

Analytics에 대한 식별자, 즉 ID 서비스, 데이터 컬렉션 옵트아웃, 지리적 위치 및 메타데이터 "blob" 컨텐츠를 기본적으로 반환하는 비동기 API입니다. 또한 선택적 visitor.FIELDS 열거와 함께 반환할 ID를 제어할 수 있습니다.
내용:

구문

이 함수에서 사용하는 구문(기울임체는 변수 자리 표시자를 나타냄):
var *
* = visitor.getVisitorValues (callback, [visitor.FIELDS. *
ID 유형
*, visitor.FIELDS. *
ID 유형
*]);
함수 매개 변수 설명:
  • *
    callback
    *
    은 반환된 ID를 수신하는 고유한 콜백 코드를 나타냅니다.
  • (선택 사항)
    visitor.FIELDS. *
    ID 유형
    *
    은 이 함수가 반환할 ID 값 을 지정할 수 있는 열거형입니다.
자세한 내용은 다음 사용 사례 및 정의를 참조하십시오.

사용 사례 1: 기본 데이터 세트 요청

이 코드는 표준 데이터 세트를 반환합니다. 요청 및 응답이 다음 예와 비슷하게 보일 수 있습니다.
//Call the ID service var visitor = Visitor.getInstance ("Insert Experience Cloud organization ID here",{...}); //Add your callback to the GET method to return IDs and data. visitor.getVisitorValues(visitorIdsCallback);
기본 샘플 응답에서 일부 값은 데모 목적으로 축소되었습니다.
//Formatted IDs in JSON response { MCMID: 'mid-1234', MCOPTOUT: 'isoptedout-true', MCAID: 'aid-1234', MCAAMLH: 7, MCAAMB: 'hgfe54236786oygj' }

사용 사례 2: 사용자 지정 데이터 세트 요청

이 코드는
visitor.FIELDS
열거를 사용하여 특정 ID 세트를 반환하기 위해 선택적 배열을 사용합니다. 이 경우 방문자의 Experience Cloud ID(MCID)와 Analytics ID(MCAID)만 사용합니다. 요청 및 응답이 다음 예와 비슷하게 보일 수 있습니다.
//Call the ID service var visitor = Visitor.getInstance("Insert Experience Cloud organization ID here", { ... }); // Add an optional array to specify which IDs you want to return. visitor.getVisitorValues(visitorIdsCallback, [visitor.FIELDS.MCMID, visitor.FIELDS.MCAID]);
사용자 지정된 샘플 응답은 요청에 지정된 ID만 반환합니다.
//Formatted IDs in JSON response { MCMID: 'mid-1234', MCAID: 'aid-4321' }

정의된 응답 매개 변수

다음 표에는 응답 매개 변수 목록 및 정의가 나와 있습니다. 또한 이러한 매개 변수는
visitor.FIELDS
열거형의 모든 값입니다. 이 메서드는 특정 변수에 대한 값이 없는 경우 및 빈 문자열을 반환합니다.
설명
MCAAMB
"Blob"이라고도 하는 암호화된
Audience Manager
메타데이터입니다.
MCAAMLH
데이터 수집 영역 ID입니다. 특정 ID 서비스 데이터 센터의 지리적 위치에 대한 숫자 식별자입니다.
MCAID
방문자의
Analytics
ID입니다.
MCMID
방문자 Experience Cloud ID입니다.
MCOPTOUT
방문자가 데이터 수집을 해제했는지 여부를 나타내는 플래그입니다.
값은 다음과 같습니다.
  • 'isoptedout-true'
    : 방문자가 데이터 수집을 해제했습니다.
  • 'isoptedout-false'
    : 방문자가 데이터 수집을 해제하지 않았습니다.