Package google.ads.datamanager.v1

색인

IngestionService

지원되는 대상에 잠재고객 데이터를 전송하는 서비스입니다.

IngestAudienceMembers

rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse)

제공된 DestinationAudienceMember 리소스 목록을 업로드합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/datamanager
IngestEvents

rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse)

제공된 Destination에서 Event 리소스 목록을 업로드합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/datamanager
RemoveAudienceMembers

rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)

제공된 Destination에서 AudienceMember 리소스 목록을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/datamanager
RetrieveRequestStatus

rpc RetrieveRequestStatus(RetrieveRequestStatusRequest) returns (RetrieveRequestStatusResponse)

요청 ID가 지정된 요청의 상태를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/datamanager

AdIdentifiers

전환 이벤트를 다른 온라인 활동 (예: 광고 클릭)과 일치시키는 데 사용되는 식별자 및 기타 정보입니다.

필드
session_attributes

string

선택사항입니다. 이벤트 기여 분석 및 모델링을 위한 세션 속성입니다.

gclid

string

선택사항입니다. 이 이벤트와 연결된 Google 클릭 ID (gclid)입니다.

gbraid

string

선택사항입니다. iOS14부터 iOS 기기에서 발생하고 앱 이벤트와 연결된 클릭의 클릭 식별자입니다.

wbraid

string

선택사항입니다. iOS14부터 웹 이벤트와 연결되고 iOS 기기에서 발생한 클릭의 클릭 식별자입니다.

landing_page_device_info

DeviceInfo

선택사항입니다. 광고와 상호작용한 후 광고주의 사이트에 방문할 때 사용 중인 기기에 관해 수집된 정보입니다 (있는 경우).

AddressInfo

사용자의 주소 정보입니다.

필드
given_name

string

필수 항목입니다. 사용자의 이름 (성 제외)입니다. 모두 소문자이며, 구두점과 앞뒤 공백이 없고 SHA-256으로 해싱됩니다.

family_name

string

필수 항목입니다. 사용자의 성 (마지막 이름)입니다. 모두 소문자이며, 구두점과 앞뒤 공백이 없고 SHA-256으로 해싱됩니다.

region_code

string

필수 항목입니다. 사용자 주소의 ISO-3166-1 alpha-2 형식의 2자리 지역 코드입니다.

postal_code

string

필수 항목입니다. 사용자 주소의 우편번호입니다.

AudienceMember

작업할 잠재고객 구성원입니다.

필드
destination_references[]

string

선택사항입니다. 잠재고객 구성원을 보낼 Destination을 정의합니다.

consent

Consent

선택사항입니다. 사용자의 동의 설정입니다.

통합 필드 data. 작업할 식별 데이터의 유형입니다. data은 다음 중 하나여야 합니다.
user_data

UserData

사용자를 식별하는 사용자 제공 데이터입니다.

pair_data

PairData

게시자와 광고주의 식별 정보 매칭 솔루션 (PAIR) ID

mobile_data

MobileData

사용자의 휴대기기를 식별하는 데이터입니다.

CartData

이벤트와 연결된 장바구니 데이터입니다.

필드
merchant_id

string

선택사항입니다. 상품과 연결된 판매자 센터 ID입니다.

merchant_feed_label

string

선택사항입니다. 상품 피드와 연결된 판매자 센터 피드 라벨입니다.

merchant_feed_language_code

string

선택사항입니다. 상품이 업로드된 판매자 센터 피드와 연결된 ISO 639-1의 언어 코드입니다.

transaction_discount

double

선택사항입니다. 거래와 관련된 모든 할인 금액의 합계입니다.

items[]

Item

선택사항입니다. 이벤트와 연결된 항목 목록입니다.

사용자의 디지털 시장법 (DMA) 동의 설정입니다.

필드
ad_user_data

ConsentStatus

선택사항입니다. 사용자가 광고 사용자 데이터에 동의하는지 여부를 나타냅니다.

ad_personalization

ConsentStatus

선택사항입니다. 사용자가 광고 개인 최적화에 동의하는지 여부를 나타냅니다.

ConsentStatus

사용자가 동의를 부여했는지, 거부했는지, 지정하지 않았는지를 나타냅니다.

열거형
CONSENT_STATUS_UNSPECIFIED 지정되지 않음
CONSENT_GRANTED 허용됨
CONSENT_DENIED 거부되었습니다.

CustomVariable

광고 전환의 맞춤 변수입니다.

필드
variable

string

선택사항입니다. 설정할 맞춤 변수의 이름입니다. 지정된 대상에 변수가 없으면 무시됩니다.

value

string

선택사항입니다. 맞춤 변수에 저장할 값입니다.

destination_references[]

string

선택사항입니다. 맞춤 변수를 전송할 Event.destination_references를 결정하는 데 사용되는 참조 문자열입니다. 비어 있으면 Event.destination_references가 사용됩니다.

CustomerType

이벤트와 연결된 고객의 유형입니다.

열거형
CUSTOMER_TYPE_UNSPECIFIED 지정되지 않은 CustomerType입니다. 절대로 사용하지 마세요.
NEW 고객이 광고주를 처음 이용합니다.
RETURNING 고객이 광고주에게 반품합니다.
REENGAGED 고객이 광고주와 다시 상호작용했습니다.

CustomerValueBucket

광고주가 평가한 고객의 가치입니다.

열거형
CUSTOMER_VALUE_BUCKET_UNSPECIFIED 지정되지 않은 CustomerValueBucket입니다. 절대로 사용하지 마세요.
LOW 고객의 가치가 낮습니다.
MEDIUM 고객이 중간 가치입니다.
HIGH 고객의 가치가 높습니다.

대상

데이터를 전송하는 Google 제품입니다. 예를 들어 Google Ads 계정입니다.

필드
reference

string

선택사항입니다. 이 Destination 리소스의 ID로, 요청 내에서 고유합니다. IngestEventsRequestIngestAudienceMembersRequest에서 이 Destination를 참조하는 데 사용됩니다.

login_account

ProductAccount

선택사항입니다. 이 API 호출을 만드는 데 사용된 계정입니다. operating_account에서 데이터를 추가하거나 삭제하려면 이 login_accountoperating_account에 대한 쓰기 액세스 권한이 있어야 합니다. 예를 들어 operating_account의 관리자 계정 또는 operating_account에 연결된 계정입니다.

linked_account

ProductAccount

선택사항입니다. 호출 사용자의 login_account가 설정된 계정 연결을 통해 액세스할 수 있는 계정입니다. 예를 들어 데이터 파트너의 login_account가 클라이언트의 linked_account에 액세스할 수 있습니다. 파트너는 이 필드를 사용하여 linked_account에서 다른 operating_account로 데이터를 전송할 수 있습니다.

operating_account

ProductAccount

필수 항목입니다. 데이터를 전송하거나 데이터를 삭제할 계정입니다.

product_destination_id

string

필수 항목입니다. 제품 계정 내에서 수집할 객체입니다. 예를 들어 Google Ads 잠재고객 ID, Display & Video 360 잠재고객 ID 또는 Google Ads 전환 액션 ID입니다.

DeviceInfo

이벤트가 발생했을 때 사용 중인 기기에 관한 정보입니다 (있는 경우).

필드
user_agent

string

선택사항입니다. 지정된 컨텍스트의 기기 사용자 에이전트 문자열입니다.

ip_address

string

선택사항입니다. 지정된 컨텍스트의 기기 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

GcpWrappedKeyInfo

Google Cloud Platform 래핑된 키 정보입니다.

ErrorCount

특정 오류 이유의 오류 수입니다.

필드
record_count

int64

특정 이유로 업로드에 실패한 레코드 수입니다.

reason

ProcessingErrorReason

실패한 레코드의 오류 이유입니다.

ErrorInfo

각 오류 유형의 오류 수입니다.

필드
error_counts[]

ErrorCount

오류 이유별 오류 및 개수 목록입니다. 경우에 따라 채워지지 않을 수 있습니다.

이벤트

사용자와 광고주의 웹사이트 또는 앱 간의 상호작용을 나타내는 이벤트입니다.

필드
destination_references[]

string

선택사항입니다. 대상을 결정하는 데 사용되는 참조 문자열입니다. 비어 있으면 이벤트가 요청의 모든 destinations에 전송됩니다.

transaction_id

string

선택사항입니다. 이 이벤트의 고유 식별자입니다. 여러 데이터 소스를 사용하는 전환에 필요합니다.

event_timestamp

Timestamp

필수 항목입니다. 이벤트가 발생한 시간입니다.

last_updated_timestamp

Timestamp

선택사항입니다. 이벤트가 마지막으로 업데이트된 시간입니다.

user_data

UserData

선택사항입니다. 이벤트와 연결된 사용자를 나타내는 사용자 제공 데이터입니다.

consent

Consent

선택사항입니다. 연결된 사용자가 다양한 유형의 동의를 제공했는지에 관한 정보입니다.

ad_identifiers

AdIdentifiers

선택사항입니다. 전환 이벤트를 다른 온라인 활동 (예: 광고 클릭)과 일치시키는 데 사용되는 식별자 및 기타 정보입니다.

currency

string

선택사항입니다. 이 이벤트 내의 모든 금전적 가치와 연결된 통화 코드입니다.

conversion_value

double

선택사항입니다. 가치 기반 전환의 경우 이벤트와 연결된 전환 가치입니다.

event_source

EventSource

선택사항입니다. 이벤트가 발생한 위치 (웹, 앱, 매장 등)를 나타내는 신호입니다.

event_device_info

DeviceInfo

선택사항입니다. 이벤트가 발생했을 때 사용 중인 기기에 관해 수집된 정보입니다 (있는 경우).

cart_data

CartData

선택사항입니다. 거래 및 이벤트와 연결된 상품에 대한 정보입니다.

custom_variables[]

CustomVariable

선택사항입니다. 전환 컨테이너 (전환 액션 또는 FL 활동)로 전송할 추가 키/값 쌍 정보입니다.

experimental_fields[]

ExperimentalField

선택사항입니다. 실험용 필드의 키-값 쌍 목록입니다. 실험용 필드는 결국 API의 일부로 승격될 수 있습니다.

user_properties

UserProperties

선택사항입니다. 이벤트가 발생한 시점에 광고주가 평가한 사용자에 관한 정보입니다.

EventSource

이벤트의 소스입니다.

열거형
EVENT_SOURCE_UNSPECIFIED 지정되지 않은 EventSource입니다. 절대로 사용하지 마세요.
WEB 이 이벤트는 웹브라우저에서 생성되었습니다.
APP 앱에서 생성된 이벤트입니다.
IN_STORE 이 이벤트는 오프라인 거래에서 생성되었습니다.
PHONE 이 일정은 전화 통화에서 생성되었습니다.
OTHER 이 이벤트는 다른 소스에서 생성되었습니다.

ExperimentalField

비공식 필드를 나타내는 실험용 필드입니다.

필드
field

string

선택사항입니다. 사용할 필드의 이름입니다.

value

string

선택사항입니다. 설정할 필드의 값입니다.

GcpWrappedKeyInfo

Google Cloud Platform 래핑된 키에 관한 정보입니다.

필드
key_type

KeyType

필수 항목입니다. 데이터를 암호화하는 데 사용된 알고리즘의 유형입니다.

wip_provider

string

필수 항목입니다. KEK를 사용하는 데 필요한 워크로드 아이덴티티 풀 제공자입니다.

kek_uri

string

필수 항목입니다. Google Cloud Platform Cloud Key Management Service 리소스 ID입니다. 'projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}' 형식이어야 합니다.

encrypted_dek

string

필수 항목입니다. base64로 인코딩된 암호화된 데이터 암호화 키입니다.

KeyType

데이터를 암호화하는 데 사용된 알고리즘의 유형입니다.

열거형
KEY_TYPE_UNSPECIFIED 지정되지 않은 키 유형입니다. 절대로 사용하지 마세요.
XCHACHA20_POLY1305 알고리즘 XChaCha20-Poly1305

IngestAudienceMembersRequest

제공된 대상에 잠재고객 구성원을 업로드하도록 요청합니다. IngestAudienceMembersResponse을 반환합니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.
필드
destinations[]

Destination

필수 항목입니다. 잠재고객 구성원을 보낼 도착 페이지 목록입니다.

audience_members[]

AudienceMember

필수 항목입니다. 지정된 도착 페이지로 보낼 사용자 목록입니다. 단일 요청에서 최대 10,000개의 AudienceMember 리소스를 전송할 수 있습니다.

consent

Consent

선택사항입니다. 요청의 모든 사용자에게 적용되는 요청 수준 동의입니다. 사용자 수준 동의는 요청 수준 동의보다 우선하며 각 AudienceMember에서 지정할 수 있습니다.

validate_only

bool

선택사항입니다. 테스트 목적으로 사용됩니다. true인 경우 요청이 검증되지만 실행되지는 않습니다. 결과가 아닌 오류만 반환됩니다.

encoding

Encoding

선택사항입니다. UserData 업로드에 필요합니다. 사용자 식별자의 인코딩 유형입니다. 해싱된 사용자 식별자의 경우 해싱된 문자열의 인코딩 유형입니다. 암호화된 해시 사용자 식별자의 경우 이는 외부 암호화된 문자열의 인코딩 유형이지만 내부 해시 문자열의 인코딩 유형은 아닐 수 있습니다. 즉, 내부 해시 문자열은 외부 암호화된 문자열과 다른 방식으로 인코딩될 수 있습니다. UserData이 아닌 업로드의 경우 이 필드는 무시됩니다.

encryption_info

EncryptionInfo

선택사항입니다. UserData 업로드의 암호화 정보입니다. 설정되지 않은 경우 업로드된 식별 정보가 해싱되었지만 암호화되지 않은 것으로 간주됩니다. UserData이 아닌 업로드의 경우 이 필드는 무시됩니다.

terms_of_service

TermsOfService

선택사항입니다. 사용자가 수락/거부한 서비스 약관입니다.

IngestAudienceMembersResponse

IngestAudienceMembersRequest의 응답입니다.

필드
request_id

string

요청의 자동 생성 ID입니다.

IngestEventsRequest

제공된 대상에 잠재고객 구성원을 업로드하도록 요청합니다. IngestEventsResponse을 반환합니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.
필드
destinations[]

Destination

필수 항목입니다. 이벤트를 보낼 대상 목록입니다.

events[]

Event

필수 항목입니다. 지정된 대상에 전송할 이벤트 목록입니다. 단일 요청에서 최대 2,000개의 Event 리소스를 전송할 수 있습니다.

consent

Consent

선택사항입니다. 요청의 모든 사용자에게 적용되는 요청 수준 동의입니다. 사용자 수준 동의는 요청 수준 동의보다 우선하며 각 Event에서 지정할 수 있습니다.

validate_only

bool

선택사항입니다. 테스트 목적으로 사용됩니다. true인 경우 요청이 검증되지만 실행되지는 않습니다. 결과가 아닌 오류만 반환됩니다.

encoding

Encoding

선택사항입니다. UserData 업로드에 필요합니다. 사용자 식별자의 인코딩 유형입니다. 해싱된 사용자 식별자의 경우 해싱된 문자열의 인코딩 유형입니다. 암호화된 해시 사용자 식별자의 경우 이는 외부 암호화된 문자열의 인코딩 유형이지만 내부 해시 문자열의 인코딩 유형은 아닐 수 있습니다. 즉, 내부 해시 문자열은 외부 암호화된 문자열과 다른 방식으로 인코딩될 수 있습니다. UserData이 아닌 업로드의 경우 이 필드는 무시됩니다.

encryption_info

EncryptionInfo

선택사항입니다. UserData 업로드의 암호화 정보입니다. 설정되지 않은 경우 업로드된 식별 정보가 해싱되었지만 암호화되지 않은 것으로 간주됩니다. UserData이 아닌 업로드의 경우 이 필드는 무시됩니다.

IngestEventsResponse

IngestEventsRequest의 응답입니다.

필드
request_id

string

요청의 자동 생성 ID입니다.

항목

이벤트와 연결된 장바구니의 상품을 나타냅니다.

필드
merchant_product_id

string

선택사항입니다. 판매자 센터 계정 내 제품 ID입니다.

quantity

int64

선택사항입니다. 이 이벤트와 연결된 상품의 수입니다.

unit_price

double

선택사항입니다. 세금, 배송비, 거래별 할인 금액을 제외한 단위 가격입니다.

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% ([91, 100] 간격)입니다.

MobileData

잠재고객의 모바일 ID입니다. 모바일 ID가 하나 이상 필요합니다.

필드
mobile_ids[]

string

필수 항목입니다. 휴대기기 ID (광고 ID/IDFA) 목록입니다. 단일 AudienceMember에서 최대 10개의 mobileIds을 제공할 수 있습니다.

PairData

잠재고객의 PAIR ID입니다. 하나 이상의 페어링 ID가 필요합니다.

필드
pair_ids[]

string

필수 항목입니다. 클린룸에서 제공한 PII 데이터로, SHA256으로 해싱되고 PAIR 사용자 목록에 게시자 키를 사용하여 EC 교환 암호로 암호화됩니다. 단일 AudienceMember에서 최대 10개의 pairIds을 제공할 수 있습니다.

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_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 내부 오류입니다.

제품

지원이 중단되었습니다. 대신 AccountType를 사용하세요. 특정 Google 제품을 나타냅니다.

열거형
PRODUCT_UNSPECIFIED 지정되지 않은 제품입니다. 절대로 사용하지 마세요.
GOOGLE_ADS Google Ads
DISPLAY_VIDEO_PARTNER Display & Video 360 파트너입니다.
DISPLAY_VIDEO_ADVERTISER Display & Video 360 광고주
DATA_PARTNER 데이터 파트너

ProductAccount

특정 계정을 나타냅니다.

필드
product
(deprecated)

Product

지원이 중단되었습니다. 대신 account_type를 사용하세요.

account_id

string

필수 항목입니다. 계정의 ID입니다. 예를 들어 Google Ads 계정 ID입니다.

account_type

AccountType

선택사항입니다. 계정 유형입니다. 예를 들면 GOOGLE_ADS입니다. account_type 또는 지원 중단된 product이 필요합니다. 두 값이 모두 설정된 경우 값이 일치해야 합니다.

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를 반환합니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.
필드
destinations[]

Destination

필수 항목입니다. 사용자를 삭제할 도착 페이지 목록입니다.

audience_members[]

AudienceMember

필수 항목입니다. 삭제할 사용자의 목록입니다.

validate_only

bool

선택사항입니다. 테스트 목적으로 사용됩니다. true인 경우 요청이 검증되지만 실행되지는 않습니다. 결과가 아닌 오류만 반환됩니다.

encoding

Encoding

선택사항입니다. UserData 업로드에 필요합니다. 사용자 식별자의 인코딩 유형입니다. 암호화된 사용자 식별자의 외부 인코딩에만 적용됩니다. UserData이 아닌 업로드의 경우 이 필드는 무시됩니다.

encryption_info

EncryptionInfo

선택사항입니다. UserData 업로드의 암호화 정보입니다. 설정되지 않은 경우 업로드된 식별 정보가 해싱되었지만 암호화되지 않은 것으로 간주됩니다. UserData이 아닌 업로드의 경우 이 필드는 무시됩니다.

RemoveAudienceMembersResponse

RemoveAudienceMembersRequest의 응답입니다.

필드
request_id

string

요청의 자동 생성 ID입니다.

RequestStatusPerDestination

대상별 요청 상태입니다.

필드
destination

Destination

DM API 요청 내의 대상입니다.

request_status

RequestStatus

대상 위치의 요청 상태입니다.

error_info

ErrorInfo

업로드와 관련된 오류 이유와 오류 수를 포함하는 오류 정보 오류입니다.

warning_info

WarningInfo

업로드와 관련된 경고 이유와 경고 수를 포함하는 경고 정보입니다.

통합 필드 status. 대상 위치의 상태입니다. status은 다음 중 하나여야 합니다.
audience_members_ingestion_status

IngestAudienceMembersStatus

수집 잠재고객 구성원 요청의 상태입니다.

events_ingestion_status

IngestEventsStatus

수집 이벤트 요청의 상태입니다.

audience_members_removal_status

RemoveAudienceMembersStatus

잠재고객 구성원 삭제 요청의 상태입니다.

IngestAudienceMembersStatus

수집 잠재고객 구성원 요청의 상태입니다.

필드
통합 필드 status. 대상에 대한 잠재고객 구성원 인게션의 상태입니다. status은 다음 중 하나여야 합니다.
user_data_ingestion_status

IngestUserDataStatus

대상으로의 사용자 데이터 수집 상태입니다.

mobile_data_ingestion_status

IngestMobileDataStatus

대상으로의 모바일 데이터 수집 상태입니다.

pair_data_ingestion_status

IngestPairDataStatus

대상으로의 페어 데이터 수집 상태입니다.

IngestEventsStatus

이벤트가 대상에 수집되는 상태입니다.

필드
record_count

int64

업로드 요청에서 전송된 총 이벤트 수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청의 모든 이벤트를 포함합니다.

IngestMobileDataStatus

수집과 관련된 통계가 포함된 대상에 대한 모바일 데이터 수집 상태입니다.

필드
record_count

int64

대상에 대한 업로드 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.

mobile_id_count

int64

대상에 대한 업로드 요청에서 전송된 모바일 ID의 총 개수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 모바일 ID를 포함합니다.

IngestPairDataStatus

수집과 관련된 통계가 포함된 대상에 대한 쌍 데이터 수집 상태입니다.

필드
record_count

int64

대상에 대한 업로드 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.

pair_id_count

int64

대상에 대한 업로드 요청에서 전송된 쌍 ID의 총 개수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청의 모든 쌍 ID를 포함합니다.

IngestUserDataStatus

수집과 관련된 통계가 포함된 대상에 대한 사용자 데이터 수집 상태입니다.

필드
record_count

int64

대상에 대한 업로드 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.

user_identifier_count

int64

대상에 대한 업로드 요청에서 전송된 사용자 식별자의 총 개수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 사용자 식별자를 포함합니다.

upload_match_rate_range

MatchRateRange

업로드의 일치율 범위입니다.

RemoveAudienceMembersStatus

잠재고객 구성원 삭제 요청의 상태입니다.

필드
통합 필드 status. 대상에서 잠재고객 구성원 삭제 상태입니다. status은 다음 중 하나여야 합니다.
user_data_removal_status

RemoveUserDataStatus

대상에서 사용자 데이터 삭제 상태입니다.

mobile_data_removal_status

RemoveMobileDataStatus

대상에서 모바일 데이터 삭제 상태입니다.

pair_data_removal_status

RemovePairDataStatus

대상에서 페어 데이터 삭제 상태입니다.

RemoveMobileDataStatus

대상에서 모바일 데이터 삭제 상태입니다.

필드
record_count

int64

삭제 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.

mobile_id_count

int64

삭제 요청에서 전송된 모바일 ID의 총 개수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 모바일 ID를 포함합니다.

RemovePairDataStatus

대상에서 페어 데이터 삭제 상태입니다.

필드
record_count

int64

삭제 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.

pair_id_count

int64

삭제 요청에서 전송된 쌍 ID의 총 개수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청의 모든 쌍 ID가 포함됩니다.

RemoveUserDataStatus

대상에서 사용자 데이터 삭제 상태입니다.

필드
record_count

int64

삭제 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.

user_identifier_count

int64

삭제 요청에서 전송된 사용자 식별자의 총 개수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 사용자 식별자를 포함합니다.

RequestStatus

요청 상태입니다.

열거형
REQUEST_STATUS_UNKNOWN 요청 상태를 알 수 없습니다.
SUCCESS 요청이 성공했습니다.
PROCESSING 요청이 처리 중입니다.
FAILED 요청에 실패했습니다.
PARTIAL_SUCCESS 요청이 부분적으로 성공했습니다.

RetrieveRequestStatusRequest

특정 요청 ID에 대해 DM API에 전송된 요청의 상태를 가져오기 위한 요청입니다. RetrieveRequestStatusResponse를 반환합니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.
필드
request_id

string

(필수 항목) 필수 항목입니다. Data Manager API 요청의 요청 ID입니다.

RetrieveRequestStatusResponse

RetrieveRequestStatusRequest의 응답입니다.

필드
request_status_per_destination[]

RequestStatusPerDestination

대상별 요청 상태 목록입니다. 상태의 순서는 원래 요청의 대상 순서와 일치합니다.

TermsOfService

사용자가 수락/거부한 서비스 약관입니다.

필드
customer_match_terms_of_service_status

TermsOfServiceStatus

선택사항입니다. 고객 일치 타겟팅 서비스 약관: https://support.google.com/adspolicy/answer/6299717 UserData 또는 MobileData를 인그레스할 때 수락해야 합니다. 이 필드는 파트너 일치 타겟팅 사용자 목록에 필요하지 않습니다.

TermsOfServiceStatus

서비스 약관을 수락하거나 거부하는 호출자의 결정을 나타냅니다.

열거형
TERMS_OF_SERVICE_STATUS_UNSPECIFIED 지정되지 않음
ACCEPTED 호출자가 서비스 약관에 동의하기로 선택했음을 나타내는 상태입니다.
REJECTED 호출자가 서비스 약관을 거부하기로 선택했음을 나타내는 상태입니다.

UserData

사용자를 식별하는 데이터입니다. 식별자가 하나 이상 필요합니다.

필드
user_identifiers[]

UserIdentifier

필수 항목입니다. 사용자의 식별자입니다. 동일한 유형의 데이터 (예: 여러 이메일 주소)를 여러 개 제공할 수 있습니다. 일치 가능성을 높이려면 식별자를 최대한 많이 제공하세요. AudienceMember 또는 Event 하나에 최대 10개의 userIdentifiers을 제공할 수 있습니다.

UserIdentifier

사용자의 단일 식별자입니다.

필드
통합 필드 identifier. 정확히 하나를 지정해야 합니다. identifier은 다음 중 하나여야 합니다.
email_address

string

정규화 후 SHA-256 해시 함수를 사용하여 해싱된 이메일 주소입니다.

phone_number

string

정규화 (E164 표준) 후 SHA-256 해시 함수를 사용하여 해싱된 전화번호입니다.

address

AddressInfo

사용자 주소의 알려진 구성요소입니다. 한 번에 모두 일치하는 식별자의 그룹화를 보유합니다.

UserProperties

이벤트가 발생한 시점에 광고주가 평가한 사용자에 관한 정보입니다. 자세한 내용은 https://support.google.com/google-ads/answer/14007601을 참고하세요.

필드
customer_type

CustomerType

선택사항입니다. 이벤트와 연결된 고객의 유형입니다.

customer_value_bucket

CustomerValueBucket

선택사항입니다. 광고주가 평가한 고객의 가치입니다.

WarningCount

특정 경고 이유에 대한 경고 수입니다.

필드
record_count

int64

경고가 있는 레코드 수입니다.

reason

ProcessingWarningReason

경고 이유입니다.

WarningInfo

각 경고 유형의 경고 수입니다.

필드
warning_counts[]

WarningCount

경고 목록 및 경고 이유별 개수입니다.