색인
IngestionService
(인터페이스)AdIdentifiers
(메시지)AddressInfo
(메시지)AudienceMember
(메시지)CartData
(메시지)Consent
(메시지)ConsentStatus
(열거형)CustomVariable
(메시지)CustomerType
(열거형)CustomerValueBucket
(열거형)Destination
(메시지)DeviceInfo
(메시지)Encoding
(열거형)EncryptionInfo
(메시지)ErrorCount
(메시지)ErrorInfo
(메시지)Event
(메시지)EventSource
(열거형)ExperimentalField
(메시지)GcpWrappedKeyInfo
(메시지)GcpWrappedKeyInfo.KeyType
(열거형)IngestAudienceMembersRequest
(메시지)IngestAudienceMembersResponse
(메시지)IngestEventsRequest
(메시지)IngestEventsResponse
(메시지)Item
(메시지)MatchRateRange
(열거형)MobileData
(메시지)PairData
(메시지)ProcessingErrorReason
(열거형)ProcessingWarningReason
(열거형)Product
(열거형)(지원 중단됨)ProductAccount
(메시지)ProductAccount.AccountType
(열거형)RemoveAudienceMembersRequest
(메시지)RemoveAudienceMembersResponse
(메시지)RequestStatusPerDestination
(메시지)RequestStatusPerDestination.IngestAudienceMembersStatus
(메시지)RequestStatusPerDestination.IngestEventsStatus
(메시지)RequestStatusPerDestination.IngestMobileDataStatus
(메시지)RequestStatusPerDestination.IngestPairDataStatus
(메시지)RequestStatusPerDestination.IngestUserDataStatus
(메시지)RequestStatusPerDestination.RemoveAudienceMembersStatus
(메시지)RequestStatusPerDestination.RemoveMobileDataStatus
(메시지)RequestStatusPerDestination.RemovePairDataStatus
(메시지)RequestStatusPerDestination.RemoveUserDataStatus
(메시지)RequestStatusPerDestination.RequestStatus
(열거형)RetrieveRequestStatusRequest
(메시지)RetrieveRequestStatusResponse
(메시지)TermsOfService
(메시지)TermsOfServiceStatus
(열거형)UserData
(메시지)UserIdentifier
(메시지)UserProperties
(메시지)WarningCount
(메시지)WarningInfo
(메시지)
IngestionService
지원되는 대상에 잠재고객 데이터를 전송하는 서비스입니다.
IngestAudienceMembers |
---|
제공된
|
IngestEvents |
---|
제공된
|
RemoveAudienceMembers |
---|
제공된
|
RetrieveRequestStatus |
---|
요청 ID가 지정된 요청의 상태를 가져옵니다.
|
AdIdentifiers
전환 이벤트를 다른 온라인 활동 (예: 광고 클릭)과 일치시키는 데 사용되는 식별자 및 기타 정보입니다.
필드 | |
---|---|
session_attributes |
선택사항입니다. 이벤트 기여 분석 및 모델링을 위한 세션 속성입니다. |
gclid |
선택사항입니다. 이 이벤트와 연결된 Google 클릭 ID (gclid)입니다. |
gbraid |
선택사항입니다. iOS14부터 iOS 기기에서 발생하고 앱 이벤트와 연결된 클릭의 클릭 식별자입니다. |
wbraid |
선택사항입니다. iOS14부터 웹 이벤트와 연결되고 iOS 기기에서 발생한 클릭의 클릭 식별자입니다. |
landing_page_device_info |
선택사항입니다. 광고와 상호작용한 후 광고주의 사이트에 방문할 때 사용 중인 기기에 관해 수집된 정보입니다 (있는 경우). |
AddressInfo
사용자의 주소 정보입니다.
필드 | |
---|---|
given_name |
필수 항목입니다. 사용자의 이름 (성 제외)입니다. 모두 소문자이며, 구두점과 앞뒤 공백이 없고 SHA-256으로 해싱됩니다. |
family_name |
필수 항목입니다. 사용자의 성 (마지막 이름)입니다. 모두 소문자이며, 구두점과 앞뒤 공백이 없고 SHA-256으로 해싱됩니다. |
region_code |
필수 항목입니다. 사용자 주소의 ISO-3166-1 alpha-2 형식의 2자리 지역 코드입니다. |
postal_code |
필수 항목입니다. 사용자 주소의 우편번호입니다. |
AudienceMember
작업할 잠재고객 구성원입니다.
필드 | |
---|---|
destination_references[] |
선택사항입니다. 잠재고객 구성원을 보낼 |
consent |
선택사항입니다. 사용자의 동의 설정입니다. |
통합 필드 data . 작업할 식별 데이터의 유형입니다. data 은 다음 중 하나여야 합니다. |
|
user_data |
사용자를 식별하는 사용자 제공 데이터입니다. |
pair_data |
|
mobile_data |
사용자의 휴대기기를 식별하는 데이터입니다. |
CartData
이벤트와 연결된 장바구니 데이터입니다.
필드 | |
---|---|
merchant_id |
선택사항입니다. 상품과 연결된 판매자 센터 ID입니다. |
merchant_feed_label |
선택사항입니다. 상품 피드와 연결된 판매자 센터 피드 라벨입니다. |
merchant_feed_language_code |
선택사항입니다. 상품이 업로드된 판매자 센터 피드와 연결된 ISO 639-1의 언어 코드입니다. |
transaction_discount |
선택사항입니다. 거래와 관련된 모든 할인 금액의 합계입니다. |
items[] |
선택사항입니다. 이벤트와 연결된 항목 목록입니다. |
동의
사용자의 디지털 시장법 (DMA) 동의 설정입니다.
필드 | |
---|---|
ad_user_data |
선택사항입니다. 사용자가 광고 사용자 데이터에 동의하는지 여부를 나타냅니다. |
ad_personalization |
선택사항입니다. 사용자가 광고 개인 최적화에 동의하는지 여부를 나타냅니다. |
ConsentStatus
사용자가 동의를 부여했는지, 거부했는지, 지정하지 않았는지를 나타냅니다.
열거형 | |
---|---|
CONSENT_STATUS_UNSPECIFIED |
지정되지 않음 |
CONSENT_GRANTED |
허용됨 |
CONSENT_DENIED |
거부되었습니다. |
CustomVariable
광고 전환의 맞춤 변수입니다.
필드 | |
---|---|
variable |
선택사항입니다. 설정할 맞춤 변수의 이름입니다. 지정된 대상에 변수가 없으면 무시됩니다. |
value |
선택사항입니다. 맞춤 변수에 저장할 값입니다. |
destination_references[] |
선택사항입니다. 맞춤 변수를 전송할 |
CustomerType
이벤트와 연결된 고객의 유형입니다.
열거형 | |
---|---|
CUSTOMER_TYPE_UNSPECIFIED |
지정되지 않은 CustomerType입니다. 절대로 사용하지 마세요. |
NEW |
고객이 광고주를 처음 이용합니다. |
RETURNING |
고객이 광고주에게 반품합니다. |
REENGAGED |
고객이 광고주와 다시 상호작용했습니다. |
CustomerValueBucket
광고주가 평가한 고객의 가치입니다.
열거형 | |
---|---|
CUSTOMER_VALUE_BUCKET_UNSPECIFIED |
지정되지 않은 CustomerValueBucket입니다. 절대로 사용하지 마세요. |
LOW |
고객의 가치가 낮습니다. |
MEDIUM |
고객이 중간 가치입니다. |
HIGH |
고객의 가치가 높습니다. |
대상
데이터를 전송하는 Google 제품입니다. 예를 들어 Google Ads 계정입니다.
필드 | |
---|---|
reference |
선택사항입니다. 이 |
login_account |
선택사항입니다. 이 API 호출을 만드는 데 사용된 계정입니다. |
linked_account |
선택사항입니다. 호출 사용자의 |
operating_account |
필수 항목입니다. 데이터를 전송하거나 데이터를 삭제할 계정입니다. |
product_destination_id |
필수 항목입니다. 제품 계정 내에서 수집할 객체입니다. 예를 들어 Google Ads 잠재고객 ID, Display & Video 360 잠재고객 ID 또는 Google Ads 전환 액션 ID입니다. |
DeviceInfo
이벤트가 발생했을 때 사용 중인 기기에 관한 정보입니다 (있는 경우).
필드 | |
---|---|
user_agent |
선택사항입니다. 지정된 컨텍스트의 기기 사용자 에이전트 문자열입니다. |
ip_address |
선택사항입니다. 지정된 컨텍스트의 기기 IP 주소입니다. 참고: Google Ads는 유럽 경제 지역 (EEA), 영국 (UK), 스위스 (CH)의 최종 사용자에 대한 IP 주소 일치를 지원하지 않습니다. 이러한 지역의 사용자의 IP 주소 공유를 조건부로 제외하는 로직을 추가하고, 사이트, 앱, 기타 속성에서 수집하는 데이터에 대해 명확하고 포괄적인 정보를 사용자에게 제공하고 법 또는 관련 Google 정책에서 요구하는 경우 동의를 얻어야 합니다. 자세한 내용은 오프라인 전환 가져오기 정보 페이지를 참고하세요. |
인코딩
해시된 식별 정보의 인코딩 유형입니다.
열거형 | |
---|---|
ENCODING_UNSPECIFIED |
지정되지 않은 인코딩 유형입니다. 절대로 사용하지 마세요. |
HEX |
16진수 인코딩입니다. |
BASE64 |
Base 64 인코딩입니다. |
EncryptionInfo
수집되는 데이터의 암호화 정보입니다.
필드 | |
---|---|
통합 필드 wrapped_key . 데이터를 암호화하는 데 사용되는 래핑된 키입니다. wrapped_key 은 다음 중 하나일 수 있습니다. |
|
gcp_wrapped_key_info |
Google Cloud Platform 래핑된 키 정보입니다. |
ErrorCount
특정 오류 이유의 오류 수입니다.
필드 | |
---|---|
record_count |
특정 이유로 업로드에 실패한 레코드 수입니다. |
reason |
실패한 레코드의 오류 이유입니다. |
ErrorInfo
각 오류 유형의 오류 수입니다.
필드 | |
---|---|
error_counts[] |
오류 이유별 오류 및 개수 목록입니다. 경우에 따라 채워지지 않을 수 있습니다. |
이벤트
사용자와 광고주의 웹사이트 또는 앱 간의 상호작용을 나타내는 이벤트입니다.
필드 | |
---|---|
destination_references[] |
선택사항입니다. 대상을 결정하는 데 사용되는 참조 문자열입니다. 비어 있으면 이벤트가 요청의 모든 |
transaction_id |
선택사항입니다. 이 이벤트의 고유 식별자입니다. 여러 데이터 소스를 사용하는 전환에 필요합니다. |
event_timestamp |
필수 항목입니다. 이벤트가 발생한 시간입니다. |
last_updated_timestamp |
선택사항입니다. 이벤트가 마지막으로 업데이트된 시간입니다. |
user_data |
선택사항입니다. 이벤트와 연결된 사용자를 나타내는 사용자 제공 데이터입니다. |
consent |
선택사항입니다. 연결된 사용자가 다양한 유형의 동의를 제공했는지에 관한 정보입니다. |
ad_identifiers |
선택사항입니다. 전환 이벤트를 다른 온라인 활동 (예: 광고 클릭)과 일치시키는 데 사용되는 식별자 및 기타 정보입니다. |
currency |
선택사항입니다. 이 이벤트 내의 모든 금전적 가치와 연결된 통화 코드입니다. |
conversion_value |
선택사항입니다. 가치 기반 전환의 경우 이벤트와 연결된 전환 가치입니다. |
event_source |
선택사항입니다. 이벤트가 발생한 위치 (웹, 앱, 매장 등)를 나타내는 신호입니다. |
event_device_info |
선택사항입니다. 이벤트가 발생했을 때 사용 중인 기기에 관해 수집된 정보입니다 (있는 경우). |
cart_data |
선택사항입니다. 거래 및 이벤트와 연결된 상품에 대한 정보입니다. |
custom_variables[] |
선택사항입니다. 전환 컨테이너 (전환 액션 또는 FL 활동)로 전송할 추가 키/값 쌍 정보입니다. |
experimental_fields[] |
선택사항입니다. 실험용 필드의 키-값 쌍 목록입니다. 실험용 필드는 결국 API의 일부로 승격될 수 있습니다. |
user_properties |
선택사항입니다. 이벤트가 발생한 시점에 광고주가 평가한 사용자에 관한 정보입니다. |
EventSource
이벤트의 소스입니다.
열거형 | |
---|---|
EVENT_SOURCE_UNSPECIFIED |
지정되지 않은 EventSource입니다. 절대로 사용하지 마세요. |
WEB |
이 이벤트는 웹브라우저에서 생성되었습니다. |
APP |
앱에서 생성된 이벤트입니다. |
IN_STORE |
이 이벤트는 오프라인 거래에서 생성되었습니다. |
PHONE |
이 일정은 전화 통화에서 생성되었습니다. |
OTHER |
이 이벤트는 다른 소스에서 생성되었습니다. |
ExperimentalField
비공식 필드를 나타내는 실험용 필드입니다.
필드 | |
---|---|
field |
선택사항입니다. 사용할 필드의 이름입니다. |
value |
선택사항입니다. 설정할 필드의 값입니다. |
GcpWrappedKeyInfo
Google Cloud Platform 래핑된 키에 관한 정보입니다.
필드 | |
---|---|
key_type |
필수 항목입니다. 데이터를 암호화하는 데 사용된 알고리즘의 유형입니다. |
wip_provider |
필수 항목입니다. KEK를 사용하는 데 필요한 워크로드 아이덴티티 풀 제공자입니다. |
kek_uri |
필수 항목입니다. Google Cloud Platform Cloud Key Management Service 리소스 ID입니다. 'projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}' 형식이어야 합니다. |
encrypted_dek |
필수 항목입니다. base64로 인코딩된 암호화된 데이터 암호화 키입니다. |
KeyType
데이터를 암호화하는 데 사용된 알고리즘의 유형입니다.
열거형 | |
---|---|
KEY_TYPE_UNSPECIFIED |
지정되지 않은 키 유형입니다. 절대로 사용하지 마세요. |
XCHACHA20_POLY1305 |
알고리즘 XChaCha20-Poly1305 |
IngestAudienceMembersRequest
제공된 대상에 잠재고객 구성원을 업로드하도록 요청합니다. IngestAudienceMembersResponse
을 반환합니다.
필드 | |
---|---|
destinations[] |
필수 항목입니다. 잠재고객 구성원을 보낼 도착 페이지 목록입니다. |
audience_members[] |
필수 항목입니다. 지정된 도착 페이지로 보낼 사용자 목록입니다. 단일 요청에서 최대 10,000개의 |
consent |
선택사항입니다. 요청의 모든 사용자에게 적용되는 요청 수준 동의입니다. 사용자 수준 동의는 요청 수준 동의보다 우선하며 각 |
validate_only |
선택사항입니다. 테스트 목적으로 사용됩니다. |
encoding |
선택사항입니다. |
encryption_info |
선택사항입니다. |
terms_of_service |
선택사항입니다. 사용자가 수락/거부한 서비스 약관입니다. |
IngestAudienceMembersResponse
IngestAudienceMembersRequest
의 응답입니다.
필드 | |
---|---|
request_id |
요청의 자동 생성 ID입니다. |
IngestEventsRequest
제공된 대상에 잠재고객 구성원을 업로드하도록 요청합니다. IngestEventsResponse
을 반환합니다.
필드 | |
---|---|
destinations[] |
필수 항목입니다. 이벤트를 보낼 대상 목록입니다. |
events[] |
필수 항목입니다. 지정된 대상에 전송할 이벤트 목록입니다. 단일 요청에서 최대 2,000개의 |
consent |
선택사항입니다. 요청의 모든 사용자에게 적용되는 요청 수준 동의입니다. 사용자 수준 동의는 요청 수준 동의보다 우선하며 각 |
validate_only |
선택사항입니다. 테스트 목적으로 사용됩니다. |
encoding |
선택사항입니다. |
encryption_info |
선택사항입니다. |
IngestEventsResponse
IngestEventsRequest
의 응답입니다.
필드 | |
---|---|
request_id |
요청의 자동 생성 ID입니다. |
항목
이벤트와 연결된 장바구니의 상품을 나타냅니다.
필드 | |
---|---|
merchant_product_id |
선택사항입니다. 판매자 센터 계정 내 제품 ID입니다. |
quantity |
선택사항입니다. 이 이벤트와 연결된 상품의 수입니다. |
unit_price |
선택사항입니다. 세금, 배송비, 거래별 할인 금액을 제외한 단위 가격입니다. |
MatchRateRange
업로드 또는 사용자 목록의 일치율 범위입니다.
열거형 | |
---|---|
MATCH_RATE_RANGE_UNKNOWN |
일치율 범위를 알 수 없습니다. |
MATCH_RATE_RANGE_NOT_ELIGIBLE |
일치율 범위가 적합하지 않습니다. |
MATCH_RATE_RANGE_LESS_THAN_20 |
일치율 범위가 20% 미만입니다([0, 20) 간격). |
MATCH_RATE_RANGE_20_TO_30 |
일치율 범위는 20~30% ([20, 31) 간격)입니다. |
MATCH_RATE_RANGE_31_TO_40 |
일치율 범위는 31~40% ([31, 41) 간격)입니다. |
MATCH_RATE_RANGE_41_TO_50 |
일치율 범위는 41~50% ([41, 51) 간격)입니다. |
MATCH_RATE_RANGE_51_TO_60 |
일치율 범위는 51~60% ([51, 61) 간격)입니다. |
MATCH_RATE_RANGE_61_TO_70 |
일치율 범위는 61~70% ([61, 71) 간격)입니다. |
MATCH_RATE_RANGE_71_TO_80 |
일치율 범위는 71~80% ([71, 81) 간격)입니다. |
MATCH_RATE_RANGE_81_TO_90 |
일치율 범위는 81~90% ([81, 91) 간격)입니다. |
MATCH_RATE_RANGE_91_TO_100 |
일치율 범위는 91% ~100% ( |
MobileData
잠재고객의 모바일 ID입니다. 모바일 ID가 하나 이상 필요합니다.
필드 | |
---|---|
mobile_ids[] |
필수 항목입니다. 휴대기기 ID (광고 ID/IDFA) 목록입니다. 단일 |
PairData
잠재고객의 PAIR ID입니다. 하나 이상의 페어링 ID가 필요합니다.
필드 | |
---|---|
pair_ids[] |
필수 항목입니다. 클린룸에서 제공한 PII 데이터로, SHA256으로 해싱되고 PAIR 사용자 목록에 게시자 키를 사용하여 EC 교환 암호로 암호화됩니다. 단일 |
ProcessingErrorReason
처리 오류 이유입니다.
열거형 | |
---|---|
PROCESSING_ERROR_REASON_UNSPECIFIED |
처리 오류 이유를 알 수 없습니다. |
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE |
맞춤 변수가 잘못되었습니다. |
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED |
맞춤 변수의 상태가 사용 설정되지 않았습니다. |
PROCESSING_ERROR_REASON_EVENT_TOO_OLD |
전환 이후 지금까지의 기간이 지원되는 최대 기간보다 깁니다. |
PROCESSING_ERROR_REASON_DENIED_CONSENT |
사용자 또는 광고주 기본 설정에 의해 광고 사용자 데이터가 거부됩니다. |
PROCESSING_ERROR_REASON_NO_CONSENT |
광고주가 광고 핵심 플랫폼 서비스에 대한 서드 파티 동의를 제공하지 않았습니다. |
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT |
이 사용자의 전체 동의 (행 수준 동의, 요청 수준 동의, 계정 설정에서 결정됨)를 확인할 수 없습니다. |
PROCESSING_ERROR_REASON_DUPLICATE_GCLID |
GCLID 및 전환 시간이 동일한 전환이 이미 시스템에 있습니다. |
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID |
동일한 주문 ID와 전환 액션 조합이 포함된 전환이 이미 업로드되었습니다. |
PROCESSING_ERROR_REASON_INVALID_GBRAID |
gbraid를 디코딩할 수 없습니다. |
PROCESSING_ERROR_REASON_INVALID_GCLID |
Google 클릭 ID를 디코딩할 수 없습니다. |
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID |
판매자 ID에 숫자가 아닌 문자가 포함되어 있습니다. |
PROCESSING_ERROR_REASON_INVALID_WBRAID |
wbraid를 디코딩할 수 없습니다. |
PROCESSING_ERROR_REASON_INTERNAL_ERROR |
내부 오류입니다. |
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED |
대상 계정에서 향상된 전환 약관에 서명하지 않았습니다. |
PROCESSING_ERROR_REASON_INVALID_EVENT |
이벤트가 잘못되었습니다. |
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS |
일치하는 거래가 최소 기준점 미만입니다. |
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS |
거래가 최소 기준액 미만입니다. |
PROCESSING_ERROR_REASON_INVALID_FORMAT |
이벤트에 형식 오류가 있습니다. |
PROCESSING_ERROR_REASON_DECRYPTION_ERROR |
이벤트에 복호화 오류가 있습니다. |
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR |
DEK를 복호화할 수 없습니다. |
PROCESSING_ERROR_REASON_INVALID_WIP |
WIP의 형식이 잘못되었거나 WIP가 없습니다. |
PROCESSING_ERROR_REASON_INVALID_KEK |
KEK가 잘못되었거나 존재하지 않으므로 데이터를 복호화할 수 없습니다. |
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED |
증명 조건에 의해 거부되었으므로 WIP를 사용할 수 없습니다. |
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED |
시스템에 KEK에 액세스하는 데 필요한 권한이 없습니다. |
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
DEK를 사용하여 UserIdentifier 데이터를 복호화하지 못했습니다. |
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER |
사용자가 운영 계정의 광고가 아닌 광고 식별자로 이벤트를 수집하려고 시도했습니다. |
ProcessingWarningReason
처리 경고 이유입니다.
열거형 | |
---|---|
PROCESSING_WARNING_REASON_UNSPECIFIED |
처리 경고 이유를 알 수 없습니다. |
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED |
시스템에 KEK에 액세스하는 데 필요한 권한이 없습니다. |
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR |
DEK를 복호화할 수 없습니다. |
PROCESSING_WARNING_REASON_DECRYPTION_ERROR |
이벤트에 복호화 오류가 있습니다. |
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED |
증명 조건에 의해 거부되었으므로 WIP를 사용할 수 없습니다. |
PROCESSING_WARNING_REASON_INVALID_WIP |
WIP의 형식이 잘못되었거나 WIP가 없습니다. |
PROCESSING_WARNING_REASON_INVALID_KEK |
KEK가 잘못되었거나 존재하지 않으므로 데이터를 복호화할 수 없습니다. |
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
DEK를 사용하여 UserIdentifier 데이터를 복호화하지 못했습니다. |
PROCESSING_WARNING_REASON_INTERNAL_ERROR |
내부 오류입니다. |
제품
지원이 중단되었습니다. 대신
를 사용하세요. 특정 Google 제품을 나타냅니다.AccountType
열거형 | |
---|---|
PRODUCT_UNSPECIFIED |
지정되지 않은 제품입니다. 절대로 사용하지 마세요. |
GOOGLE_ADS |
Google Ads |
DISPLAY_VIDEO_PARTNER |
Display & Video 360 파트너입니다. |
DISPLAY_VIDEO_ADVERTISER |
Display & Video 360 광고주 |
DATA_PARTNER |
데이터 파트너 |
ProductAccount
특정 계정을 나타냅니다.
필드 | |
---|---|
product |
지원이 중단되었습니다. 대신 |
account_id |
필수 항목입니다. 계정의 ID입니다. 예를 들어 Google Ads 계정 ID입니다. |
account_type |
선택사항입니다. 계정 유형입니다. 예를 들면 |
AccountType
Google 계정 유형을 나타냅니다. 계정 및 대상을 찾는 데 사용됩니다.
열거형 | |
---|---|
ACCOUNT_TYPE_UNSPECIFIED |
지정되지 않은 제품입니다. 절대로 사용하지 마세요. |
GOOGLE_ADS |
Google Ads |
DISPLAY_VIDEO_PARTNER |
Display & Video 360 파트너입니다. |
DISPLAY_VIDEO_ADVERTISER |
Display & Video 360 광고주 |
DATA_PARTNER |
데이터 파트너 |
RemoveAudienceMembersRequest
제공된 대상에서 사용자를 타겟층에서 삭제하도록 요청합니다. RemoveAudienceMembersResponse
를 반환합니다.
필드 | |
---|---|
destinations[] |
필수 항목입니다. 사용자를 삭제할 도착 페이지 목록입니다. |
audience_members[] |
필수 항목입니다. 삭제할 사용자의 목록입니다. |
validate_only |
선택사항입니다. 테스트 목적으로 사용됩니다. |
encoding |
선택사항입니다. |
encryption_info |
선택사항입니다. |
RemoveAudienceMembersResponse
RemoveAudienceMembersRequest
의 응답입니다.
필드 | |
---|---|
request_id |
요청의 자동 생성 ID입니다. |
RequestStatusPerDestination
대상별 요청 상태입니다.
필드 | |
---|---|
destination |
DM API 요청 내의 대상입니다. |
request_status |
대상 위치의 요청 상태입니다. |
error_info |
업로드와 관련된 오류 이유와 오류 수를 포함하는 오류 정보 오류입니다. |
warning_info |
업로드와 관련된 경고 이유와 경고 수를 포함하는 경고 정보입니다. |
통합 필드 status . 대상 위치의 상태입니다. status 은 다음 중 하나여야 합니다. |
|
audience_members_ingestion_status |
수집 잠재고객 구성원 요청의 상태입니다. |
events_ingestion_status |
수집 이벤트 요청의 상태입니다. |
audience_members_removal_status |
잠재고객 구성원 삭제 요청의 상태입니다. |
IngestAudienceMembersStatus
수집 잠재고객 구성원 요청의 상태입니다.
필드 | |
---|---|
통합 필드 status . 대상에 대한 잠재고객 구성원 인게션의 상태입니다. status 은 다음 중 하나여야 합니다. |
|
user_data_ingestion_status |
대상으로의 사용자 데이터 수집 상태입니다. |
mobile_data_ingestion_status |
대상으로의 모바일 데이터 수집 상태입니다. |
pair_data_ingestion_status |
대상으로의 페어 데이터 수집 상태입니다. |
IngestEventsStatus
이벤트가 대상에 수집되는 상태입니다.
필드 | |
---|---|
record_count |
업로드 요청에서 전송된 총 이벤트 수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청의 모든 이벤트를 포함합니다. |
IngestMobileDataStatus
수집과 관련된 통계가 포함된 대상에 대한 모바일 데이터 수집 상태입니다.
필드 | |
---|---|
record_count |
대상에 대한 업로드 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다. |
mobile_id_count |
대상에 대한 업로드 요청에서 전송된 모바일 ID의 총 개수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 모바일 ID를 포함합니다. |
IngestPairDataStatus
수집과 관련된 통계가 포함된 대상에 대한 쌍 데이터 수집 상태입니다.
필드 | |
---|---|
record_count |
대상에 대한 업로드 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다. |
pair_id_count |
대상에 대한 업로드 요청에서 전송된 쌍 ID의 총 개수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청의 모든 쌍 ID를 포함합니다. |
IngestUserDataStatus
수집과 관련된 통계가 포함된 대상에 대한 사용자 데이터 수집 상태입니다.
필드 | |
---|---|
record_count |
대상에 대한 업로드 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다. |
user_identifier_count |
대상에 대한 업로드 요청에서 전송된 사용자 식별자의 총 개수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 사용자 식별자를 포함합니다. |
upload_match_rate_range |
업로드의 일치율 범위입니다. |
RemoveAudienceMembersStatus
잠재고객 구성원 삭제 요청의 상태입니다.
필드 | |
---|---|
통합 필드 status . 대상에서 잠재고객 구성원 삭제 상태입니다. status 은 다음 중 하나여야 합니다. |
|
user_data_removal_status |
대상에서 사용자 데이터 삭제 상태입니다. |
mobile_data_removal_status |
대상에서 모바일 데이터 삭제 상태입니다. |
pair_data_removal_status |
대상에서 페어 데이터 삭제 상태입니다. |
RemoveMobileDataStatus
대상에서 모바일 데이터 삭제 상태입니다.
필드 | |
---|---|
record_count |
삭제 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다. |
mobile_id_count |
삭제 요청에서 전송된 모바일 ID의 총 개수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 모바일 ID를 포함합니다. |
RemovePairDataStatus
대상에서 페어 데이터 삭제 상태입니다.
필드 | |
---|---|
record_count |
삭제 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다. |
pair_id_count |
삭제 요청에서 전송된 쌍 ID의 총 개수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청의 모든 쌍 ID가 포함됩니다. |
RemoveUserDataStatus
대상에서 사용자 데이터 삭제 상태입니다.
필드 | |
---|---|
record_count |
삭제 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다. |
user_identifier_count |
삭제 요청에서 전송된 사용자 식별자의 총 개수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 사용자 식별자를 포함합니다. |
RequestStatus
요청 상태입니다.
열거형 | |
---|---|
REQUEST_STATUS_UNKNOWN |
요청 상태를 알 수 없습니다. |
SUCCESS |
요청이 성공했습니다. |
PROCESSING |
요청이 처리 중입니다. |
FAILED |
요청에 실패했습니다. |
PARTIAL_SUCCESS |
요청이 부분적으로 성공했습니다. |
RetrieveRequestStatusRequest
특정 요청 ID에 대해 DM API에 전송된 요청의 상태를 가져오기 위한 요청입니다. RetrieveRequestStatusResponse
를 반환합니다.
필드 | |
---|---|
request_id |
(필수 항목) 필수 항목입니다. Data Manager API 요청의 요청 ID입니다. |
RetrieveRequestStatusResponse
RetrieveRequestStatusRequest
의 응답입니다.
필드 | |
---|---|
request_status_per_destination[] |
대상별 요청 상태 목록입니다. 상태의 순서는 원래 요청의 대상 순서와 일치합니다. |
TermsOfService
사용자가 수락/거부한 서비스 약관입니다.
필드 | |
---|---|
customer_match_terms_of_service_status |
선택사항입니다. 고객 일치 타겟팅 서비스 약관: https://support.google.com/adspolicy/answer/6299717 |
TermsOfServiceStatus
서비스 약관을 수락하거나 거부하는 호출자의 결정을 나타냅니다.
열거형 | |
---|---|
TERMS_OF_SERVICE_STATUS_UNSPECIFIED |
지정되지 않음 |
ACCEPTED |
호출자가 서비스 약관에 동의하기로 선택했음을 나타내는 상태입니다. |
REJECTED |
호출자가 서비스 약관을 거부하기로 선택했음을 나타내는 상태입니다. |
UserData
사용자를 식별하는 데이터입니다. 식별자가 하나 이상 필요합니다.
필드 | |
---|---|
user_identifiers[] |
필수 항목입니다. 사용자의 식별자입니다. 동일한 유형의 데이터 (예: 여러 이메일 주소)를 여러 개 제공할 수 있습니다. 일치 가능성을 높이려면 식별자를 최대한 많이 제공하세요. |
UserIdentifier
사용자의 단일 식별자입니다.
필드 | |
---|---|
통합 필드 identifier . 정확히 하나를 지정해야 합니다. identifier 은 다음 중 하나여야 합니다. |
|
email_address |
정규화 후 SHA-256 해시 함수를 사용하여 해싱된 이메일 주소입니다. |
phone_number |
정규화 (E164 표준) 후 SHA-256 해시 함수를 사용하여 해싱된 전화번호입니다. |
address |
사용자 주소의 알려진 구성요소입니다. 한 번에 모두 일치하는 식별자의 그룹화를 보유합니다. |
UserProperties
이벤트가 발생한 시점에 광고주가 평가한 사용자에 관한 정보입니다. 자세한 내용은 https://support.google.com/google-ads/answer/14007601을 참고하세요.
필드 | |
---|---|
customer_type |
선택사항입니다. 이벤트와 연결된 고객의 유형입니다. |
customer_value_bucket |
선택사항입니다. 광고주가 평가한 고객의 가치입니다. |
WarningCount
특정 경고 이유에 대한 경고 수입니다.
필드 | |
---|---|
record_count |
경고가 있는 레코드 수입니다. |
reason |
경고 이유입니다. |
WarningInfo
각 경고 유형의 경고 수입니다.
필드 | |
---|---|
warning_counts[] |
경고 목록 및 경고 이유별 개수입니다. |