이 가이드에서는 Google Ads API를 사용하여 만들 수 있는 다양한 전환 액션 유형과 Google Ads 웹 인터페이스에 매핑되는 방식을 보여줍니다.
오프라인 전환
오프라인 전환을 사용하면 사무실, 오프라인 매장 또는 전화 통화와 같이 오프라인 환경에서 발생하는 전환 이벤트를 추적할 수 있습니다.
다음 표에는 Google Ads 웹 인터페이스의 각 소스에 사용할 수 있는 상응하는
ConversionActionType
API 매개변수와 각 특정 전환 액션 유형의 문서 링크가 나와 있습니다.
| 전환 액션 유형 | Google Ads 소스 | API 설정 가이드 |
|---|---|---|
UPLOAD_CLICKS |
클릭에서 발생한 전환 및 리드 확보용 향상된 전환 추적 | Data Manager API 사용 |
UPLOAD_CALLS |
통화에서 전환 추적 | 통화 전환 가져오기 가이드 |
STORE_SALES |
전환 오프라인 매장 판매 추적 | 매장 판매 전환 가져오기 가이드 |
온라인 (웹사이트) 전환
웹사이트 전환을 사용하면 온라인 판매, 링크 클릭, 페이지 조회수, 가입과 같은 웹사이트 액션을 추적할 수 있습니다.
웹사이트에서 전환을 추적하려면
ConversionAction
의
ConversionActionType
을 WEBPAGE로 설정하고 웹사이트의 전환 페이지에 태그
라는 코드 스니펫을 추가해야 합니다.
ConversionAction은 여러
유형의 웹사이트 전환을 포함하며, API 내에서
ConversionAction의
tag_snippets 필드에 나열된 각
TagSnippet의
type 필드로 구분됩니다.
TagSnippet은 전환 액션을 추적하기 위해 웹사이트에 포함해야 하는 추적 코드를 제공합니다.
웹사이트 및 전화번호 클릭 전환에는 결제 확인 또는 리드 양식 제출 페이지와 같은 전환 액션을 나타내는 웹페이지에 배치해야 하는
event_snippet과
웹사이트의 모든 페이지에 설치해야 하는
global_site_tag이(가) 필요합니다. ConversionActionService를 사용하여 이러한 속성을 모두 가져올 수 있습니다. 페이지에 태그를 지정하는 방법에 대한 자세한 내용은
고객센터를 참고하세요.
다음 표에는 Google Ads 웹 인터페이스의 각 소스 에 사용할 수 있는 상응하는 API 매개변수가 나와 있습니다.
| 추적 코드 유형 | Google Ads 소스 |
|---|---|
WEBPAGE |
웹사이트, 웹사이트 (Google 애널리틱스 (GA4)) |
WEBPAGE_ONCLICK |
웹사이트, 웹사이트 (Google 애널리틱스 (GA4)) |
CLICK_TO_CALL |
전화번호 클릭 |
앱 전환
앱 전환을 사용하면 Google Play 스토어에서 모바일 앱 설치 또는 인앱 구매를 추적할 수 있습니다.
다음 표에는 Google Ads 웹 인터페이스의 각 소스에 사용할 수 있는 상응하는
ConversionActionType
API 매개변수가 나와 있습니다.
| 전환 액션 유형 | Google Ads 소스 |
|---|---|
GOOGLE_PLAY_DOWNLOAD |
Google Play > 설치 |
GOOGLE_PLAY_IN_APP_PURCHASE |
Google Play > 인앱 구매 |
다른 모바일 앱 액션을 추적하려면 Google 애널리틱스 4 속성 또는 서드 파티 앱 분석를 사용하세요. 추가 전환 액션 유형을 참고하세요.
category
전화 통화 전환
전화 통화 전환 추적 을 사용하면 광고에서 연결된 통화, 웹사이트의 전화번호로 걸려온 통화, 모바일 사이트의 전화번호 클릭을 추적할 수 있습니다.
다음 표에는 Google Ads 웹 인터페이스의 각 소스에 사용할 수 있는 상응하는
ConversionActionType
API 매개변수가 나와 있습니다.
| 전환 액션 유형 | Google Ads 소스 |
|---|---|
AD_CALL |
전화번호 광고 확장이 사용된 광고 또는 통화 전용 광고에서 연결된 통화 |
WEBSITE_CALL |
웹사이트의 전화번호로 걸려온 통화수 |
CLICK_TO_CALL |
모바일 웹사이트 전화번호 클릭수 |
AD_CALL
An
AD_CALL
전환 액션은 Google Ads
웹 인터페이스에 광고에서 연결된
통화 전환으로 표시됩니다. AD_CALL 전환 액션을 만든 후 call_conversion_action 필드에 리소스 이름을 지정할 때 CallAsset을(를) 만듭니다. 전화번호
확장 소재를 사용하면 광고에
전화번호를 직접 표시할 수 있습니다.
통화가 지정된 시간보다 오래 지속되면 전환으로 보고됩니다. 기본값은 60초입니다.
WEBSITE_CALL
WEBSITE_CALL
전환 액션은 웹사이트에서 연결된
통화 전환으로
Google Ads 웹 인터페이스에 표시됩니다.
AD_CALL과 달리
이 추적기는 웹사이트에 나열된 전화번호의 통화 추적을 위한 동적 Google 착신 전화
번호를 가져오기 위해
웹사이트에 event_snippet
및 global_site_tag를 추가해야 합니다. 또한 전화번호 확장 소재를 설정하고 고객,
캠페인 또는 광고그룹 수준에서 연결해야 합니다.
CLICK_TO_CALL
CLICK_TO_CALL
전환 액션은모바일
웹사이트의 전화번호 클릭 전환으로
Google Ads 웹 인터페이스에 표시됩니다.
CLICK_TO_CALL
유형은 실제 전화 통화를 추적하지 않는다는 점에서
AD_CALL
유형과 다릅니다. 대신 CLICK_TO_CALL은 모바일 기기의 전화번호 클릭만 추적합니다. 전화 통화를 추적하는 데 Google 착신 전화번호를 사용할 수 없는 경우에 유용합니다.
향상된 전환
향상된 전환을 사용하면 기존 전환 태그에 이메일 주소, 이름, 집 주소, 전화번호와 같은 퍼스트 파티 전환 데이터를 추가하여 전환 측정의 정확성을 높일 수 있습니다.
다음 표에는 각 향상된 전환 유형에 사용할 수 있는 상응하는 API 매개변수가 나와 있습니다.
| 전환 액션 유형 | 향상된 전환 유형 | API 설정 가이드 |
|---|---|---|
UPLOAD_CLICKS |
리드 확보용 향상된 전환
웹사이트 리드 또는 방문자로부터 발생한 오프라인 거래의 측정을 개선합니다. |
Data Manager API 사용 |
WEBPAGE |
웹용 향상된 전환
온라인 전환의 측정이 개선됩니다. |
API 설정 가이드 |
추가 전환 액션 유형
Google Ads API는 보고서에서 추가 유형의 전환 액션을 사용할 수 있도록 하지만 이러한 액션의 생성 또는 수정을 제한하거나 금지할 수 있습니다.
SKAdNetwork 전환수
| 보고서 필드 | 설명 |
|---|---|
metrics.sk_ad_network_installs |
Apple에서 보고한 설치 수입니다. 이 측정항목은
segments.sk_ad_network_conversion_value 및
날짜 관련 세그먼트의 조합으로만 분류할 수 있습니다.
|
metrics.sk_ad_network_total_conversions |
Apple에서 보고한 설치 및 기타 전환 유형을 포함한 총 전환수입니다. 이 측정항목은 SKAdNetwork 관련 세그먼트 및 날짜 관련 세그먼트로만 분류할 수 있습니다. |
segments.sk_ad_network_ad_event_type |
특정 전환에 발생한 이벤트 유형입니다. |
segments.sk_ad_network_attribution_credit |
특정 전환에 기여 분석이 부여되는 방식입니다. |
segments.sk_ad_network_fine_conversion_value |
Apple에서 보고한 전환의 가치입니다. 이 세그먼트는
Apple에서 |
segments.sk_ad_network_coarse_conversion_value |
개별 전환의 대략적인 값입니다. |
segments.sk_ad_network_postback_sequence_index |
특정 전환의 순서대로의 포스트백 위치입니다. |
segments.sk_ad_network_source_app.sk_ad_network_source_app_id |
iOS 스토어 키트 광고 네트워크 설치를 유도한 광고가 게재된 앱 ID입니다. |
segments.sk_ad_network_source_domain |
iOS 스토어 키트 광고 네트워크 설치를 유도한 광고가 게재된 웹사이트입니다. null 값은 이 세그먼트가 적용되지 않거나(예: iOS가 아닌 캠페인) Apple에서 전송한 포스트백에 없음을 의미합니다. |
segments.sk_ad_network_source_type |
iOS 스토어 키트 광고 네트워크 설치를 유도한 광고가 게재된 소스 유형입니다. null 값은 이 세그먼트가 적용되지 않거나(예: iOS가 아닌 캠페인) 소스 도메인 또는 소스 앱이 Apple에서 전송한 포스트백에 없음을 의미합니다. |
segments.sk_ad_network_user_type |
특정 전환을 생성한 사용자 유형입니다. |
segments.sk_ad_network_redistributed_fine_conversion_value |
이 세그먼트의 전환 가치에는 전환 가치로 재분배된 null 값이 포함됩니다. 이 세그먼트는 Apple에서 반환한 관찰된 세부 전환 가치와 Google의 모델링된 null 값 의 합계를 나타냅니다. |
segments.sk_ad_network_version |
사용된 iOS 스토어 키트 광고 네트워크 API 버전입니다. |
Google 애널리틱스
연결된 Google 애널리틱스 속성의 전환에는 다음
type 값 중 하나가 있습니다.
GA4 속성 전환:
GOOGLE_ANALYTICS_4_CUSTOMGOOGLE_ANALYTICS_4_PURCHASE
`google_analytics_4_settings` 필드에서 GA4 속성 ID, 속성 이름, 이벤트 이름을 가져올 수도 있습니다.
google_analytics_4_settings
GA4 속성 전환을 다음과 같이 변경할 수 있습니다.
status필드를HIDDEN에서ENABLED로 수정하여 GA4 속성의 전환을 Google Ads 계정으로 가져옵니다.primary_for_goal및category필드를 수정하여 Google Ads 입찰 및 보고서에 미치는 영향을 나타냅니다.name또는value_settings를 업데이트합니다.remove작업을 사용하여 Google Ads 계정에서 전환을 삭제합니다.
가져온 GA4 전환의 다른 속성 또는 가져온 유니버설 애널리틱스 전환의 모든 속성을 수정하려고 하면 MUTATE_NOT_ALLOWED 오류가 발생합니다. 이러한 변경사항은 Google Ads UI를 통해서만 적용할 수 있습니다.
Firebase 및 서드 파티 앱 분석
서드 파티 앱 분석
또는 Firebase 전환을 가져오려면
status의
ConversionAction를 HIDDEN에서 ENABLED로 변경합니다.mutateConversionActionService 이러한
전환 액션에는
app_id 업데이트가 지원되지 않습니다.
FIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_IOS_FIRST_OPENFIREBASE_IOS_IN_APP_PURCHASEFIREBASE_IOS_CUSTOMTHIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOMTHIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
오프라인 매장 판매: 보고 기능이 있는 전환 액션으로 가져오기
Google Ads API를 사용하여 STORE_SALES 또는 STORE_SALES_DIRECT_UPLOAD
전환 액션을 만들 수는 없지만 API는 매장 판매
거래 가져오기를 지원합니다.
STORE_SALESSTORE_SALES_DIRECT_UPLOAD
읽기 전용 전환 액션 유형
다음 전환 액션 유형은 Google Ads API에서 읽기 전용이며 보고 목적으로 제공됩니다.
ANDROID_APP_PRE_REGISTRATIONANDROID_INSTALLS_ALL_OTHER_APPSFLOODLIGHT_ACTIONFLOODLIGHT_TRANSACTIONGOOGLE_HOSTEDLEAD_FORM_SUBMITSALESFORCESEARCH_ADS_360SMART_CAMPAIGN_AD_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONSSMART_CAMPAIGN_TRACKED_CALLSSTORE_VISITSWEBPAGE_CODELESS
알 수 없음
Google Ads 계정에 다른 유형의 전환 액션이 포함되어 있는 경우 쿼리 및 보고서에서
전환 액션이 반환될 수 있습니다. 여기서
ConversionAction.type은 UNKNOWN입니다.
API는 이러한 전환 액션 관리를 지원하지 않지만
보고서에서 반환하여
metrics.conversions 및 metrics.conversions_value과 같은 주요 전환 측정항목에 대한 완전한 결과를 제공합니다.