Apple Ads (formerly Apple Search Ads) 데이터 커넥터

Apple Search Ads

Singular가 Apple Search Ads (ASA)에서 광고 비용 데이터를 가져와 리포트에 표시하는 방법을 알아보세요.

중요: ASA에는 광고주가 사용할 수 있는 두 가지 솔루션이 있습니다: Advanced 또는 Basic(차이점은 여기에서 확인). ASA의 Basic 솔루션으로 운영되는 캠페인은 해당 리포팅 API에서 지원되지 않으므로, Singular는 이러한 캠페인의 광고 비용을 리포트할 수 없습니다.

2022년 2월 11일 업데이트: Keyword Match Type 기준을 추가했습니다.

빠른 세부 정보

데이터 커넥터 기술 API (Apple Search Ads API v. 5)
데이터 분석(세분화)

Apple Search Ads의 데이터는 다음 기준으로 분류됩니다:

  • 캠페인
  • 하위 캠페인(Ad Group)
  • 국가

또한 다음 중 하나의 분류 기준을 선택할 수 있습니다:

  • 키워드(검색 키워드) - 기본값
  • 도시 및 지역

키워드 분류 대신 도시 및 지역 분류를 사용하려면 Customer Success Manager 또는 Singular 지원팀에 문의하세요.

데이터를 얼마나 오래 거슬러 올라가는지 30일
시간대 기본적으로 Singular는 Apple 대시보드에 설정한 원래 시간대로 데이터를 가져옵니다. 데이터를 UTC로 가져오길 원하면 문의해 주세요.
크리에이티브 수준에서 데이터를 사용할 수 있나요?
Singular는 내 크리에이티브 에셋을 표시하나요?

예 — Singular는 Apple Ads의 크리에이티브 미리보기를 지원합니다. DefaultCustom Product Pages.

Singular는 제품 페이지와 연결된 모든 에셋을 결합하여 GIF 미리보기를 생성합니다.

참고: 크리에이티브 미리보기와 Custom Product Page 이름 및 ID는 다음에서만 사용할 수 있습니다: Creative IQ (CIQ).

Singular는 Custom Product Page ROI를 지원하나요?

- 각 Apple Search Ads 크리에이티브는 하나의 Custom Product Page
- 크리에이티브에 연결된 제품 페이지 변형이 없으면 product page id와 product page name에 기본 제품 페이지가 표시됩니다.
- Custom Product Page ROI는 어떻게 확인하나요?
ASA 크리에이티브 리포트에서 크리에이티브 및 Product Page ID와 함께 ROI 메트릭을 추가하기만 하면 됩니다.

데이터 매핑

팁:

  • Singular의 하위 캠페인는 Apple의 Ad Group.
  • 퍼블리셔 필드는 퍼블리셔가 Apple Search Ads이므로 이 데이터 커넥터에서는 채워지지 않습니다.
  • Singular 리포팅의 각 필드에 대한 설명은 다음을 참조하세요: Singular 메트릭 및 기준 용어집

Field in Singular UI Field in Singular API Field in Apple
Dimensions
Account ID adn_account_id orgID
App app appName
App Site ID app_site_id adamId
City
city
locality
Country country_field countryOrRegion OR countryCode
Creative Format
creative_format

creativeType
Possible values:

  • DEFAULT_PRODUCT_PAGE
  • CUSTOM_PRODUCT_PAGE
  • IMAGE
Creative ID creative_id adId
Creative Name creative_name adName
Date date_field date
Keyword keyword searchTermText OR keyword
Keyword ID keyword_id keywordId
Keyword Match Type keyword_match_type matchType
Network Campaign ID adn_campaign_id (campaign) id
Network Campaign Name adn_campaign_name (campaign) name
Network Creative ID adn_creative_id adId,
Network Creative Name adn_creative_name adName
Network Sub Campaign ID adn_sub_campaign_id (adGroup) id
Network Sub Campaign Name adn_sub_campaign_name (adGroup) name
OS os Always "iOS" (hardcoded)
Platform
platform
deviceClass
Public Id site_public_id adamId
Region
region
adminArea
Sub Ad Network
adn_subadnetwork
adChannelType
Timezone adn_timezone timeZone
Ad Type ad_type SupplySources
Product Page ID product_page_id productPageId
Product Page Name product_page_name productPageName
Metrics
Network Clicks adn_clicks taps
Network Impressions adn_impressions impressions
Network Installs adn_installs installs
Original Cost adn_original_cost amount
Original Currency adn_original_currency currency

Singular는 이 파트너의 캠페인 속성 가져오기도 지원합니다. 자세한 내용은 여기를 참조하세요.

추가 이벤트/메트릭

Apple Search Ads는 자체 신고 기반의 조회 기반 어트리뷰션(view-through attribution) 리포트도 제공합니다. 현재는 데이터 커넥터 연동을 통해서만 이 데이터를 제공하며, MMP 조회 기반 어트리뷰션은 아직 Apple Search Ads에서 지원되지 않습니다. 조회 기반 리포팅을 설정하려면 전환 이벤트로 계정에 추가할 수 있습니다.

Singular에서 전환 이벤트를 설정하려면 다음 단계를 따르세요:

  1. Singular에서 다음으로 이동합니다: Settings > Events. Custom EventsConversion Events 탭이 모두 있는 경우 Conversion Events.
  2. New Event.
  3. Apple SearchAds 드롭다운에서 AppleSearchAds에서 사용할 수 있는 메트릭 목록("view installs count" 포함)을 확인할 수 있습니다.

    다음 날 Singular가 계정의 일일 데이터를 가져올 때 이러한 활동의 통계도 함께 가져옵니다.

크리에이티브 미리보기

Singular는 Apple Ads의 크리에이티브 미리보기를 지원합니다. Default Product PagesCustom Product Pages.

Singular는 제품 페이지와 연결된 모든 에셋을 결합하여 하나의 애니메이션 GIF로 만들어, 크리에이티브가 사용자에게 어떻게 보이는지 시각적으로 보여줍니다.

참고: 크리에이티브 미리보기와 Custom Product Page 이름 및 ID는 다음에서만 사용할 수 있습니다: Creative IQ (CIQ).

FAQ

Q: 크리에이티브 이름 또는 Creative id에 -1이 표시되는 이유는 무엇인가요?

A: "Search Results" 캠페인을 운영하면서 광고 그룹에 특정 Custom Product Page(CPP)나 Creative Set을 지정하지 않은 경우, Apple은 앱의 기본 메타데이터(아이콘, 제목, 스크린샷)를 사용하여 광고를 자동으로 생성합니다. 이 "광고"는 사용자가 별도의 객체로 직접 만든 것이 아니므로, API는 다음 ID를 할당합니다: -1