# 새 자산 추가하기

## 새 자산 추가 <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>카카오 모먼트, 네이버 검색광고, 네이버 NOSP, 크리테오, 메타, 구글애즈, 애플서치애즈, 틱톡, 네이버 GFA, 카카오 키워드, 몰로코, 엑스(구 트위터), 레딧, 카카오 메시지 광고</td></tr><tr><td><strong>트래커</strong></td><td>앱스플라이어, 구글 애널리틱스, 에어브릿지, 카페24 어드민, 카페24 애널리틱스, 네이버 브랜드 스토어</td></tr></tbody></table>

<figure><img src="/files/KomLvQiPxmtPfAvA1Kik" alt="" width="375"><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를 선택합니다.

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

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

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

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

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

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

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

{% 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"
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.xpert.lever.me/asset_mgmt/add.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.