애플 서치 애드(Apple Search Ads)는 유저들이 iPhone 및 iPad 용 앱스토어에서 검색을 할 때 가장 효과적이면서도 손쉽게 여러분의 앱 서비스를 발견할 수 있도록 하는 광고로, 검색 탭에서 검색 전 노출되는 Suggested Apps List에 광고를 노출시키거나 검색 후 검색 결과 최상단에 광고를 노출시킬 수 있습니다.

아래 가이드를 참고하여 애플 서치 애드 광고를 운영하고 에어브릿지에서 성과를 확인해 보시길 바랍니다.

 

 

기본 설정

  1. 에어브릿지 iOS SDK 1.15.3 이상의 버전으로 업데이트 또는 설치합니다.
    • Cocoapods을 통해 SDK를 설치했다면 애플 서치 애드 성과 측정에 필요한 Framework들이 자동으로 적용됩니다.
    • 만약 Cocoapods을 사용하지 않고 Airbridge iOS SDK 를 직접 설치했다면, 에어브릿지 개발 가이드를 참고하여 AirBridge.framework 및 Dependency framework을 직접 적용해주세요.
  2. 애플 서치 애드 대시보드에서 캠페인 생성 후 광고를 운영합니다. 애플 서치 애드는 성과 측정을 위해 별도의 트래킹링크를 생성할 필요가 없습니다.
  3. 애플 서치 애드 광고에 기여된 전환이 발생하면 에어브릿지 대시보드에서 해당 성과 데이터를 확인할 수 있습니다.

 

 

기여 성과 확인

iAd Framework와 AdService Framework

애플 서치 애드의 성과 측정에는 애플에서 제공하는 기존 'iAd Framework'와 iOS 14 릴리즈와 함께 새롭게 추가된 'AdService Framework'이 모두 사용됩니다.

iAd 프레임워크는 AdService 프레임워크에 비해 더욱 풍부한 어트리뷰션 데이터를 제공하지만 iOS 14.5 이상 버전의 디바이스에서 ATT Status가 'Authorized'가 아닌 경우에는 어트리뷰션 데이터를 제공하지 않으며, 이와 같이 iAd 에서 어트리뷰션 데이터를 가져오지 못하는 경우에는 ATT Status와 상관없이 어트리뷰션 데이터를 제공하는 AdService 프레임워크를 활용합니다.

아래와 테이블과 같이 iAd 프레임워크와 AdService 프레임워크에서 제공하는 어트리뷰션 데이터 중 캠페인 관련 데이터 필드가 서로 상이하며, AdService 프레임워크에서는 이름값은 제공하지 않고 ID 값만을 제공하고 있습니다. 

Data Field

iAd

AdService
캠페인 명 (Campaign Name) 지원 미지원
캠페인 ID (Campaign ID) 지원 지원
광고그룹 명 (Ad Group Name) 지원 미지원
광고그룹 ID (Ad Group ID) 지원 지원
키워드 (Keyword) 지원 미지원
키워드 ID (Keyword ID) 지원 지원
광고소재 (Creative Name) 지원 미지원
광고소재 ID (Creative ID) 지원 지원

 

 

대행사 권한의 기여 성과 확인

애플서치애드의 데이터는 기본적으로 오너 및 사내마케터에게만 데이터 접근 권한이 부여됩니다. 특정 대행사에게 데이터 접근 권한을 부여하기 위해서는 [Integrated Ad Channels > Apple Search Ads > 대행사 설정]에서 대행사를 설정해주시기 바랍니다.

mceclip0.png

 

 

캠페인 매니지먼트 API

애플은 iOS 14.5 업데이트부터 개인정보보호 정책을 강화했습니다. 이 업데이트 이후, 기존 애플 서치 애드의 성과 측정에 사용한 iAd 프레임워크는 디바이스의 ATT 승인(Authorized) 상태인 경우에만 애플 서치 애드의 어트리뷰션 데이터를 전달합니다. 대신 애플의 새로운 프레임워크 AdService가 ATT 상태와 관계없이 어트리뷰션 데이터를 제한된 형태로 제공합니다. 이에 따라 에어브릿지 대시보드에 애플 서치 애드에서 부여한 캠페인 ID가 실제 캠페인 이름 대신 표기됩니다.

애플의 캠페인 매니지먼트 API(캠페인 API)는 iOS 14.5 업데이트 이전처럼 에어브릿지 대시보드에서 캠페인 성과를 캠페인의 실제 이름으로 확인할 수 있는 기능을 제공합니다. 단, 애플은 애플 서치 애드 어드밴스드(Advanced)에만 API를 제공하고 있습니다. 애플 서치 애드 베이직(Basic)은 캠페인 매니지먼트 API를 사용할 수 없습니다.

에어브릿지는 애플 서치 애드 계정을 에어브릿지에 연동해 캠페인 매니지먼트 API를 사용할 수 있는 환경을 제공하고 있습니다.

 

 

API 연동

애플 서치 애드 계정과 에어브릿지를 연동하는 방법은 다음과 같습니다.

1. [Integrated Ad Channels]>[애플 서치 애드]를 클릭합니다.

dm_ASA_20220722_02.png

2. [애플 서치 애드]에서 [캠페인 API] 메뉴에 있는 캠페인 매니지먼트 API(캠페인 API) 연동 토글 버튼을 클릭해 활성화합니다. 현재 연동된 애플 서치 애드 계정이 없을 경우, 토글 버튼은 회색입니다. 연동된 계정이 있으면 토글 버튼은 초록색입니다.

dm_ASA_20220722_03.png

3. 연동된 애플 서치 애드 계정이 없으면 애플 계정 로그인이 필요합니다. 여기서 로그인하는 애플 계정은 광고 캠페인을 진행하고 있는 관리자 권한이 있는 계정이어야 합니다.

애플 서치 애드 계정 로그인 후, 접근 권한을 계정 읽기 전용 또는 제한된 액세스로 허용합니다. 제한된 액세스를 선택할 경우, 권한을 허용할 캠페인 그룹을 골라야 합니다. 계정 읽기 전용 권한은 애플 계정에 있는 모든 캠페인 그룹에 관한 정보를 허용합니다. 특정 캠페인 그룹 정보만 허용하고자 한다면 제한된 액세스 권한을 선택해야 합니다. 

dm_ASA_20220722_04.png

4. 에어브릿지 대시보드에서 연동할 애플 서치 애드 캠페인 그룹을 선택합니다.

dm_ASA_20220722_05.png

5. 연동이 완료되면 연동된 캠페인 그룹이 [캠페인 API] 메뉴 하단에 있는 리스트에 추가됩니다. 이 리스트에서 계정 연동 정보를 전부 확인할 수 있습니다.

dm_ASA_20220722_06.png

 

 

연동 중단하기

애플 서치 애드 계정과 에어브릿지의 연동 중단은 [Integrated Ad Channels]>[애플 서치 애드]>[캠페인 API] 메뉴에서 활성화된 캠페인 매니지먼트 API(캠페인 API) 연동 토글 버튼을 클릭하면 됩니다. 성공적으로 연동이 중단됐다면 버튼의 색은 회색이 됩니다.

캠페인 매니지먼트 API는 계정 연동을 중단한 순간부터 데이터를 가져오지 않습니다. 계정 연동을 중단하더라도, 중단 이전의 데이터는 계속해서 확인할 수 있습니다.

dm_ASA_20220722_08.png

에어브릿지와 연동된 애플 서치 애드 계정 정보는 이 계정들과 연동된 캠페인 그룹을 삭제하기 전까지 저장됩니다. 캠페인 매니지먼트 API 연동 토글이 다시 활성화되면 저장된 계정 정보를 불러옵니다. 별도의 로그인 과정은 필요하지 않습니다. 연동된 계정 정보는 캠페인 그룹을 삭제하면 함께 삭제됩니다.

애플 서치 애드 계정과 연동된 캠페인 그룹은 [Integrated Ad Channels]>[애플 서치 애드]>[캠페인 API] 메뉴 하단 리스트의 가장 오른쪽에 있는 [관리]에서 삭제를 원하는 캠페인 그룹에 해당하는 항목을 클릭해 삭제할 수 있습니다.

dm_ASA_20220722_01.png

 

 

자주 묻는 질문

Q. 애플 서치 애드 계정 종류에 상관없이 에어브릿지와 연동하면 실제 캠페인 이름을 확인할 수 있나요?

아닙니다. 애플은 캠페인 매니지먼트 API(캠페인 API)를 애플 서치 애드 어드밴스드(Advanced)에만 제공하고 있습니다. 애플 서치 애드 베이직(Basic)은 캠페인 매니지먼트 API를 사용할 수 없습니다. 계정 연동 전, 애플 서치 애드 계정이 애플 서치 애드 어드밴스드인지 확인해야 합니다.

 

Q. 애플 서치 애드 계정이 에어브릿지에 연동되면 계정을 연동하기 전 수집한 데이터에 있는 ID의 실제 캠페인 이름을 확인할 수 있나요?

네, 로우 데이터 추출(Raw Data Export) 기능을 통해서 확인할 수 있습니다. 이 기능으로 계정을 연동하기 전 수집한 데이터에 있는 캠페인 ID의 실제 캠페인 이름을 확인할 수 있습니다.
그러나 액츄얼 리포트(Actuals Report)에서는 계정 연동 이후에 수집한 캠페인 ID의 실제 캠페인 이름만 확인할 수 있습니다. 계정 연동 이전 수집한 캠페인 ID의 실제 캠페인 이름은 확인할 수 없습니다.

 

Q. 연동 이후, 애플 서치 애드에서 부여한 임의의 ID가 실제 캠페인 이름으로 바뀌는 과정이 실시간으로 진행되나요? 그리고 이 과정을 액츄얼 리포트에서 확인할 수 있나요?

정상적으로 연동하더라도 액츄얼 리포트에서 ID가 실제 캠페인 이름으로 바뀌는 과정은 실시간으로 진행되지 않습니다.
실제 캠페인 이름이 액츄얼 리포트에 반영돼, ID 대신 나오는 데 걸리는 시간은 최대 48시간입니다. 이보다 빨리 확인하기 위해서는 로우 데이터 추출 기능을 사용하면 됩니다. 계정 연동 이후, 로우 데이터 추출 기능은 4시간마다 ID 값에 해당하는 실제 캠페인 이름을 찾습니다.

 

Q. 에어브릿지 대시보드에서 애플 서치 매치(Search Match)의 키워드를 확인할 수 있나요?

확인할 수 없습니다. 에어브릿지는 애플 서치 애드에서 서치 매치 기능에 관한 데이터(Term ID 등)를 API를 통해 받지 않습니다. 서치 매치에 관한 성과는 애플 서치 애드의 대시보드에서 확인할 수 있습니다.

mceclip0.png

 

 

비용 연동

에어브릿지 대시보드에서 애플 서치 애드 계정 로그인을 통해 캠페인을 운영 중인 계정의 비용 데이터를 연동하여 전환 성과와 함께 조회할 수 있습니다.

비용 연동을 통해서 조회할 수 있는 캠페인 및 광고 그룹 레벨의 데이터는 다음과 같습니다.

  • Metrics
    • 노출수: Impressions (Channel)
    • 클릭수: Clicks (Channel)
    • 광고비용: Cost (Channel)
  • Groupby
    • Event Datetime 필드: Event Date, Event Year, Event Month, Event Week, Event Day of the month, Event Day of the week, Event Hour 
    • 캠페인 파라미터: Channel, Campaign, Ad Group, Term, Campaign ID, Ad Group ID, Term ID, Ad Account ID, Country 

 

 

설정하기

비용 연동을 설정하는 방법은 다음과 같습니다. 

  1. [Integrated Ad Channels]>[애플 서치 애드]>[비용 연동] 메뉴에서 비용 연동 토글을 켭니다.
    ASA_cost1.png
  2. 애플 계정 로그인 버튼을 누르고 현재 캠페인을 운영하고 있는 계정으로 로그인 합니다.
    ASA_cost2.png
  3. 애플 서치 애드 계정 로그인 후 에어브릿지의 접근 권한을 허용합니다.
    ASA_cost3.png
    ASA_cost4.png
  4. 에어브릿지 대시보드에 연동할 애플 서치 캠페인 그룹을 선택합니다. 로그인 된 계정이 볼 수 있는 캠페인 그룹들 중 연동이 정상적으로 이뤄진 캠페인 그룹은 리스트에 노출되지 않습니다.
    ASA_cost5.png
  5. 연동이 완료되면 연동된 캠페인 그룹이 리스트에 추가되며, 연동 정보를 확인할 수 있습니다. 대시보드에서 설정을 변경하는 경우 최근 수정일 및 해당 액션을 수행한 최근 수정 계정 정보가 캠페인 그룹 리스트 위에 표기됩니다. 화살표 아이콘을 클릭하여 해당 날짜 및 'Apple Search Ads' 로 검색된 Activity History로 빠르게 이동할 수 있습니다.
    ASA_cost_sucess.png
blockquote-check.svg

애플 서치 애드 계정 로그인 오류 해결 방법

애플 서치 애드는 브라우저 캐시 문제로 인해 동일 브라우저에서 2가지 이상의 계정으로 로그인 시도할 경우 오류가 발생할 수 있습니다. 이 경우 새로운 계정으로 로그인을 하기 전, 브라우저 캐시를 삭제하면 로그인할 수 있습니다.

 

 

중단하기

  • ‘비용 연동 토글’을 비활성화하면 연동된 모든 캠페인 그룹을 통한 비용 연동이 중단됩니다.
  • 연동을 중지하는 시점부터 데이터를 가져오지 않으며, 연동 중단 이전의 데이터는 계속 확인할 수 있습니다.
  • 연동된 캠페인 그룹을 삭제하지 않은 상태로 '비용 연동' 토글만 비활성화하면 연동된 계정 정보는 저장됩니다.
  • 이후 토글을 다시 활성화하면 저장되었던 계정 정보를 불러오며 별도의 로그인이 필요하지 않습니다.

ASA_cost_suspend.png

 

연동 계정 삭제

잘못된 캠페인 그룹을 연동했거나 해당 광고 계정으로 더이상 광고를 운영하지 않는 경우 연동된 광고 계정 테이블의 우측에 위치한 [관리]에서 '삭제' 버튼을 클릭하여 광고 계정을 삭제할 수 있습니다.

_ASA_Cost_account_delete.png

 

캠페인 그룹 추가

기존에 연동을 완료한 캠페인 그룹 계정 외에 동일한 앱에 대해서 애플 서치 애드 광고를 운영하는 캠페인 그룹이 추가된 경우 '애플 계정 로그인' 버튼을 클릭하여 캠페인 그룹을 추가로 등록할 수 있습니다. 이후 과정은 비용 연동 설정과 동일합니다.

 

 

비용 데이터 참고사항

업데이트 주기

'애플 서치 애드 비용 연동' 토글이 활성화 상태에서 캠페인 그룹 등록이 완료되면 비용 데이터 수집이 시작됩니다. 에어브릿지는 비용 데이터를 매일 KST(한국표준시간) 오전 12시(0시)부터 4시간 주기로 하루 총 6번(0시, 4시, 8시, 12시, 16시, 20시) 업데이트합니다. 주기마다 오늘(D-0)부터 6일 전(D-6)까지의 비용 데이터가 업데이트됩니다.

 

연동 상태

  • Waiting: 캠페인 그룹 추가 후 4시간 간격의 업데이트가 진행되기 전까지의 대기 상태입니다. 
  • Active: 정상적으로 비용 데이터 업데이트가 완료되었으며, 가장 최근의 업데이트 완료 시간이 노출됩니다.
  • Error: 아래 상황 중 하나에 해당하는 경우, 비용 데이터가 정상적으로 업데이트되지 않습니다.
    • 애플 로그인 정보가 올바르지 않습니다
      • 로그인 에러로, 연동된 계정의 비밀번호 변경 등과 같은 이슈로 인해 발생합니다. 이슈 해결을 위해서는 해당 계정을 삭제 후 캠페인 그룹을 다시 등록합니다.
    • 애플 API가 응답하지 않습니다
      • 가장 최근에 진행된 업데이트 작업에서 Apple Search Ads API가 응답하지 않은 경우입니다.
  • Warning: 가장 최근에 진행된 업데이트 작업에서 데이터를 업데이트 시도하였으나 오늘 포함 최근 7일 동안 캠페인이 운영되지 않아 연동된 데이터가 없는 경우입니다.
  • Expired: 아래 상황 중 하나에 해당하는 경우, 비용 데이터가 정상적으로 업데이트 되지 않습니다.
    • 애플 서치 애드 연동 토큰이 만료된 경우
    • 애플 서치 애드 대시보드에서 사용자가 직접 Airbridge Dashboard 앱의 Access 권한을 삭제한 경우
    • 연동된 캠페인 그룹이 비활성화된 경우

 

 

데이터 조회하기

연동된 비용 데이터는 Actuals 리포트에서 아래 메트릭을 추가하여 확인하실 수 있습니다.

  • Touchpoint
    • Impressions(Channel)
    • Clicks(Channel)
  • Cost

    • Cost (Channel)

https://help.airbridge.io/hc/article_attachments/4407497457689/mceclip0.png

blockquote-check.svg

Impression vs Impression(Channel)

'Impressions', 'Clicks' 메트릭은 Airbridge에서 트래킹링크를 통해 직접 수집한 데이터이며, 'Impressions (Channel)', 'Clicks(Channel)' 메트릭은 매체(애플 서치 애드)측에서 수집 후 제공한 데이터입니다. 

 

데이터 조회 시 유의사항

애플 서치 애드의 비용 데이터 조회 시 아래 사항들에 유의하시기 바랍니다.

  • 시간 데이터 세분화

    • Display 유형 캠페인은 일 단위(Daily)로 비용 데이터를 조회할 수 있습니다. (단, Event Hour 00으로 표기)

    • Search 유형 캠페인은 시간 단위(Hourly)로 비용 데이터를 조회할 수 있습니다. 

  • 비용 데이터 수치 차이

    • 비용 데이터는 실시간이 아닌 4시간 간격으로 업데이트 됩니다. 또한 비용 데이터와 캠페인 파라미터의 인덱싱 작업에 1~2일이 소요되므로, 비용 데이터 조회 시점에 따라서 매체 측 데이터와 약간의 오차가 발생할 수 있습니다. 
    • 에어브릿지는 오늘 포함 최근 7일의 데이터를 가져와서 업데이트를 하기 때문에 데이터 조회 시점에 따른 수치 차이가 발생할 수 있습니다. (예. 2021년 9월 9일에 확인한 2021년 9월 8일의 데이터와 2021년 9월 10일에 확인한 2021년 9월 8일의 데이터가 다를 수 있습니다.) 
    • Search Term에 대한 비용 데이터는 연동되지 않습니다. 따라서 데이터 조회 시 Term 값이 비어있는 비용 데이터가 존재할 수 있습니다. 

  • 캠페인 파라미터 이름 변경

    • Campaign, Ad Group, Ad 이름 값은 수정하지 않는 것을 권장합니다.
    • 비용 데이터 연동 후 애플 서치 애드 캠페인의 Campaign, Ad Group, Ad 이름 값을 변경하게 되면 전환 데이터 맵핑에 이슈가 발생할 수 있습니다.

  • 통화 (Currency)

    • 비용 데이터 조회 시 애플 서치 애드의 통화 기준인 USD로 표시됩니다. 

  • 비용 데이터 미노출

    • Actuals 리포트에서 캠페인, 광고그룹, 광고 소재 이외의 항목으로 Groupby를 설정하면 해당 Groupby 값에는 비용 데이터가 표시되지 않습니다. 애플 서치 애드의 비용 데이터는 Campaign, Adgroup, Ad 레벨의 값을 받아오기 때문입니다. 아래의 예시를 참고해주시기 바랍니다.
      • Campaign ID로 Group by를 설정하면 해당 Campaign ID에 대한 Cost(Channel) 값 노출됩니다.
        ASA_cost.png
      • Campaign ID 값 외에 Event Category 등의 항목을 추가하면 비용 데이터 정보가 없는 Event Category 에는 Cost(Channel) 값이 노출되지 않습니다.
        Cost_null.png
blockquote-check.svg

캠페인 그룹 미입력

캠페인 그룹 이름을 입력한 적이 없는 경우, Ad Account Name 값이 빈 상태로 업데이트 됩니다.

애플 서치 애드