Package google.ads.datamanager.v1

string

Bắt buộc. Mã nhận dạng của nhà quảng cáo cho sự kiện quảng cáo.

Mã này phải khớp với mã được gửi trong quy trình liên kết.

EventType

Bắt buộc. Loại sự kiện.

Timestamp

Bắt buộc. Thời gian xảy ra sự kiện.

string

Không bắt buộc. Mã do người gọi tạo và quản lý, dùng để xác định riêng sự kiện này.

Bắt buộc nếu bạn muốn loại bỏ sự kiện quảng cáo trùng lặp có trong nhiều yêu cầu. Nếu không, bạn không bắt buộc phải điền vào trường này.

UserData

Không bắt buộc. Nhiều phần dữ liệu do người dùng cung cấp, thể hiện người dùng mà sự kiện được liên kết.

Bạn có thể cung cấp nhiều thực thể của cùng một loại dữ liệu (ví dụ: địa chỉ email). Bạn cung cấp càng nhiều dữ liệu thì khả năng tìm thấy kết quả trùng khớp càng cao.

DeviceInfo

Không bắt buộc. Thông tin được thu thập về thiết bị đang được sử dụng khi sự kiện quảng cáo xảy ra.

string

Không bắt buộc. Mã nhận dạng thiết bị của thiết bị mà quảng cáo được phân phát.

string

Bắt buộc. Mã của chiến dịch được liên kết.

string

Bắt buộc. Tên của chiến dịch được liên kết.

string

Không bắt buộc. Mã của nhóm quảng cáo được liên kết.

string

Không bắt buộc. Mã nhận dạng của quảng cáo được liên kết trong nhóm.

int32

Không bắt buộc. Chiều cao của quảng cáo tính bằng pixel.

int32

Không bắt buộc. Chiều rộng của quảng cáo tính bằng pixel.

string

Bắt buộc. Quốc gia và tiểu bang theo tiêu chuẩn ISO 3166-2.

string

Bắt buộc. Nguồn nền tảng của quảng cáo, tương tự như nguồn của Google Analytics.

string

Bắt buộc. Phương tiện của quảng cáo, tương tự như phương tiện của Google Analytics.

AttributionHint

Không bắt buộc. Trạng thái phân bổ do đối tác giả định cho sự kiện quảng cáo này.

Đây chỉ là một tín hiệu cho biết cách đối tác giả định mô hình phân bổ đã diễn ra và không bắt buộc phải có kết quả cuối cùng trong báo cáo cuối cùng.

ViewabilityInfo

Bắt buộc. Thông tin chi tiết về khả năng xem của quảng cáo được phân phát.

EventSubtype

Giá trị enum cho loại sự kiện cụ thể.

string

Giá trị chuỗi cho loại sự kiện cụ thể.

AdType

Giá trị enum cho loại quảng cáo.

string

Giá trị chuỗi cho loại quảng cáo.

AdFormat

Giá trị enum cho định dạng quảng cáo.

string

Giá trị chuỗi cho định dạng quảng cáo.

AdPlacement

Giá trị enum cho vị trí đặt quảng cáo.

string

Giá trị chuỗi cho vị trí đặt quảng cáo.

TargetingType

Giá trị enum cho loại tiêu chí nhắm mục tiêu.

string

Giá trị chuỗi cho loại tiêu chí nhắm mục tiêu.

PlatformType

Giá trị enum cho loại nền tảng.

string

Giá trị chuỗi cho loại nền tảng.

Platform

Giá trị enum cho nền tảng.

string

Giá trị chuỗi cho nền tảng.

bool

Không bắt buộc. Cho biết liệu hàng có được phép sử dụng cho mục đích đo lường hay không, chịu sự điều chỉnh của luật về quyền riêng tư hiện hành trong phạm vi khu vực tài phán.

string

Không bắt buộc. Thuộc tính của phiên để phân bổ và lập mô hình sự kiện.

string

Không bắt buộc. Mã lượt nhấp của Google (gclid) được liên kết với sự kiện này.

string

Không bắt buộc. Mã lượt nhấp cho các lượt nhấp được liên kết với sự kiện trong ứng dụng và bắt nguồn từ các thiết bị iOS bắt đầu từ iOS14.

string

Không bắt buộc. Giá trị nhận dạng lượt nhấp cho các lượt nhấp được liên kết với sự kiện trên web và bắt nguồn từ các thiết bị iOS bắt đầu từ iOS14.

DeviceInfo

Không bắt buộc. Thông tin được thu thập về thiết bị đang được sử dụng (nếu có) tại thời điểm người dùng truy cập vào trang web của nhà quảng cáo sau khi tương tác với quảng cáo.

string

Không bắt buộc. Mã nhận dạng trên thiết bị di động cho nhà quảng cáo. Đây sẽ là IDFA trên iOS, AdID trên Android hoặc giá trị nhận dạng của các nền tảng khác cho nhà quảng cáo.

string

Không bắt buộc. Mã lượt nhấp hiển thị được liên kết với sự kiện này.

string

Không bắt buộc. Mã lượt hiển thị được liên kết với sự kiện này.

string

Không bắt buộc. Trường mã nhận dạng lượt so khớp dùng để kết hợp sự kiện này với một sự kiện trước đó.

EncryptedUserId

Không bắt buộc. Bất kỳ số lượng mã nhận dạng người dùng đã mã hoá nào.

string

Bắt buộc. Tên (tên riêng) của người dùng, tất cả đều là chữ thường, không có dấu câu, không có khoảng trắng ở đầu hoặc cuối và được băm dưới dạng SHA-256.

string

Bắt buộc. Họ của người dùng, tất cả đều là chữ thường, không có dấu câu, không có khoảng trắng ở đầu hoặc cuối và được băm dưới dạng SHA-256.

string

Bắt buộc. Mã vùng gồm 2 chữ cái theo chuẩn ISO-3166-1 alpha-2 trong địa chỉ của người dùng.

string

Bắt buộc. Mã bưu chính trong địa chỉ của người dùng.

string

Không bắt buộc. Xác định Destination nào sẽ gửi thành viên đối tượng đến.

Consent

Không bắt buộc. Chế độ cài đặt sự đồng ý cho người dùng.

UserData

Dữ liệu do người dùng cung cấp để xác định người dùng.

PairData

Mã nhận dạng Điều chỉnh danh tính giữa nhà xuất bản và nhà quảng cáo (PAIR).

Tính năng này chỉ dành cho các đối tác dữ liệu.

MobileData

Dữ liệu xác định thiết bị di động của người dùng.

UserIdData

Dữ liệu liên quan đến giá trị nhận dạng riêng biệt của một người dùng, do nhà quảng cáo xác định.

PpidData

Dữ liệu liên quan đến giá trị nhận dạng do nhà xuất bản cung cấp.

Tính năng này chỉ dành cho các đối tác dữ liệu.

CompositeData

Nhóm gồm nhiều loại giá trị nhận dạng.

KeyType

Bắt buộc. Loại thuật toán dùng để mã hoá dữ liệu.

string

Bắt buộc. Tên tài nguyên Amazon của vai trò IAM cần giả định để có quyền truy cập giải mã KMS. Phải ở định dạng arn:{partition}:iam::{account_id}:role/{role_name}

string

Bắt buộc. URI của khoá AWS KMS dùng để giải mã DEK. Phải ở định dạng arn:{partition}:kms:{region}:{account_id}:key/{key_id} hoặc aws-kms://arn:{partition}:kms:{region}:{account_id}:key/{key_id}

string

Bắt buộc. Khoá mã hoá dữ liệu đã mã hoá được mã hoá base64.

Location

Vị trí cơ sở của yêu cầu. Vị trí cơ sở là danh sách OR của các khu vực được yêu cầu.

bool

Nếu được đặt thành true, dịch vụ sẽ cố gắng tự động phát hiện vị trí cơ sở cho thông tin chi tiết.

string

Danh sách mã vùng gồm 2 chữ cái theo ISO 3166-1.

string

Không bắt buộc. Mã truy cập Merchant Center được liên kết với các mặt hàng.

string

Không bắt buộc. Nhãn nguồn cấp dữ liệu Merchant Center được liên kết với nguồn cấp dữ liệu của các mặt hàng.

string

Không bắt buộc. Mã ngôn ngữ theo tiêu chuẩn ISO 639-1 được liên kết với nguồn cấp dữ liệu Merchant Center của các mặt hàng mà bạn tải lên.

double

Không bắt buộc. Tổng số tiền chiết khấu liên quan đến giao dịch.

Item

Không bắt buộc. Danh sách các mặt hàng liên kết với sự kiện.

string

Không bắt buộc. Danh sách mã giảm giá đã được áp dụng cho giỏ hàng. Mã giảm giá ở cấp giỏ hàng và cấp mặt hàng là độc lập với nhau.

Nếu sự kiện này dành cho một đích đến Google Analytics, bạn chỉ cần cung cấp một mã giảm giá. Google Analytics bỏ qua các mã giảm giá bổ sung.

UserData

Không bắt buộc. Dữ liệu do người dùng cung cấp để xác định người dùng.

IpData

Không bắt buộc. Dữ liệu địa chỉ IP thể hiện lượt tương tác của khách hàng được dùng để tạo đối tượng.

ConsentStatus

Không bắt buộc. Biểu thị việc người dùng có đồng ý với dữ liệu người dùng quảng cáo hay không.

ConsentStatus

Không bắt buộc. Biểu thị việc người dùng có đồng ý với chế độ cá nhân hoá quảng cáo hay không.

int32

Chỉ có đầu ra. Tỷ lệ khớp cho danh sách người dùng so khớp khách hàng.

DataSourceType

Không bắt buộc. Không thể thay đổi. Nguồn dữ liệu tải lên

string

Bắt buộc. Mã nhận dạng của khoá điều phối được chọn.

string

Bắt buộc. Tài khoản chính sở hữu bộ sưu tập đường liên kết đến đối tác này. Định dạng: accountTypes/{account_type}/accounts/{account}

PartnerLink

Bắt buộc. Đường liên kết đối tác cần tạo.

string

Bắt buộc. Tài khoản sở hữu danh sách người dùng đang được cấp phép. Phải có định dạng accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

UserListDirectLicense

Bắt buộc. Danh sách người dùng được cấp phép trực tiếp để tạo.

string

Bắt buộc. Tài khoản sở hữu danh sách người dùng đang được cấp phép. Phải có định dạng accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

UserListGlobalLicense

Bắt buộc. Giấy phép toàn cầu để tạo danh sách người dùng.

string

Bắt buộc. Tài khoản mẹ nơi danh sách người dùng này sẽ được tạo. Định dạng: accountTypes/{account_type}/accounts/{account}

UserList

Bắt buộc. Danh sách người dùng cần tạo.

bool

Không bắt buộc. Nếu đúng, yêu cầu sẽ được xác thực nhưng không được thực thi.

string

Không bắt buộc. Tên của biến tuỳ chỉnh cần đặt. Nếu không tìm thấy biến cho đích đến đã cho, biến đó sẽ bị bỏ qua.

string

Không bắt buộc. Giá trị cần lưu trữ cho biến tuỳ chỉnh.

string

Không bắt buộc. Chuỗi tham chiếu dùng để xác định Event.destination_references nào mà biến tuỳ chỉnh sẽ được gửi đến. Nếu bạn để trống, Event.destination_references sẽ được sử dụng.

string

Bắt buộc. Tên tài nguyên của đường liên kết đến đối tác cần xoá. Định dạng: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

string

Bắt buộc. Tên của danh sách người dùng cần xoá. Định dạng: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

bool

Không bắt buộc. Nếu đúng, yêu cầu sẽ được xác thực nhưng không được thực thi.

string

Không bắt buộc. Mã nhận dạng của tài nguyên Destination này, là mã nhận dạng duy nhất trong yêu cầu. Sử dụng để tham chiếu Destination này trong IngestEventsRequest và IngestAudienceMembersRequest.

ProductAccount

Không bắt buộc. Tài khoản dùng để thực hiện lệnh gọi API này. Để thêm hoặc xoá dữ liệu khỏi operating_account, login_account này phải có quyền ghi vào operating_account. Ví dụ: tài khoản người quản lý của operating_account hoặc tài khoản đã liên kết với operating_account.

ProductAccount

Không bắt buộc. Một tài khoản mà login_account của người dùng gọi có quyền truy cập thông qua một mối liên kết tài khoản đã được thiết lập. Ví dụ: login_account của một đối tác dữ liệu có thể có quyền truy cập vào linked_account của một khách hàng. Đối tác có thể sử dụng trường này để gửi dữ liệu từ linked_account đến một operating_account khác.

ProductAccount

Bắt buộc. Tài khoản để gửi dữ liệu đến hoặc xoá dữ liệu khỏi.

string

Bắt buộc. Đối tượng trong tài khoản sản phẩm để nhập vào. Ví dụ: mã nhận dạng đối tượng Google Ads, mã nhận dạng đối tượng Display & Video 360 hoặc mã nhận dạng hành động chuyển đổi Google Ads.

string

Không bắt buộc. Chuỗi tác nhân người dùng của thiết bị cho ngữ cảnh đã cho.

string

Không bắt buộc. Địa chỉ IP của thiết bị cho ngữ cảnh đã cho.

Lưu ý: Google Ads không hỗ trợ tính năng so khớp địa chỉ IP cho người dùng cuối ở Khu vực kinh tế Châu Âu (EEA), Vương quốc Anh (UK) hoặc Thuỵ Sĩ (CH). Hãy thêm logic để loại trừ có điều kiện việc chia sẻ địa chỉ IP của người dùng ở những khu vực này và đảm bảo rằng bạn cung cấp cho người dùng thông tin rõ ràng và đầy đủ về dữ liệu mà bạn thu thập trên các trang web, ứng dụng và tài sản khác của mình, đồng thời nhận được sự đồng ý khi luật pháp hoặc bất kỳ chính sách nào hiện hành của Google yêu cầu. Xem trang Giới thiệu về tính năng nhập lượt chuyển đổi ngoại tuyến để biết thêm thông tin chi tiết.

string

Không bắt buộc. Danh mục thiết bị. Ví dụ: "máy tính", "máy tính bảng", "thiết bị di động", "TV thông minh".

string

Không bắt buộc. Ngôn ngữ mà thiết bị sử dụng ở định dạng ISO 639-1.

int32

Không bắt buộc. Chiều cao của màn hình tính bằng pixel.

int32

Không bắt buộc. Chiều rộng của màn hình, tính bằng pixel.

string

Không bắt buộc. Hệ điều hành hoặc nền tảng của thiết bị.

string

Không bắt buộc. Phiên bản của hệ điều hành hoặc nền tảng.

string

Không bắt buộc. Mẫu thiết bị.

string

Không bắt buộc. Thương hiệu của thiết bị.

string

Không bắt buộc. Thương hiệu hoặc loại trình duyệt.

string

Không bắt buộc. Phiên bản của trình duyệt.

string

Bắt buộc. Mã nhận dạng gồm chữ và số đã mã hoá.

EncryptionEntityType

Bắt buộc. Loại thực thể mã hoá. Giá trị này phải khớp với cấu hình mã hoá để phân phát quảng cáo hoặc Chuyển dữ liệu.

int64

Bắt buộc. Mã nhận dạng thực thể mã hoá. Giá trị này phải khớp với cấu hình mã hoá để phân phát quảng cáo hoặc Chuyển dữ liệu.

EncryptionSource

Bắt buộc. Mô tả việc cookie được mã hoá nhận được từ hoạt động phân phát quảng cáo (macro %m) hay từ tính năng Chuyển dữ liệu.

GcpWrappedKeyInfo

Thông tin về khoá được bao bọc của Google Cloud Platform.

AwsWrappedKeyInfo

Thông tin khoá được bao bọc của Amazon Web Services.

CoordinatorKeyInfo

Thông tin chính cho khoá điều phối viên đã chọn.

Điều này không được hỗ trợ cho các phương thức IngestEvents, IngestAudienceMembers và RemoveAudienceMembers.

int64

Số lượng bản ghi không tải lên được vì một lý do nhất định.

ProcessingErrorReason

Lý do xảy ra lỗi của các bản ghi không thành công.

ErrorCount

Danh sách lỗi và số lượng lỗi theo từng lý do gây ra lỗi. Có thể không được điền sẵn trong một số trường hợp.

string

Không bắt buộc. Chuỗi tham chiếu dùng để xác định đích đến. Nếu bạn để trống trường này, sự kiện sẽ được gửi đến tất cả destinations trong yêu cầu.

string

Không bắt buộc. Giá trị nhận dạng riêng biệt của sự kiện này. Bắt buộc đối với những sự kiện được gửi dưới dạng một nguồn dữ liệu bổ sung cho lượt chuyển đổi thông qua thẻ.

Timestamp

Bắt buộc. Thời gian xảy ra sự kiện.

Timestamp

Không bắt buộc. Lần gần đây nhất sự kiện được cập nhật.

UserData

Không bắt buộc. Các phần dữ liệu do người dùng cung cấp, thể hiện người dùng mà sự kiện được liên kết.

Consent

Không bắt buộc. Thông tin về việc người dùng được liên kết có đồng ý với các loại đồng ý khác nhau hay không.

AdIdentifiers

Không bắt buộc. Giá trị nhận dạng và thông tin khác được dùng để so khớp sự kiện chuyển đổi với hoạt động khác trên mạng (chẳng hạn như lượt nhấp vào quảng cáo).

string

Không bắt buộc. Mã đơn vị tiền tệ được liên kết với tất cả giá trị bằng tiền trong sự kiện này.

EventSource

Không bắt buộc. Tín hiệu cho biết nơi xảy ra sự kiện (trên web, ứng dụng, tại cửa hàng, v.v.).

DeviceInfo

Không bắt buộc. Thông tin được thu thập về thiết bị đang được sử dụng (nếu có) khi sự kiện xảy ra.

CartData

Không bắt buộc. Thông tin về giao dịch và các mặt hàng liên quan đến sự kiện.

CustomVariable

Không bắt buộc. Thông tin bổ sung về cặp khoá/giá trị để gửi đến các vùng chứa lượt chuyển đổi (hành động chuyển đổi hoặc hoạt động trên Floodlight).

ExperimentalField

Không bắt buộc. Danh sách các cặp khoá/giá trị cho các trường thử nghiệm có thể cuối cùng sẽ được nâng cấp để trở thành một phần của API.

UserProperties

Không bắt buộc. Thông tin do nhà quảng cáo đánh giá về người dùng tại thời điểm xảy ra sự kiện.

string

Không bắt buộc. Tên của sự kiện. Bắt buộc đối với sự kiện GA4.

string

Không bắt buộc. Giá trị nhận dạng riêng biệt cho phiên bản người dùng của một ứng dụng web cho luồng dữ liệu web GA4 này.

string

Không bắt buộc. Giá trị nhận dạng riêng biệt cho một người dùng, do nhà quảng cáo xác định.

EventParameter

Không bắt buộc. Một nhóm gồm mọi thông số sự kiện sẽ được đưa vào sự kiện mà bạn chưa chỉ định bằng các trường có cấu trúc khác.

UserData

Không bắt buộc. Cùng loại dữ liệu được cung cấp trong user_data, nhưng được gắn cờ rõ ràng là do bên thứ ba cung cấp và không phải dữ liệu của nhà quảng cáo bên thứ nhất.

EventLocation

Không bắt buộc. Thông tin được thu thập về vị trí của người dùng khi sự kiện này xảy ra.

string

Không bắt buộc. Giá trị nhận dạng riêng biệt cho phiên bản người dùng của một ứng dụng khách cho luồng ứng dụng GA4 này.

double

Không bắt buộc. Giá trị lượt chuyển đổi được liên kết với sự kiện, đối với lượt chuyển đổi dựa trên giá trị.

double

Không bắt buộc. Số lượt chuyển đổi liên quan đến sự kiện, đối với lượt chuyển đổi dựa trên số lượt đếm.

string

Không bắt buộc. Bắt buộc đối với lượt bán hàng tại cửa hàng thực tế. Giá trị nhận dạng đại diện cho một cửa hàng thực tế nơi diễn ra sự kiện.

string

Không bắt buộc. Tên của thành phố nơi diễn ra sự kiện.

string

Không bắt buộc. Mã phân vùng theo ISO 3166-2 nơi diễn ra sự kiện.

string

Không bắt buộc. Mã khu vực CLDR gồm 2 chữ cái trong địa chỉ của người dùng.

string

Không bắt buộc. Mã tiểu lục địa theo định dạng UN M49 nơi xảy ra sự kiện.

string

Không bắt buộc. Mã châu lục theo định dạng UN M49 nơi diễn ra sự kiện.

string

Bắt buộc. Tên của thông số cần sử dụng.

string

Bắt buộc. Chuỗi biểu thị giá trị của thông số cần đặt.

string

Không bắt buộc. Tên của trường cần sử dụng.

string

Không bắt buộc. Giá trị của trường cần đặt.

KeyType

Bắt buộc. Loại thuật toán dùng để mã hoá dữ liệu.

string

Bắt buộc. Nhà cung cấp nhóm Workload Identity bắt buộc phải sử dụng KEK.

string

Bắt buộc. Mã tài nguyên Cloud Key Management Service của Google Cloud Platform. Phải ở định dạng projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} hoặc gcp-kms://projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}

string

Bắt buộc. Khoá mã hoá dữ liệu đã mã hoá được mã hoá base64.

string

Bắt buộc. Tên tài nguyên của giấy phép trực tiếp cho danh sách người dùng.

string

Bắt buộc. Tên tài nguyên của giấy phép toàn cầu cho danh sách người dùng.

string

Bắt buộc. Tên tài nguyên của UserList cần truy xuất. Định dạng: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

AdEvent

Bắt buộc. Bắt buộc (ít nhất 1). Danh sách các sự kiện quảng cáo.

EncryptionInfo

Không bắt buộc. Thông tin về các khoá mã hoá dùng để mã hoá dữ liệu.

bool

Không bắt buộc. Nếu đúng, yêu cầu sẽ được xác thực nhưng không được thực thi.

Destination

Bắt buộc. Danh sách đích đến để chuyển các thành viên trong đối tượng đến.

AudienceMember

Bắt buộc. Danh sách người dùng sẽ được gửi đến đích đến đã chỉ định. Bạn có thể gửi tối đa 10.000 tài nguyên AudienceMember trong một yêu cầu.

Consent

Không bắt buộc. Sự đồng ý ở cấp yêu cầu sẽ áp dụng cho tất cả người dùng trong yêu cầu. Mức độ đồng ý ở cấp người dùng sẽ ghi đè mức độ đồng ý ở cấp yêu cầu và có thể được chỉ định trong mỗi AudienceMember.

bool

Không bắt buộc. Chỉ dùng cho mục đích kiểm thử. Nếu true, yêu cầu sẽ được xác thực nhưng không được thực thi. Chỉ trả về lỗi, không trả về kết quả.

Encoding

Không bắt buộc. Bắt buộc đối với tệp tải lên UserData. Loại mã hoá của giá trị nhận dạng người dùng. Đối với giá trị nhận dạng người dùng đã băm, đây là loại mã hoá của chuỗi đã băm. Đối với giá trị nhận dạng người dùng được băm đã mã hoá, đây là loại mã hoá của chuỗi được mã hoá bên ngoài, nhưng không nhất thiết phải là chuỗi được băm bên trong. Tức là chuỗi được băm bên trong có thể được mã hoá theo cách khác với chuỗi được mã hoá bên ngoài. Đối với các tệp tải lên không phải UserData, trường này sẽ bị bỏ qua.

EncryptionInfo

Không bắt buộc. Thông tin mã hoá cho nội dung tải lên UserData. Nếu bạn không đặt, thì hệ thống sẽ giả định rằng thông tin nhận dạng được tải lên đã được băm nhưng chưa được mã hoá. Đối với các tệp tải lên không phải UserData, trường này sẽ bị bỏ qua.

TermsOfService

Không bắt buộc. Điều khoản dịch vụ mà người dùng đã chấp nhận/từ chối.

string

Mã nhận dạng được tạo tự động của yêu cầu.

Destination

Bắt buộc. Danh sách đích đến để gửi sự kiện đến.

Event

Bắt buộc. Danh sách các sự kiện cần gửi đến những đích đến được chỉ định. Bạn có thể gửi tối đa 2.000 Event tài nguyên trong một yêu cầu.

Consent

Không bắt buộc. Sự đồng ý ở cấp yêu cầu sẽ áp dụng cho tất cả người dùng trong yêu cầu. Mức độ đồng ý ở cấp người dùng sẽ ghi đè mức độ đồng ý ở cấp yêu cầu và có thể được chỉ định trong mỗi Event.

bool

Không bắt buộc. Chỉ dùng cho mục đích kiểm thử. Nếu true, yêu cầu sẽ được xác thực nhưng không được thực thi. Chỉ trả về lỗi, không trả về kết quả.

Encoding

Không bắt buộc. Bắt buộc đối với tệp tải lên UserData. Loại mã hoá của giá trị nhận dạng người dùng. Đối với giá trị nhận dạng người dùng đã băm, đây là loại mã hoá của chuỗi đã băm. Đối với mã nhận dạng người dùng được băm đã mã hoá, đây là loại mã hoá của chuỗi được mã hoá bên ngoài, nhưng không nhất thiết phải là chuỗi được băm bên trong. Tức là chuỗi được băm bên trong có thể được mã hoá theo cách khác với chuỗi được mã hoá bên ngoài. Đối với các tệp tải lên không phải UserData, trường này sẽ bị bỏ qua.

EncryptionInfo

Không bắt buộc. Thông tin mã hoá cho nội dung tải lên UserData. Nếu bạn không đặt, thì hệ thống sẽ giả định rằng thông tin nhận dạng được tải lên đã được băm nhưng chưa được mã hoá. Đối với các tệp tải lên không phải UserData, trường này sẽ bị bỏ qua.

string

Mã nhận dạng được tạo tự động của yêu cầu.

UploadKeyType

Bắt buộc. Không thể thay đổi. Loại khoá tải lên của danh sách người dùng này.

ContactIdInfo

Không bắt buộc. Thông tin bổ sung khi CONTACT_ID là một trong các upload_key_types.

MobileIdInfo

Không bắt buộc. Thông tin bổ sung khi MOBILE_ID là một trong các upload_key_types.

UserIdInfo

Không bắt buộc. Thông tin bổ sung khi USER_ID là một trong các upload_key_types.

PairIdInfo

Không bắt buộc. Thông tin bổ sung khi PAIR_ID là một trong các upload_key_types.

Tính năng này chỉ dành cho các đối tác dữ liệu.

PseudonymousIdInfo

Không bắt buộc. Thông tin bổ sung cho PSEUDONYMOUS_ID là một trong những upload_key_types.

PartnerAudienceInfo

Không bắt buộc. Thông tin bổ sung cho đối tượng của đối tác.

Tính năng này chỉ dành cho các đối tác dữ liệu.

string

Bắt buộc. Địa chỉ IP được ghi lại tại thời điểm khách hàng tương tác. Chấp nhận các định dạng chuỗi tiêu chuẩn cho cả IPv4 và IPv6.

Timestamp

Không bắt buộc. Thời gian tương tác đầu tiên được ghi lại từ địa chỉ IP này trong một phiên.

Timestamp

Không bắt buộc. Thời gian tương tác gần đây nhất được ghi lại từ địa chỉ IP này trong một phiên.

string

Không bắt buộc. Mã sản phẩm trong tài khoản Merchant Center.

int64

Không bắt buộc. Số lượng mặt hàng này được liên kết với sự kiện.

double

Không bắt buộc. Giá của từng đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và mọi khoản chiết khấu ở cấp giao dịch.

string

Không bắt buộc. Giá trị nhận dạng riêng biệt để tham chiếu đến mặt hàng.

ItemParameter

Không bắt buộc. Một nhóm gồm mọi thông số sự kiện liên quan đến một mặt hàng sẽ được đưa vào sự kiện mà bạn chưa chỉ định bằng các trường có cấu trúc khác.

string

Không bắt buộc. Mã truy cập Merchant Center được liên kết với mặt hàng. Đối với sự kiện Giao dịch tại cửa hàng thực tế, thông số này sẽ ghi đè giá trị được đặt ở cấp giỏ hàng. Trường này sẽ bị bỏ qua đối với các sự kiện khác.

string

Không bắt buộc. Nhãn nguồn cấp dữ liệu của nguồn cấp dữ liệu Merchant Center. Nếu bạn vẫn đang sử dụng quốc gia, thì bạn có thể sử dụng mã quốc gia gồm 2 chữ cái theo chuẩn ISO-3166-1 alpha-2. Đối với sự kiện Giao dịch tại cửa hàng thực tế, thông số này sẽ ghi đè giá trị được đặt ở cấp giỏ hàng. Trường này sẽ bị bỏ qua đối với các sự kiện khác.

string

Không bắt buộc. Mã ngôn ngữ theo tiêu chuẩn ISO 639-1 được liên kết với nguồn cấp dữ liệu Merchant Center nơi bạn tải các mặt hàng lên.

ItemCustomVariable

Không bắt buộc. Thông tin bổ sung về cặp khoá/giá trị cần gửi đến các vùng chứa lượt chuyển đổi (hành động chuyển đổi hoặc hoạt động Floodlight) khi theo dõi lượt chuyển đổi cho mỗi mặt hàng.

double

Không bắt buộc. Giá trị lượt chuyển đổi được liên kết với mặt hàng này trong sự kiện, trong trường hợp giá trị lượt chuyển đổi khác nhau đối với từng mặt hàng.

string

Không bắt buộc. Tên của biến tuỳ chỉnh cần đặt. Nếu không tìm thấy biến cho đích đến đã cho, biến đó sẽ bị bỏ qua.

string

Không bắt buộc. Giá trị cần lưu trữ cho biến tuỳ chỉnh.

string

Không bắt buộc. Chuỗi tham chiếu dùng để xác định Event.destination_references nào mà biến tuỳ chỉnh sẽ được gửi đến. Nếu bạn để trống, Event.destination_references sẽ được sử dụng.

string

Bắt buộc. Tên của thông số cần sử dụng.

string

Bắt buộc. Chuỗi biểu thị giá trị của thông số cần đặt.

string

Bắt buộc. Tài khoản có giấy phép đang được truy vấn. Phải có định dạng accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

string

Không bắt buộc. Một chuỗi bộ lọc để áp dụng cho yêu cầu danh sách. Tất cả các trường phải nằm ở phía bên trái của mỗi điều kiện (ví dụ: user_list_id = 123). Bạn phải chỉ định các trường bằng cách sử dụng tất cả camel case hoặc tất cả snake case. Không sử dụng kết hợp giữa kiểu lạc đà và kiểu rắn.

Các thao tác được hỗ trợ:

• AND
• =
• !=
• >
• >=
• <
• <=

Các hàm được hỗ trợ: – IN(field, value1, value2, ...): trả về giá trị true nếu trường khớp với bất kỳ giá trị nào. Ví dụ: IN(user_list_id, 123, 456)

Trường không được hỗ trợ:

• name (thay vào đó, hãy sử dụng phương thức get)
• historical_pricings và tất cả các trường phụ của nó
• pricing.start_time
• pricing.end_time

int32

Không bắt buộc. Số lượng giấy phép tối đa cần trả về trên mỗi trang. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 50 giấy phép. Giá trị tối đa là 1000; các giá trị trên 1000 sẽ được chuyển đổi thành 1000.

string

Không bắt buộc. Mã thông báo trang nhận được từ một lệnh gọi ListUserListDirectLicense trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListUserListDirectLicense phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

UserListDirectLicense

Giấy phép cho danh sách người dùng đã cho trong yêu cầu.

string

Một mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có các trang tiếp theo.

string

Bắt buộc. Giấy phép toàn cầu mà thông tin khách hàng đang được truy vấn. Phải ở định dạng accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}. Để liệt kê tất cả thông tin khách hàng có giấy phép trên toàn cầu trong một tài khoản, hãy thay thế mã giấy phép trên toàn cầu của danh sách người dùng bằng dấu "-" (ví dụ: accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-)

string

Không bắt buộc. Một chuỗi bộ lọc để áp dụng cho yêu cầu danh sách. Tất cả các trường phải nằm ở phía bên trái của mỗi điều kiện (ví dụ: user_list_id = 123). Bạn phải chỉ định các trường bằng cách sử dụng tất cả camel case hoặc tất cả snake case. Không sử dụng kết hợp giữa kiểu lạc đà và kiểu rắn.

Các thao tác được hỗ trợ:

• AND
• =
• !=
• >
• >=
• <
• <=

Các hàm được hỗ trợ: – IN(field, value1, value2, ...): trả về giá trị true nếu trường khớp với bất kỳ giá trị nào. Ví dụ: IN(user_list_id, 123, 456)

Trường không được hỗ trợ:

• name (thay vào đó, hãy sử dụng phương thức get)
• historical_pricings và tất cả các trường phụ của nó
• pricing.start_time
• pricing.end_time

int32

Không bắt buộc. Số lượng giấy phép tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 50 giấy phép. Giá trị tối đa là 1000; các giá trị trên 1000 sẽ được chuyển đổi thành 1000.

string

Không bắt buộc. Mã thông báo trang nhận được từ một lệnh gọi ListUserListDirectLicense trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListUserListDirectLicense phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

UserListGlobalLicenseCustomerInfo

Thông tin khách hàng cho giấy phép cụ thể trong yêu cầu.

string

Một mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có các trang tiếp theo.

string

Bắt buộc. Tài khoản có giấy phép đang được truy vấn. Phải có định dạng accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

string

Không bắt buộc. Một chuỗi bộ lọc để áp dụng cho yêu cầu danh sách. Tất cả các trường phải nằm ở phía bên trái của mỗi điều kiện (ví dụ: user_list_id = 123). Bạn phải chỉ định các trường bằng cách sử dụng tất cả camel case hoặc tất cả snake case. Không sử dụng kết hợp giữa kiểu lạc đà và kiểu rắn.

Các thao tác được hỗ trợ:

• AND
• =
• !=
• >
• >=
• <
• <=

Các hàm được hỗ trợ: – IN(field, value1, value2, ...): trả về giá trị true nếu trường khớp với bất kỳ giá trị nào. Ví dụ: IN(user_list_id, 123, 456)

Trường không được hỗ trợ:

• name (thay vào đó, hãy sử dụng phương thức get)
• historical_pricings và tất cả các trường phụ của nó
• pricing.start_time
• pricing.end_time

int32

Không bắt buộc. Số lượng giấy phép tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 50 giấy phép. Giá trị tối đa là 1000; các giá trị trên 1000 sẽ được chuyển đổi thành 1000.

string

Không bắt buộc. Mã thông báo trang nhận được từ một lệnh gọi ListUserListGlobalLicense trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListUserListDirectLicense phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

UserListGlobalLicense

Giấy phép cho danh sách người dùng đã cho trong yêu cầu.

string

Một mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có các trang tiếp theo.

string

Bắt buộc. Tài khoản chính sở hữu bộ sưu tập danh sách người dùng này. Định dạng: accountTypes/{account_type}/accounts/{account}

int32

Không bắt buộc. Số lượng danh sách người dùng tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định, tối đa 50 danh sách người dùng sẽ được trả về. Giá trị tối đa là 1000; các giá trị trên 1000 sẽ được chuyển đổi thành 1000.

string

Không bắt buộc. Mã thông báo trang nhận được từ một lệnh gọi ListUserLists trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListUserLists phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

string

Không bắt buộc. Một chuỗi bộ lọc. Tất cả các trường phải nằm ở phía bên trái của mỗi điều kiện (ví dụ: display_name = "list 1"). Bạn phải chỉ định các trường bằng cách sử dụng tất cả camel case hoặc tất cả snake case. Không sử dụng kết hợp giữa kiểu lạc đà và kiểu rắn.

Các thao tác được hỗ trợ:

• AND
• =
• !=
• >
• >=
• <
• <=
• : (có)

Các hàm được hỗ trợ: – IN(field, value1, value2, ...): trả về giá trị true nếu trường khớp với bất kỳ giá trị nào. Ví dụ: IN(display_name, "name1", "name2")

Các trường được hỗ trợ:

• id
• display_name
• description
• membership_status
• integration_code
• access_reason
• ingested_user_list_info.upload_key_types

UserList

Danh sách người dùng từ tài khoản được chỉ định.

string

Một mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có các trang tiếp theo.

string

Bắt buộc. Danh sách mã thiết bị di động (mã nhận dạng cho quảng cáo/IDFA). Bạn có thể cung cấp tối đa 10 mobileIds trong một AudienceMember.

DataSourceType

Không bắt buộc. Không thể thay đổi. Nguồn của dữ liệu tải lên.

KeySpace

Bắt buộc. Không thể thay đổi. Không gian khoá của mã nhận dạng thiết bị di động.

string

Bắt buộc. Không thể thay đổi. Một chuỗi xác định duy nhất một ứng dụng di động mà từ đó dữ liệu được thu thập.

string

Bắt buộc. Dữ liệu PII do Clean Room cung cấp, được băm bằng SHA256 và mã hoá bằng mật mã giao hoán EC bằng khoá của nhà xuất bản cho danh sách người dùng PAIR. Bạn có thể cung cấp tối đa 10 pairIds trong một AudienceMember.

int64

Bắt buộc. Không thể thay đổi. Xác định nhà xuất bản mà danh sách người dùng Điều chỉnh danh tính nhà quảng cáo của nhà xuất bản được điều chỉnh. Trường này do nhà cung cấp phòng sạch cung cấp và chỉ có giá trị duy nhất trong phạm vi của phòng sạch đó. Bạn không thể dùng giá trị nhận dạng này làm giá trị nhận dạng chung trên nhiều phòng sạch.

string

Bắt buộc. Tên mô tả của nhà xuất bản sẽ xuất hiện trong giao diện người dùng để có trải nghiệm nhắm mục tiêu tốt hơn.

int32

Bắt buộc. Trường này biểu thị tỷ lệ phần trăm mức độ trùng khớp thành viên của danh sách người dùng này với dữ liệu tương ứng của bên thứ nhất của nhà xuất bản. Phải nằm trong khoảng từ 0 đến 100.

int64

Không bắt buộc. Số lượng bản ghi dữ liệu của bên thứ nhất của nhà quảng cáo đã được tải lên một nhà cung cấp phòng sạch. Điều này không biểu thị quy mô của danh sách người dùng PAIR.

string

Bắt buộc. Không thể thay đổi. Xác định mối quan hệ duy nhất giữa nhà quảng cáo và nhà xuất bản với một nhà cung cấp phòng sạch hoặc trên nhiều nhà cung cấp phòng sạch.

PartnerAudienceSource

Bắt buộc. Không thể thay đổi. Nguồn của đối tượng đối tác.

string

Không bắt buộc. Tên đối tác thương mại. Chỉ được phép nếu partner_audience_source là COMMERCE_AUDIENCE.

string

Bắt buộc. Giá trị nhận dạng của tài khoản khách hàng trong không gian mã nhận dạng của đối tác.

string

Không bắt buộc. Tên của tài khoản.

string

Không bắt buộc. Loại tài khoản. Có thể dùng để phân biệt giữa tài khoản của nhà quảng cáo và tài khoản cấp doanh nghiệp, chẳng hạn.

string

Giá trị nhận dạng. Tên của đường liên kết đến đối tác. Định dạng: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

string

Chỉ có đầu ra. Mã nhận dạng đường liên kết đến đối tác.

ProductAccount

Bắt buộc. Tài khoản sở hữu cấp quyền truy cập cho tài khoản đối tác.

ProductAccount

Bắt buộc. Tài khoản đối tác được tài khoản sở hữu cấp quyền truy cập.

FeatureSet

Không bắt buộc. Không thể thay đổi. Tập hợp các tính năng được hỗ trợ cho đường liên kết đến đối tác. Nếu bạn không chỉ định, hành vi mặc định của hệ thống sẽ là FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT.

PartnerCustomerAccount

Không bắt buộc. Tài khoản khách hàng trong hệ thống của đối tác. Đây là yêu cầu bắt buộc đối với các mối liên kết với đối tác có bộ tính năng FEATURE_SET_AD_EVENT_MANAGEMENT.

PartnerLinkMetadata

Không bắt buộc. Siêu dữ liệu liên kết với đường liên kết đến đối tác. Đây là thông tin không bắt buộc và chỉ được chấp nhận đối với những đường liên kết đến đối tác có biểu tượng FEATURE_SET_AD_EVENT_MANAGEMENT.

PartnerCustomerAccount

Không bắt buộc. Danh sách tài khoản ngầm định.

string

Bắt buộc. Danh sách giá trị nhận dạng do nhà xuất bản cung cấp cho một người dùng.

Product

Không dùng nữa. Thay vào đó, hãy sử dụng account_type.

string

Bắt buộc. Mã nhận dạng của tài khoản. Ví dụ: mã tài khoản Google Ads của bạn.

AccountType

Bắt buộc. Loại tài khoản. Ví dụ: GOOGLE_ADS. Bạn phải cung cấp account_type hoặc product (không dùng nữa). Nếu bạn đặt cả hai, thì các giá trị phải khớp nhau.

SyncStatus

Chỉ có đầu ra. Trạng thái đồng bộ hoá của danh sách người dùng.

int64

Không bắt buộc. Không thể thay đổi. Số lượng bản ghi có tính phí (ví dụ: đã tải lên hoặc đã khớp).

Destination

Bắt buộc. Danh sách đích đến mà bạn muốn xoá người dùng.

AudienceMember

Bắt buộc. Danh sách người dùng cần xoá.

bool

Không bắt buộc. Chỉ dùng cho mục đích kiểm thử. Nếu true, yêu cầu sẽ được xác thực nhưng không được thực thi. Chỉ trả về lỗi, không trả về kết quả.

Encoding

Không bắt buộc. Bắt buộc đối với tệp tải lên UserData. Loại mã hoá của giá trị nhận dạng người dùng. Chỉ áp dụng cho lớp mã hoá bên ngoài đối với giá trị nhận dạng người dùng được mã hoá. Đối với các tệp tải lên không phải UserData, trường này sẽ bị bỏ qua.

EncryptionInfo

Không bắt buộc. Thông tin mã hoá cho nội dung tải lên UserData. Nếu bạn không đặt, thì hệ thống sẽ giả định rằng thông tin nhận dạng được tải lên đã được băm nhưng chưa được mã hoá. Đối với các tệp tải lên không phải UserData, trường này sẽ bị bỏ qua.

string

Mã nhận dạng được tạo tự động của yêu cầu.

Destination

Một đích đến trong yêu cầu API DM.

RequestStatus

Trạng thái yêu cầu của đích đến.

ErrorInfo

Một lỗi thông tin lỗi chứa lý do lỗi và số lượng lỗi liên quan đến quá trình tải lên. Chỉ được điền sẵn nếu request_status là FAILED hoặc PARTIAL_SUCCESS. Trường này không được điền sẵn trong khi yêu cầu có request_status là PROCESSING.

WarningInfo

Thông tin cảnh báo chứa lý do cảnh báo và số lượng cảnh báo liên quan đến tệp tải lên. Trường này không được điền sẵn trong khi yêu cầu có request_status là PROCESSING.

IngestAudienceMembersStatus

Trạng thái của yêu cầu về việc tiếp nhận hội viên là khán giả.

IngestEventsStatus

Trạng thái của yêu cầu sự kiện truyền trực tiếp.

RemoveAudienceMembersStatus

Trạng thái của yêu cầu xoá hội viên là khán giả.

DataType

Loại dữ liệu.

int64

Số lượng cho loại dữ liệu này.

IngestUserDataStatus

Trạng thái của quá trình tiếp nhận dữ liệu người dùng vào đích đến.

IngestMobileDataStatus

Trạng thái của quá trình nhập dữ liệu di động vào đích đến.

IngestPairDataStatus

Trạng thái của quá trình nhập dữ liệu theo cặp vào đích đến.

IngestUserIdDataStatus

Trạng thái của việc truyền dữ liệu mã nhận dạng người dùng đến đích đến.

IngestPpidDataStatus

Trạng thái của quá trình nhập dữ liệu ppid vào đích đến.

IngestCompositeDataStatus

Trạng thái của quá trình nhập dữ liệu tổng hợp vào đích đến.

int64

Tổng số thành viên đối tượng được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả thành viên đối tượng trong yêu cầu, bất kể họ có được nhập thành công hay không.

DataTypeCount

Tổng số loại dữ liệu được gửi trong yêu cầu tải lên cho đích đến, được phân tích theo loại dữ liệu. Bao gồm tất cả các loại dữ liệu trong yêu cầu, bất kể chúng có được nhập thành công hay không.

MatchRateRange

Phạm vi tỷ lệ khớp của nội dung tải lên.

int64

Tổng số sự kiện được gửi trong yêu cầu tải lên. Bao gồm tất cả sự kiện trong yêu cầu, bất kể sự kiện đó có được nhập thành công hay không.

int64

Tổng số thành viên đối tượng được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả thành viên đối tượng trong yêu cầu, bất kể họ có được nhập thành công hay không.

int64

Tổng số mã nhận dạng thiết bị di động được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả mã nhận dạng thiết bị di động trong yêu cầu, bất kể mã nhận dạng đó có được nhập thành công hay không.

int64

Tổng số thành viên đối tượng được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả thành viên đối tượng trong yêu cầu, bất kể họ có được nhập thành công hay không.

int64

Tổng số mã nhận dạng theo cặp được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả mã nhận dạng theo cặp trong yêu cầu, bất kể mã đó có được nhập thành công hay không.

int64

Tổng số thành viên đối tượng được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả thành viên đối tượng trong yêu cầu, bất kể họ có được nhập thành công hay không.

int64

Tổng số ppid được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả ppid trong yêu cầu, bất kể chúng có được nhập thành công hay không.

int64

Tổng số thành viên đối tượng được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả thành viên đối tượng trong yêu cầu, bất kể họ có được nhập thành công hay không.

int64

Tổng số giá trị nhận dạng người dùng được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả giá trị nhận dạng người dùng trong yêu cầu, bất kể giá trị đó có được truyền thành công hay không.

MatchRateRange

Phạm vi tỷ lệ khớp của nội dung tải lên.

int64

Tổng số thành viên đối tượng được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả thành viên đối tượng trong yêu cầu, bất kể họ có được nhập thành công hay không.

int64

Tổng số mã nhận dạng người dùng được gửi trong yêu cầu tải lên cho đích đến. Bao gồm tất cả mã nhận dạng người dùng trong yêu cầu, bất kể mã nhận dạng đó có được nhập thành công hay không.

RemoveUserDataStatus

Trạng thái xoá dữ liệu người dùng khỏi đích đến.

RemoveMobileDataStatus

Trạng thái xoá dữ liệu di động khỏi đích đến.

RemovePairDataStatus

Trạng thái xoá dữ liệu cặp khỏi đích đến.

RemoveUserIdDataStatus

Trạng thái xoá dữ liệu mã nhận dạng người dùng khỏi đích đến.

RemovePpidDataStatus

Trạng thái xoá dữ liệu ppid khỏi đích đến.

RemoveCompositeDataStatus

Trạng thái xoá dữ liệu kết hợp khỏi đích đến.

int64

Tổng số thành viên đối tượng được gửi trong yêu cầu xoá. Bao gồm tất cả thành viên trong đối tượng có trong yêu cầu, bất kể họ có được xoá thành công hay không.

DataTypeCount

Tổng số loại dữ liệu được gửi trong yêu cầu xoá, được phân tích theo loại dữ liệu. Bao gồm tất cả các loại dữ liệu trong yêu cầu, bất kể chúng đã được xoá thành công hay chưa.

int64

Tổng số thành viên đối tượng được gửi trong yêu cầu xoá. Bao gồm tất cả thành viên trong đối tượng có trong yêu cầu, bất kể họ có được xoá thành công hay không.

int64

Tổng số mã nhận dạng thiết bị di động được gửi trong yêu cầu gỡ bỏ. Bao gồm tất cả mã nhận dạng thiết bị di động trong yêu cầu, bất kể mã nhận dạng đó có được xoá thành công hay không.

int64

Tổng số thành viên đối tượng được gửi trong yêu cầu xoá. Bao gồm tất cả thành viên trong đối tượng có trong yêu cầu, bất kể họ có được xoá thành công hay không.

int64

Tổng số mã nhận dạng cặp được gửi trong yêu cầu gỡ bỏ. Bao gồm tất cả mã nhận dạng theo cặp trong yêu cầu, bất kể mã nhận dạng đó có được xoá thành công hay không.

int64

Tổng số thành viên đối tượng được gửi trong yêu cầu xoá. Bao gồm tất cả thành viên trong đối tượng có trong yêu cầu, bất kể họ có được xoá thành công hay không.

int64

Tổng số ppid được gửi trong yêu cầu gỡ bỏ. Bao gồm tất cả ppid trong yêu cầu, bất kể yêu cầu có được xoá thành công hay không.

int64

Tổng số thành viên đối tượng được gửi trong yêu cầu xoá. Bao gồm tất cả thành viên trong đối tượng có trong yêu cầu, bất kể họ có được xoá thành công hay không.

int64

Tổng số giá trị nhận dạng người dùng được gửi trong yêu cầu xoá. Bao gồm tất cả giá trị nhận dạng người dùng trong yêu cầu, bất kể giá trị nhận dạng đó có được xoá thành công hay không.

int64

Tổng số thành viên đối tượng được gửi trong yêu cầu xoá. Bao gồm tất cả thành viên trong đối tượng có trong yêu cầu, bất kể họ có được xoá thành công hay không.

int64

Tổng số mã nhận dạng người dùng được gửi trong yêu cầu gỡ bỏ. Bao gồm tất cả mã nhận dạng người dùng trong yêu cầu, bất kể mã nhận dạng đó có được xoá thành công hay không.

string

Bắt buộc. Tài khoản cha mẹ sở hữu danh sách người dùng. Định dạng accountTypes/{account_type}/accounts/{account}

Baseline

Bắt buộc. Đường cơ sở cho thông tin chi tiết được yêu cầu.

string

Bắt buộc. Mã danh sách người dùng mà bạn yêu cầu thông tin chi tiết.

MarketingDataInsight

Chứa thông tin chi tiết về dữ liệu tiếp thị.

AudienceInsightsDimension

Phương diện mà thông tin chi tiết thuộc về.

MarketingDataInsightsAttribute

Thông tin chi tiết về các giá trị của một phương diện nhất định.

int64

Mã nhận dạng mối quan tâm của người dùng.

float

Mức tăng mà đối tượng có được cho giá trị thuộc tính so với đường cơ sở. Phạm vi [0-1].

AgeRange

Phạm vi độ tuổi của đối tượng mà bạn cung cấp mức tăng.

Gender

Giới tính của đối tượng mà bạn cung cấp mức tăng.

string

Bắt buộc. Bắt buộc. Mã yêu cầu của yêu cầu Data Manager API.

RequestStatusPerDestination

Danh sách trạng thái yêu cầu cho mỗi đích đến. Thứ tự của các trạng thái khớp với thứ tự của các đích đến trong yêu cầu ban đầu.

string

Bắt buộc. Tài khoản để tìm kiếm các mối liên kết với đối tác. Nếu bạn không chỉ định filter, thì tất cả các mối liên kết với đối tác mà tài khoản này là owning_account hoặc partner_account đều được trả về.

Định dạng accountTypes/{account_type}/accounts/{account}

int32

Số lượng đường liên kết đến đối tác tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định, tối đa 10 đường liên kết đến đối tác sẽ được trả về. Giá trị tối đa là 100; các giá trị trên 100 sẽ được chuyển đổi thành 100.

string

Mã thông báo trang nhận được từ một lệnh gọi SearchPartnerLinks trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho SearchPartnerLinks phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

string

Không bắt buộc. Một chuỗi bộ lọc. Tất cả các trường phải nằm ở phía bên trái của mỗi điều kiện (ví dụ: partner_link_id = 123456789). Bạn phải chỉ định các trường bằng cách sử dụng tất cả camel case hoặc tất cả snake case. Không sử dụng kết hợp giữa kiểu lạc đà và kiểu rắn.

Các thao tác được hỗ trợ:

• AND
• =
• !=

Các trường được hỗ trợ:

• partner_link_id
• owning_account.account_type
• owning_account.account_id
• partner_account.account_type
• partner_account.account_id

Ví dụ: owning_account.account_type = "GOOGLE_ADS" AND partner_account.account_id = 987654321

PartnerLink

Các đường liên kết đến đối tác cho tài khoản đã cho.

string

Một mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có các trang tiếp theo.

int64

Chỉ có đầu ra. Số lượng thành viên ước tính trong danh sách người dùng này, trên Mạng Hiển thị của Google.

int64

Chỉ có đầu ra. Số lượng thành viên ước tính trong danh sách người dùng này trong miền google.com. Đây là những thành viên mà bạn có thể nhắm đến trong chiến dịch Tìm kiếm.

int64

Chỉ có đầu ra. Số lượng thành viên ước tính trong danh sách người dùng này trên YouTube.

int64

Chỉ có đầu ra. Số lượng thành viên ước tính trong danh sách người dùng này trên Gmail.

bool

Chỉ có đầu ra. Cho biết danh sách người dùng này đủ điều kiện cho Mạng Hiển thị của Google.

bool

Không bắt buộc. Cho biết liệu danh sách người dùng này có đủ điều kiện cho Mạng Tìm kiếm của Google hay không.

TermsOfServiceStatus

Không bắt buộc. Điều khoản dịch vụ về tính năng So khớp khách hàng: https://support.google.com/adspolicy/answer/6299717. Bạn phải chấp nhận điều này khi nhập UserData hoặc MobileData. Bạn không bắt buộc phải điền trường này cho Danh sách người dùng Partner Match.

UserListDirectLicense

Bắt buộc. Trường name của giấy phép được dùng để xác định giấy phép cần cập nhật.

FieldMask

Không bắt buộc. Danh sách các trường cần cập nhật. Ký tự đặc biệt * không được hỗ trợ và lỗi INVALID_UPDATE_MASK sẽ xảy ra nếu bạn sử dụng ký tự này.

UserListGlobalLicense

Bắt buộc. Trường name của giấy phép được dùng để xác định giấy phép cần cập nhật.

FieldMask

Không bắt buộc. Danh sách các trường cần cập nhật. Ký tự đặc biệt * không được hỗ trợ và lỗi INVALID_UPDATE_MASK sẽ xảy ra nếu bạn sử dụng ký tự này.

UserList

Bắt buộc. Danh sách người dùng cần cập nhật.

Trường name của danh sách người dùng được dùng để xác định danh sách người dùng cần cập nhật. Định dạng: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

FieldMask

Không bắt buộc. Danh sách các trường cần cập nhật.

bool

Không bắt buộc. Nếu đúng, yêu cầu sẽ được xác thực nhưng không được thực thi.

UserIdentifier

Bắt buộc. Giá trị nhận dạng của người dùng. Bạn có thể cung cấp nhiều phiên bản của cùng một loại dữ liệu (ví dụ: nhiều địa chỉ email). Để tăng khả năng trùng khớp, hãy cung cấp càng nhiều giá trị nhận dạng càng tốt. Bạn có thể cung cấp tối đa 10 userIdentifiers trong một AudienceMember hoặc Event.

string

Bắt buộc. Giá trị nhận dạng riêng biệt cho một người dùng, do nhà quảng cáo xác định.

DataSourceType

Không bắt buộc. Không thể thay đổi. Nguồn của dữ liệu tải lên.

string

Địa chỉ email đã băm bằng hàm băm SHA-256 sau khi chuẩn hoá.

string

Số điện thoại đã băm bằng hàm băm SHA-256 sau khi chuẩn hoá (tiêu chuẩn E164).

AddressInfo

Các thành phần đã biết trong địa chỉ của người dùng. Chứa một nhóm giá trị nhận dạng được so khớp cùng một lúc.

string

Giá trị nhận dạng. Tên tài nguyên của danh sách người dùng. Định dạng: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

int64

Chỉ có đầu ra. Mã nhận dạng duy nhất của danh sách người dùng.

bool

Chỉ có đầu ra. Một lựa chọn cho biết liệu người dùng có thể chỉnh sửa danh sách hay không.

Duration

Không bắt buộc. Khoảng thời gian mà người dùng vẫn nằm trong danh sách người dùng. Thời lượng hợp lệ phải là bội số chính xác của 24 giờ (86400 giây). Nếu bạn cung cấp một giá trị không phải là bội số chính xác của 24 giờ, thì sẽ xảy ra lỗi INVALID_ARGUMENT.

AccessReason

Chỉ có đầu ra. Lý do tài khoản này được cấp quyền truy cập vào danh sách.

SizeInfo

Chỉ có đầu ra. Số lượng thành viên ước tính trong danh sách người dùng này ở các mạng mục tiêu khác nhau.

TargetNetworkInfo

Không bắt buộc. Thông tin về điều kiện sử dụng cho các mạng mục tiêu.

string

Bắt buộc. Tên hiển thị của danh sách người dùng.

string

Không bắt buộc. Nội dung mô tả danh sách người dùng.

MembershipStatus

Không bắt buộc. Trạng thái thành viên của danh sách người dùng này.

string

Không bắt buộc. Mã nhận dạng từ hệ thống bên ngoài. Người bán danh sách người dùng sử dụng mã này để tương quan các mã nhận dạng trên hệ thống của họ.

ClosingReason

Chỉ có đầu ra. Lý do khiến trạng thái thành viên của danh sách người dùng này là đã đóng.

AccessStatus

Không bắt buộc. Cho biết liệu chế độ chia sẻ này có còn được bật hay không. Khi một danh sách người dùng được chia sẻ với tài khoản, trường này sẽ được đặt thành ENABLED. Sau đó, chủ sở hữu danh sách người dùng có thể quyết định thu hồi quyền chia sẻ và đặt danh sách ở chế độ DISABLED.

IngestedUserListInfo

Không bắt buộc. Đại diện cho danh sách người dùng được điền sẵn bằng dữ liệu do người dùng nhập.

string

Giá trị nhận dạng. Tên tài nguyên của giấy phép trực tiếp cho danh sách người dùng.

string

Chỉ có đầu ra. Tên của danh sách người dùng được cấp phép.

Trường này ở chế độ chỉ đọc.

string

Chỉ có đầu ra. Tên của khách hàng mà danh sách người dùng đang được cấp phép.

Trường này ở chế độ chỉ đọc.

UserListLicensePricing

Không bắt buộc. Giá UserListDirectLicense.

UserListLicensePricing

Chỉ có đầu ra. Nhật ký định giá của giấy phép danh sách người dùng này.

Trường này ở chế độ chỉ đọc.

UserListLicenseMetrics

Chỉ có đầu ra. Các chỉ số liên quan đến giấy phép này

Trường này ở chế độ chỉ đọc và chỉ được điền sẵn nếu bạn đặt ngày bắt đầu và ngày kết thúc trong lệnh gọi ListUserListDirectLicenses

int64

Không thể thay đổi. Mã nhận dạng của danh sách người dùng đang được cấp phép.

UserListLicenseClientAccountType

Không thể thay đổi. Loại tài khoản của khách hàng mà danh sách người dùng đang được cấp phép.

int64

Không thể thay đổi. Mã nhận dạng khách hàng của khách hàng mà danh sách người dùng đang được cấp phép.

UserListLicenseStatus

Không bắt buộc. Trạng thái của UserListDirectLicense – ENABLED hoặc DISABLED.