- JSON 표현
- TransactionAttribute
- StoreAttribute
- ItemAttribute
- UserAttribute
- ShoppingLoyalty
- EventAttribute
- EventItemAttribute
사용자 식별자 및 속성이 포함된 사용자 데이터입니다.
JSON 표현 |
---|
{ "userIdentifiers": [ { object ( |
필드 | |
---|---|
userIdentifiers[] |
사용자 식별 정보입니다. 필수 항목입니다. |
transactionAttribute |
사용자와 관련된 추가 거래/속성입니다. 매장 판매 데이터를 업데이트할 때 필요합니다. |
userAttribute |
사용자와 연결된 추가 속성입니다. 고객 일치 타겟팅 속성을 업데이트할 때 필요합니다. 유효기간은 540일입니다. |
consent |
사용자의 동의 설정입니다. 고객 일치 타겟팅은 이 입력란을 무시하고 경고를 반환합니다. |
TransactionAttribute
매장 판매 거래의 속성입니다.
JSON 표현 |
---|
{ "storeAttribute": { object ( |
필드 | |
---|---|
storeAttribute |
거래의 매장 속성입니다. 허용 목록에 있는 고객만 액세스할 수 있습니다. |
itemAttribute |
거래의 상품 속성입니다. |
transactionDateTime |
트랜잭션이 발생한 시점의 타임스탬프입니다. 필수 항목입니다. 형식은 '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 |
마이크로 단위의 거래 금액입니다. 필수 항목입니다. 마이크로 단위의 거래 금액은 1,000보다 커야 합니다. 상품 속성이 제공되는 경우 상품당 단가에 ItemAttributes에서 제공된 수량을 곱하여 상품의 총 가치를 나타냅니다. |
currencyCode |
거래 통화 코드입니다. 세 자리 ISO 4217 코드가 사용됩니다. 필수 항목입니다. |
conversionAction |
전환을 보고할 전환 액션의 리소스 이름입니다. 필수 항목입니다. |
orderId |
거래 주문 ID입니다. 허용 목록에 있는 고객만 액세스할 수 있습니다. |
customValue |
거래별 맞춤 변수 값입니다. 허용 목록에 있는 고객만 액세스할 수 있습니다. |
StoreAttribute
거래의 매장 속성입니다.
JSON 표현 |
---|
{ "storeCode": string } |
필드 | |
---|---|
storeCode |
https://support.google.com/business/answer/3370250#storecode의 판매점 코드 |
ItemAttribute
거래의 상품 속성입니다.
JSON 표현 |
---|
{ "itemId": string, "countryCode": string, "languageCode": string, "quantity": string, "merchantId": string } |
필드 | |
---|---|
itemId |
제품의 고유 식별자입니다. 판매자 센터 상품 ID 또는 GTIN (국제거래단품식별코드)일 수 있습니다. |
countryCode |
상품이 업로드된 피드와 연결된 국가의 공통 언어 데이터 저장소 (CLDR) 지역 코드입니다. 자세한 내용은 https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes를 참고하세요. |
languageCode |
상품이 업로드되는 피드와 연결된 언어의 ISO 639-1 코드입니다. |
quantity |
판매된 상품의 개수입니다. 설정하지 않으면 기본값은 1입니다. |
merchantId |
판매자 센터 계정의 ID입니다. |
UserAttribute
사용자 속성입니다. CUSTOMER_MATCH_WITH_ATTRIBUTES 작업 유형에만 사용할 수 있습니다.
JSON 표현 |
---|
{ "lastPurchaseDateTime": string, "averagePurchaseCount": integer, "averagePurchaseValueMicros": string, "acquisitionDateTime": string, "lifecycleStage": string, "firstPurchaseDateTime": string, "eventAttribute": [ { object ( |
필드 | |
---|---|
lastPurchaseDateTime |
사용자의 마지막 구매 타임스탬프입니다. 형식은 YYYY-MM-DD HH:MM:SS[+/-HH:MM]이며, 여기서 [+/-HH:MM] 은 UTC로부터의 선택적 시간대 오프셋입니다. 오프셋이 없으면 API에서 계정의 시간대를 기본값으로 사용합니다. |
averagePurchaseCount |
광고주가 30일 동안 사용자의 평균 구매 횟수를 정의함 |
averagePurchaseValueMicros |
광고주가 사용자의 평균 구매 가치를 마이크로 단위로 정의함 |
acquisitionDateTime |
사용자를 획득한 시점의 타임스탬프입니다. 형식은 YYYY-MM-DD HH:MM:SS[+/-HH:MM]이며, 여기서 [+/-HH:MM] 은 UTC로부터의 선택적 시간대 오프셋입니다. 오프셋이 없으면 API에서 계정의 시간대를 기본값으로 사용합니다. |
lifecycleStage |
선택사항입니다. 광고주가 사용자에 대해 정의한 수명 주기 단계입니다. 허용되는 값은 '리드', '활성', '앱 제거'입니다. |
firstPurchaseDateTime |
선택사항입니다. 사용자의 첫 구매 타임스탬프입니다. 형식은 YYYY-MM-DD HH:MM:SS[+/-HH:MM]이며, 여기서 [+/-HH:MM] 은 UTC로부터의 선택적 시간대 오프셋입니다. 오프셋이 없으면 API에서 계정의 시간대를 기본값으로 사용합니다. |
eventAttribute[] |
선택사항입니다. 광고주가 이벤트와 해당 속성을 정의했습니다. 중첩 필드의 모든 값이 필요합니다. 현재 이 필드는 베타 버전입니다. |
lifetimeValueMicros |
광고주가 사용자에 대해 정의한 평생 가치 |
lifetimeValueBucket |
광고주가 사용자에 대해 정의한 평생 가치 버킷 평생 가치 버킷의 유효한 범위는 1 (낮음)~10 (높음)입니다. 단, 0도 허용되는 삭제 작업은 예외입니다. |
shoppingLoyalty |
쇼핑 충성도 관련 데이터입니다. 쇼핑에서는 이 데이터를 활용하여 사용자에게 더 나은 경험을 제공합니다. 사용자의 동의를 받아 허용 목록에 있는 판매자만 액세스할 수 있습니다. |
ShoppingLoyalty
쇼핑 충성도 관련 데이터입니다. 쇼핑에서는 이 데이터를 활용하여 사용자에게 더 나은 경험을 제공합니다. 허용 목록에 있는 판매자만 액세스할 수 있습니다.
JSON 표현 |
---|
{ "loyaltyTier": string } |
필드 | |
---|---|
loyaltyTier |
멤버십 등급입니다. 판매자마다 포인트 제도가 다를 수 있으므로 이는 자유 형식의 문자열입니다. 예를 들어 1에서 10 사이의 숫자, 'Golden' 또는 'Silver'와 같은 문자열 또는 빈 문자열 ''일 수도 있습니다. |
EventAttribute
광고주가 이벤트와 해당 속성을 정의했습니다. 중첩 필드의 모든 값이 필요합니다.
JSON 표현 |
---|
{
"event": string,
"eventDateTime": string,
"itemAttribute": [
{
object ( |
필드 | |
---|---|
event |
필수 항목입니다. 리마케팅에 사용할 광고주가 정의한 이벤트입니다. 허용되는 값은 '조회됨', '장바구니', '구입한 항목', '추천'입니다. |
eventDateTime |
필수 항목입니다. 이벤트가 발생한 타임스탬프입니다. 형식은 YYYY-MM-DD HH:MM:SS[+/-HH:MM]이며, 여기서 [+/-HH:MM] 은 UTC로부터의 선택적 시간대 오프셋입니다. 오프셋이 없으면 API에서 계정의 시간대를 기본값으로 사용합니다. |
itemAttribute[] |
필수 항목입니다. 이벤트의 상품 속성입니다. |
EventItemAttribute
고객 일치 타겟팅의 이벤트 상품 속성입니다.
JSON 표현 |
---|
{ "itemId": string } |
필드 | |
---|---|
itemId |
선택사항입니다. 제품의 고유 식별자입니다. 판매자 센터 상품 ID 또는 GTIN (국제거래단품식별코드)일 수 있습니다. |