getVisitorValues

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

내용:

• 구문
• 사용 사례 1: 기본 데이터 세트 요청
• 사용 사례 2: 사용자 지정 데이터 세트 요청
• 정의된 응답 매개 변수

구문

이 함수에서 사용하는 구문(기울임체는 변수 자리 표시자를 나타냄): 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 열거형의 모든 값입니다. 참고 사항으로, 이 메서드는 특정 변수에 대한 값이 없으면 빈 문자열을 반환합니다.