UserData

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

JSON 표현 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  },
  "consent": {
    object (Consent)
  }
}
입력란
userIdentifiers[]

object (UserIdentifier)

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

object (TransactionAttribute)

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

object (UserAttribute)

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

object (Consent)

사용자의 동의 설정입니다. 고객 일치 타겟팅은 이 필드를 무시하고 경고를 반환합니다.

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 (Common Locale Data Repository) 지역 코드입니다. 자세한 내용은 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 (국제거래단품식별코드)일 수 있습니다.