시작하기 전에 확인하세요.
준비 사항
Apple Ads Advanced
활성화된 Apple Ads 계정
App Store Connect
광고 계정과 연결된 앱
승인 가능한 역할
Account Admin 또는 Manager
01
Apple Ads에 로그인합니다
광고를 운영하는 Apple 계정으로 Apple Ads Advanced에 로그인하세요.
App Store Connect에 등록된 앱을 광고하는 Apple Ads 계정으로 로그인합니다. 계정 이름 아래에 캠페인 화면이 보이면 준비가 된 상태입니다.
Apple Ads 계정과 App Store Connect 계정이 연결되어 있어야 합니다.
두 서비스에 같은 Apple 계정 이메일을 사용하는 것이 가장 안전합니다.
아직 Apple Ads 계정이 없다면 먼저 Apple Ads에서 계정을 생성하세요.
02
Account Settings를 엽니다
오른쪽 위 계정 메뉴에서 Settings를 선택한 다음 Account Settings 화면으로 이동합니다.
Apple Ads 오른쪽 위의 계정 이름을 누르고 Settings를 선택하세요. 이후 표시되는 Account Settings에서 연결 권한과 API 승인을 확인할 수 있습니다.
03
연결할 사용자의 역할을 확인합니다
User Management에서 현재 사용자가 연결을 승인할 수 있는 역할인지 확인하세요.
App Buddy 같은 외부 서비스에 접근 권한을 부여하려면 현재 사용자가 Account Admin 또는 Campaign Group Manager 역할이어야 합니다. 역할이 다르다면 계정 관리자에게 변경을 요청하세요.
권장
Account Admin
전체 계정과 API 연결을 관리할 수 있습니다.
가능
Campaign Group Manager
허용된 캠페인 그룹의 연결을 승인할 수 있습니다.
확인 필요
Read Only
API 연결을 승인할 수 없는 경우가 있으므로 관리자에게 요청하세요.
04
App Buddy에서 Apple Ads 연결을 시작합니다
App Buddy의 Settings에서 Linked Accounts를 열고 Apple Ads 연결을 선택합니다.
App Buddy
Settings → Linked Accounts → Link an Account → Apple Ads
Connect Apple Ads를 누르면 Apple의 보안 로그인 화면이 열립니다. App Buddy는 Apple 계정 비밀번호를 직접 받지 않으며, Apple에서 발급한 승인 정보만 사용합니다.
비밀번호나 API 키를 App Buddy에 직접 입력하지 마세요.
.p8 키는 Apple Ads 연결 키가 아니므로 업로드하지 않습니다.05
Apple Ads 계정과 권한을 선택합니다
Apple 로그인 후 App Buddy가 접근할 계정과 캠페인 그룹을 선택합니다.
Apple의 승인 화면에서 연결할 Apple Ads 계정을 선택하고 접근 범위를 확인하세요. 처음에는 캠페인 보고서를 읽는 데 필요한 최소 권한만 허용하는 것을 권장합니다.
Apple 로그인
광고 계정 선택
접근 권한 승인
첫 동기화
여러 캠페인 그룹을 사용하는 경우
06
API 탭에서 연결 상태를 확인합니다
승인이 끝나면 Apple Ads의 API 탭과 App Buddy 양쪽에서 연결을 확인하세요.
Apple Ads의 Account Settings → API로 돌아가면 승인한 서비스 제공자가 표시됩니다. App Buddy에서는 계정 상태가 Connected로 바뀌고 첫 데이터 동기화가 시작됩니다.
연결된 Apple Ads 계정 이름이 맞는지 확인합니다.
선택한 캠페인 그룹과 읽기 권한이 맞는지 확인합니다.
첫 동기화가 끝날 때까지 App Buddy를 종료하지 않아도 됩니다. 백그라운드에서 계속 진행됩니다.
07
연결이 안 될 때 확인할 내용
오류 메시지에 따라 아래 항목부터 확인하면 대부분의 연결 문제를 해결할 수 있습니다.
연결할 Apple Ads 계정이 목록에 나오지 않습니다.
Apple Ads와 App Store Connect가 연결되어 있는지, 두 서비스에서 같은 Apple 계정 이메일을 사용하는지 확인하세요.
권한이 부족하다는 메시지가 표시됩니다.
User Management에서 Account Admin 또는 Campaign Group Manager 역할인지 확인하고, 역할을 변경했다면 로그아웃 후 다시 로그인하세요.
App Buddy에서 Connect Apple Ads 버튼이 보이지 않습니다.
현재 설치된 App Buddy 버전에서 Apple Ads OAuth 기능이 아직 활성화되지 않은 상태일 수 있습니다. 업데이트를 확인하거나 지원팀에 문의하세요.
연결은 되었지만 캠페인 데이터가 보이지 않습니다.
첫 동기화에는 시간이 걸릴 수 있습니다. App Buddy의 Linked Accounts에서 마지막 동기화 시각과 선택된 캠페인 그룹을 확인하세요.
NEED HELP?
연결 과정에서 막혔나요?
오류 메시지와 현재 진행 중인 단계만 알려주시면 확인해 드립니다. 비밀번호나 API 키는 보내지 마세요.