setAudience
setAudience(String sessionID, NameValuePairImpl[] audienceID, 
String audienceLevel, NameValuePairImpl[] parameters)
setAudience 메소드를 사용하여 방문자에 대해 대상 ID 및 레벨을 설정할 수 있습니다.
*
sessionID - 세션 ID를 식별하는 문자열입니다.
*
audienceID - 대상 ID를 정의하는 NameValuePairImpl 오브젝트의 배열입니다.
*
audienceLevel - 대상 레벨을 정의하는 문자열입니다.
*
parameters - setAudience와 함께 전달해야 하는 매개변수를 식별하는 NameValuePairImpl 오브젝트입니다. 이 값은 세션 데이터에 저장되며 세그먼트에 사용할 수 있습니다.
프로파일의 모든 열에 대해 값이 있어야 합니다. 이는 대화식 채널 및 실시간 데이터에 대해 정의된 모든 테이블에 있는 모든 열의 상위 집합입니다. 모든 세션 데이터를 startSession 또는 postEvent로 이미 채운 경우, 새 매개변수를 보내지 않아도 됩니다.
setAudience 메소드는 재세그먼트를 트리거합니다. getOffers 메소드는 실행 전에 재세그먼트가 완료되기를 기다립니다. 따라서 getOffers 호출 직전에 setAudience 메소드를 호출하면 지연이 있습니다.
setAudience 메소드는 대상 ID에 대한 프로파일 데이터도 로드합니다. setAudience 메소드를 사용하여 startSession 메소드가 로드한 동일한 프로파일 데이터를 강제로 다시 로드할 수 있습니다.
리턴 값
런타임 서버는 다음 속성이 채워진 Response 오브젝트로 setAudience에 응답합니다.
*
*
*
*
이 예의 경우, 대상 레벨은 동일하지만 마치 익명의 사용자가 로그인하여 알려지는 것처럼 ID가 변경됩니다.
sessionIdaudienceLevel은 이 세션을 시작한 startSession 호출에서 사용되는 세션 및 대상 레벨을 식별할 동일한 문자열입니다.
NameValuePair custId2 = new NameValuePairImpl();
custId2.setName("CustomerId");
custId2.setValueAsNumeric(123.0);
custId2.setValueDataType(NameValuePair.DATA_TYPE_NUMERIC);

NameValuePair[] newAudienceId = { custId2 };

/** Parameters can be passed in as well. For this example, there are no parameters,
* therefore pass in null */
NameValuePair[] noParameters=null;

/** Make the call */
response = api.setAudience(sessionId, newAudienceId, audienceLevel, noParameters);

/** Process the response appropriately */
// check if response is successful or not
if(response.getStatusCode() == Response.STATUS_SUCCESS)
{
System.out.println("setAudience call processed with no warnings or errors");
}
else if(response.getStatusCode() == Response.STATUS_WARNING)
{
System.out.println("setAudience call processed with a warning");
}
else
{
System.out.println("setAudience call processed with an error");
}

// For any non-successes, there should be advisory messages explaining why
if(response.getStatusCode() != Response.STATUS_SUCCESS)
printDetailMessageOfWarningOrError("setAudience",
response.getAdvisoryMessages());