프로필 속성

Adobe Target의 프로필 속성은 방문자와 관련된 매개변수입니다. 이러한 속성은 방문자의 프로필에 저장되어 활동에 사용할 수 있는 방문자에 대한 정보를 제공합니다.

사용자 프로필에는 웹 페이지 방문자의 인구학적, 행동적 정보가 포함되어 있습니다. 이 정보에는 연령, 성별, 구매한 제품, 마지막 방문 시간 등이 포함될 수 있습니다. Target은 이 정보를 사용하여 해당 방문자에게 제공되는 콘텐츠를 개인화합니다.

방문자가 웹 사이트를 탐색할 때 또는 방문자가 다른 세션으로 돌아갈 때 프로필에 저장된 프로필 속성을 사용하여 세그먼트 필터링에 콘텐츠 또는 로그 정보를 타겟팅할 수 있습니다.

프로필 속성을 설정하려면:

  1. 대상자 > 프로필 스크립트 ​를 클릭합니다.

    프로필 스크립트 탭

  2. 스크립트 만들기 ​를 클릭합니다.

    프로필 스크립트 만들기 대화 상자

    다음 유형의 프로필 속성을 사용할 수 있습니다.

    table 0-row-2 1-row-2 2-row-2
    매개변수 유형 설명
    mbox

    mbox를 만들 때 페이지 코드를 통해 직접 전달됩니다. Target 개발자 안내서 ​의 글로벌 Mbox에 매개변수 전달을 참조하십시오.

    참고: Target에는 mbox 호출당 50개의 고유 프로필 속성 제한이 있습니다. Target에 50개 이상의 프로필 속성을 전달해야 하는 경우 프로필 업데이트 API 방법을 사용하십시오. 자세한 내용은 Target 개발자 안내서 ​의 프로필 업데이트를 참조하십시오.

    프로필 JavaScript 코드 스니펫으로 바로 정의됩니다. 이들 스니펫은 소비자가 소비한 금액 합계와 같이 실행 중인 합계를 저장할 수 있으며 각 mbox 요청에 대해 실행됩니다. 아래의 프로필 스크립트 속성 ​을 참조하십시오.

프로필 스크립트 속성 concept_8C07AEAB0A144FECA8B4FEB091AED4D2

연결된 JavaScript 코드 스니펫으로 프로필 스크립트 속성을 정의합니다.

프로필 스크립트를 사용하여 여러 방문에서 방문자 속성을 캡처할 수 있습니다. 프로필 스크립트는 서버측 JavaScript 형식을 사용하여 Target 내에서 정의된 코드 스니펫입니다. 예를 들어 프로필 스크립트를 사용하여 방문자가 사이트를 방문하는 빈도 및 해당 방문자가 마지막으로 방문한 날짜를 캡처할 수 있습니다.

프로필 스크립트는 프로필 매개변수와 다릅니다. 프로필 매개변수는 Target의 mbox 코드 구현을 사용하는 방문자에 대한 정보를 캡처합니다.

프로필 스크립트 만들기 section_CB02F8B97CAF407DA84F7591A7504810

프로필 스크립트는 Target 인터페이스의 대상자 탭에서 사용할 수 있습니다.

프로필 스크립트를 추가하려면 프로필 스크립트 탭, 스크립트 만들기 ​를 클릭한 다음 스크립트를 작성합니다.

또는

기존 프로필 스크립트를 복사하려면 프로필 스크립트 목록에서 원하는 스크립트에 대한 생략 아이콘을 클릭한 다음 복제 ​를 클릭합니다.

그러면 대상자를 편집하여 유사한 대상자를 만들 수 있습니다.

프로필 스크립트는 각 추적 요청에 대해 프로필 속성 “catchers”를 실행합니다. 추적 요청이 수신되면 Target은 실행해야 하는 활동을 결정하고 해당 활동 및 경험에 적합한 콘텐츠를 표시합니다. 또한 Target은 활동의 성공을 추적하고 관련된 모든 프로필 스크립트를 실행합니다. 이 프로세스를 통해 방문자의 위치, 시각, 방문자가 사이트에 있었던 횟수, 전에 구입한 적이 있었는지 여부 등과 같은 방문에 대한 정보를 추적할 수 있습니다. 그런 다음 이러한 정보가 방문자의 프로필에 추가되므로 방문자의 사이트 활동을 더 잘 추적할 수 있습니다.

프로필 스크립트 속성은 속성 이름 앞에 user. 태그가 삽입되어 있습니다. 예:

if (mbox.name == 'Track_Interest') {
    if (profile.get('model') == "A5" &&; profile.get('subcat') == "KS6") {
        return (user.get('A5KS6') || 0) + 1;
    }
}

다음 정보를 참고하십시오.

  • user.get('parameterName')이 있는 코드의 프로필 스크립트 속성(자체 포함)을 참조합니다.

  • 다음에 user.setLocal('variable_name', 'value')를 사용하여 스크립트가 실행될 때(다음 mbox 요청에 대해) 액세스할 수 있는 변수를 저장합니다. user.getLocal('variable_name')을 사용하여 변수를 참조합니다. 이 프로세스는 마지막 요청 날짜 및 시간을 참조하고자 하는 상황에 유용합니다.

    이러한 값은 프로필 스크립트처럼 유지되지만 설정된 스크립트 내에서만 액세스할 수 있습니다.

  • 매개변수 및 값은 대/소문자를 구분합니다. 활동 또는 테스트 도중 수신하는 매개변수 및 값의 대/소문자를 일치시키십시오.

  • 자세한 JavaScript 구문에 대해서는 아래의 “스크립트 프로필 매개변수에 대한 JavaScript 참조” 섹션을 참조하십시오.

  • 이 매개변수는 스크립트를 비활성화한 후에도 프로필에 남아 있습니다. 프로필에 이미 활동 대상자에 사용되는 매개변수가 포함되어 있는 사용자는 해당 활동에 참여할 자격이 있습니다.

  • 프로필 스크립트를 활동에서 사용하는 동안에는 삭제할 수 없습니다.

  • 한 프로필 스크립트의 결과를 다른 프로필 스크립트에서 사용하는 종속 프로필 스크립트를 생성하는 것은 권장되지 않습니다. 프로필 스크립트 실행 순서는 보장되지 않습니다.

프로필 스크립트 정보 카드 보기 section_18EA3B919A8E49BBB09AA9215E1E3F17

오퍼 정보 카드와 유사한 프로필 스크립트 정보 팝업 카드를 볼 수 있습니다. 이러한 프로필 스크립트 정보 카드를 사용하면 선택한 프로필 스크립트를 참조하는 활동 목록과 함께 다른 유용한 메타데이터를 볼 수 있습니다.

예를 들어 다음 프로필 스크립트 정보 카드는 목록(대상자 > 프로필 스크립트)에서 원하는 프로필 스크립트에 대한 정보 아이콘을 클릭하여 사용할 수 있습니다.

스크립트 정보 탭에는 이름, 설명 및 스크립트 코드가 포함됩니다.

프로필 스크립트 정보 카드

선택한 프로필 스크립트를 참조하는 대상자 및 활동을 보려면 세부 정보 보기 ​를 클릭하십시오.

프로필 스크립트 정보 카드 > 스크립트 사용 탭

NOTE
스크립트 사용 탭에는 다음과 같은 경우 선택한 프로필 스크립트를 참조하는 활동이 표시되지 않습니다.
  • 활동이 초안 상태입니다.
  • 활동에 사용된 콘텐츠 또는 오퍼가 스크립트 변수(활동 내의 인라인 오퍼 또는 오퍼 라이브러리 내의 오퍼)를 사용합니다.

Target이 프로필 스크립트를 비활성화하는 특정 상황 section_C0FCB702E60D4576AD1174D39FBBE1A7

Target은 실행 시간이 너무 길거나 명령어가 너무 많은 경우와 같은 특정 상황에서 프로필 스크립트를 자동으로 비활성화합니다.

프로필 스크립트를 비활성화하는 경우, 아래 그림과 같이 Target UI의 프로필 스크립트 옆에 노란색 경고 아이콘이 표시됩니다.

profile_script_invalid 이미지

마우스로 가리키면 아래 그램과 같이 오류에 대한 세부 사항이 표시됩니다.

profile_script_hover 이미지

시스템이 프로필 스크립트를 비활성화하는 일반적인 이유는 다음과 같습니다.

  • 정의되지 않은 변수가 참조되었습니다.
  • 올바르지 않은 값이 참조되었습니다. 이 오류는 종종 적절한 확인 없이 URL 값 또는 기타 사용자 입력 데이터를 참조할 때 발생합니다.
  • 너무 많은 JavaScript 명령어가 사용되었습니다. Target에는 스크립트당 2,000개의 JavaScript 명령어 제한이 있지만, 이 제한은 단순히 JavaScript를 수동으로 읽는 것으로는 계산할 수 없습니다. 예를 들어 Rhino는 모든 함수 호출 및 “새로운” 호출을 100개의 명령어로 처리합니다. 모든 함수에 대한 호출은 100개의 명령어를 사용합니다. 또한 URL 값과 같은 임의 항목 데이터의 크기는 명령어 개수에 영향을 줄 수 있습니다.
  • 아래의 모범 사례 섹션에서 강조 표시된 항목을 따르지 않습니다.

모범 사례 best

다음 지침은 시스템 스크립트 중지를 강제하지 않고 스크립트가 처리되도록 정상적으로 실패하는 코드를 작성하여 가능한 한 오류 실패가 없는 간소화된 프로필 스크립트를 작성하기 위한 것입니다. 이러한 지침은 효율적으로 실행되는 것으로 입증된 모범 사례의 결과이며 Rhino 개발 커뮤니티에서 작성된 원칙 및 권장 사항과 함께 적용됩니다.

  • 현재 스크립트 값을 사용자 스크립트의 로컬 변수로 설정하고, 장애 조치를 빈 문자열로 설정합니다.

  • 빈 문자열이 아니도록 하여 로컬 변수의 유효성을 확인합니다.

  • 문자열 기반 조작 함수와 정규 표현식을 비교 사용합니다.

  • 제한된 for 루프와 개방된 for 또는 while 루프를 비교 사용합니다.

  • 1,300자 또는 50개 루프 반복을 초과하지 않도록 합니다.

  • JavaScript 명령어 2,000개를 초과하지 않도록 합니다. Target에는 스크립트당 2,000개의 JavaScript 명령어 제한이 있지만, 이 제한은 단순히 JavaScript를 수동으로 읽는 것으로는 계산할 수 없습니다. 예를 들어 Rhino는 모든 함수 호출 및 “새로운” 호출을 100개의 명령어로 처리합니다. 또한 URL 값과 같은 임의 항목 데이터의 크기는 명령어 개수에 영향을 줄 수 있습니다.

  • 스크립트 성능뿐만 아니라 모든 스크립트를 결합한 성능에 주의하십시오. Adobe는 총 5,000개 이하의 명령어를 사용할 것을 권장합니다. 명령어 수 계산은 완벽하지 않지만, 중요한 것은 명령어의 수가 2,000개를 초과하는 스크립트는 자동으로 비활성화된다는 것입니다. 활성 프로필 스크립트의 수는 300개를 초과할 수 없습니다. 각 스크립트는 모든 단일 mbox 호출로 실행됩니다. 필요만 만큼만 스크립트를 실행합니다.

  • 정규 표현식에서 첫 번째 문자를 점-별로 할 필요는 없습니다(예: /.*match/, /a|.*b/). 정규 표현식 검색은 ^으로 묶이지 않는 한 문자열의 모든 위치에서 시작하므로 이미 점-별이 가정되었습니다. 그러한 정규 표현식이 충분히 긴 입력 데이터(적게는 수백 자까지 가능)와 일치하면 스크립트 실행이 중단될 수 있습니다.

  • 모두 실패하는 경우 try/catch에 스크립트를 래핑합니다.

  • 다음 권장 사항은 프로필 스크립트 복잡성을 제한하는 데 도움이 됩니다. 프로필 스크립트는 제한된 수의 명령어를 실행할 수 있습니다.

    모범 사례:

    • 가능하면 프로필 스크립트를 작고 단순하게 유지하십시오.
    • 정규 표현식을 사용하지 않거나 간단한 정규 표현식만 사용하십시오. 간단한 표현식도 평가하는 데 많은 명령어가 필요할 수 있습니다.
    • 재귀를 사용하지 마십시오.
    • 프로필 스크립트를 Target에 추가하기 전에 성능을 테스트해야 합니다. 모든 프로필 스크립트는 모든 mbox 요청에 대해 실행됩니다. 프로필 스크립트가 올바르게 실행되지 않는 경우 mbox 요청을 실행하는 데 많은 시간이 소요되며, 이는 트래픽 및 전환에 영향을 미칠 수 있습니다.
    • 프로필 스크립트가 너무 복잡한 경우 응답 토큰을 대신 사용해 보십시오.
  • 자세한 내용은 JS Rhino 엔진 설명서를 참조하십시오.

프로필 스크립트 디버그 section_E9F933DE47EC4B4E9AF2463B181CE2DA

다음 방법을 사용하여 프로필 스크립트를 디버그할 수 있습니다.

NOTE
프로필 스크립트가 서버측에서 실행되므로 프로필 스크립트 내에서 console.log를 사용하면 프로필 값이 출력되지 않습니다.
  • 프로필 스크립트를 응답 토큰으로 추가하여 프로필 스크립트 디버그:

    Target에서 관리 ​를 클릭하고, 응답 토큰 ​을 클릭한 다음 디버그하려는 프로필 스크립트를 활성화합니다.

    Target이 있는 사이트의 페이지를 로드할 때마다 Target의 응답의 일부에는 아래와 같이 지정된 프로필 스크립트 값이 포함됩니다.

    debug_profile_script_1 이미지

  • mboxTrace 디버깅 도구를 사용하여 프로필 스크립트를 디버그합니다.

    이 방법을 사용하려면 디버거 도구 섹션에서 Target > 관리 > 구현 > 인증 토큰 생성 ​을 클릭하여 생성할 수 있는 인증 토큰이 필요합니다.

    그런 다음 이들 두 가지 매개변수를 페이지 URL의 “?” 뒤에 추가하십시오. mboxTrace=window&authorization=YOURTOKEN

    이들 매개변수를 추가하는 것은 프로필의 실행 전 스냅샷 및 실행 후 스냅샷을 얻을 수 있으므로 응답 토큰을 사용하는 것보다 좀 더 유용합니다. 사용 가능한 모든 프로필도 표시됩니다.

    debug_profile_script_2 이미지

프로필 스크립트 FAQ section_1389497BB6D84FC38958AE43AAA6E712

이 프로필 스크립트를 사용하여 데이터 계층에 있는 페이지에서 정보를 캡처할 수 있습니까?

프로필 스크립트는 서버측을 실행하므로 페이지를 직접 읽을 수 없습니다. 데이터는 mbox 요청이나 Target으로 데이터를 가져오는 다른 방법을 통해 전달되어야 합니다. 데이터가 Target에 있으면 프로필 스크립트는 데이터를 mbox 매개변수 또는 프로필 매개변수로 읽을 수 있습니다.

스크립트 프로필 매개변수에 대한 JavaScript 참조

스크립트 프로필 매개변수를 효과적으로 사용하려면 간단한 Javascript 지식이 필요합니다. 이 섹션은 단 몇 분 만에 이 기능을 사용하여 생산성을 발휘하는 데 도움이 되는 빠른 참조 역할을 합니다.

스크립트 프로필 매개변수는 mbox/프로필 탭 아래에 있습니다. Javascript 유형(문자열, 정수, 배열 등)을 반환하는 Javascript 프로그램을 작성할 수 있습니다.

스크립트 프로필 매개변수 예 examples

이름: user.recency

var dayInMillis = 3600 * 24 * 1000;
if (mbox.name == 'orderThankyouPage') {
    user.setLocal('lastPurchaseTime', new Date().getTime());
}
var lastPurchaseTime = user.getLocal('lastPurchaseTime');
if (lastPurchaseTime) {
    return ((new Date()).getTime() - lastPurchaseTime) / dayInMillis;
}

측정된 일에 대한 변수(밀리초)를 만듭니다. mbox 이름이 orderThankyouPage인 경우, lastPurchaseTime으로 이름이 지정된 로컬(표시되지 않는) 사용자 프로필 속성에 현재 날짜 및 시간 값이 표시되도록 설정합니다. 마지막 구매 시간 값이 읽히고 정의된 경우 Target은 마지막 구매 시간 이후 경과한 시간을 밀리초로 나눈 값(마지막 구매 이후 경과된 일 수)을 반환합니다.

이름: user.frequency

var frequency = user.get('frequency') || 0;
if (mbox.name == 'orderThankyouPage') {
    return frequency + 1;
}

frequency라고 하는 변수를 만들어 이전 값으로 초기화하거나 이전 값이 없는 경우 0으로 초기화합니다. mbox 이름이 orderThankyouPage이면 증분 값이 반환됩니다.

이름: user.monetaryValue

var monetaryValue = user.get('monetaryValue') || 0;
if (mbox.name == 'orderThankyouPage') {
    return monetaryValue + parseInt(mbox.param('orderTotal'));
}

지정된 방문자에 대한 현재 값을 조회(또는 이전 값이 없는 경우 0으로 설정)하는 monetaryValue라는 변수를 만듭니다. mbox 이름이 orderThankyouPage이면 이전 통화 값과 mbox에 전달된 orderTotal 매개변수의 값을 추가하여 새 통화 값이 반환됩니다.

이름: adobeQA

if (page.param("adobeQA"))
     return page.param("adobeQA");
else if (page.param("adobeqa"))
     return page.param("adobeqa");
else if (mbox.param("adobeQA"))
     return mbox.param("adobeQA");

adobeQA라고 하는 변수를 만들어 활동 QA에 대한 사용자를 추적합니다.

오브젝트 및 방법 objects

스크립트 프로필 매개변수에서 다음 오브젝트 및 방법을 참조할 수 있습니다.

오브젝트 또는 메서드
세부 사항
page.url
현재 URL입니다.
page.protocol
페이지에 사용된 프로토콜(http, https)입니다.
page.domain
현재 URL 도메인(첫 번째 슬래시 앞에 있는 모든 것)입니다. 예: http://www.acme.com/categories/men_jeans?color=blue&size=small에서 www.acme.com.
page.query
현재 페이지에 대한 쿼리 문자열입니다. '?' 뒤에 있는 모든 것입니다. 예: http://www.acme.com/categories/mens_jeans?color=blue&size=small에서 blue&size=small.
page.param('<par_name>')
<par_name>으로 표시된 매개변수의 값입니다. 현재 URL이 Google의 검색 페이지이고 page.param('hl')을 입력한 경우, URL http://www.google.com/search?hl=en& q=what+is+asdf&btnG=Google+Search에 대해 “en”이 표시됩니다.
page.referrer
위와 동일한 작업 세트가 레퍼러 및 랜딩에 적용됩니다. 즉, referrer.url은 레퍼러의 URL 주소입니다.
landing.url, landing.protocol, landing.querylanding.param

페이지의 값과 비슷하지만 랜딩 페이지용입니다.

랜딩 페이지 URL이 예상대로 작동하려면 context > browser > host를 설정합니다.

mbox.name
활성 mbox 이름입니다.
mbox.param('<par_name>')
활성 mbox에서 제공된 이름의 mbox 매개변수입니다.
profile.get('<par_name>')
<par_name>이라는 이름으로 클라이언트가 생성한 사용자 프로필 매개변수입니다. 예를 들어 사용자가 “gender”라는 프로필 매개변수를 설정하면 “profile.gender”를 사용하여 값을 추출할 수 있습니다. 현재 방문자에 대해 설정된 “profile.<par_name>” 값을 반환합니다. 설정된 값이 없으면 null를 반환합니다. profile.get(<par_name>)은 함수 호출로서의 자격이 있습니다.
user.get('<par_name>')
현재 방문자에 대해 설정된 “user.<par_name>” 값을 반환합니다. 설정된 값이 없으면 null를 반환합니다.
user.categoryAffinity
가장 적합한 카테고리의 이름을 반환합니다.
user.categoryAffinities
가장 적합한 카테고리가 있는 배열을 반환합니다.
user.isFirstSession
방문자의 첫 번째 세션인 경우 true를 반환합니다.
user.browser
HTTP 헤더에서 사용자-에이전트를 반환합니다. 예를 들어 Safari 사용자만 대상으로 하는 표현식 타겟을 만들 수 있습니다. if (user.browser != null && user.browser.indexOf('Safari') != -1) { return true; }

일반 연산자

모든 표준 JavaScript 연산자가 존재하며 사용할 수 있습니다. 문자열 및 숫자(및 기타 데이터 유형)에 JavaScript 연산자를 사용할 수 있습니다. 요약하면 다음과 같습니다.

연산자
설명
==
같음을 나타냅니다. 양쪽에 있는 피연산자가 동일한 경우 true입니다.
!=
같지 않음을 나타냅니다. 양쪽에 있는 피연산자가 동일하지 않은 경우 true입니다.
<
왼쪽에 있는 변수가 오른쪽에 있는 변수보다 작음을 나타냅니다. 변수가 동일한 경우 false로 평가합니다.
>
왼쪽의 변수가 오른쪽의 변수보다 큼을 나타냅니다. 변수가 동일한 경우 false로 평가합니다.
<=
변수가 동일하고 true로 평가하는 경우를 제외하고 <와 동일합니다.
>=
변수가 동일하고 true로 평가하는 경우를 제외하고 >와 동일합니다.
&&
표현식의 왼쪽과 오른쪽에 있는 논리적 “AND”는 양쪽이 true인 경우에만 true이고, 그렇지 않으면 false입니다.
`
//
부울에 포함된 타겟의 모든 요소(Array source, Array target)가 소스에 포함되어 있는지 확인합니다.
//는 대상(정규 표현식에 해당함)에서 하위 문자열을 추출하여 Array/*String*/ decode(String encoding, String regexp, String target)로 디코딩합니다.
이 기능은 상수 문자열 값, 그룹화(`condition1

교육 비디오: 프로필 스크립트 튜토리얼 배지

다음 비디오에는 프로필 스크립트 사용 및 작성에 대한 정보가 포함되어 있습니다.

  • 프로필 스크립트가 무엇인지 설명
  • 프로필 스크립트와 프로필 매개변수의 차이점 설명
  • 간단한 프로필 스크립트 만들기
  • 사용 가능한 토큰 메뉴를 사용하여 사용 가능한 선택 사항에 액세스
  • 프로필 스크립트 활성화 및 비활성화
recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654