집계 정책

API 끝점으로 데이터를 내보낼 때 최대의 효율성을 보장하기 위해 다양한 설정을 사용하여 내보낸 프로필을 더 크거나 작은 배치로 집계하고 ID별로 그룹화하고 기타 사용 사례를 사용할 수 있습니다. 또한 데이터 내보내기를 API 끝점에 대한 다운스트림 제한(속도 제한, API 호출당 ID 수 등)으로 사용자 지정할 수 있습니다.

구성 가능한 집계를 사용하여 Destination SDK에서 제공한 설정을 자세히 살펴보거나 우수 사례 집계를 사용하여 Destination SDK에게 API 호출을 가능한 한 가장 잘 일괄 처리하도록 알립니다.

Destination SDK을 사용하여 실시간(스트리밍) 대상을 작성할 때 내보낸 프로필을 그 결과로 내보내기에 결합하는 방법을 구성할 수 있습니다. 이 동작은 집계 정책 설정에 의해 결정됩니다.

이 구성 요소가 Destination SDK으로 만든 통합에 어떻게 적합한지 이해하려면 구성 옵션 설명서에서 다이어그램을 참조하거나 Destination SDK을 사용하여 스트리밍 대상을 구성하는 방법에 대한 안내서를 참조하십시오.

/authoring/destinations 끝점을 통해 집계 정책 설정을 구성할 수 있습니다. 이 페이지에 표시된 구성 요소를 구성할 수 있는 자세한 API 호출 예는 다음 API 참조 페이지를 참조하십시오.

이 문서에서는 대상에 사용할 수 있는 지원되는 모든 집계 정책 설정에 대해 설명합니다.

이 문서를 읽은 후 선택한 집계 정책을 기반으로 메시지 변환 템플릿에 집계 정책을 포함하는 방법을 이해하려면 템플릿 사용 및 집계 키 예제에 대한 설명서를 참조하십시오.

지원되는 통합 유형 supported-integration-types

이 페이지에 설명된 기능을 지원하는 통합 유형에 대한 자세한 내용은 아래 표를 참조하십시오.

최상의 작업 집계 best-effort-aggregation

우수 사례 집계는 요청당 프로필 수를 최소화하고, 데이터가 많은 요청보다 데이터가 적은 요청을 더 많은 요청으로 처리하는 대상에 가장 적합합니다.

아래 예제 구성은 최상의 집계 구성을 보여 줍니다. 구성 가능한 집계는 구성 가능한 집계 섹션을 참조하십시오. 최상의 노력 집계에 적용할 수 있는 매개 변수는 아래 표에 설명되어 있습니다.

"aggregation":{
   "aggregationType":"BEST_EFFORT",
   "bestEffortAggregation":{
      "maxUsersPerRequest":10,
      "splitUserById":false
   }
}

구성 가능한 집계 configurable-aggregation

구성 가능한 집계는 동일한 호출에 수천 개의 프로필이 있는 대용량 일괄 처리를 원하는 경우 가장 잘 작동합니다. 이 옵션을 사용하면 복잡한 집계 규칙을 기반으로 내보낸 프로필을 집계할 수도 있습니다.

아래 예제 구성은 구성 가능한 집계 구성을 보여 줍니다. 모범 노력 집계의 예를 보려면 모범 노력 집계 섹션을 참조하십시오. 구성 가능한 집계에 적용할 수 있는 매개 변수는 아래 표에 설명되어 있습니다.

"aggregation":{
   "aggregationType":"CONFIGURABLE_AGGREGATION",
   "configurableAggregation":{
      "splitUserById":true,
      "maxBatchAgeInSecs":2400,
      "maxNumEventsInBatch":5000,
      "aggregationKey":{
         "includeSegmentId":true,
         "includeSegmentStatus":true,
         "includeIdentity":true,
         "oneIdentityPerGroup":true,
         "groups":[
            {
               "namespaces":[
                  "IDFA",
                  "GAID"
               ]
            },
            {
               "namespaces":[
                  "EMAIL"
               ]
            }
         ]
      }
   }
}

다음 단계 next-steps

이 문서를 읽은 후에는 대상에 대한 집계 정책을 구성하는 방법을 더 잘 이해할 수 있어야 합니다.

다른 대상 구성 요소에 대한 자세한 내용은 다음 문서를 참조하십시오.