ดัชนี
IngestionService
(อินเทอร์เฟซ)AdIdentifiers
(ข้อความ)AddressInfo
(ข้อความ)AudienceMember
(ข้อความ)CartData
(ข้อความ)Consent
(ข้อความ)ConsentStatus
(enum)CustomVariable
(ข้อความ)CustomerType
(enum)CustomerValueBucket
(enum)Destination
(ข้อความ)DeviceInfo
(ข้อความ)Encoding
(enum)EncryptionInfo
(ข้อความ)ErrorCount
(ข้อความ)ErrorInfo
(ข้อความ)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 |
---|
อัปโหลดรายการ
|
IngestEvents |
---|
อัปโหลดรายการ
|
RemoveAudienceMembers |
---|
นำรายการ
|
RetrieveRequestStatus |
---|
รับสถานะของคำขอที่ระบุรหัสคำขอ
|
AdIdentifiers
ตัวระบุและข้อมูลอื่นๆ ที่ใช้เพื่อจับคู่เหตุการณ์ Conversion กับกิจกรรมออนไลน์อื่นๆ (เช่น การคลิกโฆษณา)
ช่อง | |
---|---|
session_attributes |
ไม่บังคับ แอตทริบิวต์เซสชันสําหรับการระบุแหล่งที่มาและการประมาณเหตุการณ์ |
gclid |
ไม่บังคับ Google Click ID (gclid) ที่เชื่อมโยงกับเหตุการณ์นี้ |
gbraid |
ไม่บังคับ ตัวระบุคลิกสําหรับคลิกที่เชื่อมโยงกับเหตุการณ์ของแอปและมาจากอุปกรณ์ iOS ตั้งแต่ iOS14 |
wbraid |
ไม่บังคับ ตัวระบุคลิกสําหรับคลิกที่เชื่อมโยงกับเหตุการณ์บนเว็บและมาจากอุปกรณ์ iOS ตั้งแต่ iOS14 |
landing_page_device_info |
ไม่บังคับ ข้อมูลที่รวบรวมเกี่ยวกับอุปกรณ์ที่ใช้ (หากมี) ในขณะที่เข้าสู่เว็บไซต์ของผู้ลงโฆษณาหลังจากโต้ตอบกับโฆษณา |
AddressInfo
ข้อมูลที่อยู่ของผู้ใช้
ช่อง | |
---|---|
given_name |
ต้องระบุ ชื่อ (ชื่อแรก) ของผู้ใช้เป็นตัวพิมพ์เล็กทั้งหมด ไม่มีเครื่องหมายวรรคตอน ไม่มีช่องว่างนำหน้าหรือต่อท้าย และแฮชเป็น SHA-256 |
family_name |
ต้องระบุ นามสกุลของผู้ใช้เป็นตัวพิมพ์เล็กทั้งหมด ไม่มีเครื่องหมายวรรคตอน ไม่มีช่องว่างนำหน้าหรือต่อท้าย และแฮชเป็น SHA-256 |
region_code |
ต้องระบุ รหัสภูมิภาค 2 ตัวอักษรตามมาตรฐาน ISO-3166-1 alpha-2 ของที่อยู่ผู้ใช้ |
postal_code |
ต้องระบุ รหัสไปรษณีย์ของที่อยู่ของผู้ใช้ |
AudienceMember
สมาชิกในกลุ่มเป้าหมายที่จะดำเนินการ
ช่อง | |
---|---|
destination_references[] |
ไม่บังคับ กำหนดว่าควรส่งสมาชิกในกลุ่มเป้าหมายไปยัง |
consent |
ไม่บังคับ การตั้งค่าความยินยอมสำหรับผู้ใช้ |
ฟิลด์ Union data ประเภทของข้อมูลระบุตัวตนที่จะดำเนินการ data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
user_data |
ข้อมูลที่ได้จากผู้ใช้ซึ่งระบุตัวผู้ใช้ |
pair_data |
|
mobile_data |
ข้อมูลที่ระบุอุปกรณ์เคลื่อนที่ของผู้ใช้ |
CartData
ข้อมูลรถเข็นช็อปปิ้งที่เชื่อมโยงกับเหตุการณ์
ช่อง | |
---|---|
merchant_id |
ไม่บังคับ รหัส Merchant Center ที่เชื่อมโยงกับสินค้า |
merchant_feed_label |
ไม่บังคับ ป้ายกำกับฟีด Merchant Center ที่เชื่อมโยงกับฟีดของสินค้า |
merchant_feed_language_code |
ไม่บังคับ รหัสภาษาใน ISO 639-1 ที่เชื่อมโยงกับฟีด Merchant Center ของสินค้าที่มีการอัปโหลด |
transaction_discount |
ไม่บังคับ ยอดรวมของส่วนลดทั้งหมดที่เชื่อมโยงกับธุรกรรม |
items[] |
ไม่บังคับ รายการสินค้าที่เชื่อมโยงกับกิจกรรม |
ความยินยอม
การตั้งค่าความยินยอมตามกฎหมายตลาดดิจิทัล (DMA) สำหรับผู้ใช้
ช่อง | |
---|---|
ad_user_data |
ไม่บังคับ แสดงว่าผู้ใช้ยินยอมให้ใช้ข้อมูลผู้ใช้ของโฆษณาหรือไม่ |
ad_personalization |
ไม่บังคับ แสดงว่าผู้ใช้ยินยอมให้ปรับโฆษณาตามโปรไฟล์ของผู้ใช้หรือไม่ |
ConsentStatus
แสดงว่าผู้ใช้ให้ ปฏิเสธ หรือไม่ได้ระบุความยินยอม
Enum | |
---|---|
CONSENT_STATUS_UNSPECIFIED |
ไม่ได้ระบุ |
CONSENT_GRANTED |
ให้สิทธิ์แล้ว |
CONSENT_DENIED |
ถูกปฏิเสธ |
ตัวแปรที่กำหนดเอง
ตัวแปรที่กำหนดเองสําหรับ Conversion ของโฆษณา
ช่อง | |
---|---|
variable |
ไม่บังคับ ชื่อของตัวแปรที่กำหนดเองที่จะตั้งค่า หากไม่พบตัวแปรสำหรับปลายทางที่ระบุ ระบบจะไม่สนใจตัวแปรนั้น |
value |
ไม่บังคับ ค่าที่จะจัดเก็บสำหรับตัวแปรที่กำหนดเอง |
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 |
ไม่บังคับ รหัสสำหรับทรัพยากร |
login_account |
ไม่บังคับ บัญชีที่ใช้ในการเรียก API นี้ หากต้องการเพิ่มหรือนำข้อมูลออกจาก |
linked_account |
ไม่บังคับ บัญชีที่ |
operating_account |
ต้องระบุ บัญชีที่จะส่งข้อมูลไปหรือนำข้อมูลออกจาก |
product_destination_id |
ต้องระบุ ออบเจ็กต์ภายในบัญชีผลิตภัณฑ์ที่จะนำเข้า เช่น รหัสกลุ่มเป้าหมาย Google Ads, รหัสกลุ่มเป้าหมาย Display & Video 360 หรือรหัสการกระทําที่ถือเป็น Conversion ของ Google Ads |
DeviceInfo
ข้อมูลเกี่ยวกับอุปกรณ์ที่ใช้ (หากมี) เมื่อเกิดเหตุการณ์
ช่อง | |
---|---|
user_agent |
ไม่บังคับ สตริง User Agent ของอุปกรณ์สำหรับบริบทที่ระบุ |
ip_address |
ไม่บังคับ ที่อยู่ 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 |
ข้อมูลคีย์ที่ปกปิดของ Google Cloud Platform |
ErrorCount
จำนวนข้อผิดพลาดสำหรับเหตุผลของข้อผิดพลาดที่ระบุ
ช่อง | |
---|---|
record_count |
จำนวนระเบียนที่อัปโหลดไม่สำเร็จเนื่องจากสาเหตุที่ระบุ |
reason |
เหตุผลของข้อผิดพลาดของระเบียนที่ไม่สำเร็จ |
ErrorInfo
จํานวนข้อผิดพลาดสําหรับข้อผิดพลาดแต่ละประเภท
ช่อง | |
---|---|
error_counts[] |
รายการข้อผิดพลาดและจำนวนตามเหตุผลของข้อผิดพลาด อาจไม่แสดงในบางกรณี |
กิจกรรม
เหตุการณ์ที่แสดงการโต้ตอบของผู้ใช้กับเว็บไซต์หรือแอปของผู้ลงโฆษณา
ช่อง | |
---|---|
destination_references[] |
ไม่บังคับ สตริงอ้างอิงที่ใช้ในการกำหนดปลายทาง หากเว้นว่างไว้ ระบบจะส่งเหตุการณ์ไปยัง |
transaction_id |
ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันสำหรับเหตุการณ์นี้ ต้องระบุสำหรับ Conversion ที่ใช้แหล่งข้อมูลหลายแหล่ง |
event_timestamp |
ต้องระบุ เวลาที่เกิดเหตุการณ์ |
last_updated_timestamp |
ไม่บังคับ ครั้งล่าสุดที่มีการอัปเดตกิจกรรม |
user_data |
ไม่บังคับ ชิ้นส่วนของข้อมูลที่ได้จากผู้ใช้ ซึ่งแสดงถึงผู้ใช้ที่เชื่อมโยงกับเหตุการณ์ |
consent |
ไม่บังคับ ข้อมูลเกี่ยวกับว่าผู้ใช้ที่เชื่อมโยงได้ให้ความยินยอมประเภทต่างๆ หรือไม่ |
ad_identifiers |
ไม่บังคับ ตัวระบุและข้อมูลอื่นๆ ที่ใช้เพื่อจับคู่เหตุการณ์ Conversion กับกิจกรรมออนไลน์อื่นๆ (เช่น การคลิกโฆษณา) |
currency |
ไม่บังคับ รหัสสกุลเงินที่เชื่อมโยงกับมูลค่าทางการเงินทั้งหมดภายในเหตุการณ์นี้ |
conversion_value |
ไม่บังคับ มูลค่า Conversion ที่เชื่อมโยงกับเหตุการณ์สําหรับ Conversion ตามมูลค่า |
event_source |
ไม่บังคับ สัญญาณที่ระบุตำแหน่งที่เกิดเหตุการณ์ (เว็บ แอป ในร้านค้า ฯลฯ) |
event_device_info |
ไม่บังคับ ข้อมูลที่รวบรวมเกี่ยวกับอุปกรณ์ที่ใช้ (หากมี) เมื่อเกิดเหตุการณ์ |
cart_data |
ไม่บังคับ ข้อมูลเกี่ยวกับธุรกรรมและรายการที่เชื่อมโยงกับกิจกรรม |
custom_variables[] |
ไม่บังคับ ข้อมูลคู่คีย์/ค่าเพิ่มเติมที่จะส่งไปยังคอนเทนเนอร์ Conversion (การกระทำที่ถือเป็น Conversion หรือกิจกรรม FL) |
experimental_fields[] |
ไม่บังคับ รายการคู่คีย์/ค่าสำหรับฟิลด์เวอร์ชันทดลองที่อาจได้รับการเลื่อนขั้นให้เป็นส่วนหนึ่งของ API ในอนาคต |
user_properties |
ไม่บังคับ ข้อมูลที่ผู้ลงโฆษณาประเมินเกี่ยวกับผู้ใช้ ณ เวลาที่เกิดเหตุการณ์ |
EventSource
แหล่งที่มาของเหตุการณ์
Enum | |
---|---|
EVENT_SOURCE_UNSPECIFIED |
EventSource ที่ไม่ได้ระบุ ไม่ควรใช้ |
WEB |
เหตุการณ์นี้สร้างขึ้นจากเว็บเบราว์เซอร์ |
APP |
กิจกรรมสร้างขึ้นจากแอป |
IN_STORE |
กิจกรรมนี้สร้างขึ้นจากธุรกรรมในร้านค้า |
PHONE |
ระบบสร้างกิจกรรมจากการโทร |
OTHER |
ระบบสร้างกิจกรรมจากแหล่งที่มาอื่นๆ |
ExperimentalField
ฟิลด์ทดลองที่แสดงฟิลด์ที่ไม่เป็นทางการ
ช่อง | |
---|---|
field |
ไม่บังคับ ชื่อของช่องที่จะใช้ |
value |
ไม่บังคับ ค่าของช่องที่จะตั้งค่า |
GcpWrappedKeyInfo
ข้อมูลเกี่ยวกับคีย์ที่ห่อไว้ของ Google Cloud Platform
ช่อง | |
---|---|
key_type |
ต้องระบุ ประเภทของอัลกอริทึมที่ใช้ในการเข้ารหัสข้อมูล |
wip_provider |
ต้องระบุ ผู้ให้บริการพูล Workload Identity ที่จำเป็นต้องใช้ KEK |
kek_uri |
ต้องระบุ รหัสทรัพยากรของ Cloud Key Management Service ใน Google Cloud Platform ควรอยู่ในรูปแบบ "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}" |
encrypted_dek |
ต้องระบุ คีย์การเข้ารหัสข้อมูลที่เข้ารหัสซึ่งเข้ารหัสแบบ Base64 |
KeyType
ประเภทของอัลกอริทึมที่ใช้ในการเข้ารหัสข้อมูล
Enum | |
---|---|
KEY_TYPE_UNSPECIFIED |
ประเภทคีย์ที่ไม่ได้ระบุ ไม่ควรใช้ |
XCHACHA20_POLY1305 |
อัลกอริทึม XChaCha20-Poly1305 |
IngestAudienceMembersRequest
ขออัปโหลดสมาชิกกลุ่มเป้าหมายไปยังปลายทางที่ระบุ แสดงผล IngestAudienceMembersResponse
ช่อง | |
---|---|
destinations[] |
ต้องระบุ รายการปลายทางที่จะส่งสมาชิกในกลุ่มเป้าหมายไป |
audience_members[] |
ต้องระบุ รายชื่อผู้ใช้ที่จะส่งไปยังปลายทางที่ระบุ ส่งทรัพยากร |
consent |
ไม่บังคับ ความยินยอมระดับคำขอที่จะใช้กับผู้ใช้ทั้งหมดในคำขอ ความยินยอมระดับผู้ใช้จะลบล้างความยินยอมระดับคำขอ และระบุได้ในแต่ละ |
validate_only |
ไม่บังคับ เพื่อวัตถุประสงค์ในการทดสอบ หากเป็น |
encoding |
ไม่บังคับ ต้องระบุสำหรับการอัปโหลด |
encryption_info |
ไม่บังคับ ข้อมูลการเข้ารหัสสำหรับการอัปโหลดของ |
terms_of_service |
ไม่บังคับ ข้อกำหนดในการให้บริการที่ผู้ใช้ยอมรับ/ปฏิเสธ |
IngestAudienceMembersResponse
คำตอบจาก IngestAudienceMembersRequest
ช่อง | |
---|---|
request_id |
รหัสที่สร้างขึ้นโดยอัตโนมัติของคำขอ |
IngestEventsRequest
ขออัปโหลดสมาชิกกลุ่มเป้าหมายไปยังปลายทางที่ระบุ แสดงผล IngestEventsResponse
ช่อง | |
---|---|
destinations[] |
ต้องระบุ รายการปลายทางที่จะส่งเหตุการณ์ไป |
events[] |
ต้องระบุ รายการเหตุการณ์ที่จะส่งไปยังปลายทางที่ระบุ ส่งทรัพยากร |
consent |
ไม่บังคับ ความยินยอมระดับคำขอที่จะใช้กับผู้ใช้ทั้งหมดในคำขอ ความยินยอมระดับผู้ใช้จะลบล้างความยินยอมระดับคำขอ และระบุได้ในแต่ละ |
validate_only |
ไม่บังคับ เพื่อวัตถุประสงค์ในการทดสอบ หากเป็น |
encoding |
ไม่บังคับ ต้องระบุสำหรับการอัปโหลด |
encryption_info |
ไม่บังคับ ข้อมูลการเข้ารหัสสำหรับการอัปโหลดของ |
IngestEventsResponse
คำตอบจาก IngestEventsRequest
ช่อง | |
---|---|
request_id |
รหัสที่สร้างขึ้นโดยอัตโนมัติของคำขอ |
รายการ
แสดงสินค้าในรถเข็นที่เชื่อมโยงกับเหตุการณ์
ช่อง | |
---|---|
merchant_product_id |
ไม่บังคับ รหัสผลิตภัณฑ์ภายในบัญชี Merchant Center |
quantity |
ไม่บังคับ หมายเลขของสินค้าที่เชื่อมโยงกับเหตุการณ์ |
unit_price |
ไม่บังคับ ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดธุรกรรมระดับใดๆ |
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% (ในช่วง |
MobileData
รหัสอุปกรณ์เคลื่อนที่สำหรับกลุ่มเป้าหมาย ต้องระบุรหัสอุปกรณ์เคลื่อนที่อย่างน้อย 1 รายการ
ช่อง | |
---|---|
mobile_ids[] |
ต้องระบุ รายการรหัสอุปกรณ์เคลื่อนที่ (รหัสโฆษณา/IDFA) ระบุ |
PairData
รหัส PAIR สำหรับกลุ่มเป้าหมาย ต้องระบุรหัส PAIR อย่างน้อย 1 รายการ
ช่อง | |
---|---|
pair_ids[] |
ต้องระบุ ข้อมูล PII ที่ได้จากคลีนรูม ซึ่งแฮชด้วย SHA256 และเข้ารหัสด้วยการเข้ารหัสลับแบบสลับที่ใช้ EC โดยใช้คีย์ของผู้เผยแพร่โฆษณาสำหรับรายชื่อผู้ใช้ PAIR ระบุ |
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 |
ข้อผิดพลาดภายใน |
ผลิตภัณฑ์
เลิกใช้งานแล้ว โปรดใช้
แทน แสดงถึงผลิตภัณฑ์ Google ที่เฉพาะเจาะจงAccountType
Enum | |
---|---|
PRODUCT_UNSPECIFIED |
ผลิตภัณฑ์ที่ไม่ได้ระบุ ไม่ควรใช้ |
GOOGLE_ADS |
Google Ads |
DISPLAY_VIDEO_PARTNER |
พาร์ทเนอร์ Display & Video 360 |
DISPLAY_VIDEO_ADVERTISER |
ผู้ลงโฆษณา Display & Video 360 |
DATA_PARTNER |
พาร์ทเนอร์ด้านข้อมูล |
ProductAccount
แสดงถึงบัญชีที่เฉพาะเจาะจง
ช่อง | |
---|---|
product |
เลิกใช้งานแล้ว โปรดใช้ |
account_id |
ต้องระบุ รหัสของบัญชี เช่น รหัสบัญชี Google Ads |
account_type |
ไม่บังคับ ประเภทของบัญชี เช่น |
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
ช่อง | |
---|---|
destinations[] |
ต้องระบุ รายการปลายทางที่จะนำผู้ใช้ออกจาก |
audience_members[] |
ต้องระบุ รายชื่อผู้ใช้ที่จะนำออก |
validate_only |
ไม่บังคับ เพื่อวัตถุประสงค์ในการทดสอบ หากเป็น |
encoding |
ไม่บังคับ ต้องระบุสำหรับการอัปโหลด |
encryption_info |
ไม่บังคับ ข้อมูลการเข้ารหัสสำหรับการอัปโหลดของ |
RemoveAudienceMembersResponse
คำตอบจาก RemoveAudienceMembersRequest
ช่อง | |
---|---|
request_id |
รหัสที่สร้างขึ้นโดยอัตโนมัติของคำขอ |
RequestStatusPerDestination
สถานะคำขอต่อปลายทาง
ช่อง | |
---|---|
destination |
ปลายทางภายในคำขอ DM API |
request_status |
สถานะคำขอของปลายทาง |
error_info |
ข้อผิดพลาดเกี่ยวกับข้อมูลข้อผิดพลาดที่มีเหตุผลของข้อผิดพลาดและจำนวนข้อผิดพลาดที่เกี่ยวข้องกับการอัปโหลด |
warning_info |
ข้อมูลคำเตือนที่มีเหตุผลของคำเตือนและจำนวนคำเตือนที่เกี่ยวข้องกับการอัปโหลด |
ฟิลด์ Union status สถานะของปลายทาง status ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
audience_members_ingestion_status |
สถานะของคำขอสมาชิกในกลุ่มเป้าหมายที่ส่ง |
events_ingestion_status |
สถานะของคำขอเหตุการณ์การส่งผ่านข้อมูล |
audience_members_removal_status |
สถานะของคำขอให้นำสมาชิกของกลุ่มเป้าหมายออก |
IngestAudienceMembersStatus
สถานะของคำขอสมาชิกในกลุ่มเป้าหมายที่ส่ง
ช่อง | |
---|---|
ฟิลด์ Union status สถานะการส่งข้อมูลสมาชิกในกลุ่มเป้าหมายไปยังปลายทาง status ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
user_data_ingestion_status |
สถานะการนำเข้าข้อมูลผู้ใช้ไปยังปลายทาง |
mobile_data_ingestion_status |
สถานะการนำเข้าข้อมูลมือถือไปยังปลายทาง |
pair_data_ingestion_status |
สถานะของการนำเข้าข้อมูลคู่ไปยังปลายทาง |
IngestEventsStatus
สถานะของการส่งผ่านข้อมูลเหตุการณ์ไปยังปลายทาง
ช่อง | |
---|---|
record_count |
จํานวนเหตุการณ์ทั้งหมดที่ส่งในคําขออัปโหลด รวมเหตุการณ์ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม |
IngestMobileDataStatus
สถานะของการส่งผ่านข้อมูลอินเทอร์เน็ตมือถือไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการส่งผ่านข้อมูล
ช่อง | |
---|---|
record_count |
จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม |
mobile_id_count |
จำนวนรหัสอุปกรณ์เคลื่อนที่ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมรหัสอุปกรณ์เคลื่อนที่ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม |
IngestPairDataStatus
สถานะของการนำเข้าข้อมูลคู่ไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการนำเข้า
ช่อง | |
---|---|
record_count |
จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม |
pair_id_count |
จำนวนรหัสคู่ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมรหัสคู่ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม |
IngestUserDataStatus
สถานะของการนำเข้าข้อมูลผู้ใช้ไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการนำเข้า
ช่อง | |
---|---|
record_count |
จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม |
user_identifier_count |
จำนวนตัวระบุผู้ใช้ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมตัวระบุผู้ใช้ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม |
upload_match_rate_range |
ช่วงอัตราการจับคู่ของการอัปโหลด |
RemoveAudienceMembersStatus
สถานะของคำขอให้นำสมาชิกของกลุ่มเป้าหมายออก
ช่อง | |
---|---|
ฟิลด์ Union status สถานะของการนำสมาชิกกลุ่มเป้าหมายออกจากปลายทาง status ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
user_data_removal_status |
สถานะการนำข้อมูลผู้ใช้ออกจากปลายทาง |
mobile_data_removal_status |
สถานะการนำข้อมูลในอุปกรณ์เคลื่อนที่ออกจากปลายทาง |
pair_data_removal_status |
สถานะการนำข้อมูลคู่ที่นำออกจากปลายทาง |
RemoveMobileDataStatus
สถานะการนำข้อมูลในอุปกรณ์เคลื่อนที่ออกจากปลายทาง
ช่อง | |
---|---|
record_count |
จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม |
mobile_id_count |
จำนวนรหัสอุปกรณ์เคลื่อนที่ทั้งหมดที่ส่งในคำขอลบ รวมรหัสอุปกรณ์เคลื่อนที่ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม |
RemovePairDataStatus
สถานะการนำข้อมูลคู่ที่นำออกจากปลายทาง
ช่อง | |
---|---|
record_count |
จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม |
pair_id_count |
จำนวนรหัสคู่ทั้งหมดที่ส่งในคำขอให้นำออก รวมรหัสคู่ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม |
RemoveUserDataStatus
สถานะการนำข้อมูลผู้ใช้ออกจากปลายทาง
ช่อง | |
---|---|
record_count |
จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม |
user_identifier_count |
จำนวนตัวระบุผู้ใช้ทั้งหมดที่ส่งในคำขอให้นำออก รวมตัวระบุผู้ใช้ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม |
RequestStatus
สถานะคำขอ
Enum | |
---|---|
REQUEST_STATUS_UNKNOWN |
ไม่ทราบสถานะคำขอ |
SUCCESS |
คำขอสำเร็จ |
PROCESSING |
คำขออยู่ระหว่างดำเนินการ |
FAILED |
คำขอล้มเหลว |
PARTIAL_SUCCESS |
คำขอสำเร็จบางส่วน |
RetrieveRequestStatusRequest
คำขอรับสถานะของคำขอที่ส่งไปยัง DM API สำหรับรหัสคำขอที่ระบุ แสดงผล RetrieveRequestStatusResponse
ช่อง | |
---|---|
request_id |
ต้องระบุ ต้องระบุ รหัสคำขอของคำขอ Data Manager API |
RetrieveRequestStatusResponse
คำตอบจาก RetrieveRequestStatusRequest
ช่อง | |
---|---|
request_status_per_destination[] |
รายการสถานะคำขอต่อปลายทาง ลำดับของสถานะจะตรงกับลำดับของปลายทางในคำขอเดิม |
TermsOfService
ข้อกำหนดในการให้บริการที่ผู้ใช้ยอมรับ/ปฏิเสธ
ช่อง | |
---|---|
customer_match_terms_of_service_status |
ไม่บังคับ ข้อกำหนดในการให้บริการของการจับคู่ข้อมูลลูกค้า: https://support.google.com/adspolicy/answer/6299717 คุณต้องยอมรับข้อกำหนดนี้เมื่อส่งผ่านข้อมูล |
TermsOfServiceStatus
แสดงการตัดสินใจของผู้โทรว่าจะยอมรับหรือปฏิเสธข้อกำหนดในการให้บริการ
Enum | |
---|---|
TERMS_OF_SERVICE_STATUS_UNSPECIFIED |
ไม่ได้ระบุ |
ACCEPTED |
สถานะที่ระบุว่าผู้โทรเลือกที่จะยอมรับข้อกำหนดในการให้บริการ |
REJECTED |
สถานะที่บ่งบอกว่าผู้โทรเลือกที่จะปฏิเสธข้อกำหนดในการให้บริการ |
UserData
ข้อมูลที่ระบุตัวตนผู้ใช้ ต้องระบุตัวระบุอย่างน้อย 1 รายการ
ช่อง | |
---|---|
user_identifiers[] |
ต้องระบุ ตัวระบุสำหรับผู้ใช้ คุณระบุข้อมูลประเภทเดียวกันได้หลายรายการ (เช่น อีเมลหลายรายการ) ระบุตัวระบุให้มากที่สุดเท่าที่จะเป็นไปได้เพื่อเพิ่มโอกาสในการจับคู่ ระบุ |
UserIdentifier
ตัวระบุเดียวสำหรับผู้ใช้
ช่อง | |
---|---|
ฟิลด์ Union identifier ต้องระบุอย่างใดอย่างหนึ่งเท่านั้น identifier ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
email_address |
อีเมลที่แฮชโดยใช้ฟังก์ชันแฮช SHA-256 หลังจากทําการแปลงให้เป็นรูปแบบมาตรฐาน |
phone_number |
หมายเลขโทรศัพท์ที่แฮชโดยใช้ฟังก์ชันแฮช SHA-256 หลังจากทำการทำให้เป็นมาตรฐาน (มาตรฐาน E164) |
address |
องค์ประกอบที่ทราบของที่อยู่ของผู้ใช้ มีกลุ่มตัวระบุที่ตรงกันทั้งหมดในครั้งเดียว |
UserProperties
ข้อมูลที่ผู้ลงโฆษณาประเมินเกี่ยวกับผู้ใช้ ณ เวลาที่เกิดเหตุการณ์ ดูรายละเอียดเพิ่มเติมได้ที่ https://support.google.com/google-ads/answer/14007601
ช่อง | |
---|---|
customer_type |
ไม่บังคับ ประเภทลูกค้าที่เชื่อมโยงกับเหตุการณ์ |
customer_value_bucket |
ไม่บังคับ มูลค่าของลูกค้าที่ผู้ลงโฆษณาประเมิน |
WarningCount
จำนวนคำเตือนสำหรับเหตุผลของคำเตือนที่ระบุ
ช่อง | |
---|---|
record_count |
จำนวนระเบียนที่มีคำเตือน |
reason |
เหตุผลของคำเตือน |
WarningInfo
จำนวนคำเตือนสำหรับคำเตือนแต่ละประเภท
ช่อง | |
---|---|
warning_counts[] |
รายการคำเตือนและจำนวนคำเตือนตามเหตุผลของคำเตือน |