Package google.shopping.merchant.conversions.v1beta

색인

ConversionSourcesService

판매자 계정의 전환 소스를 관리하는 서비스

CreateConversionSource

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

새 전환 소스를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.
DeleteConversionSource

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

기존 전환 소스를 보관처리합니다. 전환 소스가 판매자 센터 대상 유형인 경우 30일 동안 복구할 수 있습니다. 전환 소스가 Google 애널리틱스 링크인 경우 즉시 삭제되며 새 링크를 만들어 복원할 수 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.
GetConversionSource

rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)

전환 소스를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.
ListConversionSources

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

호출자가 액세스할 수 있는 전환 소스 목록을 검색합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.
UndeleteConversionSource

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

보관처리된 전환 소스를 다시 사용 설정합니다. 판매자 센터 대상 전환 소스에만 사용할 수 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.
UpdateConversionSource

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

기존 전환 소스의 정보를 업데이트합니다. 판매자 센터 대상 전환 소스에만 사용할 수 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.

AttributionSettings

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

입력란
attribution_lookback_window_days

int32

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

AttributionModel

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

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

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

입력란
name

string

출력 전용입니다. 클라이언트에 의해 보고되는 전환 이벤트 이름입니다.
report

bool

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

ConversionSource

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

입력란
name

string

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

State

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

Timestamp

출력 전용입니다. 보관처리된 전환 소스가 영구적으로 삭제되어 더 이상 삭제를 취소할 수 없는 시점입니다.
controller

Controller

출력 전용입니다. 전환 소스의 컨트롤러입니다.
통합 필드 source_data. 필수 항목입니다. 소스 유형별 전환 소스 데이터입니다. source_data는 다음 중 하나여야 합니다.
merchant_center_destination

MerchantCenterDestination

'판매자 센터 태그 대상 위치' 유형의 전환 소스

컨트롤러

전환 소스를 제어하는 엔티티입니다.

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

상태

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

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

CreateConversionSourceRequest

CreateConversionSource 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 새 전환 소스를 소유할 판매자 계정입니다. 형식: accounts/{account}
conversion_source

ConversionSource

필수 항목입니다. 전환 소스에 대한 설명입니다. 생성 시 새 ID가 자동으로 할당됩니다.

DeleteConversionSourceRequest

DeleteConversionSource 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제할 전환 소스의 이름입니다. 형식: accounts/{account}/conversionSources/{conversion_source}

GetConversionSourceRequest

GetConversionSource 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 가져올 전환 소스의 이름입니다. 형식: accounts/{account}/conversionsources/{conversion_source}

ListConversionSourcesRequest

ListConversionSources 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 전환 소스 컬렉션을 소유한 판매자 계정입니다. 형식: accounts/{account}
page_size

int32

선택사항입니다. 페이지에서 반환할 최대 전환 소스 수입니다. page_size을 지정하지 않으면 100이 기본값으로 사용됩니다. 최댓값은 200입니다. 200보다 큰 값은 200(으)로 강제 변환됩니다. 페이지로 나누기와 관계없이 총 200개의 전환 소스가 반환됩니다.
page_token

string

선택사항입니다. 페이지 토큰입니다.
show_deleted

bool

선택사항입니다. 삭제된 (보관처리됨) 옵션 표시

ListConversionSourcesResponse

ListConversionSources 메서드의 응답 메시지입니다.

입력란
conversion_sources[]

ConversionSource

전환 소스 목록입니다.
next_page_token

string

다음 결과 페이지를 가져오는 데 사용되는 토큰입니다.

MerchantCenterDestination

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

입력란
destination

string

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

AttributionSettings

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

string

필수 항목입니다. 대상 유형에 판매자가 지정한 표시 이름입니다. 판매자 센터 UI 내에서 전환 소스를 식별하는 이름입니다. 64자(영문 기준)로 제한됩니다.
currency_code

string

필수 항목입니다. 3자리 통화 코드 (ISO 4217)입니다. 통화 코드는 이 대상 위치로 전송된 전환이 판매자 센터에 보고될 통화를 정의합니다.

UndeleteConversionSourceRequest

UndeleteConversionSource 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제 취소할 전환 소스의 이름입니다. 형식: accounts/{account}/conversionSources/{conversion_source}

UpdateConversionSourceRequest

UpdateConversionSource 메서드의 요청 메시지입니다.

입력란
conversion_source

ConversionSource

필수 항목입니다. 전환 소스 데이터의 새 버전입니다. 형식: accounts/{account}/conversionSources/{conversion_source}
update_mask

FieldMask

필수 항목입니다. 업데이트 중인 필드 목록입니다.