> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BlueConic

> BlueConic에서 OneSignal로 데이터 동기화

## 개요

[BlueConic 웹훅](https://support.blueconic.com/hc/en-us/articles/115004431305-Webhook-Connection)을 사용하면 사이트에서 특정 이벤트가 발생할 때마다 프로필 또는 세그먼트 데이터를 OneSignal에 실시간으로 동기화할 수 있습니다. 이 가이드는 [사용자 업데이트](/reference/update-user) API를 통해 OneSignal로 데이터를 보내도록 BlueConic을 구성하는 방법을 보여줍니다.

## 설정

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

### 스크립트 업데이트

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

<CodeGroup>
  ```javascript javascript theme={null}
  // 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);

  ```
</CodeGroup>

시스템에서 BlueConic ID를 기본 식별자로 사용하는 경우 `OneSignal.login`에 전달합니다.

<CodeGroup>
  ```javascript javascript theme={null}
  // Get the BlueConic ID
  const blueConicId = blueConicClient.profile.getProfile().getId();

  // Set OneSignal External ID to BlueConic ID
  OneSignal.login(blueConicId);
  ```
</CodeGroup>

### 웹훅 추가

특정 필요에 따라 웹훅을 사용하여 BlueConic에서 OneSignal로 데이터를 동기화합니다. 아래 예제는 이를 달성하기 위해 [사용자 업데이트](/reference/update-user) API를 사용하는 방법을 보여줍니다.

**API 세부 정보**

|               |                                                                            |
| ------------- | -------------------------------------------------------------------------- |
| URL           | `https://api.onesignal.com/apps/<APP_ID>/users/by/alias_label/alias_value` |
| Method        | PATCH                                                                      |
| Authorization | Basic \<API\_KEY>                                                          |

시스템에서 BlueConic ID를 기본 식별자로 사용하는 경우...

대신 다음 URL을 사용합니다:

`https://api.onesignal.com/apps/<APP_ID>/users/by/external_id/{{blueconic_profile_id}}`

### 프로필 속성 동기화

[태그](./add-user-data-tags) 및 기타 사용자 데이터를 설정하여 BlueConic 프로필 데이터를 OneSignal에 동기화합니다.

<Frame caption="태그 업데이트를 위한 예제 구성">
  <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/924b855b7ab5f4626de59cd6146470e446ba41880c8f4b9a7a9c065ca8c0590f-Screenshot_2024-11-26_at_11.28.49_AM.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=1fec9fc3a9555005a21c6ef421a3f09f" width="3296" height="2780" data-path="images/docs/924b855b7ab5f4626de59cd6146470e446ba41880c8f4b9a7a9c065ca8c0590f-Screenshot_2024-11-26_at_11.28.49_AM.png" />
</Frame>

**페이로드**

<CodeGroup>
  ```json json theme={null}
  {
    "properties": {
      "tags": {
        "tag_name_at_onesignal": "{{BLUECONIC_PROPERTY}}"
      }
    }
  }
  ```
</CodeGroup>

#### 세그먼트 동기화

[태그](./add-user-data-tags)를 설정하여 BlueConic 세그먼트 데이터를 OneSignal에 동기화합니다. 이러한 태그를 사용하여 OneSignal 내에서 직접 세그먼트를 만듭니다.

<Frame caption="세그먼트를 동기화 상태로 유지하기 위한 예제 구성">
  <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/3f5e229f8bc0a85ccee76fded108ec5407cedce9cf6f651b687de7802430a6b8-Screenshot_2024-11-26_at_11.23.52_AM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=06f2ef40620798fca49cdba278f6c537" width="3298" height="2884" data-path="images/docs/3f5e229f8bc0a85ccee76fded108ec5407cedce9cf6f651b687de7802430a6b8-Screenshot_2024-11-26_at_11.23.52_AM.png" />
</Frame>

**페이로드**

<CodeGroup>
  ```json json theme={null}
  {
    "properties": {
      "tags": {
        "early_bird": "Yes",
      }
    }
  }
  ```
</CodeGroup>

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

***