ConversionAction

전환 액션

JSON 표현 
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
필드
resourceName

string

변경할 수 없습니다. 전환 액션의 리소스 이름입니다. 전환 액션 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/conversionActions/{conversion_action_id}
status

enum (ConversionActionStatus)

전환 이벤트 발생에 대한 이 전환 액션의 상태입니다.
type

enum (ConversionActionType)

변경할 수 없습니다. 이 전환 액션의 유형입니다.
origin

enum (ConversionOrigin)

출력 전용. 이 전환 액션의 전환 출처입니다.
category

enum (ConversionActionCategory)

이 전환 액션에 대해 보고된 전환의 카테고리입니다.
valueSettings

object (ValueSettings)

이 전환 액션과 연결된 전환 이벤트의 가치와 관련된 설정입니다.
countingType

enum (ConversionActionCountingType)

전환 액션의 전환 이벤트를 집계하는 방법
attributionModelSettings

object (AttributionModelSettings)

이 전환 액션의 기여 분석 모델과 관련된 설정입니다.
tagSnippets[]

object (TagSnippet)

출력 전용. 전환 추적에 사용되는 스니펫입니다.
mobileAppVendor

enum (MobileAppVendor)

출력 전용. 앱 전환 액션을 위한 모바일 앱 공급업체
firebaseSettings

object (FirebaseSettings)

출력 전용. Firebase 전환 유형에 대한 Firebase 설정
thirdPartyAppAnalyticsSettings

object (ThirdPartyAppAnalyticsSettings)

출력 전용. 타사 전환 유형에 대한 타사 앱 애널리틱스 설정
googleAnalytics4Settings

object (GoogleAnalytics4Settings)

출력 전용. Google 애널리틱스 4 전환 유형에 대한 Google 애널리틱스 4 설정
id

string (int64 format)

출력 전용. 전환 액션의 ID입니다.
name

string

전환 액션의 이름입니다.

이 필드는 필수 항목이며 새 전환 액션을 만들 때 비워 두지 않아야 합니다.
primaryForGoal

boolean

전환 액션의 primaryForGoal 비트가 false인 경우 전환 액션은 고객 전환 목표 또는 캠페인 전환 목표에 관계없이 모든 캠페인에서 입찰이 불가능합니다. 하지만 맞춤 전환 목표는 primaryForGoal을 따르지 않으므로 캠페인에 primaryForGoal = false 전환 액션으로 구성된 맞춤 전환 목표가 있는 경우 해당 전환 액션은 계속 입찰할 수 있습니다. 설정하지 않으면 기본적으로 primaryForGoal이 true입니다. V9에서는 primaryForGoal을 선택사항으로 선언하지 않으므로 'update' 작업을 통해 만든 후에만 false로 설정할 수 있습니다.
ownerCustomer

string

출력 전용. 전환 액션 소유자 고객의 리소스 이름이거나, 시스템 정의 전환 액션인 경우 null입니다.
includeInConversionsMetric

boolean

이 전환 액션을 '전환수' 측정항목에 포함해야 하는지 여부입니다.
clickThroughLookbackWindowDays

string (int64 format)

상호작용 (예: 클릭)과 전환 이벤트 사이에 경과할 수 있는 최대 일수입니다.
viewThroughLookbackWindowDays

string (int64 format)

노출과 상호작용 없이 전환이 발생하기까지 경과할 수 있는 최대 일수입니다.
phoneCallDurationSeconds

string (int64 format)

이 전환 액션에 대한 전환을 보고하기까지 걸리는 전화 통화 시간(초)입니다.

값은 0 이상 10000 이하여야 합니다.
appId

string

앱 전환 액션의 앱 ID

ConversionActionStatus

전환 액션의 가능한 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 전환이 기록됩니다.
REMOVED 전환이 기록되지 않습니다.
HIDDEN 전환이 기록되지 않고 전환 액션이 UI에 표시되지 않습니다.

ConversionActionType

전환 액션의 유형

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AD_CALL 사용자가 광고의 전화번호 광고 확장을 클릭할 때 발생하는 전환입니다.
CLICK_TO_CALL 휴대기기에서 사용자가 전화번호를 클릭할 때 발생하는 전환입니다.
GOOGLE_PLAY_DOWNLOAD 사용자가 Google Play 스토어에서 모바일 앱을 다운로드할 때 발생하는 전환입니다.
GOOGLE_PLAY_IN_APP_PURCHASE 사용자가 Android 결제를 통해 앱에서 구매할 때 발생하는 전환입니다.
UPLOAD_CALLS 광고주가 추적하여 업로드한 통화 전환입니다.
UPLOAD_CLICKS 광고주가 추적하고 기여 클릭수를 사용하여 업로드된 전환입니다.
WEBPAGE 웹페이지에서 발생하는 전환입니다.
WEBSITE_CALL 사용자가 광고주의 웹사이트에서 동적으로 생성된 전화번호로 전화를 걸 때 발생하는 전환입니다.
STORE_SALES_DIRECT_UPLOAD 퍼스트 파티 또는 서드 파티 판매자 데이터 업로드에 기반한 매장 판매 전환 허용 목록에 있는 고객만 매장 판매 직접 업로드 유형을 사용할 수 있습니다.
STORE_SALES 퍼스트 파티 또는 서드 파티 판매자 데이터 업로드 및/또는 결제 네트워크의 카드를 사용한 오프라인 구매를 기반으로 한 매장 판매 전환 허용 목록에 있는 고객만 매장 판매 유형을 사용할 수 있습니다. 읽기 전용입니다.
FIREBASE_ANDROID_FIRST_OPEN Android 앱 최초 실행 전환은 Firebase를 통해 추적됩니다.
FIREBASE_ANDROID_IN_APP_PURCHASE Firebase를 통해 추적되는 Android 앱 내 구매 전환
FIREBASE_ANDROID_CUSTOM Firebase를 통해 추적되는 Android 앱 맞춤 전환
FIREBASE_IOS_FIRST_OPEN Firebase를 통해 추적된 iOS 앱 최초 실행 전환
FIREBASE_IOS_IN_APP_PURCHASE Firebase를 통해 추적되는 iOS 앱 내 구매 전환
FIREBASE_IOS_CUSTOM Firebase를 통해 추적되는 iOS 앱 맞춤 전환
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Android 앱 첫 실행 전환수는 서드 파티 앱 애널리틱스를 통해 추적됩니다.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Android 앱 인앱 구매 전환이 서드 파티 앱 애널리틱스를 통해 추적됩니다.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM 서드 파티 앱 애널리틱스를 통해 추적되는 Android 앱 맞춤 전환
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN 서드 파티 앱 애널리틱스를 통해 추적된 iOS 앱 최초 실행 전환
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE 서드 파티 앱 애널리틱스를 통해 추적되는 iOS 앱 인앱 구매 전환
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM 서드 파티 앱 애널리틱스를 통해 추적되는 iOS 앱 맞춤 전환
ANDROID_APP_PRE_REGISTRATION 사용자가 Google Play 스토어에서 모바일 앱을 사전 등록할 때 발생하는 전환입니다. 읽기 전용입니다.
ANDROID_INSTALLS_ALL_OTHER_APPS 특정 앱 유형으로 추적되지 않는 모든 Google Play 다운로드를 추적하는 전환입니다. 읽기 전용입니다.
FLOODLIGHT_ACTION 사용자가 광고주의 광고 중 하나를 보거나 클릭한 후 특정 웹페이지를 방문한 횟수를 계산하는 플러드라이트 활동입니다. 읽기 전용입니다.
FLOODLIGHT_TRANSACTION 판매 횟수 또는 구매한 상품 수를 추적하는 플러드라이트 활동 각 판매의 총 가치를 파악할 수도 있습니다. 읽기 전용입니다.
GOOGLE_HOSTED 광고와 상호작용한 후 Google 제품 및 서비스에서 발생한 오프라인 액션을 추적하는 전환입니다. 읽기 전용입니다.
LEAD_FORM_SUBMIT 사용자가 리드 양식을 제출할 때 보고되는 전환수입니다. 읽기 전용입니다.
SALESFORCE Salesforce에서 발생하는 전환입니다. 읽기 전용입니다.
SEARCH_ADS_360 Search Ads 360 플러드라이트 데이터에서 가져온 전환입니다. 읽기 전용입니다.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL 스마트 캠페인 맞춤 기준을 사용하여 통화 추적을 설정하지 않은 스마트 캠페인 광고에서 발생하는 통화 전환 읽기 전용입니다.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL 사용자가 Google 지도에서 통화 요소를 클릭합니다. 스마트 캠페인만 해당 읽기 전용입니다.
SMART_CAMPAIGN_MAP_DIRECTIONS 사용자가 Google 지도 내의 비즈니스 위치로 가는 경로를 요청합니다. 스마트 캠페인만 해당 읽기 전용입니다.
SMART_CAMPAIGN_TRACKED_CALLS 통화 추적 설정이 적용된 스마트 캠페인 광고에서 스마트 캠페인 맞춤 기준을 사용하여 발생하는 통화 전환 읽기 전용입니다.
STORE_VISITS 사용자가 광고주의 소매점을 방문할 때 발생하는 전환입니다. 읽기 전용입니다.
WEBPAGE_CODELESS 개별적으로 코딩된 이벤트 스니펫을 사용하지 않는 웹사이트 이벤트 (예: 양식 제출 또는 페이지 로드)에서 생성된 전환 읽기 전용입니다.
UNIVERSAL_ANALYTICS_GOAL 연결된 유니버설 애널리틱스 목표에서 발생하는 전환입니다.
UNIVERSAL_ANALYTICS_TRANSACTION 연결된 유니버설 애널리틱스 거래에서 발생하는 전환입니다.
GOOGLE_ANALYTICS_4_CUSTOM 연결된 Google 애널리틱스 4 맞춤 이벤트 전환에서 발생하는 전환입니다.
GOOGLE_ANALYTICS_4_PURCHASE 연결된 Google 애널리틱스 4 구매 전환에서 발생하는 전환입니다.

ValueSettings

이 전환 액션과 연결된 전환 이벤트의 가치와 관련된 설정입니다.

JSON 표현 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
필드
defaultValue

number

이 전환 액션의 전환 이벤트가 유효하지 않거나 허용되지 않거나 누락된 값과 함께 전송되거나 이 전환 액션이 항상 기본값을 사용하도록 구성된 경우 사용할 값입니다.
defaultCurrencyCode

string

이 전환 액션의 전환 이벤트가 잘못되거나 누락된 통화 코드와 함께 전송되거나 이 전환 액션이 항상 기본값을 사용하도록 구성된 경우 사용할 통화 코드입니다.
alwaysUseDefaultValue

boolean

이 전환 액션의 전환 이벤트에 지정된 값 및 통화 코드 대신 기본값 및 기본 통화 코드를 사용할지 여부를 제어합니다.

ConversionActionCountingType

이 액션의 전환이 집계되는 방식을 나타냅니다. 자세한 내용은 https://support.google.com/google-ads/answer/3438531을 참고하세요.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ONE_PER_CLICK 클릭당 한 번의 전환만 집계합니다.
MANY_PER_CLICK 클릭당 모든 전환수를 집계합니다.

AttributionModelSettings

이 전환 액션의 기여 분석 모델과 관련된 설정입니다.

JSON 표현 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
필드
attributionModel

enum (AttributionModel)

이 전환 액션의 기여 분석 모델 유형입니다.
dataDrivenModelStatus

enum (DataDrivenModelStatus)

출력 전용. 전환 액션에 대한 데이터 기반 기여 분석 모델의 상태입니다.

AttributionModel

잠재적으로 많은 이전 상호작용에 특정 전환의 기여도를 배분하는 방법을 설명하는 기여 분석 모델입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
EXTERNAL 외부 기여 분석을 사용합니다.
GOOGLE_ADS_LAST_CLICK 마지막 클릭이 전환에 100% 기여했다고 간주합니다.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Google 검색 기여 분석을 사용하여 첫 번째 클릭이 전환에 100% 기여했다고 간주합니다.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Google 검색 기여 분석을 사용하여 모든 클릭에 동등하게 전환 기여도를 부여합니다.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Google 검색 기여 분석을 사용하면 최근의 클릭이 전환에 크게 기여했다고 간주합니다 (반감기: 1주).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED 첫 번째 클릭과 마지막 클릭이 전환에 40% 기여했다고 간주합니다. 나머지 20% 는 다른 모든 클릭에 균등하게 배분됩니다. 여기에서는 Google 검색 기여 분석을 사용합니다.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN 머신러닝을 사용하는 유연한 모델로, Google 검색 기여 분석을 통해 클릭 간에 기여도를 적절히 배분할 수 있습니다.

DataDrivenModelStatus

데이터 기반 모델 상태를 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AVAILABLE 데이터 기반 모델을 사용할 수 있습니다.
STALE 데이터 기반 모델이 오래되었습니다. 7일 이상 업데이트되지 않았습니다. 아직 사용 중이지만 30일 동안 업데이트되지 않으면 만료됩니다.
EXPIRED 데이터 기반 모델이 만료되었습니다. 30일 이상 업데이트되지 않아 사용할 수 없습니다. 가장 일반적인 이유는 최근 30일 동안 필요한 이벤트 수가 없었기 때문입니다.
NEVER_GENERATED 데이터 기반 모델은 생성된 적이 없습니다. 가장 일반적인 이유는 30일 동안 필요한 이벤트 수가 없었기 때문입니다.

FirebaseSettings

Firebase 전환 액션과 관련된 설정입니다.

JSON 표현 
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
필드
propertyId

string (int64 format)

출력 전용. 전환의 GA 속성 ID입니다.
propertyName

string

출력 전용. 전환의 GA 속성 이름입니다.
eventName

string

출력 전용. Firebase 전환의 이벤트 이름입니다.
projectId

string

출력 전용. 전환의 Firebase 프로젝트 ID입니다.

ThirdPartyAppAnalyticsSettings

서드 파티 앱 애널리틱스 전환 액션과 관련된 설정입니다.

JSON 표현 
{
  "providerName": string,
  "eventName": string
}
필드
providerName

string

출력 전용. 서드 파티 앱 분석 서비스 제공업체의 이름입니다.
eventName

string

출력 전용. 서드 파티 앱 애널리틱스 전환의 이벤트 이름입니다.

GoogleAnalytics4Settings

Google 애널리틱스 4 전환 액션과 관련된 설정입니다.

JSON 표현 
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
필드
eventName

string

출력 전용. GA 4 이벤트의 이름입니다.
propertyName

string

출력 전용. GA 4 속성의 이름입니다.
propertyId

string (int64 format)

출력 전용. GA4 속성의 ID입니다.