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 열거형의 모든 값입니다. 참고 사항으로, 이 메서드는 특정 변수에 대한 값이 없으면 빈 문자열을 반환합니다.

설명
MCAAMB
"Blob"이라고도 하는 암호화된 Audience Manager 메타데이터입니다.
MCAAMLH

데이터 수집 지역 ID. 특정 ID 서비스 데이터 센터의 지리적 위치에 대한 숫자 식별자입니다.

DCS 지역 ID, 위치 및 호스트 이름getLocationHint를 참조하십시오.

MCAID
방문자의 Analytics ID입니다.
MCMID

방문자의 Experience Cloud ID.

쿠키 및 Experience Cloud ID 서비스를 참조하십시오.

MCOPTOUT

방문자가 데이터 수집을 옵트아웃했는지 여부를 나타내는 플래그.

값에는 다음이 포함됩니다.

  • 'isoptedout-true': 방문자가 데이터 수집을 해제했습니다.
  • 'isoptedout-false': 방문자가 데이터 수집을 해제하지 않았습니다.
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a