[Alpha]{class="badge informative"}

setConsent(서버 SDK)

이 페이지에서는 Server SDK setConsent 메서드를 설명합니다. 웹 SDK에 대해서는 setConsent.​을(를) 참조하십시오.

setConsent 메서드는 서버 SDK에 방문자에 대한 데이터를 보낼 수 있는지(옵트인) 아니면 버려야 하는지(옵트아웃) 여부를 알려줍니다. SDK은 방문자의 환경 설정을 Edge Network으로 보낸 다음, forRequest에 전달하는 쿠키 서비스를 통해 결과를 kndctr_<orgId>_consent 쿠키에 저장합니다.

SDK은 다음 동의 표준을 지원합니다.

이 메서드는 createInstance에 기본적으로 포함된 동의 구성 요소가 인스턴스에 포함된 경우에만 사용할 수 있습니다.

방문자에 대한 setConsent 호출 call

동의는 단일 방문자에 속하므로 항상 해당 방문자의 forRequest 핸들에서 setConsent을(를) 호출하고 최상위 인스턴스에서는 호출하지 마십시오. 다음 예에서는 Adobe 2.0 표준을 사용합니다.

const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });

await visitor.setConsent({
  consent: [{
    standard: "Adobe",
    version: "2.0",
    value: {
      collect: { val: "y" }
    }
  }]
});

다음 예에서는 Adobe 1.0 표준을 사용합니다.

await visitor.setConsent({
  consent: [{
    standard: "Adobe",
    version: "1.0",
    value: { general: "in" }
  }]
});

다음 예에서는 IAB TCF 2.0 표준을 사용합니다.

await visitor.setConsent({
  consent: [{
    standard: "IAB TCF",
    version: "2.0",
    value: "CO052l-O052l-DGAMBFRACBgAIBAAAAAAIYgEawAQEagAAAA",
    gdprApplies: true
  }]
});

IAB TCF 표준을 사용하며 방문자의 프로필에 동의 데이터를 원하는 경우, 이벤트 xdm 개체에도 IAB 동의 정보를 포함하십시오. SDK에서는 이 값을 이벤트에 자동으로 추가하지 않습니다.

동의가 기억되는 방식 stored-consent

SDK은 사용자가 forRequest에 전달하는 cookie 서비스를 통해 동의 쿠키를 읽고 씁니다.

SDK은 방문자에 대해 동일한 환경 설정을 이미 보낸 경우 요청을 건너뜁니다. storage 서비스를 통해 보낸 환경 설정을 추적하므로 이 검사는 해당 방문자의 storage 서비스을(를) forRequest에 전달하는 경우에만 요청 간에 작동합니다. 그렇지 않으면, 각 호출은 방문자의 환경 설정이 변경되지 않았더라도 Edge Network에 요청을 보냅니다. 모든 요청이 아닌 방문자가 동의 선택을 하거나 변경하면 setConsent에 호출합니다.

요청이 인증되지 않았습니다. 데이터 스트림이 인증되지 않은 요청을 수락하는지 확인하십시오. 데이터 스트림 액세스 형식 설정을 참조하십시오.

옵션 options

setConsent 메서드는 다음 속성을 가진 개체를 허용합니다.

결과 개체 result

setConsent 메서드는 Edge Network이 동의 환경 설정을 수락하면 빈 개체로 확인되는 약속을 반환합니다.