- JSON 표현
- OfflineUserDataJobType
- OfflineUserDataJobStatus
- OfflineUserDataJobFailureReason
- OfflineUserDataJobMetadata
- OfflineUserDataJobMatchRateRange
- StoreSalesMetadata
- StoreSalesThirdPartyMetadata
비동기식으로 처리되는 매장 방문자 또는 사용자 목록 회원의 오프라인 사용자 데이터가 포함된 작업입니다. 업로드된 데이터를 읽을 수 없으며 GoogleAdsService.Search/SearchStream을 사용하여 작업 처리 결과를 읽을 수만 있습니다.
JSON 표현 |
---|
{ "resourceName": string, "type": enum ( |
필드 | |
---|---|
resourceName |
변경할 수 없습니다. 오프라인 사용자 데이터 작업의 리소스 이름입니다. 오프라인 사용자 데이터 작업 리소스 이름의 형식은 다음과 같습니다.
|
type |
변경할 수 없습니다. 작업 유형입니다. |
status |
출력 전용. 작업의 상태입니다. |
failureReason |
출력 전용. 상태가 FAILED인 경우 처리 실패 이유입니다. |
operationMetadata |
출력 전용. 일치율 범위를 나타내는 오프라인 사용자 데이터 작업의 메타데이터입니다. |
id |
출력 전용. 이 오프라인 사용자 데이터 작업의 ID입니다. |
externalId |
변경할 수 없습니다. 사용자가 지정한 작업 ID입니다. |
통합 필드 metadata . 작업의 메타데이터입니다. metadata 은 다음 중 하나여야 합니다. |
|
customerMatchUserListMetadata |
변경할 수 없습니다. CRM 기반 사용자 목록의 데이터 업데이트에 대한 메타데이터입니다. |
storeSalesMetadata |
변경할 수 없습니다. 매장 판매 데이터 업데이트에 대한 메타데이터입니다. |
OfflineUserDataJobType
오프라인 사용자 데이터 작업의 유형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
STORE_SALES_UPLOAD_FIRST_PARTY |
셀프 서비스를 위한 매장 판매 직접 데이터 |
STORE_SALES_UPLOAD_THIRD_PARTY |
서드 파티의 매장 판매 직접 데이터입니다. |
CUSTOMER_MATCH_USER_LIST |
고객 일치 타겟팅 사용자 목록 데이터입니다. |
CUSTOMER_MATCH_WITH_ATTRIBUTES |
속성 데이터를 사용한 고객 일치 타겟팅 |
OfflineUserDataJobStatus
오프라인 사용자 데이터 작업의 상태입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
PENDING |
작업이 생성되었으며 업로드 대기 중입니다. |
RUNNING |
업로드가 수락되었으며 데이터를 처리하는 중입니다. |
SUCCESS |
업로드된 데이터가 처리되었습니다. |
FAILED |
업로드된 데이터를 처리하지 못했습니다. |
OfflineUserDataJobFailureReason
오프라인 사용자 데이터 작업이 실패한 이유입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
INSUFFICIENT_MATCHED_TRANSACTIONS |
일치하는 거래가 충분하지 않습니다. |
INSUFFICIENT_TRANSACTIONS |
업로드된 거래가 충분하지 않습니다. |
HIGH_AVERAGE_TRANSACTION_VALUE |
계정의 평균 거래 금액이 비정상적으로 높습니다. 이러한 의도적인 경우 지원팀에 문의하여 예외를 요청하세요. https://support.google.com/google-ads/answer/10018944#transaction_value에서 자세히 알아보세요. |
LOW_AVERAGE_TRANSACTION_VALUE |
계정의 평균 거래 금액이 비정상적으로 낮습니다. 이러한 의도적인 경우 지원팀에 문의하여 예외를 요청하세요. https://support.google.com/google-ads/answer/10018944#transaction_value에서 자세히 알아보세요. |
NEWLY_OBSERVED_CURRENCY_CODE |
업로드에 이전에 사용하지 않은 통화 코드가 있습니다. 이러한 의도적인 경우 지원팀에 문의하여 예외를 요청하세요. 자세한 내용은 다음 페이지를 참조하세요. https://support.google.com/google-ads/answer/10018944#Unrecognized_currency |
OfflineUserDataJobMetadata
오프라인 사용자 데이터 작업의 메타데이터입니다.
JSON 표현 |
---|
{
"matchRateRange": enum ( |
필드 | |
---|---|
matchRateRange |
출력 전용. 고객 일치 타겟팅 사용자 목록 업로드의 일치율입니다. 작업 상태가 'RUNNING'인 경우 예상 일치율을 설명하고 작업 상태가 'SUCCESS/FAILED'인 후 최종 일치율을 사용할 수 있는 경우의 최종 일치율을 설명합니다. |
OfflineUserDataJobMatchRateRange
오프라인 사용자 데이터 작업의 일치율 범위입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
일치율 범위의 기본값입니다. |
MATCH_RANGE_LESS_THAN_20 |
오프라인 데이터 업로드 항목의 일치율 범위는 0~19%입니다. |
MATCH_RANGE_20_TO_30 |
오프라인 데이터 업로드 항목의 일치율 범위는 20~30%입니다. |
MATCH_RANGE_31_TO_40 |
오프라인 데이터 업로드 항목의 일치율 범위는 31~40%입니다. |
MATCH_RANGE_41_TO_50 |
오프라인 데이터 업로드 항목의 일치율 범위는 41~50%입니다. |
MATCH_RANGE_51_TO_60 |
오프라인 데이터 업로드 항목의 일치율 범위는 51% 에서 60% 사이입니다. |
MATCH_RANGE_61_TO_70 |
오프라인 데이터 업로드 항목의 일치율 범위는 61~70%입니다. |
MATCH_RANGE_71_TO_80 |
오프라인 데이터 업로드 항목의 일치율 범위는 71~80%입니다. |
MATCH_RANGE_81_TO_90 |
오프라인 데이터 업로드 항목의 일치율 범위는 81~90%입니다. |
MATCH_RANGE_91_TO_100 |
오프라인 데이터 업로드 항목의 일치율 범위가 91% 이상입니다. |
StoreSalesMetadata
매장 직접 판매의 메타데이터입니다.
JSON 표현 |
---|
{
"thirdPartyMetadata": {
object ( |
필드 | |
---|---|
thirdPartyMetadata |
서드 파티 매장 판매 업로드에 대한 메타데이터입니다. |
loyaltyFraction |
식별 가능한 모든 거래 (예: 모든 형태의 고객 정보와 관련)가 있는 거래의 비율입니다. 필수 항목입니다. 비율은 0에서 1 사이여야 합니다(0 제외). |
transactionUploadFraction |
고객과 관련될 수 있는 전체 판매 대비 업로드 중인 판매의 비율입니다. 필수 항목입니다. 비율은 0에서 1 사이여야 합니다(0 제외). 예를 들어 고객과 연결할 수 있는 판매의 절반을 업로드하면 0.5가 됩니다. |
customKey |
매장 판매 맞춤 변수 키의 이름입니다. 거래에 적용한 후 나중에 보고서에서 맞춤 세분화에 사용할 수 있는 사전 정의된 키입니다. 허용 목록에 있는 고객만 액세스할 수 있습니다. |
StoreSalesThirdPartyMetadata
서드 파티 매장 판매에 대한 메타데이터입니다. 이 제품은 허용 목록에 있는 고객 전용입니다. 업로드 구성에 대한 자세한 내용은 Google BD/계약 담당 담당자에게 문의하세요.
JSON 표현 |
---|
{ "advertiserUploadDateTime": string, "validTransactionFraction": number, "partnerMatchFraction": number, "partnerUploadFraction": number, "bridgeMapVersionId": string, "partnerId": string } |
필드 | |
---|---|
advertiserUploadDateTime |
광고주가 파트너에게 데이터를 업로드한 시간입니다. 필수 항목입니다. 형식은 'YYYY-MM-DD HH:MM:SS'입니다. 예: '2018-03-05 09:15:00' 또는 '2018-02-01 14:34:30' |
validTransactionFraction |
유효한 거래의 비율입니다. 무효 거래에는 잘못된 형식이나 값이 포함될 수 있습니다. 필수 항목입니다. 비율은 0에서 1 사이여야 합니다(0 제외). |
partnerMatchFraction |
파트너 측에서 할당한 서드 파티의 사용자 ID와 일치하는 유효한 거래의 비율입니다. 필수 항목입니다. 비율은 0에서 1 사이여야 합니다(0 제외). |
partnerUploadFraction |
파트너가 Google에 업로드한 유효한 거래의 비율입니다. 필수 항목입니다. 비율은 0에서 1 사이여야 합니다(0 제외). |
bridgeMapVersionId |
업로드에 사용할 파트너 ID의 버전입니다. 필수 항목입니다. |
partnerId |
거래 피드를 업데이트하는 서드 파티 파트너의 ID입니다. |