Bạn có thể truy cập vào mã nhận dạng của bên thứ nhất của nhà xuất bản cho web và xoá dữ liệu nhắm mục tiêu quảng cáo được liên kết.
Truy cập vào mã nhận dạng của bên thứ nhất của nhà xuất bản trên web
Bạn có thể truy cập vào mã nhận dạng của bên thứ nhất của nhà xuất bản trên web ngay từ các cookie của bên thứ nhất do JavaScript đặt trong miền của nhà xuất bản. Mã nhận dạng dành cho mục đích sử dụng bên ngoài của các nhà xuất bản và đối tác của chúng tôi có trong cookie __gpi. Cookie còn lại (có tên __gads) không dành cho mục đích sử dụng bên ngoài của các nhà xuất bản hoặc đối tác của chúng tôi, và không được phép sử dụng cho mục đích cá nhân hoá.
Giá trị của cookie __gpi có dạng như sau:
UID=<unique_user_ID>:T=<creation_unix_timestamp_in_seconds>:RT=<refresh_unix_timestamp_in_seconds>:S=<google_generated_authenticity_signature>
Ví dụ về giá trị __gpi:
UID=00000a1b2c3def45:T=1709171636:RT=1709171636:S=ALNI_Ma_CBr2wmXJhLdNKG9z4FWhjVVIog
Giá trị của mã nhận dạng (UID) và dấu thời gian (T) là các thành phần duy nhất dành cho mục đích sử dụng bên ngoài của các nhà xuất bản và đối tác của chúng tôi:
- UID hiện là một chuỗi thập lục phân gồm 16 ký tự, nhưng độ dài không được coi là ổn định và có thể thay đổi theo thời gian.
- T là một số nguyên cơ số 10 biểu thị dấu thời gian Unix của việc tạo mã nhận dạng.
Hai thành phần còn lại là thông tin triển khai nội bộ có thể thay đổi và không nên dùng làm căn cứ.
Cookie __gpi và __gads hiện đều có thời gian tồn tại tối đa là 13 tháng, trừ phi trình duyệt có thời hạn xoá cookie sớm hơn (chẳng hạn như giới hạn ITP của Safari đối với cookie do JavaScript đặt). Nếu cookie bị xoá, Google sẽ cố gắng điền lại cookie bằng các giá trị mới (khi được phép).
Ngoài __gpi và __gads, hộp cookie cũng có thể chứa cookie chọn không tham gia của người dùng __gpi_opt_out. Nếu giá trị là 1, thì người dùng đã tắt tính năng cá nhân hoá cho Google Ads trên miền đó (thông qua chế độ kiểm soát Lựa chọn quảng cáo của Google).
Trước khi truy cập vào các cookie đó, bạn phải đảm bảo rằng việc sử dụng cookie tuân thủ mọi luật, chỉ thị, quy định và quy tắc hiện hành về quyền riêng tư, bảo mật dữ liệu và bảo vệ dữ liệu trong bất kỳ khu vực tài phán nào có liên quan.
Xem ví dụ về phương thức JavaScript để truy xuất mã nhận dạng
/**
* Trả về Mã nhận dạng của bên thứ nhất của nhà xuất bản và Dấu thời gian.
* @returns {{UID: string|undefined, T: string|undefined}} Một đối tượng
* chứa chuỗi UID và Dấu thời gian, nếu có.
*/
function getPublisherFirstPartyIdAndCreationTimestamp() {
// Lấy khoá-giá trị cookie
const gpiCookie = document.cookie.split('; ').find(cookie => cookie.startsWith('__gpi='));
if (!gpiCookie) {
return {UID: undefined, T: undefined};
}
// Sử dụng biểu thức chính quy để phân tích cú pháp
const regex_match = gpiCookie.match(/UID=([^:]+):T=([^:]+)/);
if (!regex_match) {
return {UID: undefined, T: undefined};
}
// Trả về các giá trị đã trích xuất
return {
UID: regex_match[1],
T: regex_match[2]
};
}
Xem ví dụ về cách sử dụng
try {
const parsedValues = getPublisherFirstPartyIdAndCreationTimestamp();
console.log(parsedValues);
console.log(parsedValues['UID']); // Giá trị của mã nhận dạng
console.log(parsedValues['T']); // Dấu thời gian tạo
} catch (error) {
console.error(error.message);
}Xoá dữ liệu người dùng được liên kết với mã nhận dạng của bên thứ nhất của nhà xuất bản trên web
Nhà xuất bản có thể yêu cầu xoá dữ liệu người dùng liên kết với một mã nhận dạng của bên thứ nhất cụ thể. Bạn có thể sử dụng API xoá dữ liệu để gửi yêu cầu cho một giá trị nhận dạng duy nhất. Bạn có hai lựa chọn. Lựa chọn 1 hỗ trợ Khuôn khổ yêu cầu xoá dữ liệu của IAB.
Lựa chọn 1 (hỗ trợ Khuôn khổ yêu cầu xoá dữ liệu của IAB)
dsrdelete.json.dsrdelete.json rồi lưu trữ tệp này ở thư mục gốc của miền. Bạn có thể tìm hiểu thêm về tệp dsrdelete.json, cũng như các trường bắt buộc và không bắt buộc của tệp này trong tài liệu của IAB.Gửi yêu cầu
Thuộc tính bắt buộc
Hãy xem xét các thuộc tính bắt buộc cho yêu cầu xoá dữ liệu trong bảng sau. Để biết đầy đủ thông tin chi tiết về các tham số, mã mẫu và các yêu cầu khác, hãy tham khảo Khuôn khổ yêu cầu xoá dữ liệu của IAB.
| Thuộc tính | Mô tả | Giá trị mẫu |
|---|---|---|
| sub.identifierType | Loại giá trị nhận dạng | sco_domain |
| sub.identifierValue | Giá trị nhận dạng mà bạn đang yêu cầu xoá | 0000128ff97be809 |
| sub.identifierFormat | Định dạng của giá trị nhận dạng người dùng | plaintext |
Cách 2 (Đã ngừng hoạt động)
Để yêu cầu xoá dữ liệu liên kết với thành phần UID của một __gpi cụ thể, nhà xuất bản phải gửi một yêu cầu HTTPS ở dạng sau:
https://securepubads.g.doubleclick.net/user_data_deletion?id={id_value}&iu={network_code}&idtype=sco
Lưu ý các giá trị sau cho dạng này:
- id là giá trị của mã nhận dạng. Đây phải là một số thập lục phân gồm 16 ký tự và là thành phần UID được truy xuất bằng phương thức truy cập được mô tả ở trên.
- iu là mã mạng Ad Manager của nhà xuất bản.
- idtype xác định loại mã nhận dạng. Đối với mã nhận dạng của bên thứ nhất của nhà xuất bản trên web, giá trị phải là "sco" để cho biết cookie trong phạm vi trang web.
Ví dụ:
https://securepubads.g.doubleclick.net/user_data_deletion?id=123456789012345&iu=12345&idtype=sco
Phản hồi dự kiến
Mã trạng thái phản hồi HTTPS "200", cho biết yêu cầu đã được xử lý thành công, sẽ được trả về nếu cả ba tham số đều có giá trị hợp lệ:
- Giá trị "id" là một giá trị thập lục phân gồm 16 ký tự.
- Giá trị "iu" là một mã mạng Ad Manager hợp lệ.
- Giá trị "idtype" phải là "sco" để cho biết đây là mã nhận dạng của bên thứ nhất của nhà xuất bản trên web.
Mã trạng thái phản hồi HTTPS "400" sẽ được trả về nếu yêu cầu không đúng định dạng.
Xoá dữ liệu người dùng liên kết với IDFV trên iOS 14 trở lên
Nhà xuất bản Ad Manager có thể yêu cầu xoá dữ liệu người dùng liên kết với một giá trị nhận dạng cho nhà cung cấp (IDFV) cụ thể. Bạn có thể sử dụng API xoá dữ liệu để gửi yêu cầu cho một giá trị nhận dạng duy nhất. API xoá dữ liệu tuân theo Khuôn khổ yêu cầu xoá dữ liệu của IAB.
Trước khi gửi yêu cầu xoá dữ liệu, đầu tiên, bạn phải liên hệ với người quản lý tài khoản của mình và yêu cầu được thêm vào sổ đăng ký của chúng tôi cho khuôn khổ của IAB. Bạn cần gửi miền sẽ lưu trữ tệp dsrdelete.json.
Sau khi đăng ký miền với Google, bạn nên tạo tệp dsrdelete.json rồi lưu trữ tệp này ở thư mục gốc của miền. Bạn có thể tìm hiểu thêm về tệp dsrdelete.json, cũng như các trường bắt buộc và không bắt buộc của tệp này trong tài liệu của IAB.
Gửi yêu cầu xoá dữ liệu IDFV
Để yêu cầu xoá dữ liệu IDFV, hãy bắt đầu yêu cầu bằng URL sau:
Thuộc tính bắt buộc
Hãy xem các thuộc tính bắt buộc cho yêu cầu xoá dữ liệu IDFV trong bảng sau. Để biết đầy đủ thông tin chi tiết về các tham số, mã mẫu và các yêu cầu khác, hãy tham khảo Khuôn khổ yêu cầu xoá dữ liệu của IAB.
| Thuộc tính | Mô tả |
Giá trị mẫu |
|---|---|---|
| sub.identifierType | Loại giá trị nhận dạng | ifv |
| sub.identifierValue | Giá trị nhận dạng mà bạn đang yêu cầu xoá | 82e812aa-1972-49ad-aad8-6092387e1275 |
| sub.identifierFormat | Định dạng của giá trị nhận dạng người dùng | plaintext |