Freshsales Ruby 라이브러리는 웹 애플리케이션을 사용하는 고객의 앱 내 활동을 추적하는 데 도움이 됩니다.
1단계: 시작하기
- 이 스니펫을 복사하여 gem 파일에 붙여넣고 bundle install을 실행하세요.
gem 'freshsales-analytics', git:'git@github.com:freshdesk/freshsales-ruby-sdk.git'
2. yml 파일을 생성하고 웹 앱의 config 폴더에 "fs_analytics_config.yml"이라는 이름으로 저장하세요.
3. 아래 스니펫을 복사하여 생성한 .yml 파일에 붙여넣으세요.
app_token: ‘your freshsales app token’ url: ‘your freshsales portal url’
4. app_token과 url을 귀하의 앱 토큰과 포털 URL로 교체하세요. 이는 관리자 설정 > 통합 > 웹용 Freshsales > Ruby에서 찾을 수 있습니다.
2단계: 리드 생성
아래 스니펫을 사용하여 리드를 생성하고, 가입 및 로그인을 추적할 수 있습니다.
sample_contact = {
'First Name' => 'John', // 사용자의 이름으로 교체
'Last Name' => 'Doe', // 사용자의 성으로 교체
'Email' => 'john@abc.com', // 사용자의 이메일로 교체
‘Custom Field' => 'custom field value', // 사용자 정의 필드로 교체
}
begin
FreshsalesAnalytics::identify('john@abc.com', sample_contact)
rescue FreshsalesAnalytics::Exceptions => exc
p '#{exc.err_obj}: #{exc.message}'
End
웹 양식에 Freshsales에 없는 필드가 있는 경우, 동일한 사용자 정의 필드를 생성하여 값을 Freshsales로 전송할 수 있습니다.
4단계: 페이지뷰 추적
아래 스니펫의 trackPageView를 사용하여 애플리케이션에서 본 페이지를 추적할 수 있습니다.
freshsales.trackPageView('/pricing.html');
5단계: 이벤트 추적
아래 스니펫을 사용하여 사용자 추가, 통합 활성화/비활성화, 비밀번호 재설정, 로그인 횟수 등과 같은 사용자의 앱 내 활동을 Freshsales의 이벤트로 추적할 수 있습니다.
이벤트를 추적하려면,
-
알림을 받고자 하는 특정 콜 투 액션 버튼을 식별하세요.
- 아래 스니펫의 FreshsalesAnalytics::trackEvent 메서드를 호출하세요
sample_event_properties = {
'user email' => 'user@abc.com' //추적하려는 이벤트로 교체
}
begin
FreshsalesAnalytics::trackEvent('Inviting Users', sample_event_properties)
rescue FreshsalesAnalytics::Exceptions => exc
p '#{exc.err_obj}: #{exc.message}'
end
6단계: 리드 및 연락처 정보 업데이트
라이브러리는 또한 웹 양식과 웹앱의 방문자 활동을 통해 리드 및 연락처 정보를 업데이트합니다.
리드/연락처 정보를 업데이트하려면,
- 아래 스니펫의 FreshsalesAnalytics::set 메서드를 호출하세요.
contact_payment = {
“Payment Id” => 129863,
“Plan Name” => “2 agents”,
“Amount”=> $2500,
“Custom Field” => “custom field value” // 사용자 정의 필드로 교체
}
identifier = “john@abc.com”
begin
FreshsalesAnalytics::set(identifier, contact_payment)
rescue FreshsalesAnalytics::Exceptions => exc
p '#{exc.err_obj}: #{exc.message}'
end