콘텐츠로 건너뛰기

Amplitude: 사용자 속성 설정

Amplitude: 사용자 속성 설정을 사용하여 Journey 단계에서 참여자의 Amplitude 사용자 프로필을 HTTP API V2의 $identify 작업을 통해 업데이트하여 Amplitude 측의 세분화 및 코호트가 Pushwoosh와 동일한 데이터를 보도록 합니다.

Pushwoosh는 참여자와 이 단계에서 Amplitude의 insert_id를 설정합니다. 즉, 예를 들어 반복되는 Journey의 두 번째 순회에서 동일한 참여자가 이 정확한 지점을 두 번 통과하면 중복 식별 이벤트를 작성하는 대신 동일한 Amplitude 프로필을 업데이트합니다.

일반적인 용도:

  • 태그를 Amplitude 세그먼트로 동기화: 요금제 등급, 체험판 상태 또는 다른 태그를 Amplitude 프로필에 푸시하여 Amplitude 코호트가 Pushwoosh 잠재고객과 일치하도록 합니다.
  • 별도의 동기화 작업 없이 프로필을 최신 상태로 유지: 태그가 변경된 정확한 Journey 단계에서 프로필을 업데이트합니다.
  • 반복에서 중복 식별 호출 방지: 내장된 중복 제거 기능은 이 지점을 반복적으로 통과할 때 두 번 작성하는 대신 동일한 프로필을 업데이트함을 의미합니다.

지점 구성

Anchor link to
  1. 통합 섹션에서 Amplitude: 사용자 속성 설정을 캔버스로 드래그합니다.
  2. 지점을 더블 클릭하고 단계 이름을 입력합니다.
  3. API 키에 Amplitude의 프로젝트 API 키를 입력합니다: 설정 > 프로젝트 > 사용자 프로젝트 > 일반. 웹훅 비밀 헤더처럼 마스킹되어 저장됩니다. Pushwoosh는 저장된 후에는 절대로 표시하거나 반환하지 않으며, 지점의 저장된 요청이나 호출 로그에 나타나지 않습니다.
Amplitude 사용자 속성 설정 서랍, 단계 이름이 채워져 있고 API 키가 마스킹됨
  1. Amplitude 엔드포인트에서 Amplitude 프로젝트가 생성된 지역을 선택합니다: 미국 프로젝트의 경우 api2.amplitude.com, EU 프로젝트의 경우 api.eu.amplitude.com입니다. 한 지역의 키는 다른 지역에서 거부됩니다.
Amplitude 엔드포인트 필드가 api2.amplitude.com으로 설정됨
  1. 사용자 속성에서 Amplitude 프로필에 설정할 속성마다 한 행을 추가합니다. 속성 이름과 값을 입력합니다. 이름은 비어 있지 않아야 하며 고유해야 합니다. 단일 참여자 매크로인 값은 Amplitude에서 자체 유형을 유지합니다({{tag:Age}}는 숫자로, {{tag:Trial Ends}}는 날짜로 도착). 다른 모든 텍스트는 문자열로 전송됩니다. 매크로는 웹훅 본문과 동일한 구문을 사용합니다. 또는 동적 값 삽입을 클릭하여 이 Journey의 이전 단계에서 생성된 속성(예: LLM 응답 또는 매핑된 웹훅 값)을 선택합니다.
사용자 속성 테이블, user_id 및 plan이 장치 및 태그 매크로에 매핑됨
  1. 저장을 클릭합니다.

참여자는 캔버스에서 다음에 연결하는 단계로 계속 진행합니다.

단계 실행 후 속성

Anchor link to
속성내용
amplitude_events_ingestedAmplitude가 수집한 이벤트 수

이후 단계에서 사용하는 방법

Anchor link to

참여자는 이 속성과 관계없이 이미 다음 단계로 진행했습니다. 업데이트가 수집되었는지 확인하거나 조건 분할로 분기해야 하는 경우 사용자 프로필 업데이트를 사용하여 태그에 저장하세요.

실패 및 예기치 않은 응답

Anchor link to

요청이 실패하면 참여자는 Journey에서 제외됩니다. 오류 및 실패한 요청을 참조하세요.

예시 시나리오: 구독자의 Amplitude 프로필 동기화 유지

Anchor link to

한 팀은 참여자의 요금제 등급이 Pushwoosh에서 변경되는 즉시 Amplitude 프로필에 업데이트되기를 원합니다.

  1. 요금제 등급이 변경되는 단계 바로 뒤에 Amplitude: 사용자 속성 설정을 추가합니다. 사용자 속성에서 plan을 {{tag:Plan}}으로 설정합니다.
  2. 저장을 클릭합니다.

이것이 실행되면 Amplitude 프로필은 별도의 동기화 작업 없이 요금제 변경 사항을 반영합니다.