OfflineUserDataJob

비동기식으로 처리되는 매장 방문자 또는 사용자 목록 회원의 오프라인 사용자 데이터가 포함된 작업입니다. 업로드된 데이터를 읽을 수 없으며 GoogleAdsService.Search/SearchStream을 사용하여 작업 처리 결과를 읽을 수만 있습니다.

JSON 표현 
{
  "resourceName": string,
  "type": enum (OfflineUserDataJobType),
  "status": enum (OfflineUserDataJobStatus),
  "failureReason": enum (OfflineUserDataJobFailureReason),
  "operationMetadata": {
    object (OfflineUserDataJobMetadata)
  },
  "id": string,
  "externalId": string,

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  },
  "storeSalesMetadata": {
    object (StoreSalesMetadata)
  }
  // End of list of possible types for union field metadata.
}
필드
resourceName

string

변경할 수 없습니다. 오프라인 사용자 데이터 작업의 리소스 이름입니다. 오프라인 사용자 데이터 작업 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/offlineUserDataJobs/{offline_user_data_job_id}
type

enum (OfflineUserDataJobType)

변경할 수 없습니다. 작업 유형입니다.
status

enum (OfflineUserDataJobStatus)

출력 전용. 작업의 상태입니다.
failureReason

enum (OfflineUserDataJobFailureReason)

출력 전용. 상태가 FAILED인 경우 처리 실패 이유입니다.
operationMetadata

object (OfflineUserDataJobMetadata)

출력 전용. 일치율 범위를 나타내는 오프라인 사용자 데이터 작업의 메타데이터입니다.
id

string (int64 format)

출력 전용. 이 오프라인 사용자 데이터 작업의 ID입니다.
externalId

string (int64 format)

변경할 수 없습니다. 사용자가 지정한 작업 ID입니다.
통합 필드 metadata. 작업의 메타데이터입니다. metadata은 다음 중 하나여야 합니다.
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

변경할 수 없습니다. CRM 기반 사용자 목록의 데이터 업데이트에 대한 메타데이터입니다.
storeSalesMetadata

object (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 (OfflineUserDataJobMatchRateRange)
}
필드
matchRateRange

enum (OfflineUserDataJobMatchRateRange)

출력 전용. 고객 일치 타겟팅 사용자 목록 업로드의 일치율입니다. 작업 상태가 '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 (StoreSalesThirdPartyMetadata)
  },
  "loyaltyFraction": number,
  "transactionUploadFraction": number,
  "customKey": string
}
필드
thirdPartyMetadata

object (StoreSalesThirdPartyMetadata)

서드 파티 매장 판매 업로드에 대한 메타데이터입니다.
loyaltyFraction

number

식별 가능한 모든 거래 (예: 모든 형태의 고객 정보와 관련)가 있는 거래의 비율입니다. 필수 항목입니다. 비율은 0에서 1 사이여야 합니다(0 제외).
transactionUploadFraction

number

고객과 관련될 수 있는 전체 판매 대비 업로드 중인 판매의 비율입니다. 필수 항목입니다. 비율은 0에서 1 사이여야 합니다(0 제외). 예를 들어 고객과 연결할 수 있는 판매의 절반을 업로드하면 0.5가 됩니다.
customKey

string

매장 판매 맞춤 변수 키의 이름입니다. 거래에 적용한 후 나중에 보고서에서 맞춤 세분화에 사용할 수 있는 사전 정의된 키입니다. 허용 목록에 있는 고객만 액세스할 수 있습니다.

StoreSalesThirdPartyMetadata

서드 파티 매장 판매에 대한 메타데이터입니다. 이 제품은 허용 목록에 있는 고객 전용입니다. 업로드 구성에 대한 자세한 내용은 Google BD/계약 담당 담당자에게 문의하세요.

JSON 표현 
{
  "advertiserUploadDateTime": string,
  "validTransactionFraction": number,
  "partnerMatchFraction": number,
  "partnerUploadFraction": number,
  "bridgeMapVersionId": string,
  "partnerId": string
}
필드
advertiserUploadDateTime

string

광고주가 파트너에게 데이터를 업로드한 시간입니다. 필수 항목입니다. 형식은 'YYYY-MM-DD HH:MM:SS'입니다. 예: '2018-03-05 09:15:00' 또는 '2018-02-01 14:34:30'
validTransactionFraction

number

유효한 거래의 비율입니다. 무효 거래에는 잘못된 형식이나 값이 포함될 수 있습니다. 필수 항목입니다. 비율은 0에서 1 사이여야 합니다(0 제외).
partnerMatchFraction

number

파트너 측에서 할당한 서드 파티의 사용자 ID와 일치하는 유효한 거래의 비율입니다. 필수 항목입니다. 비율은 0에서 1 사이여야 합니다(0 제외).
partnerUploadFraction

number

파트너가 Google에 업로드한 유효한 거래의 비율입니다. 필수 항목입니다. 비율은 0에서 1 사이여야 합니다(0 제외).
bridgeMapVersionId

string

업로드에 사용할 파트너 ID의 버전입니다. 필수 항목입니다.
partnerId

string (int64 format)

거래 피드를 업데이트하는 서드 파티 파트너의 ID입니다.