หน้านี้ได้รับการแปลโดย Cloud Translation API

Package google.ads.datamanager.v1

ดัชนี

IngestionService (อินเทอร์เฟซ)
AdIdentifiers (ข้อความ)
AddressInfo (ข้อความ)
AudienceMember (ข้อความ)
CartData (ข้อความ)
Consent (ข้อความ)
ConsentStatus (enum)
CustomVariable (ข้อความ)
CustomerType (enum)
CustomerValueBucket (enum)
Destination (ข้อความ)
DeviceInfo (ข้อความ)
Encoding (enum)
EncryptionInfo (ข้อความ)
ErrorCount (ข้อความ)
ErrorInfo (ข้อความ)
ErrorReason (enum)
Event (ข้อความ)
EventSource (enum)
ExperimentalField (ข้อความ)
GcpWrappedKeyInfo (ข้อความ)
GcpWrappedKeyInfo.KeyType (enum)
IngestAudienceMembersRequest (ข้อความ)
IngestAudienceMembersResponse (ข้อความ)
IngestEventsRequest (ข้อความ)
IngestEventsResponse (ข้อความ)
Item (ข้อความ)
MatchRateRange (enum)
MobileData (ข้อความ)
PairData (ข้อความ)
ProcessingErrorReason (enum)
ProcessingWarningReason (enum)
Product (enum) (เลิกใช้งานแล้ว)
ProductAccount (ข้อความ)
ProductAccount.AccountType (enum)
RemoveAudienceMembersRequest (ข้อความ)
RemoveAudienceMembersResponse (ข้อความ)
RequestStatusPerDestination (ข้อความ)
RequestStatusPerDestination.IngestAudienceMembersStatus (ข้อความ)
RequestStatusPerDestination.IngestEventsStatus (ข้อความ)
RequestStatusPerDestination.IngestMobileDataStatus (ข้อความ)
RequestStatusPerDestination.IngestPairDataStatus (ข้อความ)
RequestStatusPerDestination.IngestUserDataStatus (ข้อความ)
RequestStatusPerDestination.RemoveAudienceMembersStatus (ข้อความ)
RequestStatusPerDestination.RemoveMobileDataStatus (ข้อความ)
RequestStatusPerDestination.RemovePairDataStatus (ข้อความ)
RequestStatusPerDestination.RemoveUserDataStatus (ข้อความ)
RequestStatusPerDestination.RequestStatus (enum)
RetrieveRequestStatusRequest (ข้อความ)
RetrieveRequestStatusResponse (ข้อความ)
TermsOfService (ข้อความ)
TermsOfServiceStatus (enum)
UserData (ข้อความ)
UserIdentifier (ข้อความ)
UserProperties (ข้อความ)
WarningCount (ข้อความ)
WarningInfo (ข้อความ)

IngestionService

บริการสําหรับการส่งข้อมูลกลุ่มเป้าหมายไปยังปลายทางที่รองรับ

IngestAudienceMembers

IngestAudienceMembers
`rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse)` อัปโหลดรายการ`AudienceMember`ไปยัง`Destination`ที่ระบุ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ `https://www.googleapis.com/auth/datamanager`

rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse)

อัปโหลดรายการAudienceMemberไปยังDestinationที่ระบุ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

IngestEvents

IngestEvents
`rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse)` อัปโหลดรายการ`Event`จาก`Destination`ที่ระบุ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ `https://www.googleapis.com/auth/datamanager`

rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse)

อัปโหลดรายการEventจากDestinationที่ระบุ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

RemoveAudienceMembers

RemoveAudienceMembers
`rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)` นำรายการทรัพยากร `AudienceMember` ออกจาก `Destination` ที่ระบุ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ `https://www.googleapis.com/auth/datamanager`

rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)

นำรายการทรัพยากร AudienceMember ออกจาก Destination ที่ระบุ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

RetrieveRequestStatus

RetrieveRequestStatus
`rpc RetrieveRequestStatus(RetrieveRequestStatusRequest) returns (RetrieveRequestStatusResponse)` รับสถานะของคำขอที่ระบุรหัสคำขอ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ `https://www.googleapis.com/auth/datamanager`

rpc RetrieveRequestStatus(RetrieveRequestStatusRequest) returns (RetrieveRequestStatusResponse)

รับสถานะของคำขอที่ระบุรหัสคำขอ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

AdIdentifiers

ตัวระบุและข้อมูลอื่นๆ ที่ใช้เพื่อจับคู่เหตุการณ์ Conversion กับกิจกรรมออนไลน์อื่นๆ (เช่น การคลิกโฆษณา)

ช่อง
`session_attributes`	`string` ไม่บังคับ แอตทริบิวต์เซสชันสําหรับการระบุแหล่งที่มาและการประมาณเหตุการณ์
`gclid`	`string` ไม่บังคับ Google Click ID (gclid) ที่เชื่อมโยงกับเหตุการณ์นี้
`gbraid`	`string` ไม่บังคับ ตัวระบุคลิกสําหรับคลิกที่เชื่อมโยงกับเหตุการณ์ของแอปและมาจากอุปกรณ์ iOS ตั้งแต่ iOS14
`wbraid`	`string` ไม่บังคับ ตัวระบุคลิกสําหรับคลิกที่เชื่อมโยงกับเหตุการณ์บนเว็บและมาจากอุปกรณ์ iOS ตั้งแต่ iOS14
`landing_page_device_info`	`DeviceInfo` ไม่บังคับ ข้อมูลที่รวบรวมเกี่ยวกับอุปกรณ์ที่ใช้ (หากมี) ในขณะที่เข้าสู่เว็บไซต์ของผู้ลงโฆษณาหลังจากโต้ตอบกับโฆษณา

AddressInfo

ข้อมูลที่อยู่ของผู้ใช้

ช่อง
`given_name`	`string` ต้องระบุ ชื่อ (ชื่อแรก) ของผู้ใช้เป็นตัวพิมพ์เล็กทั้งหมด ไม่มีเครื่องหมายวรรคตอน ไม่มีช่องว่างนำหน้าหรือต่อท้าย และแฮชเป็น SHA-256
`family_name`	`string` ต้องระบุ นามสกุลของผู้ใช้เป็นตัวพิมพ์เล็กทั้งหมด ไม่มีเครื่องหมายวรรคตอน ไม่มีช่องว่างนำหน้าหรือต่อท้าย และแฮชเป็น SHA-256
`region_code`	`string` ต้องระบุ รหัสภูมิภาค 2 ตัวอักษรตามมาตรฐาน ISO-3166-1 alpha-2 ของที่อยู่ผู้ใช้
`postal_code`	`string` ต้องระบุ รหัสไปรษณีย์ของที่อยู่ของผู้ใช้

AudienceMember

สมาชิกในกลุ่มเป้าหมายที่จะดำเนินการ

ช่อง
`destination_references[]`	`string` ไม่บังคับ กำหนดว่าควรส่งสมาชิกในกลุ่มเป้าหมายไปยัง `Destination` ใด
`consent`	`Consent` ไม่บังคับ การตั้งค่าความยินยอมสำหรับผู้ใช้
ฟิลด์ Union `data` ประเภทของข้อมูลระบุตัวตนที่จะดำเนินการ `data` ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
`user_data`	`UserData` ข้อมูลที่ได้จากผู้ใช้ซึ่งระบุตัวผู้ใช้
`pair_data`	`PairData` รหัส Publisher Advertiser Identity Reconciliation (PAIR)
`mobile_data`	`MobileData` ข้อมูลที่ระบุอุปกรณ์เคลื่อนที่ของผู้ใช้

CartData

ข้อมูลรถเข็นช็อปปิ้งที่เชื่อมโยงกับเหตุการณ์

ช่อง
`merchant_id`	`string` ไม่บังคับ รหัส Merchant Center ที่เชื่อมโยงกับสินค้า
`merchant_feed_label`	`string` ไม่บังคับ ป้ายกำกับฟีด Merchant Center ที่เชื่อมโยงกับฟีดของสินค้า
`merchant_feed_language_code`	`string` ไม่บังคับ รหัสภาษาใน ISO 639-1 ที่เชื่อมโยงกับฟีด Merchant Center ของสินค้าที่มีการอัปโหลด
`transaction_discount`	`double` ไม่บังคับ ยอดรวมของส่วนลดทั้งหมดที่เชื่อมโยงกับธุรกรรม
`items[]`	`Item` ไม่บังคับ รายการสินค้าที่เชื่อมโยงกับกิจกรรม

ช่อง

ช่อง
`ad_user_data`	`ConsentStatus` ไม่บังคับ แสดงว่าผู้ใช้ยินยอมให้ใช้ข้อมูลผู้ใช้ของโฆษณาหรือไม่
`ad_personalization`	`ConsentStatus` ไม่บังคับ แสดงว่าผู้ใช้ยินยอมให้ปรับโฆษณาตามโปรไฟล์ของผู้ใช้หรือไม่

ad_user_data

ConsentStatus

ไม่บังคับ แสดงว่าผู้ใช้ยินยอมให้ใช้ข้อมูลผู้ใช้ของโฆษณาหรือไม่

ad_personalization

ConsentStatus

ไม่บังคับ แสดงว่าผู้ใช้ยินยอมให้ปรับโฆษณาตามโปรไฟล์ของผู้ใช้หรือไม่

ConsentStatus

แสดงว่าผู้ใช้ให้ ปฏิเสธ หรือไม่ได้ระบุความยินยอม

Enum
`CONSENT_STATUS_UNSPECIFIED`	ไม่ได้ระบุ
`CONSENT_GRANTED`	ให้สิทธิ์แล้ว
`CONSENT_DENIED`	ถูกปฏิเสธ

ตัวแปรที่กำหนดเอง

ตัวแปรที่กำหนดเองสําหรับ Conversion ของโฆษณา

ช่อง

ช่อง
`variable`	`string` ไม่บังคับ ชื่อของตัวแปรที่กำหนดเองที่จะตั้งค่า หากไม่พบตัวแปรสำหรับปลายทางที่ระบุ ระบบจะไม่สนใจตัวแปรนั้น
`value`	`string` ไม่บังคับ ค่าที่จะจัดเก็บสำหรับตัวแปรที่กำหนดเอง
`destination_references[]`	`string` ไม่บังคับ สตริงอ้างอิงที่ใช้เพื่อกำหนดว่าควรส่งตัวแปรที่กำหนดเองไปยัง `Event.destination_references` ใด หากเว้นว่าง ระบบจะใช้ `Event.destination_references`

variable

string

ไม่บังคับ ชื่อของตัวแปรที่กำหนดเองที่จะตั้งค่า หากไม่พบตัวแปรสำหรับปลายทางที่ระบุ ระบบจะไม่สนใจตัวแปรนั้น

value

string

ไม่บังคับ ค่าที่จะจัดเก็บสำหรับตัวแปรที่กำหนดเอง

destination_references[]

string

ไม่บังคับ สตริงอ้างอิงที่ใช้เพื่อกำหนดว่าควรส่งตัวแปรที่กำหนดเองไปยัง Event.destination_references ใด หากเว้นว่าง ระบบจะใช้ Event.destination_references

CustomerType

ประเภทลูกค้าที่เชื่อมโยงกับเหตุการณ์

Enum
`CUSTOMER_TYPE_UNSPECIFIED`	ไม่ได้ระบุ CustomerType ไม่ควรใช้
`NEW`	ลูกค้าเป็นลูกค้าใหม่ของผู้ลงโฆษณา
`RETURNING`	ลูกค้ากลับมาหาผู้ลงโฆษณา
`REENGAGED`	ลูกค้ากลับมามีส่วนร่วมกับผู้ลงโฆษณาอีกครั้ง

CustomerValueBucket

มูลค่าของลูกค้าที่ผู้ลงโฆษณาประเมิน

Enum
`CUSTOMER_VALUE_BUCKET_UNSPECIFIED`	Unspecified CustomerValueBucket ไม่ควรใช้
`LOW`	ลูกค้ามีคุณค่าต่ำ
`MEDIUM`	ลูกค้ามีคุณค่าปานกลาง
`HIGH`	ลูกค้ามีคุณค่าสูง

ปลายทาง

ผลิตภัณฑ์ Google ที่คุณส่งข้อมูลไปให้ เช่น บัญชี Google Ads

ช่อง
`reference`	`string` ไม่บังคับ รหัสสำหรับทรัพยากร `Destination` นี้ ซึ่งไม่ซ้ำกันภายในคำขอ ใช้เพื่ออ้างอิงถึง `Destination` นี้ใน `IngestEventsRequest` และ `IngestAudienceMembersRequest`
`login_account`	`ProductAccount` ไม่บังคับ บัญชีที่ใช้ในการเรียก API นี้ หากต้องการเพิ่มหรือนำข้อมูลออกจาก `operating_account` `login_account` นี้จะต้องมีสิทธิ์เขียนไปยัง `operating_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, รหัสกลุ่มเป้าหมาย Display & Video 360 หรือรหัสการกระทําที่ถือเป็น Conversion ของ Google Ads

DeviceInfo

ข้อมูลเกี่ยวกับอุปกรณ์ที่ใช้ (หากมี) เมื่อเกิดเหตุการณ์

ช่อง

ช่อง
`user_agent`	`string` ไม่บังคับ สตริง User Agent ของอุปกรณ์สำหรับบริบทที่ระบุ
`ip_address`	`string` ไม่บังคับ ที่อยู่ IP ของอุปกรณ์สำหรับบริบทที่ระบุ หมายเหตุ: Google Ads ไม่รองรับการจับคู่ที่อยู่ IP สำหรับผู้ใช้ปลายทางในเขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร (UK) หรือสวิตเซอร์แลนด์ (CH) เพิ่มตรรกะเพื่อยกเว้นการแชร์ที่อยู่ IP จากผู้ใช้ในภูมิภาคเหล่านี้แบบมีเงื่อนไข และตรวจสอบว่าคุณได้ให้ข้อมูลที่ชัดเจนและครบถ้วนแก่ผู้ใช้เกี่ยวกับข้อมูลที่คุณรวบรวมในเว็บไซต์ แอป และพร็อพเพอร์ตี้อื่นๆ พร้อมทั้งได้รับความยินยอมในกรณีที่กฎหมายหรือนโยบายที่เกี่ยวข้องของ Google กำหนด ดูรายละเอียดเพิ่มเติมได้ที่หน้าเกี่ยวกับการนำเข้า Conversion ออฟไลน์

user_agent

string

ไม่บังคับ สตริง User Agent ของอุปกรณ์สำหรับบริบทที่ระบุ

ip_address

string

ไม่บังคับ ที่อยู่ IP ของอุปกรณ์สำหรับบริบทที่ระบุ

หมายเหตุ: Google Ads ไม่รองรับการจับคู่ที่อยู่ IP สำหรับผู้ใช้ปลายทางในเขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร (UK) หรือสวิตเซอร์แลนด์ (CH) เพิ่มตรรกะเพื่อยกเว้นการแชร์ที่อยู่ IP จากผู้ใช้ในภูมิภาคเหล่านี้แบบมีเงื่อนไข และตรวจสอบว่าคุณได้ให้ข้อมูลที่ชัดเจนและครบถ้วนแก่ผู้ใช้เกี่ยวกับข้อมูลที่คุณรวบรวมในเว็บไซต์ แอป และพร็อพเพอร์ตี้อื่นๆ พร้อมทั้งได้รับความยินยอมในกรณีที่กฎหมายหรือนโยบายที่เกี่ยวข้องของ Google กำหนด ดูรายละเอียดเพิ่มเติมได้ที่หน้าเกี่ยวกับการนำเข้า Conversion ออฟไลน์

การเข้ารหัส

ประเภทการเข้ารหัสของข้อมูลระบุตัวตนที่แฮช

Enum
`ENCODING_UNSPECIFIED`	ประเภทการเข้ารหัสที่ไม่ได้ระบุ ไม่ควรใช้
`HEX`	การเข้ารหัสฐาน 16
`BASE64`	การเข้ารหัส Base64

EncryptionInfo

ข้อมูลการเข้ารหัสสำหรับข้อมูลที่กำลังส่งผ่านข้อมูล

ช่อง

ช่อง
ฟิลด์ Union `wrapped_key` คีย์ที่ห่อที่ใช้เข้ารหัสข้อมูล `wrapped_key` ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
`gcp_wrapped_key_info`	`GcpWrappedKeyInfo` ข้อมูลคีย์ที่ปกปิดของ Google Cloud Platform

ฟิลด์ Union wrapped_key คีย์ที่ห่อที่ใช้เข้ารหัสข้อมูล wrapped_key ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น

gcp_wrapped_key_info

GcpWrappedKeyInfo

ข้อมูลคีย์ที่ปกปิดของ Google Cloud Platform

ErrorCount

จำนวนข้อผิดพลาดสำหรับเหตุผลของข้อผิดพลาดที่ระบุ

ช่อง

ช่อง
`record_count`	`int64` จำนวนระเบียนที่อัปโหลดไม่สำเร็จเนื่องจากสาเหตุที่ระบุ
`reason`	`ProcessingErrorReason` เหตุผลของข้อผิดพลาดของระเบียนที่ไม่สำเร็จ

record_count

int64

จำนวนระเบียนที่อัปโหลดไม่สำเร็จเนื่องจากสาเหตุที่ระบุ

reason

ProcessingErrorReason

เหตุผลของข้อผิดพลาดของระเบียนที่ไม่สำเร็จ

ErrorInfo

จํานวนข้อผิดพลาดสําหรับข้อผิดพลาดแต่ละประเภท

ช่อง

ช่อง
`error_counts[]`	`ErrorCount` รายการข้อผิดพลาดและจำนวนตามเหตุผลของข้อผิดพลาด อาจไม่แสดงในบางกรณี

error_counts[]

ErrorCount

รายการข้อผิดพลาดและจำนวนตามเหตุผลของข้อผิดพลาด อาจไม่แสดงในบางกรณี

ErrorReason

สาเหตุของข้อผิดพลาดสำหรับ Data Manager API

Enum
`ERROR_REASON_UNSPECIFIED`	อย่าใช้ค่าเริ่มต้นนี้
`INTERNAL_ERROR`	เกิดข้อผิดพลาดภายใน
`DEADLINE_EXCEEDED`	คำขอใช้เวลาตอบสนองนานเกินไป
`RESOURCE_EXHAUSTED`	มีคำขอมากเกินไป
`NOT_FOUND`	ไม่พบทรัพยากร
`PERMISSION_DENIED`	ผู้ใช้ไม่มีสิทธิ์หรือไม่พบทรัพยากร
`INVALID_ARGUMENT`	เกิดปัญหากับคำขอ
`REQUIRED_FIELD_MISSING`	ไม่มีข้อมูลในฟิลด์ที่ต้องระบุ
`INVALID_FORMAT`	รูปแบบไม่ถูกต้อง
`INVALID_HEX_ENCODING`	ค่าที่เข้ารหัส HEX มีรูปแบบไม่ถูกต้อง
`INVALID_BASE64_ENCODING`	ค่าที่เข้ารหัส Base64 มีรูปแบบไม่ถูกต้อง
`INVALID_SHA256_FORMAT`	ค่าที่เข้ารหัส SHA256 มีรูปแบบไม่ถูกต้อง
`INVALID_POSTAL_CODE`	รหัสไปรษณีย์ไม่ถูกต้อง
`INVALID_COUNTRY_CODE`	รหัสประเทศไม่ถูกต้อง
`INVALID_ENUM_VALUE`	ใช้ค่า enum ไม่ได้
`INVALID_USER_LIST_TYPE`	ประเภทของรายชื่อผู้ใช้ไม่เกี่ยวข้องกับคำขอนี้
`INVALID_AUDIENCE_MEMBER`	สมาชิกในกลุ่มเป้าหมายนี้ไม่ถูกต้อง
`TOO_MANY_AUDIENCE_MEMBERS`	จำนวนสมาชิกกลุ่มเป้าหมายสูงสุดที่อนุญาตต่อคำขอคือ 10,000 ราย
`TOO_MANY_USER_IDENTIFIERS`	จำนวนตัวระบุผู้ใช้สูงสุดที่อนุญาตต่อสมาชิกกลุ่มเป้าหมายคือ 10
`TOO_MANY_DESTINATIONS`	จำนวนปลายทางสูงสุดที่อนุญาตต่อคำขอคือ 10
`INVALID_DESTINATION`	ปลายทางนี้ไม่ถูกต้อง
`DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED`	พาร์ทเนอร์ข้อมูลไม่มีสิทธิ์เข้าถึงกลุ่มเป้าหมายตามข้อมูลลูกค้าที่บัญชีปฏิบัติการเป็นเจ้าของ
`INVALID_MOBILE_ID_FORMAT`	รูปแบบรหัสมือถือไม่ถูกต้อง
`INVALID_USER_LIST_ID`	กลุ่มเป้าหมายตามรายการผู้ใช้ไม่ถูกต้อง
`MULTIPLE_DATA_TYPES_NOT_ALLOWED`	ไม่อนุญาตให้นำเข้าข้อมูลหลายประเภทในคำขอเดียว
`DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER`	การกำหนดค่าปลายทางที่มีบัญชีเข้าสู่ระบบ DataPartner ต้องมีบัญชีเข้าสู่ระบบเดียวกันในการกำหนดค่าปลายทางทั้งหมด
`TERMS_AND_CONDITIONS_NOT_SIGNED`	ไม่ยอมรับข้อกำหนดและเงื่อนไขที่จำเป็น
`INVALID_NUMBER_FORMAT`	รูปแบบตัวเลขไม่ถูกต้อง
`INVALID_CONVERSION_ACTION_ID`	รหัสการกระทำที่ถือเป็น Conversion ไม่ถูกต้อง
`INVALID_CONVERSION_ACTION_TYPE`	ประเภทการกระทำที่ถือเป็น Conversion ไม่ถูกต้อง
`INVALID_CURRENCY_CODE`	ไม่รองรับรหัสสกุลเงิน
`INVALID_EVENT`	กิจกรรมนี้ไม่ถูกต้อง
`TOO_MANY_EVENTS`	จำนวนเหตุการณ์สูงสุดที่อนุญาตต่อคำขอคือ 10,000 รายการ
`DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS`	บัญชีปลายทางไม่ได้เปิดใช้ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย
`DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS`	ใช้ Conversion ที่ปรับปรุงแล้วกับบัญชีปลายทางไม่ได้เนื่องจากนโยบายข้อมูลลูกค้าของ Google โปรดติดต่อตัวแทนของ Google
`DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED`	บัญชีปลายทางยังไม่ยอมรับข้อกำหนดสำหรับ Conversion ที่ปรับปรุงแล้ว
`DUPLICATE_DESTINATION_REFERENCE`	ปลายทางอย่างน้อย 2 แห่งในคำขอมีการอ้างอิงเดียวกัน
`NO_IDENTIFIERS_PROVIDED`	ข้อมูลเหตุการณ์ไม่มีตัวระบุผู้ใช้หรือตัวระบุโฆษณา

กิจกรรม

เหตุการณ์ที่แสดงการโต้ตอบของผู้ใช้กับเว็บไซต์หรือแอปของผู้ลงโฆษณา

ช่อง
`destination_references[]`	`string` ไม่บังคับ สตริงอ้างอิงที่ใช้ในการกำหนดปลายทาง หากเว้นว่างไว้ ระบบจะส่งเหตุการณ์ไปยัง `destinations` ทั้งหมดในคำขอ
`transaction_id`	`string` ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันสำหรับเหตุการณ์นี้ ต้องระบุสำหรับ Conversion ที่ใช้แหล่งข้อมูลหลายแหล่ง
`event_timestamp`	`Timestamp` ต้องระบุ เวลาที่เกิดเหตุการณ์
`last_updated_timestamp`	`Timestamp` ไม่บังคับ ครั้งล่าสุดที่มีการอัปเดตกิจกรรม
`user_data`	`UserData` ไม่บังคับ ชิ้นส่วนของข้อมูลที่ได้จากผู้ใช้ ซึ่งแสดงถึงผู้ใช้ที่เชื่อมโยงกับเหตุการณ์
`consent`	`Consent` ไม่บังคับ ข้อมูลเกี่ยวกับว่าผู้ใช้ที่เชื่อมโยงได้ให้ความยินยอมประเภทต่างๆ หรือไม่
`ad_identifiers`	`AdIdentifiers` ไม่บังคับ ตัวระบุและข้อมูลอื่นๆ ที่ใช้เพื่อจับคู่เหตุการณ์ Conversion กับกิจกรรมออนไลน์อื่นๆ (เช่น การคลิกโฆษณา)
`currency`	`string` ไม่บังคับ รหัสสกุลเงินที่เชื่อมโยงกับมูลค่าทางการเงินทั้งหมดภายในเหตุการณ์นี้
`conversion_value`	`double` ไม่บังคับ มูลค่า Conversion ที่เชื่อมโยงกับเหตุการณ์สําหรับ Conversion ตามมูลค่า
`event_source`	`EventSource` ไม่บังคับ สัญญาณที่ระบุตำแหน่งที่เกิดเหตุการณ์ (เว็บ แอป ในร้านค้า ฯลฯ)
`event_device_info`	`DeviceInfo` ไม่บังคับ ข้อมูลที่รวบรวมเกี่ยวกับอุปกรณ์ที่ใช้ (หากมี) เมื่อเกิดเหตุการณ์
`cart_data`	`CartData` ไม่บังคับ ข้อมูลเกี่ยวกับธุรกรรมและรายการที่เชื่อมโยงกับกิจกรรม
`custom_variables[]`	`CustomVariable` ไม่บังคับ ข้อมูลคู่คีย์/ค่าเพิ่มเติมที่จะส่งไปยังคอนเทนเนอร์ Conversion (การกระทำที่ถือเป็น Conversion หรือกิจกรรม FL)
`experimental_fields[]`	`ExperimentalField` ไม่บังคับ รายการคู่คีย์/ค่าสำหรับฟิลด์เวอร์ชันทดลองที่อาจได้รับการเลื่อนขั้นให้เป็นส่วนหนึ่งของ API ในอนาคต
`user_properties`	`UserProperties` ไม่บังคับ ข้อมูลที่ผู้ลงโฆษณาประเมินเกี่ยวกับผู้ใช้ ณ เวลาที่เกิดเหตุการณ์

EventSource

แหล่งที่มาของเหตุการณ์

Enum
`EVENT_SOURCE_UNSPECIFIED`	EventSource ที่ไม่ได้ระบุ ไม่ควรใช้
`WEB`	กิจกรรมสร้างขึ้นจากเว็บเบราว์เซอร์
`APP`	กิจกรรมสร้างขึ้นจากแอป
`IN_STORE`	ระบบสร้างเหตุการณ์จากธุรกรรมในร้านค้า
`PHONE`	ระบบสร้างกิจกรรมจากการโทร
`OTHER`	ระบบสร้างกิจกรรมจากแหล่งที่มาอื่นๆ

ExperimentalField

ฟิลด์ทดลองที่แสดงฟิลด์ที่ไม่เป็นทางการ

ช่อง

ช่อง
`field`	`string` ไม่บังคับ ชื่อของช่องที่จะใช้
`value`	`string` ไม่บังคับ ค่าของช่องที่จะตั้งค่า

field

string

ไม่บังคับ ชื่อของช่องที่จะใช้

value

string

ไม่บังคับ ค่าของช่องที่จะตั้งค่า

GcpWrappedKeyInfo

ข้อมูลเกี่ยวกับคีย์ที่ห่อไว้ของ Google Cloud Platform

ช่อง
`key_type`	`KeyType` ต้องระบุ ประเภทของอัลกอริทึมที่ใช้ในการเข้ารหัสข้อมูล
`wip_provider`	`string` ต้องระบุ ผู้ให้บริการพูล Workload Identity ที่จำเป็นต้องใช้ KEK
`kek_uri`	`string` ต้องระบุ รหัสทรัพยากรของ Cloud Key Management Service ใน Google Cloud Platform ควรอยู่ในรูปแบบ "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}"
`encrypted_dek`	`string` ต้องระบุ คีย์การเข้ารหัสข้อมูลที่เข้ารหัสซึ่งเข้ารหัสแบบ Base64

KeyType

ประเภทของอัลกอริทึมที่ใช้ในการเข้ารหัสข้อมูล

Enum
`KEY_TYPE_UNSPECIFIED`	ประเภทคีย์ที่ไม่ได้ระบุ ไม่ควรใช้
`XCHACHA20_POLY1305`	อัลกอริทึม XChaCha20-Poly1305

IngestAudienceMembersRequest

ขออัปโหลดสมาชิกกลุ่มเป้าหมายไปยังปลายทางที่ระบุ แสดงผล IngestAudienceMembersResponse

คุณลองใช้วิธีนี้ได้ใน REST API Explorer:

ลองใช้กับ REST

ช่อง
`destinations[]`	`Destination` ต้องระบุ รายการปลายทางที่จะส่งสมาชิกในกลุ่มเป้าหมายไป
`audience_members[]`	`AudienceMember` ต้องระบุ รายชื่อผู้ใช้ที่จะส่งไปยังปลายทางที่ระบุ ส่งทรัพยากร `AudienceMember` ได้สูงสุด 10,000 รายการในคำขอเดียว
`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` รหัสที่สร้างขึ้นโดยอัตโนมัติของคำขอ

request_id

string

รหัสที่สร้างขึ้นโดยอัตโนมัติของคำขอ

IngestEventsRequest

ขออัปโหลดสมาชิกกลุ่มเป้าหมายไปยังปลายทางที่ระบุ แสดงผล IngestEventsResponse

คุณลองใช้วิธีนี้ได้ใน REST API Explorer:

ลองใช้กับ REST

ช่อง
`destinations[]`	`Destination` ต้องระบุ รายการปลายทางที่จะส่งเหตุการณ์ไป
`events[]`	`Event` ต้องระบุ รายการเหตุการณ์ที่จะส่งไปยังปลายทางที่ระบุ ส่งทรัพยากร `Event` ได้สูงสุด 2,000 รายการในคำขอเดียว
`consent`	`Consent` ไม่บังคับ ความยินยอมระดับคำขอที่จะใช้กับผู้ใช้ทั้งหมดในคำขอ ความยินยอมระดับผู้ใช้จะลบล้างความยินยอมระดับคำขอ และระบุได้ในแต่ละ `Event`
`validate_only`	`bool` ไม่บังคับ เพื่อวัตถุประสงค์ในการทดสอบ หากเป็น `true` ระบบจะตรวจสอบคำขอแต่จะไม่ดำเนินการ ระบบจะแสดงเฉพาะข้อผิดพลาด ไม่ใช่ผลลัพธ์
`encoding`	`Encoding` ไม่บังคับ ต้องระบุสำหรับการอัปโหลด `UserData` ประเภทการเข้ารหัสของตัวระบุผู้ใช้ สำหรับตัวระบุผู้ใช้ที่แฮช นี่คือประเภทการเข้ารหัสของสตริงที่แฮช สำหรับตัวระบุผู้ใช้ที่แฮชและเข้ารหัส นี่คือประเภทการเข้ารหัสของสตริงที่เข้ารหัสภายนอก แต่ไม่จำเป็นต้องเป็นสตริงที่แฮชภายใน ซึ่งหมายความว่าสตริงที่แฮชภายในอาจเข้ารหัสในลักษณะที่แตกต่างจากสตริงที่เข้ารหัสภายนอก สำหรับ`UserData`ที่ไม่ใช่การอัปโหลด ระบบจะไม่สนใจฟิลด์นี้
`encryption_info`	`EncryptionInfo` ไม่บังคับ ข้อมูลการเข้ารหัสสำหรับการอัปโหลดของ `UserData` หากไม่ได้ตั้งค่าไว้ ระบบจะถือว่าข้อมูลระบุตัวตนที่อัปโหลดได้รับการแฮชแต่ไม่ได้เข้ารหัส สำหรับ`UserData`ที่ไม่ใช่การอัปโหลด ระบบจะไม่สนใจฟิลด์นี้

IngestEventsResponse

คำตอบจาก IngestEventsRequest

ช่อง

ช่อง
`request_id`	`string` รหัสที่สร้างขึ้นโดยอัตโนมัติของคำขอ

request_id

string

รหัสที่สร้างขึ้นโดยอัตโนมัติของคำขอ

รายการ

แสดงสินค้าในรถเข็นที่เชื่อมโยงกับเหตุการณ์

ช่อง

ช่อง
`merchant_product_id`	`string` ไม่บังคับ รหัสผลิตภัณฑ์ภายในบัญชี Merchant Center
`quantity`	`int64` ไม่บังคับ หมายเลขของสินค้าที่เชื่อมโยงกับเหตุการณ์
`unit_price`	`double` ไม่บังคับ ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดธุรกรรมระดับใดๆ

merchant_product_id

string

ไม่บังคับ รหัสผลิตภัณฑ์ภายในบัญชี Merchant Center

quantity

int64

ไม่บังคับ หมายเลขของสินค้าที่เชื่อมโยงกับเหตุการณ์

unit_price

double

ไม่บังคับ ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดธุรกรรมระดับใดๆ

MatchRateRange

ช่วงอัตราการจับคู่ของการอัปโหลดหรือกลุ่มเป้าหมายตามข้อมูลผู้ใช้

Enum
`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

รหัสอุปกรณ์เคลื่อนที่สำหรับกลุ่มเป้าหมาย ต้องระบุรหัสอุปกรณ์เคลื่อนที่อย่างน้อย 1 รายการ

ช่อง

ช่อง
`mobile_ids[]`	`string` ต้องระบุ รายการรหัสอุปกรณ์เคลื่อนที่ (รหัสโฆษณา/IDFA) ระบุ `mobileIds` ได้สูงสุด 10 รายการใน `AudienceMember` เดียว

mobile_ids[]

string

ต้องระบุ รายการรหัสอุปกรณ์เคลื่อนที่ (รหัสโฆษณา/IDFA) ระบุ mobileIds ได้สูงสุด 10 รายการใน AudienceMember เดียว

PairData

รหัส PAIR สำหรับกลุ่มเป้าหมาย ต้องระบุรหัส PAIR อย่างน้อย 1 รายการ

ช่อง

ช่อง
`pair_ids[]`	`string` ต้องระบุ ข้อมูล PII ที่ได้จากคลีนรูม ซึ่งแฮชด้วย SHA256 และเข้ารหัสด้วยการเข้ารหัสลับแบบสลับที่ใช้ EC โดยใช้คีย์ของผู้เผยแพร่โฆษณาสำหรับรายชื่อผู้ใช้ PAIR ระบุ `pairIds` ได้สูงสุด 10 รายการใน `AudienceMember` เดียว

pair_ids[]

string

ต้องระบุ ข้อมูล PII ที่ได้จากคลีนรูม ซึ่งแฮชด้วย SHA256 และเข้ารหัสด้วยการเข้ารหัสลับแบบสลับที่ใช้ EC โดยใช้คีย์ของผู้เผยแพร่โฆษณาสำหรับรายชื่อผู้ใช้ PAIR ระบุ pairIds ได้สูงสุด 10 รายการใน AudienceMember เดียว

ProcessingErrorReason

เหตุผลของข้อผิดพลาดในการประมวลผล

Enum
`PROCESSING_ERROR_REASON_UNSPECIFIED`	ไม่ทราบสาเหตุของข้อผิดพลาดในการประมวลผล
`PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE`	ตัวแปรที่กำหนดเองไม่ถูกต้อง
`PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED`	ไม่ได้เปิดใช้สถานะของตัวแปรที่กำหนดเอง
`PROCESSING_ERROR_REASON_EVENT_TOO_OLD`	Conversion เก่ากว่าอายุสูงสุดที่รองรับ
`PROCESSING_ERROR_REASON_DENIED_CONSENT`	ผู้ใช้ปฏิเสธข้อมูลผู้ใช้ของโฆษณา ไม่ว่าจะเป็นโดยผู้ใช้หรือในการตั้งค่าเริ่มต้นของผู้ลงโฆษณา
`PROCESSING_ERROR_REASON_NO_CONSENT`	ผู้ลงโฆษณาไม่ได้ให้ความยินยอมแก่บุคคลที่สามสำหรับบริการแพลตฟอร์มหลักของโฆษณา
`PROCESSING_ERROR_REASON_UNKNOWN_CONSENT`	ไม่สามารถระบุความยินยอมโดยรวม (พิจารณาจากความยินยอมระดับแถว ความยินยอมระดับคำขอ และการตั้งค่าบัญชี) สำหรับผู้ใช้รายนี้
`PROCESSING_ERROR_REASON_DUPLICATE_GCLID`	มี Conversion ที่มี GCLID และเวลาที่เกิด Conversion เดียวกันนี้อยู่ในระบบแล้ว
`PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID`	มีการอัปโหลด Conversion ที่มีชุดค่าผสมรหัสคำสั่งซื้อและการกระทำที่ถือเป็น Conversion เดียวกันแล้ว
`PROCESSING_ERROR_REASON_INVALID_GBRAID`	ถอดรหัส gbraid ไม่ได้
`PROCESSING_ERROR_REASON_INVALID_GCLID`	ไม่สามารถถอดรหัส Google Click ID
`PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID`	รหัสผู้ขายมีอักขระที่ไม่ใช่ตัวเลข
`PROCESSING_ERROR_REASON_INVALID_WBRAID`	ไม่สามารถถอดรหัส wbraid
`PROCESSING_ERROR_REASON_INTERNAL_ERROR`	ข้อผิดพลาดภายใน
`PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED`	ไม่ได้ลงนามในข้อกำหนดของ Conversion ที่ปรับปรุงแล้วในบัญชีปลายทาง
`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 ถอดรหัสข้อมูลไม่ได้เนื่องจากเป็น KEK ที่ไม่ถูกต้องหรือไม่พบ
`PROCESSING_ERROR_REASON_WIP_AUTH_FAILED`	ใช้ WIP ไม่ได้เนื่องจากเงื่อนไขการรับรองปฏิเสธ
`PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED`	ระบบไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง KEK
`PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR`	ถอดรหัสข้อมูล `UserIdentifier` โดยใช้ DEK ไม่สำเร็จ
`PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER`	ผู้ใช้พยายามส่งเหตุการณ์ที่มีตัวระบุโฆษณาซึ่งไม่ได้มาจากโฆษณาของบัญชีปฏิบัติการ

ProcessingWarningReason

เหตุผลของคำเตือนการประมวลผล

Enum
`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 ถอดรหัสข้อมูลไม่ได้เนื่องจากเป็น KEK ที่ไม่ถูกต้องหรือไม่พบ
`PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR`	ถอดรหัสข้อมูล `UserIdentifier` ไม่สำเร็จโดยใช้ DEK
`PROCESSING_WARNING_REASON_INTERNAL_ERROR`	ข้อผิดพลาดภายใน

ผลิตภัณฑ์

เลิกใช้งานแล้ว โปรดใช้ AccountType แทน แสดงผลิตภัณฑ์ Google ที่เฉพาะเจาะจง

Enum
`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` ต้องระบุ รหัสของบัญชี เช่น รหัสบัญชี Google Ads
`account_type`	`AccountType` ไม่บังคับ ประเภทของบัญชี เช่น `GOOGLE_ADS` ต้องระบุ `account_type` หรือ `product` ที่เลิกใช้งานแล้ว หากตั้งค่าทั้ง 2 อย่าง ค่าจะต้องตรงกัน

product
(deprecated)

Product

เลิกใช้งานแล้ว โปรดใช้ account_type แทน

account_id

string

ต้องระบุ รหัสของบัญชี เช่น รหัสบัญชี Google Ads

account_type

AccountType

ไม่บังคับ ประเภทของบัญชี เช่น GOOGLE_ADS ต้องระบุ account_type หรือ product ที่เลิกใช้งานแล้ว หากตั้งค่าทั้ง 2 อย่าง ค่าจะต้องตรงกัน

AccountType

แสดงประเภทบัญชี Google ใช้เพื่อค้นหาบัญชีและปลายทาง

Enum
`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 Explorer:

ลองใช้กับ REST

ช่อง
`destinations[]`	`Destination` ต้องระบุ รายการปลายทางที่จะนำผู้ใช้ออกจาก
`audience_members[]`	`AudienceMember` ต้องระบุ รายชื่อผู้ใช้ที่จะนำออก
`validate_only`	`bool` ไม่บังคับ เพื่อวัตถุประสงค์ในการทดสอบ หากเป็น `true` ระบบจะตรวจสอบคำขอแต่จะไม่ดำเนินการ ระบบจะแสดงเฉพาะข้อผิดพลาด ไม่ใช่ผลลัพธ์
`encoding`	`Encoding` ไม่บังคับ ต้องระบุสำหรับการอัปโหลด `UserData` ประเภทการเข้ารหัสของตัวระบุผู้ใช้ ใช้กับการเข้ารหัสภายนอกสำหรับตัวระบุผู้ใช้ที่เข้ารหัสเท่านั้น สำหรับ`UserData`ที่ไม่ใช่การอัปโหลด ระบบจะไม่สนใจฟิลด์นี้
`encryption_info`	`EncryptionInfo` ไม่บังคับ ข้อมูลการเข้ารหัสสำหรับการอัปโหลดของ `UserData` หากไม่ได้ตั้งค่าไว้ ระบบจะถือว่าข้อมูลระบุตัวตนที่อัปโหลดได้รับการแฮชแต่ไม่ได้เข้ารหัส สำหรับ`UserData`ที่ไม่ใช่การอัปโหลด ระบบจะไม่สนใจฟิลด์นี้

RemoveAudienceMembersResponse

คำตอบจาก RemoveAudienceMembersRequest

ช่อง

ช่อง
`request_id`	`string` รหัสที่สร้างขึ้นโดยอัตโนมัติของคำขอ

request_id

string

รหัสที่สร้างขึ้นโดยอัตโนมัติของคำขอ

RequestStatusPerDestination

สถานะคำขอต่อปลายทาง

ช่อง
`destination`	`Destination` ปลายทางภายในคำขอ DM API
`request_status`	`RequestStatus` สถานะคำขอของปลายทาง
`error_info`	`ErrorInfo` ข้อผิดพลาดเกี่ยวกับข้อมูลข้อผิดพลาดที่มีเหตุผลของข้อผิดพลาดและจำนวนข้อผิดพลาดที่เกี่ยวข้องกับการอัปโหลด
`warning_info`	`WarningInfo` ข้อมูลคำเตือนที่มีเหตุผลของคำเตือนและจำนวนคำเตือนที่เกี่ยวข้องกับการอัปโหลด
ฟิลด์ Union `status` สถานะของปลายทาง `status` ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
`audience_members_ingestion_status`	`IngestAudienceMembersStatus` สถานะของคำขอสมาชิกในกลุ่มเป้าหมายที่ส่ง
`events_ingestion_status`	`IngestEventsStatus` สถานะของคำขอเหตุการณ์การส่งผ่านข้อมูล
`audience_members_removal_status`	`RemoveAudienceMembersStatus` สถานะของคำขอให้นำสมาชิกของกลุ่มเป้าหมายออก

IngestAudienceMembersStatus

สถานะของคำขอสมาชิกในกลุ่มเป้าหมายที่ส่ง

ช่อง
ฟิลด์ Union `status` สถานะการส่งผ่านข้อมูลสมาชิกในกลุ่มเป้าหมายไปยังปลายทาง `status` ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
`user_data_ingestion_status`	`IngestUserDataStatus` สถานะการนำเข้าข้อมูลผู้ใช้ไปยังปลายทาง
`mobile_data_ingestion_status`	`IngestMobileDataStatus` สถานะการนำเข้าข้อมูลมือถือไปยังปลายทาง
`pair_data_ingestion_status`	`IngestPairDataStatus` สถานะของการนำเข้าข้อมูลคู่ไปยังปลายทาง

IngestEventsStatus

สถานะของการส่งผ่านข้อมูลเหตุการณ์ไปยังปลายทาง

ช่อง

ช่อง
`record_count`	`int64` จํานวนเหตุการณ์ทั้งหมดที่ส่งในคําขออัปโหลด รวมเหตุการณ์ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม

record_count

int64

จํานวนเหตุการณ์ทั้งหมดที่ส่งในคําขออัปโหลด รวมเหตุการณ์ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม

IngestMobileDataStatus

สถานะของการส่งผ่านข้อมูลอินเทอร์เน็ตมือถือไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการส่งผ่านข้อมูล

ช่อง

ช่อง
`record_count`	`int64` จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
`mobile_id_count`	`int64` จำนวนรหัสอุปกรณ์เคลื่อนที่ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมรหัสอุปกรณ์เคลื่อนที่ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม

record_count

int64

จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม

mobile_id_count

int64

จำนวนรหัสอุปกรณ์เคลื่อนที่ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมรหัสอุปกรณ์เคลื่อนที่ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม

IngestPairDataStatus

สถานะของการนำเข้าข้อมูลคู่ไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการนำเข้า

ช่อง

ช่อง
`record_count`	`int64` จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
`pair_id_count`	`int64` จำนวนรหัสคู่ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมรหัสคู่ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม

record_count

int64

pair_id_count

int64

จำนวนรหัสคู่ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมรหัสคู่ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม

IngestUserDataStatus

สถานะของการนำเข้าข้อมูลผู้ใช้ไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการนำเข้า

ช่อง

ช่อง
`record_count`	`int64` จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
`user_identifier_count`	`int64` จำนวนตัวระบุผู้ใช้ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมตัวระบุผู้ใช้ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
`upload_match_rate_range`	`MatchRateRange` ช่วงอัตราการจับคู่ของการอัปโหลด

record_count

int64

user_identifier_count

int64

จำนวนตัวระบุผู้ใช้ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมตัวระบุผู้ใช้ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม

upload_match_rate_range

MatchRateRange

ช่วงอัตราการจับคู่ของการอัปโหลด

RemoveAudienceMembersStatus

สถานะของคำขอให้นำสมาชิกของกลุ่มเป้าหมายออก

ช่อง
ฟิลด์ Union `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` จำนวนรหัสอุปกรณ์เคลื่อนที่ทั้งหมดที่ส่งในคำขอลบ รวมรหัสอุปกรณ์เคลื่อนที่ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

record_count

int64

จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

mobile_id_count

int64

จำนวนรหัสอุปกรณ์เคลื่อนที่ทั้งหมดที่ส่งในคำขอลบ รวมรหัสอุปกรณ์เคลื่อนที่ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

RemovePairDataStatus

สถานะการนำข้อมูลคู่ที่นำออกจากปลายทาง

ช่อง

ช่อง
`record_count`	`int64` จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม
`pair_id_count`	`int64` จำนวนรหัสคู่ทั้งหมดที่ส่งในคำขอให้นำออก รวมรหัสคู่ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

record_count

int64

pair_id_count

int64

จำนวนรหัสคู่ทั้งหมดที่ส่งในคำขอให้นำออก รวมรหัสคู่ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

RemoveUserDataStatus

สถานะการนำข้อมูลผู้ใช้ออกจากปลายทาง

ช่อง

ช่อง
`record_count`	`int64` จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม
`user_identifier_count`	`int64` จำนวนตัวระบุผู้ใช้ทั้งหมดที่ส่งในคำขอให้นำออก รวมตัวระบุผู้ใช้ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

record_count

int64

user_identifier_count

int64

จำนวนตัวระบุผู้ใช้ทั้งหมดที่ส่งในคำขอให้นำออก รวมตัวระบุผู้ใช้ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

RequestStatus

สถานะคำขอ

Enum
`REQUEST_STATUS_UNKNOWN`	ไม่ทราบสถานะคำขอ
`SUCCESS`	คำขอสำเร็จ
`PROCESSING`	คำขออยู่ระหว่างดำเนินการ
`FAILED`	คำขอล้มเหลว
`PARTIAL_SUCCESS`	คำขอสำเร็จบางส่วน

RetrieveRequestStatusRequest

คำขอรับสถานะของคำขอที่ส่งไปยัง DM API สำหรับรหัสคำขอที่ระบุ แสดงผล RetrieveRequestStatusResponse

คุณลองใช้วิธีนี้ได้ใน REST API Explorer:

ลองใช้กับ REST

ช่อง

request_id

string

ต้องระบุ ต้องระบุ รหัสคำขอของคำขอ Data Manager API

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

แสดงการตัดสินใจของผู้โทรว่าจะยอมรับหรือปฏิเสธข้อกำหนดในการให้บริการ

Enum
`TERMS_OF_SERVICE_STATUS_UNSPECIFIED`	ไม่ได้ระบุ
`ACCEPTED`	สถานะที่ระบุว่าผู้โทรเลือกที่จะยอมรับข้อกำหนดในการให้บริการ
`REJECTED`	สถานะที่บ่งบอกว่าผู้โทรเลือกที่จะปฏิเสธข้อกำหนดในการให้บริการ

UserData

ข้อมูลที่ระบุตัวตนผู้ใช้ ต้องระบุตัวระบุอย่างน้อย 1 รายการ

ช่อง

user_identifiers[]

UserIdentifier

ต้องระบุ ตัวระบุสำหรับผู้ใช้ คุณระบุข้อมูลประเภทเดียวกันได้หลายรายการ (เช่น อีเมลหลายรายการ) ระบุตัวระบุให้มากที่สุดเท่าที่จะเป็นไปได้เพื่อเพิ่มโอกาสในการจับคู่ ระบุ userIdentifiers ได้สูงสุด 10 รายการใน AudienceMember หรือ Event เดียว

UserIdentifier

ตัวระบุเดียวสำหรับผู้ใช้

ช่อง
ฟิลด์ Union `identifier` ต้องระบุอย่างใดอย่างหนึ่งเท่านั้น `identifier` ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
`email_address`	`string` อีเมลที่แฮชโดยใช้ฟังก์ชันแฮช SHA-256 หลังจากทําการแปลงให้เป็นรูปแบบมาตรฐาน
`phone_number`	`string` หมายเลขโทรศัพท์ที่แฮชโดยใช้ฟังก์ชันแฮช SHA-256 หลังจากทำการทำให้เป็นมาตรฐาน (มาตรฐาน E164)
`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

รายการคำเตือนและจำนวนคำเตือนตามเหตุผลของคำเตือน