컨버터 구성 참조

이 참조 자료에서는 Amazon S3 가져오기 및 Google Cloud Storage(GCS) 컨버터 구성에 대한 예제 및 연산자를 설명합니다. 자세한 내용은 S3 가이드 또는 GCS 가이드를 참조하십시오.

skip_user_properties_sync

많은 클라우드 스토리지 소스 가져오기는 과거 데이터의 일괄 업로드이므로 과거 이벤트에 대한 최신 사용자 속성을 동기화하는 것은 의미가 없을 수 있습니다. 이러한 이유로 Amplitude는 기본적으로 $skip_user_properties_sync로 설정됩니다true. 사용자 속성을 이벤트에 포함하려면 변환기에서 해당 속성을 false로 설정하십시오.

$skip_user_properties_sync에 대한 자세한 내용은 데이터 다시 채우기 안내서를 참조하십시오.

ignoreEventFlag

ignoreEventFlag 계산된 불리언 조건에 따라 수집에서 이벤트를 선택적으로 건너뛰는 데 사용합니다. ignoreEventFlag필드 이름(예: "$ignore")으로 설정한 다음 임의의 DataLang 불리언 표현식을 사용하여 해당 필드를 정의합니다. convertToAmplitudeFunc필드가 지정된 이벤트에 대해 true로 평가되면 Amplitude는 해당 이벤트를 오류로 간주하지 않고 건너뜁니다. 이 값이 false로 평가되거나 없을 경우 Amplitude는 정상적으로 이벤트를 수집합니다.

이 옵션은 파일을 업스트림으로 사전 처리하지 않고 내부 테스트 이벤트, 봇 트래픽 또는 특정 이벤트 유형과 같이 필터링하려는 이벤트가 소스 데이터에 포함되어 있을 때 유용합니다.

예: 특정 이벤트 유형을 필터링합니다

다음 예제에서는 page_view또는 인 event_type이벤트를 session_start건너뜁니다.

{
  "converterConfig": {
    "ignoreEventFlag": "$ignore",
    "convertToAmplitudeFunc": {
      "event_type": "event_type",
      "user_id": "user_id",
      "$ignore": ["or",
        ["equals", ["path", "event_type"], ["value", "page_view"]],
        ["equals", ["path", "event_type"], ["value", "session_start"]]
      ]
    }
  }
}

이 예제에서는 다음과 같습니다.

• "ignoreEventFlag": "$ignore" $ignore는 Amplitude에게 변환된 이벤트에서 이름이 지정된 필드를 찾도록 지시합니다.
• convertToAmplitudeFunc "$ignore"에서는 or및 equals 연산자를 사용하여 불리언 표현식을 정의합니다.
• event_type이거나 page_view인 경우 session_start가 $ignore로 true평가되고 Amplitude는 이벤트를 건너뜁니다.
• Amplitude는 다른 모든 이벤트를 정상적으로 수집합니다.

전체 부울 연산자 또는 연산자의 조합을 사용하여 조건을 만들 수 있습니다.

convertToAmplitudeFunc

convertToAmplitudeFunc의 변환 규칙은 수집 서비스에 Amplitude에서 이벤트를 구성하는 방법을 지시합니다.

다음을 포함한 변환기 예제 convertToAmplitudeFunc

{
    "config_name": ["Event sample converter"],
    "converterConfig": {
        "fileType": "parquet",
        "compressionType": "none",
        "convertToAmplitudeFunc": {
          "event_type": "action",
          "user_id": "user",
          "device_id": "device",
          "event_properties": {
              "business_id_encid": "business_id"
          },
          "user_properties": {
              "utm_channel_category": "utm_channel_c",
              "utm_channel_source": "utm_channel_s"
          },
          "time": "epoch",
          "session_id": "session_id",
          "app_version": "app_version"
        }
    },
    "keyValidatorConfig": {
        "filterPattern": "folder1/folder2/ds=202011[1-2][0-9]/.*\\.parquet"
    }
}

구성된 이벤트 예제

{
  "event_type": "watch tv",
  "user_id": "john",
  "device_id": "host1",
  "event_properties": {
    "business_id_encid": "123"
      },
      "user_properties": {
        "utm_channel_category": "discovery",
        "utm_channel_source": "network"
      },
      "time": "1645066434189",
      "session_id": "1",
      "app_version": "1"
}

이벤트의 값은 convertToAmplitudeFunc에 의해 지정된 필드에서 가져옵니다. 예를 들어 event_type필드의 값은 수집된 데이터 파일의 "action" 필드에서 가져옵니다. watch tv``event_type값이 ["value":"$identify"]또는 ["value":"$groupidentify"]이 아니기 때문에 Amplitude는 HTTP V2 API를 사용하여 이벤트를 수집하는 것과 동일한 방식으로 이벤트를 수집합니다.

연산자

리스트 연산자

리스트 연산자 사용

소스 설명이 목록인 경우 목록의 첫 번째 항목은 함수를 지정하는 문자열이어야 합니다. 목록의 나머지 부분은 함수의 매개변수입니다. "|" 문자는 반복되지 않는 인수와 반복되는 인수를 구분합니다. "|" 뒤의 전체 인수는 반복 가능하며 원하는 회만큼 지정할 수 있습니다. 전체 인수 목록은 전체 다중 인수 연산자에 있어야 합니다(세 인수 중 하나만 지정할 수 없으며 세 인수 모두를 포함해야 합니다).

부울 연산자

이러한 연산자는 부울 유형의 JsonPrimitive를 반환하므로 cond및 ifelse와 함께 사용할 수 있습니다.

정수 및 부동 소수점 연산자

다음 연산자는 정수 유형의 JsonPrimitive를 반환하며, Float 유형의 JsonPrimitive를 반환하는 add연산자는 예외입니다.

JSON 연산자

사용자 속성 작업

이 변환기는 Identify API와 동일한 사용자 속성 연산자를 지원합니다. 자세한 내용은 Identify 문서를 참조하십시오.