# 새 자산 추가하기

## 새 자산 추가 <a href="#undefined" id="undefined"></a>

자산 관리 페이지 내 우측 상단 `새 자산 추가 버튼`을 클릭해 사용할 자산을 신규로 추가할 수 있습니다.

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2F5eT1K8X9v6P9gMPMvzwW%2Fimage.png?alt=media&#x26;token=23be4e3c-7ea3-45f2-8fdd-ed8231b4ad47" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
조직 자산이 등록되어 있지 않다면, 워크스페이스 내에서 자산을 추가할 수 없습니다. \
조직 자산 추가는 [#undefined-1](https://help.xpert.lever.me/xpert_admin_page/xap/asset_mgmt#undefined-1 "mention") 문서를 참조합니다.
{% endhint %}

현재 지원 되는 자산 목록은 다음과 같습니다. 원하는 자산을 선택해 추가할 수 있습니다.

<table data-header-hidden><thead><tr><th width="104"></th><th></th></tr></thead><tbody><tr><td><strong>매체</strong></td><td>카카오 모먼트, 네이버 검색광고, 네이버 NOSP, 크리테오, 메타, 구글애즈, 애플서치애즈, 틱톡, 네이버 GFA, 카카오 키워드, 몰로코, 엑스(구 트위터), 레딧, 카카오 메시지 광고</td></tr><tr><td><strong>트래커</strong></td><td>앱스플라이어, 구글 애널리틱스, 에어브릿지, 카페24 어드민, 카페24 애널리틱스, 네이버 브랜드 스토어</td></tr></tbody></table>

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FeMa3KhnscZyHkgmTo8Ao%2F%EC%9E%90%EC%82%B0%EC%B6%94%EA%B0%80.png?alt=media&#x26;token=33c47492-8e96-4de7-9d06-0766b36e6fc9" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="success" %}
Xpert 내 지원되는 자산 목록은 추가될 예정입니다.
{% endhint %}

### 에어브릿지

1. 연결할 조직 자산을 선택합니다.
2. 조직 자산에 해당하는 앱 이름(Unique ID)를 입력합니다.

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2F2w5ebLGdcI09TvxF37s9%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202024-04-18%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.27.27.png?alt=media&#x26;token=35a68da0-8316-4214-8b4b-72c3514f01aa" alt="" width="563"><figcaption></figcaption></figure>

3. 리포트 타입을 선택합니다.

리포트 타입은 Raw App, Raw Web, Actual 총 3가지 타입을 제공합니다.

* Raw App, Raw Web의 경우 이벤트, 프로퍼티, 필터를 설정할 수 있습니다. \
  입력한 조직 자산과 앱 이름을 이용해 API로 호출한 이벤트, 프로퍼티를 제공합니다.

<div><figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FYvcwiD7PGMFqDvGvDVuJ%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202024-04-18%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.27.59.png?alt=media&#x26;token=3202482f-b70b-4890-b02f-1792bfbf0801" alt=""><figcaption></figcaption></figure> <figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FmA0jWThy1XCT4VWUkq98%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202024-04-18%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.29.51.png?alt=media&#x26;token=c00659e2-04bc-4429-9236-b359b6a19c3b" alt=""><figcaption></figcaption></figure></div>

* Actual은 메트릭, 그룹바이, 필터를 설정할 수 있습니다. \
  입력한 조직 자산과 앱 이름을 이용해 API로 호출한 메트릭, 그룹바이를 제공합니다.

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FmBqfY4KOnuYKkFnoFVNj%2Fimage.png?alt=media&#x26;token=28b751ff-2894-42a8-9c87-0656e32fe624" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
필터 연산자에 대한 설명은 [에어브릿지 필터 연산자 Appendix](https://help.xpert.lever.me/asset_mgmt/add/appendix)를 참고하세요.
{% endhint %}

{% hint style="info" %}
선택한 이벤트/메트릭, 프로퍼티/그룹바이, 필터는 이후 수정할 수 있습니다.

다만, 이미 리포트에서 사용 중인 경우 삭제가 불가능해 자산을 새롭게 추가해야 합니다.
{% endhint %}

{% hint style="success" %}
**S3 Raw** 형식 리포트는 Xpert 버킷에 데일리로 데이터를 dump 해주는 방식으로 \
별도 설정 절차가 필요하오니 담당자에게 문의해주시기 바랍니다.

* S3 Raw App, S3 Raw Web, S3 Raw Tracking Link
  {% endhint %}

### 앱스플라이어 <a href="#undefined" id="undefined"></a>

1. 연결할 조직 자산을 선택합니다.
2. 연결할 앱을 선택합니다.

* AOS, iOS 2가지 타입을 동시에 추가할 수 있으며 각각 1개씩만 추가할 수 있습니다.
* 워크스페이스 설정에서 등록한 앱을 선택할 수도 있고 직접 입력하여 추가할 수도 있습니다.

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FSp2MZ5teCJY9ko31noe4%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202024-04-18%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.37.13.png?alt=media&#x26;token=883fde92-a93b-4013-b705-f3847313cbfe" alt="" width="563"><figcaption></figcaption></figure>

3. 리포트 타입을 선택합니다.

리포트 타입은 raw(오가닉, 논오가닉), aggregate, cohort, skan 4가지 타입이 제공됩니다.

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FnOn9EEdeLzlz12u8E7k7%2Fimage.png?alt=media&#x26;token=711b59e0-b610-4df6-a118-9aaa508c2b2c" alt="" width="563"><figcaption></figcaption></figure>

{% tabs %}
{% tab title="raw 타입" %}

#### raw 타입

raw(오가닉, 논오가닉)는 app별로 install, conversion, ua inappevent, re inappevent 4가지 리포트를 한번에 다운로드 받아 제공해드리고 있습니다.&#x20;

* 오가닉은 install, inappevent 2가지 리포트만 취합합니다.

앱스플라이어 raw의 경우 1회 추출시 최대로 추출할 수 있는 row 수가 100만 row로 제한되어 있어 \
원하시는 이벤트 필터를 설정할 수 있습니다.

* 이벤트 네임을 직접 입력 후 콤마를 입력하면, 하나의 컬럼칩으로 인식되어 모두 입력 후 `추가` 버튼을 클릭하면 해당 이벤트들만 수집하게 됩니다.
* 1일 1회 수집을 시도하며 앱스 API Limit 으로 인해 유저 재수집은 허용하지 않습니다.
  {% endtab %}

{% tab title="aggregate 타입" %}

#### aggregate 타입

aggregate는 앱스플라이어 집약형 데이터입니다.

* 집약형은 최근 7일치 데이터를 매일 정기 수집에서 재수집을 진행합니다.
* 정기수집 타임존을 설정할 수 있으며, 이벤트 별도 설정은 불가능합니다.

{% hint style="info" %}
앱스플라이어의 정책으로 **메타의 경우만 소재 단위까지** 리포트를 확인할 수 있으며, \
타 매체의 경우 **캠페인까지만** 리포트 확인이 가능합니다.
{% endhint %}
{% endtab %}

{% tab title="skan 타입" %}

#### skan 타입

skan은 앱스플라이어의 skan 데이터입니다.

* [앱스플라이어의 정책](https://support.appsflyer.com/hc/ko/sections/6551109855761-Meta-Ads)으로 인해 매일 2일 전 데이터까지만 수집되며, 전일자 데이터는 제공되지 않습니다.
  {% endtab %}

{% tab title="cohort 타입" %}

#### cohort 타입

cohort는 앱스플라이어의 코호트 데이터입니다.

* 최근 60일치를 데이터를 매일 정기 수집에서 재수집을 진행합니다.

입력된 이벤트만을 데이터로 수집하여 제공하오니 원하는 이벤트를 필수 입력해주세요.

* 이벤트 네임을 직접 입력 후 콤마를 입력하면, 하나의 컬럼칩으로 인식되어 모두 입력 후 `추가 버튼`을 클릭하면 해당 이벤트들의 코호트 데이터를 수집하게 됩니다.
* 입력하지 않는 경우 등록되지 않습니다.
  {% endtab %}
  {% endtabs %}

### 구글 애널리틱스 <a href="#undefined" id="undefined"></a>

1. 연결할 조직 자산과 광고 계정을 선택합니다.

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FSMZun3zH2Te2jJ6zv5ju%2Fimage.png?alt=media&#x26;token=0e9145ce-8c8b-423c-83e5-3402f7f31515" alt="" width="375"><figcaption></figcaption></figure>

2. Web Property ID를 선택합니다.

#### GA Web Property ID 확인 방법

1\) [GA 대시보드](https://analytics.google.com/?hl=ko)에 접속, `프로필 아이콘` - `애널리틱스 계정 관리`를 선택합니다.

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2F2DvXFj7KaNzdrMGxLImM%2Fimage.png?alt=media&#x26;token=35245aa4-80f0-4803-b9cc-ac58d4b9634d" alt=""><figcaption></figcaption></figure>

2\) Web Property ID를 통해 UA/GA를 판별하고, UA일 경우 **View ID**을 추가적으로 선택합니다. 속성 및 앱 메뉴에서 각 ID를 확인할 수 있습니다.

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FFKe6RsEVUCv2mON1itbx%2Fimage.png?alt=media&#x26;token=b4ee2fec-7de6-4536-9bdd-c03278ccb99d" alt=""><figcaption></figcaption></figure>

3. Dimension(측정 기준)과 Metric(측정 항목)을 선택합니다.

{% hint style="info" %}
자산 추가 과정 중 **선택한 메트릭 및 그룹바이는 이후 수정되지 않습니다.** 자산 삭제 후 새롭게 추가해야만 합니다.
{% endhint %}

{% hint style="info" %}
Xpert는 GA의 맞춤 보고서와 동일한 형식의 집약형 데이터를 제공합니다.&#x20;

입력한 계정 정보에 따라 Dimension과 Metric을 조회하여 제공하며, 지표별 세팅의 경우 [ga4\_qna](https://help.xpert.lever.me/asset_mgmt/policy/ga4_qna "mention")를 통해 자세한 내용을 확인할 수 있습니다.
{% endhint %}

### 네이버 NOSP <a href="#nosp" id="nosp"></a>

1. 자산 추가를 위해 nosp 광고 리포트 key 계약기간과 key값을 입력합니다.

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FOUB9XDcuyOzYRCauSHtY%2Fimage.png?alt=media&#x26;token=d0786bc8-fc25-4c90-8251-2b518762104d" alt="" width="563"><figcaption></figcaption></figure>

2. key 계약 기간은 NOSP 로그인 후, 대시보드의 `리포트`에서 `캠페인 기간`으로 확인할 수 있습니다. \
   해당 리포트 key 대해 **계약 기간에 해당하는 날짜**에만 데이터가 수집됩니다.

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FXtWBq5LWrF42in5kPCuP%2Fimage.png?alt=media&#x26;token=78ccc9bb-a2ab-492b-93f7-c13449db04c7" alt=""><figcaption></figcaption></figure>

3. 광고 리포트 key는 NOSP 대시보드에서 **리포트 공유하기**를 누르면 확인할 수 있습니다.

{% hint style="warning" %}
**유효 기간**은 key의 유효 기간으로 해당 기간이 지나면 key가 만료되어 더 이상 해당 리포트의 데이터를 수집할 수 없습니다.
{% endhint %}

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2Fi8wqymkmsOQ9hlcEyTIU%2Fimage.png?alt=media&#x26;token=6bdc6178-5e47-42f5-94f7-3e1e13247444" alt=""><figcaption></figcaption></figure>

### 카카오모먼트 메시지 광고 (Beta) <a href="#undefined" id="undefined"></a>

1. 워크스페이스에 카카오모먼트 자산 추가 시, \[프로필 ID] 의 \[설정] 버튼을 클릭합니다.&#x20;

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FH9msajjMK97FZn72XHYl%2Fimage.png?alt=media&#x26;token=f3265a72-36da-4807-b223-d9bd0a29a41f" alt=""><figcaption></figcaption></figure>

2. \[프로필 ID]는 카카오톡채널 관리자센터 >  \[친구 모으기] > \[채널 홍보] > \[채널 홈]에서 확인할 수 있습니다.

* &#x20;채널 URL에서 **<https://pf.kakao.com/> 부분을 제외한 뒷 자리 값**이 해당 채널의 \[프로필 ID] 입니다.&#x20;

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2Fbv5ChCWRIgZu1b7KObH3%2Fimage.png?alt=media&#x26;token=8c920505-8614-4324-a8bb-196cbcd8e5a3" alt=""><figcaption></figcaption></figure>

3. \[프로필 ID] 뒤에 `콤마 (,)` 를 입력하면 하나의 프로필 ID 칩으로 지정됩니다.

* 다수의 프로필 ID를 일괄적으로 입력하여 등록할 수 있습니다.&#x20;

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2F8TuZlhfvTewEuWMIcvMk%2Fimage.png?alt=media&#x26;token=5b18fa29-78a4-4e7b-a015-bf3c10fc0caa" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
단, 채널 프로필 ID를 등록하기 위해선 **조직자산 등록 시 사용한 카카오 계정이 해당 채널에 대한 권한을 보유**하고 있어야 합니다.&#x20;
{% endhint %}

### 이외 자산 <a href="#undefined" id="undefined"></a>

1. 연결할 조직 자산을 선택합니다.

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FC4HVjU7fiRGAfI5QVTOM%2Fimage.png?alt=media&#x26;token=e2af1ff7-d53d-4a0d-b9ca-2240eab2560b" alt="" width="563"><figcaption></figcaption></figure>

2. 해당 조직 자산으로 조회되는 광고 계정 목록을 확인하고 연결할 광고 계정을 선택합니다.
3. 우측 상단 `완료` 버튼을 클릭하면 자산이 추가됩니다.

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FEY1F3vyNyHcjnvzKIPCU%2Fimage.png?alt=media&#x26;token=a447ce71-0846-4f3b-9256-3fa8300a723f" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
최초 추가 시 자산 연결 상태는 OFF 되어있으며 연동 상태는 **대기 중** 상태로 표시됩니다.
{% endhint %}

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2F3ELofm9Xmw5CzImAkoOL%2Fimage.png?alt=media&#x26;token=5fdf94b0-0171-4a03-88e5-4ab9fbf74e21" alt=""><figcaption></figcaption></figure>

## 정기 수집 <a href="#undefined" id="undefined"></a>

정기 수집의 경우 등록한 자산의 연결 상태가 `토글 ON`이 된 경우 Xpert System이 매일 새벽 해당 자산의 데이터를 수집하는 동작입니다.

정기 수집은 고정적으로 이루어지며 자산의 수집 안정성을 높이기 위해 새벽 일찍 수집되고 있습니다.

* 각 자산별 정기 수집 로직은 다르게 설정되어 있으며 해당 로직은 [policy](https://help.xpert.lever.me/asset_mgmt/policy "mention")에서 확인할 수 있습니다.

### 제공되는 타임존 <a href="#undefined" id="undefined"></a>

제공되는 타임존은 아래와 같으며, 직접 수정은 불가하나 Xpert 운영진을 통해 요청해주시면 타임존을 변경할 수 있습니다.

{% hint style="warning" %}
해당 타임존은 **변경하고자 하는 자산에서 제공하는 경우**에만 변경이 가능하오니 이 점 유의해주세요.
{% endhint %}

* apple ( 현재 디폴트: ORTZ - 대시보드 세팅 )
* criteo ( 현재 디폴트: Asia/Seoul )
* moloco ( 현재 디폴트: Asia/Seoul )
* Appsflyer (현재 디폴트: 대시보드 세팅 - preferred\_timezone)

```
class MediaTimezone(str, Enum):
    UTC = "UTC"
    PARIS = "Europe/Paris"
    SEOUL = "Asia/Seoul"
    TOKYO = "Asia/Tokyo"
    NEW_YORK = "America/New_York"
    LONDON = "Europe/London"
    SYDNEY = "Australia/Sydney"
    SINGAPORE = "Asia/Singapore"
    HONG_KONG = "Asia/Hong_Kong"
    MOSCOW = "Europe/Moscow"
    ISTANBUL = "Europe/Istanbul"
    JAKARTA = "Asia/Jakarta"
    BEIJING = "Asia/Shanghai"
    SHANGHAI = "Asia/Shanghai"
    HANOI = "Asia/Ho_Chi_Minh"
    HO_CHI_MINH = "Asia/Ho_Chi_Minh"
    BANGKOK = "Asia/Bangkok"
    KUALA_LUMPUR = "Asia/Kuala_Lumpur"
    MANILA = "Asia/Manila"
    TAIPEI = "Asia/Taipei"
    JERUSALEM = "Asia/Jerusalem"
    CAIRO = "Africa/Cairo"
    CAPE_TOWN = "Africa/Johannesburg"
    JOHANNESBURG = "Africa/Johannesburg"
    RIO_DE_JANEIRO = "America/Sao_Paulo"
    SAO_PAULO = "America/Sao_Paulo"
    BUENOS_AIRES = "America/Argentina/Buenos_Aires"
    MEXICO_CITY = "America/Mexico_City"
    LOS_ANGELES = "America/Los_Angeles"
    CHICAGO = "America/Chicago"
    TORONTO = "America/Toronto"
    VANCOUVER = "America/Vancouver"
    MONTREAL = "America/Montreal"
    CALGARY = "America/Edmonton"
    EDMONTON = "America/Edmonton"
    OTTAWA = "America/Toronto"
    WINNIPEG = "America/Winnipeg"
    HALIFAX = "America/Halifax"
    SASKATOON = "America/Regina"
    REGINA = "America/Regina"
    QUEBEC = "America/Toronto"
    ST_JOHNS = "America/St_Johns"
    ST_JOHN = "America/St_Johns"
```