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에서는 다음 페이지에 설명된 대로 Google 애널리틱스 4에서 제공하는 것과 동일한 모델을 지원합니다.https://support.google.com/analytics/answer/10596866

열거형
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

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