# Cost API 연동

Cost API는 **버즈빌 캠페인의 광고비 데이터를 자동으로 AppsFlyer로 연동**하는 기능이에요.

설정을 완료하면 **성과(전환)**와 **비용 데이터**를 **한눈에 비교**할 수 있어,

**CPI·ROAS 등 주요 지표를 실시간으로 확인**하고 **효율적으로 캠페인을 운영**할 수 있어요.

{% stepper %}
{% step %}

### App ID 공유 <a href="#id-1.-app-id" id="id-1.-app-id"></a>

연동할 앱의 Android와 iOS 각각의 App ID를 버즈빌 담당자에게 전달 해주세요

<figure><img src="https://2858302168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtbPGZ0psEmexY4pu6qdB%2Fuploads%2FDNYZiSNks0DbAeQnVbGv%2Fimage.png?alt=media&#x26;token=c630eb62-6d19-454d-bd2c-bbd8588c1bde" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
AppsFlyer 설정 화면에서 붉은색 표시 영역의 값을 확인하실 수 있어요.
{% endhint %}

&#x20;

{% endstep %}

{% step %}

### **설정 규칙 확인**

아래 규칙과 절차를 따라주세요.

#### **1:1 매핑 필수**

**하나의 c 값**은 **하나의 af\_c\_id 값**과만 연결되어야 해요.

{% hint style="warning" %}
**잘못된 예시:**

**❌ 다대다** 또는 **일대다** 매핑

**❌**  `c`와 `af_c_id` 중 하나라도 **값이 없는 경우**

**❌** 각 파라미터 값이 특정 캠페인이나 그룹을 구분할 수 없는 경우
{% endhint %}

&#x20;

#### **파라미터 정의**&#x20;

트래킹 링크에는 **반드시** `c` **파라미터**와 `af_c_id` **파라미터**가 포함되어야 해요.

<details>

<summary>파라미터 설정값 확인</summary>

| 파라미터      | 의미         |
| --------- | ---------- |
| c         | 캠페인 또는 그룹명 |
| af\_c\_id | 캠페인 ID     |

</details>

{% hint style="success" %}
**트래킹 링크 예시**

```
https://app.appsflyer.com/
com.cost.app
?pid=buzzad_int
&af_click_lookback=7d
&clickid={bz_tracking_id}
&c=cost_app_name
&af_c_id=cost_app_id
```

{% endhint %}

**파라미터 설정값을 확인하셨다면,**

**버즈빌 매체 설정 페이지로 이동** 후 **Cost 연동 활성화 토글 활성화(ON)**&#xB97C; 해주세요.

<figure><img src="https://2858302168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtbPGZ0psEmexY4pu6qdB%2Fuploads%2F5kZKN66vgBiTSioTVzKq%2Fimage.png?alt=media&#x26;token=a5633fc5-000d-4484-98a3-5a9d7b3512fd" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### **🎉** 완료 후 세일즈 매니저에게 공유 <a href="#id-4" id="id-4"></a>

위 작업을 모두 완료하신 후, **담당 세일즈 매니저님께 해당 내용을 반드시 공유**해 주세요.\
추가 작업이나 안내가 필요한 경우 빠르게 안내 해드릴게요.