Accoil(이벤트 스트림)

Amplitude 고객들은 Accoil을 사용하여 사용자뿐만 아니라 계정에 대한 제품 데이터를 운영합니다.

Accoil은 고객 성공, 지원, 영업 및 마케팅 팀을 지원합니다.

• 제품 사용량을 기반으로 계정 상태를 실시간으로 추적합니다.
• 고객 기반 전반에 걸쳐 참여도 변화를 모니터링합니다.
• 이탈이 발생하기 전에 위험에 처한 계정을 파악하십시오.
• 사용 신호를 기반으로 제품 적격 계정(PQA)을 파악합니다.
• 고객 여정 전반에 걸쳐 사전 예방적 워크플로를 강화하십시오.

Amplitude 연동을 통해 계정 및 사용자 이벤트는 별도의 계측 없이 Accoil로 직접 스트리밍되므로 계정 수준의 인사이트를 실시간으로 유지하고 실행 가능하게 유지할 수 있습니다.

활용 사례

• 실시간 계정 상태 모니터링.
• 고객 기반 전반에 걸친 참여 추적.
• 위험 계정 식별.
• 제품 적격 계정(PQA) 노출.

고려 사항

• Accoil이 이벤트를 올바르게 처리하려면 이벤트에 유효한 사용자 ID가 포함되어야 합니다. 필요에 따라 필터를 추가하여 익명 이벤트를 제외하십시오.
• 연결을 활성화한 후 사용자 이벤트가 Accoil에 나타나는 데 1~2분이 걸릴 수 있습니다.

사전 조건

연동을 구성하기 전에 다음을 갖추고 있는지 확인하십시오.

• 활성 Accoil 작업 공간입니다.
• 귀하의 Accoil 계정에서 발급한 API 키입니다.

연동 설정

Accoil API 키 받기

1. Accoil 작업 공간에 로그인하십시오.
2. 작업 공간 > 설정 > 계정 설정 > 일반으로 이동합니다.
3. 관련 제품의 API 키를 복사합니다.

Amplitude에서 새로운 동기화 생성

1. Amplitude에서 데이터, 카탈로그 순으로 이동한 다음 대상 탭을 선택합니다.
2. 고객 참여에서 Accoil을 선택합니다.
3. 동기화 이름을 입력한 다음 동기화 생성을 선택합니다.

자격 증명 입력

1. Accoil API 키를 입력 필드에 붙여넣으십시오.
2. 1. 이벤트 선택 및 필터링 아래에서 모든 이벤트를 선택합니다.
3. 연결 테스트를 선택합니다.

Accoil은 연결을 검증합니다. 성공하면 데이터 스트리밍을 즉시 시작할 수 있습니다.

동기화 설정 구성

이벤트 선택 및 필터링

기본적으로 Amplitude는 모든 이벤트를 전달하도록 선택합니다. 사용자 생애주기 분석 전반에 걸쳐 제품 사용량을 최대한 파악할 수 있도록 이 설정을 활성화된 상태로 유지하십시오.

선택적으로 다음을 수행할 수 있습니다.

• User ID가 있는 이벤트만 포함하도록 필터링합니다.
• 전송할 특정 이벤트 유형을 수동으로 선택하십시오.

속성을 목적지에 매핑

Amplitude의 고유 사용자 식별자를 Accoil에 매핑합니다.

• Amplitude 속성: 제품에서 사용자를 고유하게 식별하는 사용자 속성을 선택합니다(예: user_id, email, 또는 사용자 지정 ID).
• Accoil 속성: 이 속성은 자동으로 userId에 매핑됩니다.

이렇게 하면 모든 이벤트 데이터가 Accoil의 올바른 사용자 프로필과 연결됩니다.

추가 속성 선택(선택 사항)

Accoil로 전송할 추가 이벤트 또는 사용자 속성을 지정합니다. Amplitude는 이러한 정보를 각 이벤트와 함께 메타데이터로 포함합니다.

• 이러한 속성을 사용하여 Accoil 내에서 세그멘테이션, 필터링 및 타겟팅에 사용할 수 있는 데이터를 풍부하게 하십시오.
• 예: trial_end, plan_type, api_key, api_token_id, status.

동기화 완료 및 활성화

1. 구성을 검토하십시오.
2. 상태 스위치를 활성화됨으로 전환합니다.
3. 저장을 선택합니다.

이제 Amplitude 이벤트가 실시간으로 Accoil로 스트리밍됩니다.

그룹 및 계정 정보를 Accoil에 매핑

Amplitude에서 Accoil로 이벤트를 스트리밍할 때, Amplitude는 Amplitude 이벤트 페이로드에서 그룹 수준의 데이터(예: 계정 식별자 및 관련 메타데이터)를 추출하여 이를 Accoil이 계정 수준의 인사이트를 위해 처리할 수 있는 구조에 매핑합니다.

그룹 및 계정 데이터의 출처

Amplitude 이벤트에는 다음이 포함될 수 있습니다.

• 이벤트가 연관된 그룹을 식별하는 groups 객체(예: Account).
• 각 그룹에 대한 메타데이터(예: domain, name 또는 기타 사용자 정의 특성)를 포함하는 group_properties 객체.

Amplitude는 이 두 필드를 함께 사용하여 각 이벤트가 속한 계정(또는 그룹)과 Accoil에서 해당 계정에 어떤 트레잇을 첨부할 것인지 결정합니다.

이벤트에서 그룹 식별

groups 및 group_properties가 모두 이벤트에 존재하는 경우, 매핑 로직:

• 모든 그룹 유형을 반복합니다(예: Account).
• 각 유형별로 그룹 ID를 수집합니다.
• group_properties에서 각 그룹 ID에 대한 연관된 메타데이터(트레잇)를 검색합니다.

그러면 후보 그룹 목록이 생성되며, 각 그룹에는 다음이 포함됩니다.

• groupId: 그룹의 고유 식별자입니다.
• traits: domain, name과 같은 메타데이터 필드 및 기타 관련 속성입니다.

기본 그룹 선택

여러 그룹이 있는 경우 Amplitude는 groupId 기준(오름차순)으로 정렬하고 첫 번째 그룹을 기본 그룹으로 선택합니다. 이를 통해 이벤트에 연결된 그룹 데이터가 일관되게 유지됩니다.

그룹 특성을 Accoil 페이로드에 매핑

기본 그룹을 선택하면 Amplitude는 해당 식별자와 메타데이터를 groupTraits 필드 아래의 Accoil 호환 구조로 포맷합니다.

예를 들면 다음과 같습니다.

"groupTraits": [
  {
    "groupId": "210000",
    "traits": {
      "domain": "accoil.com",
      "group_type": "Account",
      "name": "Released Import Test"
    }
  }
]

Accoil은 이러한 특성을 다음과 같이 사용합니다.

• 계정 프로필 강화.
• 세그멘테이션 및 코호트 분석 지원.
• 레시피와 대시보드 첫 사용 후 필터링 및 타겟팅을 활성화합니다.