> For the complete documentation index, see [llms.txt](https://help.xpert.lever.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.xpert.lever.me/asset_mgmt/add.md).

# 새 자산 추가하기

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

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

<figure><img src="/files/ZGBHvH6jWZIJT2s8Fo2G" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="/files/C28vkkzyIfCVnZrrCmbv" alt=""><figcaption></figcaption></figure>

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

### 에어브릿지

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

<figure><img src="/files/NtvK9j2RytOeMJQSGWqy" alt="" width="563"><figcaption></figcaption></figure>

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

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

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

<div><figure><img src="/files/tyLn6BBPJHkd7JgeeGHp" alt=""><figcaption></figcaption></figure> <figure><img src="/files/UqrhhHmHeteykyAvjDeq" alt=""><figcaption></figcaption></figure></div>

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

<figure><img src="/files/KPgAPDN9RCT4ORLyylUu" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
필터 연산자에 대한 설명은 [에어브릿지 필터 연산자 Appendix](/asset_mgmt/add/appendix.md)를 참고하세요.
{% 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="/files/STdi3ELtC6hQMME2DCCT" alt="" width="563"><figcaption></figcaption></figure>

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

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

<figure><img src="/files/urvTjefoWoCTF8KAvmHW" 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="/files/QJxf6SCNNI5utGYgfhtS" alt="" width="375"><figcaption></figcaption></figure>

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

{% hint style="info" %}
**GA Web Property ID 확인 방법**

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

<img src="/files/NgjE2g0wosmBIFtR0zO9" alt="" data-size="original">

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

<img src="/files/qFbgB2Hka58BqMBsPYsF" alt="" data-size="original">
{% endhint %}

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

컬럼 설정 방식은 `AI 추천 설정` 방법과 `직접 설정` 방법 중 선택할 수 있습니다.

**AI 추천 설정**

1\) GA4의 \[탐색 > 분석]에서 CSV 파일을 다운로드 받아 엑스퍼트에 업로드합니다.

<figure><img src="/files/510Iu6QOFo7FhQ2doRXW" alt=""><figcaption></figcaption></figure>

2\) 업로드한 파일을 AI가 인식해 적합한 GA4 항목을 자동으로 설정해줍니다. \
아래의 측정 기준 및 측정 항목 영역에서 `연필 아이콘`을 클릭해 직접 수정도 가능합니다.

<figure><img src="/files/NfBQbHYXAf3t5GoY74TX" alt=""><figcaption></figcaption></figure>

**직접 설정**

측정 기준 및 측정 항목 영역의 `설정` 버튼을 클릭해 필요한 컬럼을 직접 선택할 수 있습니다.

<figure><img src="/files/rDkjwMCmdUu0Sl4Bbzr7" alt=""><figcaption></figcaption></figure>

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

입력한 계정 정보에 따라 Dimension과 Metric을 조회하여 제공하며, 지표별 세팅의 경우 [GA4 자산 추가 Q\&A](/asset_mgmt/policy/ga4_qna.md)를 통해 자세한 내용을 확인할 수 있습니다.
{% endhint %}

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

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

<figure><img src="/files/bVSSXCZg19ZwA4bnRBjj" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/m18FpAF4152TlHSirtwh" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/9GovUwSa0xXVSSkErCNG" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/6lZ3raIz4YMhE9tAjc5K" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/BJizPoeBNgF0tSC2120z" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/4E9H6z4cx4DlgiWiEoL0" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="/files/1MAAFLugLF3OqDDjpUVK" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/VA8V3tnpWOAWxKJC0Drq" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/rNBQhgIhwSBRV2PcyW2p" alt=""><figcaption></figcaption></figure>

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

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

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

* 각 자산별 정기 수집 로직은 다르게 설정되어 있으며 해당 로직은 [Xpert 수집 정책](/asset_mgmt/policy.md)에서 확인할 수 있습니다.

### 제공되는 타임존 <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"
```