메인 콘텐츠로 건너뛰기

​
개요

BlueConic 웹훅을 사용하면 사이트에서 특정 이벤트가 발생할 때마다 프로필 또는 세그먼트 데이터를 OneSignal에 실시간으로 동기화할 수 있습니다. 이 가이드는 사용자 업데이트 API를 통해 OneSignal로 데이터를 보내도록 BlueConic을 구성하는 방법을 보여줍니다.

​
요구 사항

  • OneSignal이 활성화된 웹 애플리케이션. 시작하려면 웹 푸시 설정을 참조하세요.

​
설정

BlueConic과 OneSignal 간에 사용자 데이터를 동기화하려면 두 플랫폼에서 사용자를 연결하기 위한 공통 식별자가 존재해야 합니다. BlueConic은 BlueConic ID라는 고유 식별자를 생성하며, 이를 OneSignal의 사용자와 연결하여 데이터를 동기화할 수 있습니다.

​
스크립트 업데이트

BlueConic ID를 사용하여 사용자를 식별하기 위한 사용자 지정 별칭을 만드는 것이 좋습니다. 새 별칭을 할당하기 전에 먼저 사용자가 OneSignal에 로그인했는지 확인하세요. 다음 코드는 별칭 및 External ID를 사용하여 BlueConic ID를 OneSignal 사용자와 연결하는 예제를 제공합니다. 
// Get the BlueConic ID
const blueConicId = blueConicClient.profile.getProfile().getId();

// Ensure the user is logged in
// Logged in users will have an External ID
if (!OneSignal.User.externalId) {
await OneSignal.login("EXTERNAL_ID_FROM_YOUR_BACKENED");
}

// External ID must exist before calling this method
OneSignal.User.addAlias('blueconic_profile_id', blueConicId);
시스템에서 BlueConic ID를 기본 식별자로 사용하는 경우 OneSignal.login에 전달합니다. 
// Get the BlueConic ID
const blueConicId = blueConicClient.profile.getProfile().getId();

// Set OneSignal External ID to BlueConic ID
OneSignal.login(blueConicId);

​
웹훅 추가

특정 필요에 따라 웹훅을 사용하여 BlueConic에서 OneSignal로 데이터를 동기화합니다. 아래 예제는 이를 달성하기 위해 사용자 업데이트 API를 사용하는 방법을 보여줍니다. API 세부 정보
URLhttps://api.onesignal.com/apps/<APP_ID>/users/by/alias_label/alias_value
MethodPATCH
AuthorizationBasic <API_KEY>
시스템에서 BlueConic ID를 기본 식별자로 사용하는 경우… 대신 다음 URL을 사용합니다: https://api.onesignal.com/apps/<APP_ID>/users/by/external_id/{{blueconic_profile_id}}

​
프로필 속성 동기화

태그 및 기타 사용자 데이터를 설정하여 BlueConic 프로필 데이터를 OneSignal에 동기화합니다.

태그 업데이트를 위한 예제 구성

페이로드 
{
  "properties": {
    "tags": {
      "tag_name_at_onesignal": "{{BLUECONIC_PROPERTY}}"
    }
  }
}

​
세그먼트 동기화

태그를 설정하여 BlueConic 세그먼트 데이터를 OneSignal에 동기화합니다. 이러한 태그를 사용하여 OneSignal 내에서 직접 세그먼트를 만듭니다.

세그먼트를 동기화 상태로 유지하기 위한 예제 구성

페이로드 
{
  "properties": {
    "tags": {
      "early_bird": "Yes",
    }
  }
}
early_bird와 같은 특정 필요에 따라 태그 이름을 지정하거나 다른 설명 레이블을 지정할 수 있습니다. 그러나 태그에 할당된 값은 BlueConic과 OneSignal 간의 세그먼트 간 일관성을 위해 항상 Yes와 같이 하드 코딩되어야 합니다.