Package google.ads.datamanager.v1

ดัชนี

IngestionService

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

IngestAudienceMembers

rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse)

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

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

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

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

rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse)

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

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

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

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

rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)

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

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

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

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

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

ข้อมูลที่ระบุอุปกรณ์เคลื่อนที่ของผู้ใช้

AwsWrappedKeyInfo

คีย์การเข้ารหัสข้อมูลที่ปกปิดด้วยคีย์ AWS KMS

ช่อง
key_type

KeyType

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

string

ต้องระบุ ชื่อทรัพยากร Amazon ของบทบาท IAM ที่จะใช้สำหรับการเข้าถึงการถอดรหัส KMS ควรอยู่ในรูปแบบ "arn:{partition}:iam::{account_id}:role/{role_name}"
kek_uri

string

ต้องระบุ URI ของคีย์ AWS KMS ที่ใช้ในการถอดรหัส DEK ควรอยู่ในรูปแบบ "arn:{partition}:kms:{region}:{account_id}:key/{key_id}"
encrypted_dek

string

ต้องระบุ คีย์การเข้ารหัสข้อมูลที่เข้ารหัสซึ่งเข้ารหัสแบบ Base64

KeyType

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

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

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

ไม่บังคับ รายการสินค้าที่เชื่อมโยงกับกิจกรรม

การตั้งค่าความยินยอมตามกฎหมายตลาดดิจิทัล (DMA) สำหรับผู้ใช้

ช่อง
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

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 ออฟไลน์

การเข้ารหัส

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

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

EncryptionInfo

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

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

GcpWrappedKeyInfo

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

AwsWrappedKeyInfo

ข้อมูลคีย์ที่ปกปิดของ Amazon Web Services

ErrorCount

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

ช่อง
record_count

int64

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

ProcessingErrorReason

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

ErrorInfo

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

ช่อง
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 แห่งในคำขอมีการอ้างอิงเดียวกัน
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER บัญชีปฏิบัติการที่ไม่รองรับสำหรับการให้สิทธิ์พาร์ทเนอร์ด้านข้อมูล
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER บัญชีที่ลิงก์ไม่รองรับการให้สิทธิ์พาร์ทเนอร์ด้านข้อมูล
NO_IDENTIFIERS_PROVIDED ข้อมูลเหตุการณ์ไม่มีตัวระบุผู้ใช้หรือตัวระบุโฆษณา
INVALID_PROPERTY_TYPE ไม่รองรับประเภทพร็อพเพอร์ตี้
INVALID_STREAM_TYPE สตรีมประเภทนี้ไม่รองรับ
LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT ระบบจะรองรับบัญชีที่ลิงก์ไว้เมื่อบัญชีที่ใช้เข้าสู่ระบบเป็นบัญชี DATA_PARTNER เท่านั้น
OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH บัญชีเข้าสู่ระบบต้องเป็นบัญชีเดียวกับบัญชีปฏิบัติการสำหรับกรณีการใช้งานที่กำหนด
EVENT_TIME_INVALID เหตุการณ์ไม่ได้เกิดขึ้นภายในกรอบเวลาที่ยอมรับได้
RESERVED_NAME_USED พารามิเตอร์ใช้ชื่อที่สงวนไว้
INVALID_EVENT_NAME ไม่รองรับชื่อเหตุการณ์
NOT_ALLOWLISTED บัญชีไม่อยู่ในรายการที่อนุญาตสำหรับฟีเจอร์ที่ระบุ
INVALID_REQUEST_ID รหัสคำขอที่ใช้เพื่อดึงสถานะของคำขอไม่ถูกต้อง ดึงข้อมูลสถานะได้เฉพาะคำขอที่สำเร็จและไม่มี validate_only=true
MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT เหตุการณ์มีปลายทาง Google Analytics อย่างน้อย 2 รายการ
FIELD_VALUE_TOO_LONG ค่าฟิลด์ยาวเกินไป
TOO_MANY_ELEMENTS มีองค์ประกอบมากเกินไปในรายการในคำขอ

กิจกรรม

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

ช่อง
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

ไม่บังคับ ข้อมูลที่ผู้ลงโฆษณาประเมินเกี่ยวกับผู้ใช้ ณ เวลาที่เกิดเหตุการณ์
event_name

string

ไม่บังคับ ชื่อเหตุการณ์ ต้องระบุสําหรับเหตุการณ์ GA4
client_id

string

ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันสำหรับอินสแตนซ์ผู้ใช้ของไคลเอ็นต์เว็บสำหรับสตรีมเว็บ GA4 นี้
user_id

string

ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันสำหรับผู้ใช้ตามที่ผู้ลงโฆษณากำหนด
additional_event_parameters[]

EventParameter

ไม่บังคับ กลุ่มพารามิเตอร์เหตุการณ์ที่จะรวมไว้ในเหตุการณ์ที่ยังไม่ได้ระบุโดยใช้ฟิลด์ที่มีโครงสร้างอื่นๆ

EventParameter

พารามิเตอร์เหตุการณ์สําหรับเหตุการณ์ GA4

ช่อง
parameter_name

string

ต้องระบุ ชื่อพารามิเตอร์ที่จะใช้
value

string

ต้องระบุ การแสดงสตริงของค่าพารามิเตอร์ที่จะตั้งค่า

EventSource

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

Enum
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

ต้องระบุ ผู้ให้บริการพูล 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:
ลองใช้กับ 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

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

IngestEventsRequest

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

คุณลองใช้วิธีนี้ได้ใน โปรแกรมสำรวจ REST API:
ลองใช้กับ 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

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

รายการ

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

ช่อง
merchant_product_id

string

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

int64

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

double

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

string

ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันเพื่อใช้อ้างอิงรายการ
additional_item_parameters[]

ItemParameter

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

ItemParameter

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

ช่อง
parameter_name

string

ต้องระบุ ชื่อพารามิเตอร์ที่จะใช้
value

string

ต้องระบุ การแสดงสตริงของค่าพารามิเตอร์ที่จะตั้งค่า

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 เดียว

PairData

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

ช่อง
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_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_AWS_AUTH_FAILED ระบบตรวจสอบสิทธิ์กับ AWS ไม่สำเร็จ
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 ข้อผิดพลาดภายใน
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED ระบบตรวจสอบสิทธิ์กับ AWS ไม่สำเร็จ

ผลิตภัณฑ์

เลิกใช้งานแล้ว โปรดใช้ 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 อย่าง ค่าจะต้องตรงกัน

AccountType

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

Enum
ACCOUNT_TYPE_UNSPECIFIED ผลิตภัณฑ์ที่ไม่ได้ระบุ ไม่ควรใช้
GOOGLE_ADS Google Ads
DISPLAY_VIDEO_PARTNER พาร์ทเนอร์ Display & Video 360
DISPLAY_VIDEO_ADVERTISER ผู้ลงโฆษณา Display & Video 360
DATA_PARTNER พาร์ทเนอร์ด้านข้อมูล
GOOGLE_ANALYTICS_PROPERTY Google Analytics

RemoveAudienceMembersRequest

คำขอให้นำผู้ใช้ออกจากกลุ่มเป้าหมายในปลายทางที่ระบุ แสดงผล RemoveAudienceMembersResponse

คุณลองใช้วิธีนี้ได้ใน โปรแกรมสำรวจ REST API:
ลองใช้กับ REST
ช่อง
destinations[]

Destination

ต้องระบุ รายการปลายทางที่จะนำผู้ใช้ออก
audience_members[]

AudienceMember

ต้องระบุ รายชื่อผู้ใช้ที่จะนำออก
validate_only

bool

ไม่บังคับ เพื่อวัตถุประสงค์ในการทดสอบ หากเป็น true ระบบจะตรวจสอบคำขอแต่จะไม่ดำเนินการ ระบบจะแสดงเฉพาะข้อผิดพลาด ไม่ใช่ผลลัพธ์
encoding

Encoding

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

EncryptionInfo

ไม่บังคับ ข้อมูลการเข้ารหัสสำหรับการอัปโหลดของ UserData หากไม่ได้ตั้งค่าไว้ ระบบจะถือว่าข้อมูลระบุตัวตนที่อัปโหลดได้รับการแฮชแต่ไม่ได้เข้ารหัส สำหรับUserDataที่ไม่ใช่การอัปโหลด ระบบจะไม่สนใจฟิลด์นี้

RemoveAudienceMembersResponse

คำตอบจาก RemoveAudienceMembersRequest

ช่อง
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

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

IngestMobileDataStatus

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

ช่อง
record_count

int64

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

int64

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

IngestPairDataStatus

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

ช่อง
record_count

int64

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

int64

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

IngestUserDataStatus

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

ช่อง
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

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

RemovePairDataStatus

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

ช่อง
record_count

int64

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

int64

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

RemoveUserDataStatus

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

ช่อง
record_count

int64

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

int64

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

RequestStatus

สถานะคำขอ

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

RetrieveRequestStatusRequest

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

คุณลองใช้วิธีนี้ได้ใน โปรแกรมสำรวจ REST API:
ลองใช้กับ 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

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

UserProperty

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

UserProperty

กลุ่มพร็อพเพอร์ตี้ผู้ใช้เพิ่มเติมสําหรับผู้ใช้ที่เชื่อมโยงกับเหตุการณ์นี้

ช่อง
property_name

string

ต้องระบุ ชื่อของพร็อพเพอร์ตี้ผู้ใช้ที่จะใช้
value

string

ต้องระบุ การแสดงสตริงของค่าพร็อพเพอร์ตี้ผู้ใช้ที่จะใช้

WarningCount

จำนวนคำเตือนสำหรับเหตุผลของคำเตือนที่ระบุ

ช่อง
record_count

int64

จำนวนระเบียนที่มีคำเตือน
reason

ProcessingWarningReason

เหตุผลของคำเตือน

WarningInfo

จำนวนคำเตือนสำหรับคำเตือนแต่ละประเภท

ช่อง
warning_counts[]

WarningCount

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