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

# 채널 연동하기 - 애플 애즈

애플 애즈와 에어브릿지의 채널 연동과 캠페인 매니지먼트 API 연동을 완료하면 애플 애즈의 광고에서 발생한 데이터를 에어브릿지에서 확인할 수 있습니다.

<Info>
  **알립니다**

  애플 애즈는 [SKAN (SKAdNetwork)](/ko/guides/skadnetwork-overview)와 별개로 광고 성과를 측정합니다.
</Info>

## 채널 연동하기

채널 연동을 완료하면 애플 애즈의 광고에서 발생한 어트리뷰션 데이터를 에어브릿지에서 확인할 수 있습니다. 이를 위해서는 앱에 에어브릿지 iOS SDK를 설치해야 합니다.

### 에어브릿지 SDK 설치하기

애플 애즈를 사용하기 위해서 아래 표시된 버전 이상의 에어브릿지 SDK를 설치해야 합니다. 에어브릿지 SDK 설치 방법에 따라 프레임워크 설정이 필요할 수 있습니다. 자세한 내용은 [에어브릿지 가이드](/ko/developers/ios-sdk-v4#ios-sdk-%EC%84%A4%EC%B9%98%ED%95%98%EA%B8%B0)를 참고하세요.

| SDK               | 최소 버전  |
| ----------------- | ------ |
| iOS SDK           | 1.15.3 |
| React Native SDK  | 1.3.1  |
| Cordova-Ionic SDK | 1.3.2  |
| Flutter SDK       | 1.3.0  |
| Expo SDK          | 2.0.0  |
| Unity SDK         | 1.3.0  |
| Unreal SDK        | 1.0.0  |

<Danger>
  **알립니다**

  에어브릿지 iOS SDK를 [직접 설치](/ko/developers/ios-sdk-v4#ios-sdk-설치하기) 하는 경우, 에어브릿지 프레임워크의 의존성을 추가해야 합니다.
</Danger>

### 기여 기간 설정하기

\[기여 기간] 탭에서 애플 애즈의 기여 기간을 설정할 수 있습니다. 설정할 수 있는 기여 기간에는 룩백 윈도우와 어트리뷰션 윈도우가 있습니다. '수정 페이지로 가기'를 클릭하면 기여 기간을 수정할 수 있는 페이지로 이동합니다. 기여 기간을 설정하는 방법은 [에어브릿지 가이드](/ko/guides/setting-attribution-window)를 참고해 주세요.

<AccordionGroup>
  <Accordion title="룩백 윈도우 기본 설정">
    애플 애즈의 룩백 윈도우 기본 설정은 30일입니다. 이 기본 설정은 애플 애즈와 에어브릿지의 데이터 수치 차이를 최소화하는 일수이기 때문에 수정하지 않는 것을 권장합니다.
  </Accordion>

  <Accordion title="사전 주문 마케팅 룩백 윈도우">
    애플 애즈의 [사전 주문 마케팅](https://developer.apple.com/kr/app-store/pre-orders/)로 발생한 터치포인트의 룩백윈도우는 기여기간 설정과 관계 없이 90일입니다. 해당 룩백윈도우는 사전 주문 마케팅 캠페인에만 적용됩니다.

    에어브릿지 대시보드에서 사전 주문 마케팅의 룩백 윈도우를 확인하거나 수정할 수 없습니다. 사전 주문 마케팅의 룩백윈도우를 수정하고 싶다면 에어브릿지 CSM에게 요청해 주세요. 담당 CSM이 없는 경우 [문의하기](https://app.airbridge.io/supports)를 통해 요청해 주세요.
  </Accordion>
</AccordionGroup>

## 캠페인 매니지먼트 API 연동하기

캠페인 매니지먼트 API 연동을 완료하면 애플 애즈의 캠페인 정보인 캠페인 이름, 광고그룹 이름, 키워드, 광고 소재 등을 에어브릿지에서 확인할 수 있습니다.

캠페인 매니지먼트 API를 연동해야 채널 연동으로 받은 애플 애즈의 어트리뷰션 데이터를 에어브릿지에서 캠페인 이름, 광고그룹 이름같은 캠페인 정보와 함께 확인할 수 있습니다. 캠페인 매니지먼트 API를 연동하기 전에는 국가, 캠페인 ID, 광고그룹 ID, 키워드 ID, 광고소재 ID 등만 확인할 수 있습니다.

### 에어브릿지에서 설정하기

<Info>
  **알립니다**

  캠페인 매니지먼트 API 연동과 비용 연동은 애플 애즈 어드밴스드(Advanced) 솔루션에서만 할 수 있습니다. 자세한 내용은 [애플 애즈 가이드](https://searchads.apple.com/kr/help/apple-search-ads-basic/0001-compare-apple-search-ads-solutions)를 참고하세요. 어드밴스드 솔루션을 이용하지 않는 등 애플 애즈의 캠페인 매니지먼트 API 연동을 할 수 없으면 에어브릿지에 직접 비용 데이터를 업로드해 주세요.

  * [광고 비용 데이터 업로드하기](/ko/guides/data-upload-ad-spend)
</Info>

1. 에어브릿지 대시보드 \[연동]>\[광고 채널 연동]에서 '애플 애즈'를 선택합니다.

2. \[캠페인 API 연동] 탭에 있는 \[캠페인 매니지먼트 API 연동] 토글을 활성화합니다.

3. '연동 캠페인 그룹 추가'를 클릭해 애플 계정에 로그인하세요. 애플 계정에 로그인한 후에 에어브릿지의 접근 권한을 \[계정 읽기 전용]으로 부여합니다. 이 접근 권한은 에어브릿지가 로그인한 애플 계정에 있는 모든 캠페인 그룹의 정보에 접근하도록 허용합니다.

<Info>
  **알립니다**

  로그인하는 애플 계정은 애플 애즈 어드밴스드 솔루션을 사용해야 하며 계정 관리자 권한을 갖고 있어야 합니다. 또한 이 계정은 최근 광고 캠페인을 집행한 기록이 있어야 합니다.
</Info>

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/0NLx_yaUdxu9z1c9/asset/image/apple-search-ads-campaign-selection-ko.png?fit=max&auto=format&n=0NLx_yaUdxu9z1c9&q=85&s=7cc9d9719de3341d1d132fd17804fe7c" alt="05-kr-applesearchad" width="1400" height="800" data-path="asset/image/apple-search-ads-campaign-selection-ko.png" />
</Frame>

4. 연동이 완료되면 연동된 캠페인 그룹이 연동 목록에 추가됩니다.

### 연동 정보 관리하기

아래처럼 연동 정보를 관리할 수 있습니다.

<AccordionGroup>
  <Accordion title="캠페인 매니지먼트 API 연동 중지하기">
    <Info>
      **알립니다**

      [대행사 설정](/ko/guides/agency-setting)에서 권한을 부여받은 대행사 사용자는 캠페인 매니지먼트 API 연동을 시작 또는 중지할 수 있습니다. 앱 역할에 따라 아래 사항을 확인하세요.

      * 오너 또는 사내 마케터: 토글 수정을 허용할 대행사를 제외한 계정의 캠페인 그룹 정보를 모두 삭제하세요. 해당 대행사를 제외한 계정의 정보가 있다면 대행사는 토글을 수정할 수 없습니다.
      * 대행사: 연동을 중지하기 위해서는 목록에 있는 캠페인 그룹 정보를 모두 삭제한 후에 토글을 비활성화하세요. 토글을 수정할 수 없다면 오너 또는 사내 마케터에게 문의하세요.

      대행사 사용자 권한에 대한 자세한 내용은 [에어브릿지 가이드](/ko/guides/agency-setting#접근-권한이-허용된-대행사-사용자의-권한)를 참고하세요.
    </Info>

    \[캠페인 매니지먼트 API 연동] 토글을 비활성화하면 연동이 중지됩니다. 에어브릿지는 연동이 중지된 순간부터 캠페인 매니지먼트 API를 통해 데이터를 가져오지 않습니다. 그러나 중지 이전의 데이터는 계속해서 확인할 수 있습니다.

    에어브릿지와 연동된 애플 애즈의 계정 정보와 캠페인 그룹은 연동 목록에서 삭제하지 않는 한 계속 저장됩니다. \[캠페인 매니지먼트 API 연동] 토글을 다시 활성화하면 저장된 계정 정보를 불러올 수 있습니다. 이때 별도의 로그인은 필요하지 않습니다.
  </Accordion>

  <Accordion title="캠페인 매니지먼트 API 연동 계정 삭제하기">
    연동 목록에서 삭제하고 싶은 캠페인 그룹이 있다면 해당 캠페인 그룹을 선택하면 나오는 '삭제'를 클릭합니다.
  </Accordion>
</AccordionGroup>

## 주의사항

아래 사항을 주의해 주세요.

<AccordionGroup>
  <Accordion title="ATT 동의 여부에 따른 애플 애즈 성과">
    애플 애즈는 ATT(App Tracking Transparency, 앱 추적 투명성)에 동의하지 않은 유저의 클릭 타임스탬프를 에어브릿지로 제공하지 않습니다. 에어브릿지는 어트리뷰션에서 타임스탬프가 없는 터치포인트를 타임스탬프가 있는 터치포인트보다 낮은 우선순위로 처리하기 때문에 ATT 동의율에 따라 애플 애즈의 광고 성과가 변경될 수 있습니다. 아래 테이블을 참고하세요.

    | <span style={{ display: 'inline-block', minWidth: '80px' }}>ATT 동의 여부</span> | <span style={{ display: 'inline-block', minWidth: '100px' }}>애플 애즈의<br />타임스탬프 제공 여부</span> | <span style={{ display: 'inline-block', minWidth: '140px' }}>설명</span>        |
    | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
    | O                                                                            | 제공함                                                                                         | 에어브릿지에서 일반적인 [확정적 방법](/ko/guides/identity-matching#확정적-방법)으로 터치포인트를 어트리뷰션합니다. |
    | X                                                                            | 제공하지 않음                                                                                     | 타임스탬프가 제공되지 않기 때문에 터치포인트는 에어브릿지 어트리뷰션에서 일반적인 확정적 방법보다 우선순위가 낮습니다.             |
  </Accordion>

  <Accordion title="애플 애즈와 에어브릿지 대시보드에서 발생하는 수치 차이">
    애플 애즈와 에어브릿지 대시보드에서 보이는 전환 데이터에 차이가 발생할 수 있습니다. 수치 차이는 광고 추적 제한 기능 사용, 애플 내부 로직 처리 속도 차이 등 다양한 원인으로 인해 발생할 수 있습니다. 애플 애즈에서 발생하는 수치 차이에 대한 자세한 내용은 [에어브릿지 가이드](/ko/guides/apple-search-ads-discrepancy)를 참고하세요.
  </Accordion>
</AccordionGroup>

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/guides/apple-search-ads-channel-integration" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/guides/apple-search-ads-channel-integration" />