설명서TargetTarget 개발자 안내서

모델 API 개요

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 개발자

차단 목록에 추가하다 API라고도 하는 모델 API를 사용하면 사용자가 Automated Personalization (AP) 및 Auto-Target (AT) 활동에 대한 머신 러닝 모델에 사용되는 기능 목록을 보고 관리할 수 있습니다. AP 또는 AT 활동용 모델에서 기능을 사용하지 않으려면 모델 API를 사용하여 해당 기능을 "사용자 차단 목록"에 추가할 수 있습니다.

blocklist ​은(는) Adobe Target이(가) 해당 기계 학습 모델에서 제외할 기능 집합을 정의합니다. 기능에 대한 자세한 내용은 사용한 데이터 Target 머신 러닝 알고리즘을 참조하십시오.

차단 목록은 활동(활동 수준)별로 정의되거나 Target 계정(전역 수준) 내의 모든 활동에 대해 정의될 수 있습니다.

모델 API 사양

모델 API 사양 여기를 봅니다.

전제 조건

모델 API를 사용하려면 Target 관리 API에서와 마찬가지로 Adobe Developer Console을(를) 사용하여 인증을 구성해야 합니다. 자세한 내용은 인증을 구성하는 방법을 참조하세요.

모델 API 사용 지침

차단 목록 관리 방법

1단계: 활동에 대한 기능 목록 보기

2단계: 활동 차단 목록 확인

단계 3: 활동의 차단 목록에 추가하다에 기능 추가

4단계:(선택 사항) 차단 해제

단계 5:(선택 사항) 전역 차단 목록 관리

1단계: 활동에 대한 기능 목록 보기 step1

기능을 차단 목록에 추가 하기 전에 해당 활동에 대한 모델에 현재 포함되어 있는 기능 목록을 확인하십시오.

요청
code language-json line-numbers 
GET https://mc.adobe.io/<tenant>/target/models/features/<campaignId>
응답
code language-json line-numbers 
{
    "features": [
        {
            "externalName": "Visitor Profile - Total Visits to Activity",
            "internalName": "SES_PREVIOUS_VISIT_COUNT",
            "type": "CONTINUOUS"
        },
        {
            "externalName": "Visitor Profile - Total Visits",
            "internalName": "SES_TOTAL_SESSIONS",
            "type": "CONTINUOUS"
        },
        {
            "externalName": "Visitor Profile - Pages Seen Before Activity",
            "internalName": "SES_PREVIOUS_VISIT_COUNT",
            "type": "CONTINUOUS"
        },
        {
            "externalName": "Visitor Profile - Activity Lifetime Time on Site",
            "internalName": "SES_TOTAL_TIME",
            "type": "CONTINUOUS"
        }
    ],
    "reportParameters": {
        "clientCode": <tenant>,
        "campaignId": <campaignId>
    }
}

여기에 표시된 예에서 사용자는 활동 ID가 260840 활동에 대해 모델에서 사용 중인 기능 목록을 보기 위해 확인하고 있습니다.

1단계

NOTE
활동의 활동 ID를 찾으려면 Target UI에서 활동 목록으로 이동합니다. 관심 있는 활동을 클릭합니다. 활동 ID는 결과 활동 개요 페이지의 본문과 해당 페이지의 URL 끝에 표시됩니다.

externalName ​은(는) 기능에 대한 알기 쉬운 이름입니다. 이 값은 Target에 의해 만들어지며 시간이 지남에 따라 변경될 수 있습니다. 사용자는 Personalization 인사이트 보고서에서 사용자에게 친숙한 이러한 이름을 볼 수 있습니다.

internalName ​은(는) 기능의 실제 식별자입니다. 또한 Target에 의해 만들어졌지만 변경할 수 없습니다. 이 값은 차단 목록에 추가하다와 같은 기능을 식별하기 위해 참조해야 하는 값입니다.

기능 목록을 값으로 채우려면(즉, null이 아니도록 하려면) 활동은 다음을 수행합니다.

  1. Status = Live이거나 이전에 활성화했어야 합니다.
  2. 모델이 실행할 데이터가 있도록 캠페인 활동이 있을 만큼 충분히 오래 실행되고 있었어야 합니다.

단계 2: 활동의 차단 목록 확인 step2

다음은 차단 목록 보기. 즉, 현재 이 활동의 모델에 포함되지 못하고 있는 기능(있는 경우)을 확인합니다.

ERROR
/blockList/은(는) 요청에서 대/소문자를 구분합니다.
요청
code language-json line-numbers 
GET https://mc.adobe.io/<tenant>/target/models/features/blockList/<campaignId>
응답
code language-json line-numbers

여기에 표시된 예에서 사용자는 활동 ID가 260840 활동에 대해 차단된 기능 목록을 확인하고 있습니다. 결과가 비어 있습니다. 즉, 이 활동에는 현재 차단 목록에 추가된 기능이 없습니다.

2단계

NOTE
기능을 추가하기 전에 전체 차단 목록을 처음 확인하면 이와 같은 빈 결과가 나타날 수 있습니다. 그러나 차단 목록에 추가하다 결과에서 기능을 추가(및 제거)하면 빈 차단 목록에 추가된 기능 배열이 반환되는 약간 다른 결과가 표시될 수 있습니다. 4단계에서 이 예제를 보려면 계속 읽으십시오.

단계 3: 활동의 차단 목록에 추가하다에 기능 추가 step3

PUT에 기능을 추가하려면 GET에서 요청으로 변경하고 차단 목록 본문을 수정하여 blockedFeatureSources 또는 blockedFeatures을(를) 원하는 대로 지정하십시오.

  • 요청 본문에는 blockedFeatures 또는 blockedFeatureSources이(가) 필요합니다. 둘 다 포함될 수 있습니다.
  • internalName에서 식별된 값으로 blockedFeatures을(를) 채웁니다. 단계 1을 참조하세요.
  • 아래 표의 값으로 blockedFeatureSources을(를) 채웁니다.

blockedFeatureSources은(는) 기능의 출처를 나타냅니다. 차단 목록에 추가 목적으로 기능은 사용자가 전체 기능 세트를 한 번에 차단할 수 있는 기능 그룹 또는 카테고리 역할을 합니다. blockedFeatureSources의 값은 기능 식별자의 첫 번째 문자(blockedFeatures 또는 internalName 값)와 일치하므로 "기능 접두사"로 간주할 수도 있습니다.

blockedFeatureSources 값 테이블 table

접두사
설명
상자
mbox 매개 변수
URL
사용자 지정 - URL 매개 변수
환경
환경
SES
방문자 프로필
지역
지리적 위치
PRO
사용자 지정 - 프로필
SEG
사용자 지정 - 보고 세그먼트
AAM
사용자 지정 - Experience Cloud 세그먼트
군중
모바일
CRS
사용자 지정 - 고객 속성
UPA
사용자 지정 - RT-CDP 프로필 속성
IAC
방문자 관심 영역
요청
code language-json line-numbers 
PUT https://mc.adobe.io/<tenant>/target/models/features/blockList/<campaignId>

{
    "blockedFeatureSources": ["AAM"],
    "blockedFeatures": ["SES_PREVIOUS_VISIT_COUNT", "SES_TOTAL_SESSIONS"]
}
응답
code language-json line-numbers 
{
    "blockedFeatures": [
            "SES_PREVIOUS_VISIT_COUNT",
            "SES_TOTAL_SESSIONS"
        ],
    "blockedFeatureSources": [
            "AAM"
        ]
}

여기에 표시된 예에서 사용자는 단계 1에 설명된 대로 활동 ID가 260480 활동에 대한 전체 기능 목록을 쿼리하여 이전에 식별한 두 개의 기능 SES_PREVIOUS_VISIT_COUNT 및 SES_TOTAL_SESSIONS을(를) 차단하고 있습니다. 또한 위의 table에 설명된 대로 "AAM"라는 접두사가 있는 기능을 차단하여 Experience Cloud 세그먼트에서 오는 모든 기능을 차단합니다.

3단계

차단 목록에 추가 후 2을(를) 다시 수행하여 업데이트된 GET 단계를 확인하는 것이 좋습니다(차단 목록 차단 목록). 결과가 예상대로 나타나는지 확인합니다(결과에 최신 PUT 요청에서 추가된 기능이 포함되어 있는지 확인).

4단계: (선택 사항) 차단 해제 step4

모든 차단 목록에 추가된 기능을 차단 해제하려면 blockedFeatureSources 또는 blockedFeatures에서 값을 지우십시오.

요청
code language-json line-numbers 
PUT https://mc.adobe.io/<tenant>/target/models/features/blockList/<campaignId>

{
    "blockedFeatureSources": [],
    "blockedFeatures": []
}
응답
code language-json line-numbers 
{
    "blockedFeatures": [],
    "blockedFeatureSources": []
}

여기에 표시된 예에서 사용자는 활동 ID가 260840 활동에 대한 차단 목록에 추가하다를 지웁니다. 응답이 차단된 기능과 해당 소스 모두에 대해 빈 배열을 확인합니다. 각각—blockedFeatureSources 및 blockedFeatures.

4단계

차단 목록에 추가하다를 수정하는 경우 항상 그렇듯이 2단계를 다시 수행하는 것이 좋습니다(GET 후 예상대로 차단 목록에 추가하다에 기능이 포함됨). 여기에 표시된 예에서 사용자는 이제 차단 목록에 추가하다가 비어 있는지 확인하고 있습니다.

4b단계

질문: 어떻게 모든 것이 아니라 일부 차단 목록에 추가하다를 삭제할 수 있습니까?

답변: 다중 차단 목록에 추가된 기능의 개별 하위 집합을 제거하기 위해 사용자는 전체 차단 목록에 추가하다차단 목록에 추가하다 을 지우고 원하는 기능을 다시 추가하는 것에 반대하므로 차단 목록에 추가하다 요청에서 차단하고자 하는 기능의 업데이트된 목록을 보내면 됩니다. 즉, 업데이트된 기능 목록(3단계)을 보내 차단 목록에서 "삭제"할 기능을 제외하도록 합니다.

단계 5: (선택 사항) 글로벌 차단 목록 관리 step5

위의 예는 모두 단일 활동의 맥락에 있었습니다. 각 활동에 대해 개별적으로 차단 목록에 추가하다를 지정하지 않고 주어진 클라이언트(테넌트)에서 모든 활동에 대한 기능을 차단할 수도 있습니다. 전역 차단 목록을 수행하려면 blockList/<campaignId> 대신 /blockList/global 호출을 사용하십시오.

요청
code language-json line-numbers 
PUT https://mc.adobe.io/<tenant>/target/models/features/blockList/global

{
    "blockedFeatureSources": ["AAM", "PRO", "ENV"],
    "blockedFeatures": ["AAM_FEATURE_1", "AAM_FEATURE_2"]
}
응답
code language-json line-numbers 
{
    "blockedFeatures": [
        "AAM_FEATURE_1",
        "AAM_FEATURE_2"
    ],
    "blockedFeatureSources": [
        "AAM",
        "PRO",
        "ENV"
    ]
}

위에 표시된 샘플 요청에서 사용자는 Target 계정의 모든 활동에 대해 두 개의 기능인 "AAM_FEATURE_1" 및 "AAM_FEATURE_2"를 차단하고 있습니다. 즉, 활동에 관계없이 "AAM_FEATURE_1" 및 "AAM_FEATURE_2"는 이 계정의 머신 러닝 모델에 포함되지 않습니다. 또한 접두사가 "AAM", "PRO" 또는 "ENV"인 모든 기능을 전역적으로 차단합니다.

질문: 위의 코드 샘플은 중복되지 않습니까?

답변: 예. 값이 "AAM"로 시작하는 기능을 차단하는 동시에 소스가 "AAM"인 모든 기능을 차단하는 것은 이중화됩니다. 결과적으로 AAM(Experience Cloud 세그먼트)에서 가져온 모든 기능이 차단됩니다. 따라서 Experience Cloud 세그먼트에서 모든 기능을 차단하는 것이 목표라면 위의 예에서 "AAM"로 시작하는 특정 기능을 개별적으로 지정할 필요가 없습니다.

마지막 단계: 활동 수준이든 글로벌 수준이든, 활동 수준을 수정한 후 차단 목록에 추가하다를 확인하는 것이 좋습니다. 이렇게 하면 예상한 값이 포함됩니다. PUT을(를) GET(으)로 변경하여 이 작업을 수행합니다.

아래 표시된 샘플 응답은 Target이(가) 두 개의 개별 기능과 "AAM", "PRO" 및 "ENV"에서 가져온 모든 기능을 차단함을 나타냅니다.

5단계

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3