유연한 배치 스케줄을 사용하여 배치 대상 평가 제어

AVAILABILITY
유연한 일괄 처리 일정은 현재 제한된 가용성​에서 사용할 수 있습니다. 자세한 내용은 Adobe 고객 지원 센터에 문의하십시오.

일괄 처리 세그멘테이션은 프로필 데이터를 한 번에 이동하여 해당 대상자를 만들 수 있는 평가 방법입니다. 이전에는 이러한 배치 대상이 하루에 한 번 실행되는 고정된 단일 세분화 작업에 의존했습니다.

유연한 일괄 처리 일정을 사용하면 대상을 평가할 시기를 제어할 수 있으므로 보다 유연하게 평가 시간을 우선시하여 더 큰 대상 볼륨으로 확장할 수 있습니다.

일정 만들기 create-schedule

유연한 배치 일정을 사용하려면 먼저 대상에 대한 일정을 만들어야 합니다. Experience Platform UI 또는 API를 사용하여 일정을 만들 수 있습니다.

UI

Experience Platform UI를 사용하여 일정을 만들려면 먼저 Segmentation Service 작업 영역의 평가 섹션에 액세스해야 합니다.

고객 섹션 내에서 대상​을 선택한 다음 평가​를 선택합니다.

대상 및 평가 단추가 강조 표시되어 평가 페이지에 액세스하는 방법을 보여 줍니다.

조직에서 현재 사용 가능한 모든 일정을 표시하는 평가 페이지가 나타납니다. 일정 만들기를 시작하려면 일정 만들기​를 선택하십시오.

평가 페이지에서 일정 만들기 단추가 강조 표시됩니다.

일정 만들기 팝오버가 나타납니다. 이 팝오버에서 이름, 케이던스 및 일정을 실행할 시간을 포함하여 일정에 대한 세부 정보를 입력할 수 있습니다. 필요한 세부 정보를 모두 입력한 후 계속하려면 만들기​를 선택하십시오.

일정 만들기 팝오버가 표시됩니다.

API

Experience Platform API를 사용하여 일정을 만들려면 /schedules 끝점에 대한 POST 요청을 수행해야 합니다.

API 형식

code language-http
POST /schedules

요청

accordion
일정 만들기에 대한 샘플 요청입니다.
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
{
    "name": "Weekly VIP refresh",
    "type": "batch_segmentation",
    "schedule": "0 0 10 * * ?",
    "properties": {
        "segments": [
            "sample-audience-1",
            "sample-audience-2"
        ]
    },
    "state": "active"
}'

예약을 만들 때 이름, 유형, 예약, 예약에 속한 대상 및 해당 상태를 제공해야 합니다. API를 사용하여 일정을 만드는 방법에 대한 자세한 내용은 일정 끝점 안내서를 참조하십시오.

응답

accordion
일정을 만들 때 샘플 응답.
code language-json
{
  "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
  "name": "Weekly VIP Refresh",
  "type": "batch_segmentation",
  "schedule": "0 0 10 * * ?",
  "frequency": "weekly",
  "state": "active",
  "properties": {
    "segments": ["sample-audience-1", "sample-audience-2"]
  }
}

성공한 응답은 새로 만든 일정에 대한 정보와 함께 HTTP 상태 200을 반환합니다. frequency 필드는 자동으로 채워지고 제공된 schedule을(를) 기반으로 합니다.

일정에 대상자 할당 assign-audience

일정을 만든 후 이전 일정에 대상을 추가로 할당할 수 있습니다. Experience Platform UI 또는 API를 사용하여 대상을 할당할 수 있습니다.

UI

Experience Platform UI를 사용하여 일정에 대상을 할당하려면 일정 옆에 있는 줄임표 아이콘 을 선택한 다음 일정 대상​을 선택합니다.

대상자 예약 단추가 강조 표시됩니다.

대상자 예약 팝오버가 표시됩니다. 예약에 추가할 대상을 선택한 후 예약​을 선택하여 예약 변경 내용을 확인합니다.

대상자 예약 팝오버가 표시됩니다.

API

Experience Platform API를 사용하여 일정에 대상을 할당하려면 /schedules/add-audiences 끝점에 대한 POST 요청을 수행해야 합니다.

API 형식

code language-http
POST /schedules/add-audiences

요청

accordion
일정에 대상을 추가하는 샘플 요청입니다.
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/add-audiences \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
        "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
        "segments": [
            "sample-audience-3",
            "sample-audience-4"
        ]
      }'

일정에 대상자를 추가할 때 일정에 추가할 대상자의 ID와 일정 ID를 제공해야 합니다. 일정에 대상을 추가하는 방법에 대한 자세한 내용은 일정 끝점 안내서를 참조하십시오.

응답

accordion
일정에 대상을 추가할 때 성공한 응답입니다.
code language-json
{
    "added": ["sample-audience-3", "sample-audience-4"],
    "existing": [],
    "invalid": [],
    "segmentCount": {
        "previous": 2,
        "current": 4,
        "diff": 2
    }
}

성공적인 응답은 추가된 대상에 대한 정보와 함께 HTTP 상태 200을 예약에 반환합니다.

또는 대상을 만드는 동안 대상에 일정을 할당할 수 있습니다. Audience Builder 내에서 대상을 저장한 후 대상 속성 섹션의 일정 섹션으로 이동하여 달력 아이콘 을 선택합니다.

대상자 일정 팝오버가 표시됩니다. 이 팝오버에서 대상자가 속해야 하는 일정을 할당할 수 있습니다.

일정 할당 팝오버가 표시되어 대상자가 속한 일정을 보여 줍니다.

대상자의 일정 보기 view-audience-schedule

Experience Platform UI 또는 API를 사용하여 대상이 속한 일정을 확인할 수 있습니다.

UI
note
NOTE
대상자 빌더​를 사용하여 만든 대상자에 대한 예약만 볼 수 있습니다.

Experience Platform UI를 사용하여 대상자가 속한 일정을 보려면 대상자 포털(으)로 이동하여 대상자를 선택한 후 대상자 편집​을 선택하십시오.

Audience Builder에서 달력 아이콘 을 선택합니다. 대상 속성 섹션의 일정 섹션 내에서 대상 일정 팝오버를 표시합니다. 이 팝오버는 대상자가 속한 일정을 보여주며, 대상자가 속한 일정을 추가하거나 제거할 수 있도록 해줍니다.

일정 할당 팝오버가 표시되어 대상자가 속한 일정을 보여 줍니다.

API

Experience Platform API를 사용하여 대상자가 속한 일정을 보려면 /schedules/audience-map 끝점에 대한 POST 요청을 만듭니다.

API 형식

code language-http
POST /schedules/audience-map

요청

accordion
나열된 대상이 속하는 일정을 확인하는 샘플 요청입니다.
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/audience-map \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
        "segments": [
            "sample-audience-1",
            "sample-audience-2"
        ]
      }'

이 끝점을 사용하려면 일정을 보려는 대상의 ID를 제공해야 합니다. 대상이 속한 일정을 보는 방법에 대한 자세한 내용은 일정 끝점 안내서를 참조하십시오.

응답

accordion
대상에 대한 일정을 검색할 때 성공한 응답입니다.
code language-json
{
  "audienceMap": {
    "sample-audience-1": ["cd585edf-962d-420d-94ad-3be03e619ac2"],
    "sample-audience-2": []
  },
  "schedules": {
    "cd585edf-962d-420d-94ad-3be03e619ac2": {
      "name": "Weekly VIP Refresh",
      "schedule": "0 0 10 * * ?",
      "frequency": "weekly"
    }
  }
}

성공적인 응답은 요청된 대상이 속한 예약에 대한 자세한 정보와 함께 HTTP 상태 200을 반환합니다.

일정에서 대상자 제거 remove-audience

이미 생성된 일정에서 대상을 제거하려면 Experience Platform UI 또는 API를 사용할 수 있습니다.

UI

Experience Platform UI를 사용하여 일정에서 대상을 제거하려면 일정 옆에 있는 추가 아이콘 을 선택한 다음 일정 대상​을 선택합니다.

대상자 예약 단추가 강조 표시됩니다.

대상자 예약 팝오버가 표시됩니다. 일정에서 제거할 대상을 선택한 다음 일정​을 선택하여 일정 변경 내용을 확인합니다.

대상자 예약 팝오버가 표시됩니다.

API

일정에서 대상을 제거하려면 /schedules/remove-audiences 끝점에 대한 POST 요청을 수행해야 합니다.

API 형식

code language-http
POST /schedules/remove-audiences

요청

accordion
일정에서 대상을 제거하는 샘플 요청
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/remove-audiences/
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
 {
    "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
    "segments": [
        "sample-audience-1"
    ]
 }
 '

일정에서 대상을 제거할 때 일정 ID와 일정에서 제거할 대상의 ID를 제공해야 합니다. 일정에 대상을 제거하는 방법에 대한 자세한 내용은 일정 끝점 안내서를 참조하십시오.

응답

accordion
일정에서 대상자를 제거할 때 성공한 응답.
code language-json
{
    "removed": ["sample-audience-1"],
    "existing": [],
    "invalid": [],
    "segmentCount": {
        "previous"
    }
}

수동으로 일정 실행 run-manually

일정이 실행될 때까지 기다리는 대신 Experience Platform UI 또는 API를 사용하여 기존 일정이 실행될 때까지 수동으로 트리거할 수 있습니다.

UI

Experience Platform UI에서 일정을 수동으로 실행하려면 평가 페이지에서 평가하려는 일정 옆에 있는 추가 아이콘 을 선택한 다음 일정 실행​을 선택하십시오.

일정 실행 단추가 강조 표시됩니다.

확인 팝업이 나타납니다. 예약 실행을 즉시 시작하려면 시작​을 선택하십시오.

실행 일정 팝오버가 표시됩니다.

API

Experience Platform API에서 일정을 수동으로 실행하려면 /schedules/trigger 끝점에 대한 POST 요청을 수행해야 합니다.

API 형식

code language-http
POST /schedules/trigger

요청

accordion
일정의 평가를 트리거하기 위한 샘플 요청입니다.
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/trigger \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
    "id": "cd585edf-962d-420d-94ad-3be03e619ac2"
    }'

일정 평가를 트리거할 때 평가할 일정의 ID를 제공해야 합니다. 한 번에 하나의 일정을 전용​할 수 있습니다. 일정 평가를 트리거하는 방법에 대한 자세한 내용은 일정 끝점 안내서를 참조하십시오.

응답

성공적인 응답은 콘텐츠가 없는 HTTP 상태 200을 반환합니다.

일정 활성화 또는 비활성화

Experience Platform UI 또는 API를 사용하여 일정을 활성화하거나 비활성화할 수 있습니다.

UI

Experience Platform UI를 사용하여 일정을 활성화하거나 비활성화하려면 일정 옆에 있는 추가 아이콘 을 선택합니다. 현재 사용하지 않는 일정을 사용하려면 사용​을 선택하세요. 현재 활성화된 일정을 비활성화하려면 비활성화​를 선택합니다.

일정 사용 안 함 단추가 강조 표시되어 있습니다.

API

Experience Platform API를 사용하여 일정을 활성화하거나 비활성화하려면 /schedules 끝점에 PATCH을 요청하여 업데이트할 일정의 ID를 제공해야 합니다.

API 형식

code language-http
PATCH /schedules/{SCHEDULE_ID}

요청

accordion
일정 업데이트에 대한 샘플 요청
code language-shell
curl -X PATCH https://platform.adobe.io/data/core/ups/config/schedules/cd585edf-962d-420d-94ad-3be03e619ac2 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '[
        {
            "op": "replace",
            "path": "/state",
            "value": "inactive"
        }
      ]'

일정을 업데이트할 때 일정에 대한 작업, 경로 및 값을 제공해야 합니다. 비활성화된 일정을 활성화하려면 value을(를) active(으)로 설정해야 합니다. 활성화된 일정을 비활성화하려면 value을(를) inactive(으)로 설정해야 합니다. 일정 업데이트에 대한 자세한 내용은 일정 끝점 안내서를 참조하세요.

응답

성공적인 응답은 콘텐츠가 없는 HTTP 상태 204를 반환합니다.

다음 단계

이 안내서를 읽은 후에는 Experience Platform API 또는 UI를 사용하여 유연한 배치 일정을 사용하는 방법을 이해할 수 있습니다. 유연한 일괄 처리 일정 UI에 대한 자세한 내용은 세그먼테이션 서비스 UI 개요를 참조하세요. 일정 API에 대한 자세한 내용은 일정 끝점 안내서를 참조하십시오. 유연한 일괄 처리 일정이 사용자의 용량 및 크레딧에 어떻게 작동하는지 알아보려면 라이선스 사용 및 용량 개요를 읽어 보십시오.

비디오 video

다음 비디오는 평가 탭에서 사용자 지정 일정을 만들고, 세분화 작업을 모니터링하고, 크레딧을 관리하는 방법에 대한 개요를 제공하는 유연한 일괄 처리 일정을 사용하는 방법을 보여 줍니다.

부록 appendix

다음 부록에는 스케줄 간 종속성이 작동하는 방식과 유연한 배치 스케줄에 대한 FAQ가 나열되어 있습니다.

일정 간 종속성 cross-schedule-dependencies

한 대상이 다른 대상을 종속성으로 참조하는 경우 해당 종속성은 해당 대상을 속하지 않는 일정으로 가져올 수 있습니다.

다음 네 개의 대상과 두 개의 일정을 고려하십시오.

일정 A: 대상자 1, 대상자 4
일정 B: 대상 2, 대상 3

대상 1은 종속성을 통해 대상 2를 참조하므로 대상 1은 필요​하는 대상 2의 평가된 멤버십을 사용하여 자체 멤버십을 계산합니다.

예약 A가 실행되면 대상 1과 대상 4는 예상대로 평가합니다. 그러나 대상 2는 대상 1의 종속성이므로 also​도 실행됩니다.

예약 B가 실행되면 대상 2 및 대상 3이 예상대로 평가합니다. 이 시나리오에서는 대상 2가 대상 1에 종속되지 않으므로 대상 1이 평가되지 않습니다.

따라서 다른 대상(예: 위의 시나리오에서 대상 2)의 종속 항목인 대상 may​은(는) 하루에 두 번 이상 평가됩니다. 한 번은 자체 예약된 평가의 일부로, 한 번은 다른 대상에 종속되는 대상 예약의 일부로 평가됩니다.

자주 묻는 질문 faq

현재 보유한 일별 평가를 계속 사용하려면 수행해야 하는 작업이 있습니까?

답변
아니요. 시스템 스케줄은 자동으로 계속 실행됩니다. 사용자 지정 일정을 만들지 않는 한 아무것도 변경되지 않습니다.

두 개 이상의 사용자 지정 일정에 대상자를 할당할 수 있습니까?

답변
예! 대상자를 두 개 이상의 사용자 지정 일정에 할당할 수 있습니다.

스트리밍 또는 Edge 대상자가 사용자 지정 일정을 사용할 수 있습니까?

답변
아니요. 스트리밍 및 에지 대상은 항상 시스템 일정에 따라 평가됩니다.

사용자 지정 일정에 대상 구성을 할당할 수 있습니까?

답변
아니요. 대상 구성은 시스템 일정의 일부로 자동 평가됩니다. 여기에는 컴포지션의 일부인 모든 내부 대상자가 포함됩니다.

몇 개의 일정을 실행할 수 있습니까?

답변
하루에 최대 4개의 일정을 실행할 수 있습니다. 이 시스템 일정을 포함​합니다.

4,000개 이상의 일괄 처리 대상을 가지려면 유연한 일괄 처리 일정이 필요합니까?

답변
예. 10,000개의 배치 대상이 있으려면 유연한 배치 일정이 필요합니다.

사용자 지정 일정을 만드는 데 비용이 듭니까?

답변
Experience Platform에 포함된 1주간의 사용자 지정 예약(52개의 예약된 실행)을 사용할 수 있습니다. 또한 시스템 스케줄은 항상 무료입니다. 추가 사용자 정의 스케줄을 생성하려는 경우 추가 스케줄링된 실행은 크레딧을 사용합니다. 자세한 내용은 라이선스 사용 및 용량 개요를 참조하세요.

일정이 실행되었는지 어떻게 확인할 수 있습니까?

답변
세그먼테이션 작업 모니터링 보기 내에서 일정이 실행되었는지 확인할 수 있습니다. 모니터링, 대시보드, 대상자, 세분화 작업​을(를) 선택하십시오. 여기에서 일정이 실행된 시간 옆에 있는 필터 아이콘 을 선택하여 일정별로 평가된 대상 목록을 확인합니다.
recommendation-more-help
experience-platform-help-segmentation