UserData

사용자 식별자 및 속성이 포함된 사용자 데이터입니다.

JSON 표현 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  }
}
필드
userIdentifiers[]

object (UserIdentifier)

사용자 식별 정보입니다. 필수 항목입니다.
transactionAttribute

object (TransactionAttribute)

사용자와 관련된 추가 거래/속성입니다. 매장 판매 데이터를 업데이트할 때 필요합니다.
userAttribute

object (UserAttribute)

사용자와 연결된 추가 속성입니다. 고객 일치 타겟팅 속성을 업데이트할 때 필요합니다. 유효기간은 540일입니다.

TransactionAttribute

매장 판매 거래의 속성입니다.

JSON 표현 
{
  "storeAttribute": {
    object (StoreAttribute)
  },
  "itemAttribute": {
    object (ItemAttribute)
  },
  "transactionDateTime": string,
  "transactionAmountMicros": number,
  "currencyCode": string,
  "conversionAction": string,
  "orderId": string,
  "customValue": string
}
필드
storeAttribute

object (StoreAttribute)

거래의 매장 속성입니다. 허용 목록에 있는 고객만 액세스할 수 있습니다.
itemAttribute

object (ItemAttribute)

거래의 상품 속성입니다.
transactionDateTime

string

트랜잭션이 발생한 시점의 타임스탬프입니다. 필수 항목입니다. 형식은 'YYYY-MM-DD HH:MM:SS[+/-HH:MM]'이며, 여기서 [+/-HH:MM] 은 UTC의 시간대 오프셋입니다(선택사항). 오프셋이 없으면 API에서 계정의 시간대를 기본값으로 사용합니다. 예: '2018-03-05 09:15:00' 또는 '2018-02-01 14:34:30+03:00'
transactionAmountMicros

number

마이크로 단위의 거래 금액입니다. 필수 항목입니다. 마이크로 단위의 거래 금액은 1,000보다 커야 합니다. 상품 속성이 제공되는 경우 상품당 단가에 ItemAttributes에서 제공된 수량을 곱하여 상품의 총 가치를 나타냅니다.
currencyCode

string

거래 통화 코드입니다. 세 자리 ISO 4217 코드가 사용됩니다. 필수 항목입니다.
conversionAction

string

전환을 보고할 전환 액션의 리소스 이름입니다. 필수 항목입니다.
orderId

string

거래 주문 ID입니다. 허용 목록에 있는 고객만 액세스할 수 있습니다.
customValue

string

거래별 맞춤 변수 값입니다. 허용 목록에 있는 고객만 액세스할 수 있습니다.

StoreAttribute

거래의 매장 속성입니다.

JSON 표현 
{
  "storeCode": string
}
필드
storeCode

string

https://support.google.com/business/answer/3370250#storecode의 판매점 코드

ItemAttribute

거래의 상품 속성입니다.

JSON 표현 
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
필드
itemId

string

제품의 고유 식별자입니다. 판매자 센터 상품 ID 또는 GTIN (국제거래단품식별코드)일 수 있습니다.
countryCode

string

상품이 업로드된 피드와 연결된 국가의 공통 언어 데이터 저장소 (CLDR) 지역 코드입니다. 자세한 내용은 https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes를 참고하세요.
languageCode

string

상품이 업로드되는 피드와 연결된 언어의 ISO 639-1 코드입니다.
quantity

string (int64 format)

판매된 상품의 개수입니다. 설정하지 않으면 기본값은 1입니다.
merchantId

string (int64 format)

판매자 센터 계정의 ID입니다.

UserAttribute

사용자 속성입니다. CUSTOMER_MATCH_WITH_ATTRIBUTES 작업 유형에만 사용할 수 있습니다.

JSON 표현 
{
  "lastPurchaseDateTime": string,
  "averagePurchaseCount": integer,
  "averagePurchaseValueMicros": string,
  "acquisitionDateTime": string,
  "lifecycleStage": string,
  "firstPurchaseDateTime": string,
  "eventAttribute": [
    {
      object (EventAttribute)
    }
  ],
  "lifetimeValueMicros": string,
  "lifetimeValueBucket": integer,
  "shoppingLoyalty": {
    object (ShoppingLoyalty)
  }
}
필드
lastPurchaseDateTime

string

사용자의 마지막 구매 타임스탬프입니다. 형식은 YYYY-MM-DD HH:MM:SS[+/-HH:MM]이며, 여기서 [+/-HH:MM] 은 UTC로부터의 선택적 시간대 오프셋입니다. 오프셋이 없으면 API에서 계정의 시간대를 기본값으로 사용합니다.
averagePurchaseCount

integer

광고주가 30일 동안 사용자의 평균 구매 횟수를 정의함
averagePurchaseValueMicros

string (int64 format)

광고주가 사용자의 평균 구매 가치를 마이크로 단위로 정의함
acquisitionDateTime

string

사용자를 획득한 시점의 타임스탬프입니다. 형식은 YYYY-MM-DD HH:MM:SS[+/-HH:MM]이며, 여기서 [+/-HH:MM] 은 UTC로부터의 선택적 시간대 오프셋입니다. 오프셋이 없으면 API에서 계정의 시간대를 기본값으로 사용합니다.
lifecycleStage

string

선택사항입니다. 광고주가 사용자에 대해 정의한 수명 주기 단계입니다. 허용되는 값은 '리드', '활성', '앱 제거'입니다.
firstPurchaseDateTime

string

선택사항입니다. 사용자의 첫 구매 타임스탬프입니다. 형식은 YYYY-MM-DD HH:MM:SS[+/-HH:MM]이며, 여기서 [+/-HH:MM] 은 UTC로부터의 선택적 시간대 오프셋입니다. 오프셋이 없으면 API에서 계정의 시간대를 기본값으로 사용합니다.
eventAttribute[]

object (EventAttribute)

선택사항입니다. 광고주가 이벤트와 해당 속성을 정의했습니다. 중첩 필드의 모든 값이 필요합니다. 현재 이 필드는 베타 버전입니다.
lifetimeValueMicros

string (int64 format)

광고주가 사용자에 대해 정의한 평생 가치
lifetimeValueBucket

integer

광고주가 사용자에 대해 정의한 평생 가치 버킷 평생 가치 버킷의 유효한 범위는 1 (낮음)~10 (높음)입니다. 단, 0도 허용되는 삭제 작업은 예외입니다.
shoppingLoyalty

object (ShoppingLoyalty)

쇼핑 충성도 관련 데이터입니다. 쇼핑에서는 이 데이터를 활용하여 사용자에게 더 나은 경험을 제공합니다. 사용자의 동의를 받아 허용 목록에 있는 판매자만 액세스할 수 있습니다.

ShoppingLoyalty

쇼핑 충성도 관련 데이터입니다. 쇼핑에서는 이 데이터를 활용하여 사용자에게 더 나은 경험을 제공합니다. 허용 목록에 있는 판매자만 액세스할 수 있습니다.

JSON 표현 
{
  "loyaltyTier": string
}
필드
loyaltyTier

string

멤버십 등급입니다. 판매자마다 포인트 제도가 다를 수 있으므로 이는 자유 형식의 문자열입니다. 예를 들어 1에서 10 사이의 숫자, 'Golden' 또는 'Silver'와 같은 문자열 또는 빈 문자열 ''일 수도 있습니다.

EventAttribute

광고주가 이벤트와 해당 속성을 정의했습니다. 중첩 필드의 모든 값이 필요합니다.

JSON 표현 
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
필드
event

string

필수 항목입니다. 리마케팅에 사용할 광고주가 정의한 이벤트입니다. 허용되는 값은 '조회됨', '장바구니', '구입한 항목', '추천'입니다.
eventDateTime

string

필수 항목입니다. 이벤트가 발생한 타임스탬프입니다. 형식은 YYYY-MM-DD HH:MM:SS[+/-HH:MM]이며, 여기서 [+/-HH:MM] 은 UTC로부터의 선택적 시간대 오프셋입니다. 오프셋이 없으면 API에서 계정의 시간대를 기본값으로 사용합니다.
itemAttribute[]

object (EventItemAttribute)

필수 항목입니다. 이벤트의 상품 속성입니다.

EventItemAttribute

고객 일치 타겟팅의 이벤트 상품 속성입니다.

JSON 표현 
{
  "itemId": string
}
필드
itemId

string

선택사항입니다. 제품의 고유 식별자입니다. 판매자 센터 상품 ID 또는 GTIN (국제거래단품식별코드)일 수 있습니다.