집계 정책

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,
      "aggregationKey":{
         "includeSegmentId":true,
         "includeSegmentStatus":true,
         "includeIdentity":true,
         "oneIdentityPerGroup":true,
         "groups":[
            {
               "namespaces":[
                  "IDFA",
                  "GAID"
               ]
            },
            {
               "namespaces":[
                  "EMAIL"
               ]
            }
         ]
      }
   }
}

구성 가능한 집계 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

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