REST Resource: accounts.conversionSources

리소스: ConversionSource

판매자 계정에서 소유한 전환 소스를 나타냅니다. 판매자 계정 하나에 최대 200개의 전환 소스를 포함할 수 있습니다.

JSON 표현
{
  "name": string,
  "state": enum (State),
  "expireTime": string,
  "controller": enum (Controller),

  // Union field source_data can be only one of the following:
  "googleAnalyticsLink": {
    object (GoogleAnalyticsLink)
  },
  "merchantCenterDestination": {
    object (MerchantCenterDestination)
  }
  // End of list of possible types for union field source_data.
}
필드
name

string

출력 전용입니다. 식별자. 새 ConversionSource 생성 시 Content API에서 생성됩니다. 형식: [a-z]{4}:.+ 콜론 앞에 있는 4개의 문자는 변환 소스의 유형을 나타냅니다. 콜론 뒤의 콘텐츠는 해당 유형 내 전환 소스의 ID를 나타냅니다. 서로 다른 두 전환 소스의 ID는 서로 다른 유형에서 동일할 수 있습니다. 다음과 같은 유형의 접두사가 지원됩니다. - galk: GoogleAnalyticsLink 소스 - mcdn: MerchantCenterDestination 소스용입니다.

state

enum (State)

출력 전용입니다. 이 전환 소스의 현재 상태입니다. API를 통해 수정할 수 없습니다.

expireTime

string (Timestamp format)

출력 전용입니다. 보관처리된 전환 소스가 완전히 삭제되어 더 이상 삭제 취소할 수 없는 시점입니다.

controller

enum (Controller)

출력 전용입니다. 전환 소스의 컨트롤러입니다.

통합 필드 source_data. 필수 항목입니다. 각 소스 유형별 전환 소스 데이터입니다. source_data은 다음 중 하나여야 합니다.
merchantCenterDestination

object (MerchantCenterDestination)

'판매자 센터 태그 대상' 유형의 전환 소스입니다.

AttributionSettings

사전 기여 분석 데이터를 수신하는 전환 소스의 기여 분석 설정을 나타냅니다.

JSON 표현
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
필드
attributionLookbackWindowDays

integer

필수 항목입니다. 이 소스의 기여 분석에 사용된 전환 확인 기간 (일)입니다. 지원되는 값은 7, 30, 40입니다.

attributionModel

enum (AttributionModel)

필수 항목입니다. 기여 분석 모델입니다.

conversionType[]

object (ConversionType)

변경할 수 없습니다. 순서가 지정되지 않은 목록입니다. 전환 이벤트를 분류할 수 있는 다양한 전환 유형의 목록입니다. 표준 '구매' 생성 시점에 이 목록이 비어 있으면 유형이 자동으로 생성됩니다.

AttributionModel

이 소스에 사용된 기여 분석 모델입니다. Google에서는 https://support.google.com/analytics/answer/10596866에 설명된 대로 Google 애널리틱스 4에서 제공하는 것과 동일한 모델 집합을 지원합니다.

열거형
ATTRIBUTION_MODEL_UNSPECIFIED 모델이 지정되지 않았습니다.
CROSS_CHANNEL_LAST_CLICK 교차 채널 마지막 클릭 모델
ADS_PREFERRED_LAST_CLICK Google Ads 우선 마지막 클릭 모델
CROSS_CHANNEL_DATA_DRIVEN 교차 채널 데이터 기반 모델
CROSS_CHANNEL_FIRST_CLICK 교차 채널 첫 번째 클릭 모델
CROSS_CHANNEL_LINEAR 교차 채널 선형 모델입니다.
CROSS_CHANNEL_POSITION_BASED 교차 채널 시점 기반 모델입니다.
CROSS_CHANNEL_TIME_DECAY 교차 채널 시간 가치 하락 모델

ConversionType

전환 이벤트 유형을 나타내는 메시지

JSON 표현
{
  "name": string,
  "report": boolean
}
필드
name

string

출력 전용입니다. 고객이 보고하는 전환 이벤트 이름입니다.

report

boolean

출력 전용입니다. 판매자 센터 보고에 유형을 포함해야 하는지 여부를 나타내는 옵션입니다.

MerchantCenterDestination

'판매자 센터 대상 유형' 소스는 Google 태그를 사용하여 온라인 상점에서 소스가 생성된 판매자 센터 계정으로 전환 이벤트를 직접 전송하는 데 사용할 수 있습니다.

JSON 표현
{
  "destination": string,
  "attributionSettings": {
    object (AttributionSettings)
  },
  "displayName": string,
  "currencyCode": string
}
필드
destination

string

출력 전용입니다. 판매자 센터 대상 ID

attributionSettings

object (AttributionSettings)

필수 항목입니다. 판매자 센터 대상 유형에 사용되는 기여 분석 설정입니다.

displayName

string

필수 항목입니다. 판매자가 지정한 대상의 표시 이름입니다. 이 이름은 판매자 센터 UI 내에서 전환 소스를 식별하는 이름입니다. 최대 64자(영문 기준)까지 입력할 수 있습니다.

currencyCode

string

필수 항목입니다. 3글자 통화 코드 (ISO 4217)입니다. 통화 코드는 이 대상 유형으로 전송된 전환이 판매자 센터에서 보고되는 통화를 정의합니다.

전환 소스의 상태를 나타냅니다.

열거형
STATE_UNSPECIFIED 전환 소스의 상태가 지정되지 않았습니다.
ACTIVE 전환 소스가 정상적으로 작동합니다.
ARCHIVED 전환 소스가 지난 30일 동안 보관처리되었으며 현재 작동하지 않습니다. 삭제 취소 메서드를 사용하여 복원할 수 있습니다.
PENDING 전환 소스 생성이 시작되었지만 아직 완전히 완료되지 않았습니다.

컨트롤러

전환 소스를 제어하는 항목입니다.

열거형
CONTROLLER_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
MERCHANT 전환 소스를 소유한 판매자가 관리합니다.
YOUTUBE_AFFILIATES YT 제휴 프로그램에서 관리합니다.

메서드

create

새 전환 소스를 만듭니다.

delete

기존 전환 소스를 보관처리합니다.

get

전환 소스를 가져옵니다.

list

호출자가 액세스할 수 있는 전환 소스의 목록을 가져옵니다.

patch

기존 전환 소스의 정보를 업데이트합니다.

undelete

보관처리된 전환 소스를 다시 사용 설정합니다.