getVisitorValues getvisitorvalues
Analytics에 대한 식별자, 즉 ID 서비스, 데이터 컬렉션 옵트아웃, 지리적 위치 및 메타데이터 "blob" 콘텐츠를 기본적으로 반환하는 비동기 API입니다. 또한 선택적 visitor.FIELDS 열거와 함께 반환할 ID를 제어할 수 있습니다.
내용:
구문 section-5aebe3907b2b46e997f45a1d1ed35c09
이 함수에서 사용하는 구문(기울임체는 변수 자리 표시자를 나타냄): var *
값* = visitor.getVisitorValues (callback, [visitor.FIELDS. *
ID 유형*, visitor.FIELDS. *
ID 유형*]);
함수 매개 변수 설명:
*
callback*
은 반환된 ID를 수신하는 고유한 콜백 코드를 나타냅니다.- (선택 사항)
visitor.FIELDS. *
ID 유형*
은 이 함수가 반환할 ID 값을 지정할 수 있는 열거형입니다.
자세한 내용은 다음 사용 사례 및 정의를 참조하십시오.
사용 사례 1: 기본 데이터 세트 요청 section-36a31683558742a5915db3a391e09f7b
이 코드는 표준 데이터 세트를 반환합니다. 요청 및 응답은 다음 예제와 비슷합니다.
//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: 사용자 지정 데이터 세트 요청 section-467b2f4e513344c89b7332b05f6f59f3
이 코드는 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'
}
정의된 응답 매개 변수 section-4c4c300167694c6fbff1d6c612f372b5
다음 표에는 응답 매개 변수 목록 및 정의가 나와 있습니다. 또한 이러한 매개 변수는 visitor.FIELDS
열거형의 모든 값입니다. 참고 사항으로, 이 메서드는 특정 변수에 대한 값이 없으면 빈 문자열을 반환합니다.
데이터 수집 지역 ID. 특정 ID 서비스 데이터 센터의 지리적 위치에 대한 숫자 식별자입니다.
DCS 지역 ID, 위치 및 호스트 이름과 getLocationHint를 참조하십시오.
방문자의 Experience Cloud ID.
쿠키 및 Experience Cloud ID 서비스를 참조하십시오.
방문자가 데이터 수집을 옵트아웃했는지 여부를 나타내는 플래그.
값에는 다음이 포함됩니다.
- 'isoptedout-true': 방문자가 데이터 수집을 해제했습니다.
- 'isoptedout-false': 방문자가 데이터 수집을 해제하지 않았습니다.