Tải hàng loạt giá trị nhận dạng lên phân khúc đối lượng

Chỉ có trong Google Ad Manager 360.

 

Tìm hiểu về việc tải hàng loạt giá trị nhận dạng lên bằng Google Cloud. #audiencesegments

This article has been updated in alignment with upcoming changes to Audience Solutions.

To adhere to the EU user consent policy and continue creating audience segments globally, publishers using batch upload must make updates to pass the required consent signals to Ad Manager by March 2024.

Bạn phải liên hệ với Bộ phận hỗ trợ nhà xuất bản hoặc Bộ phận kinh doanh để kích hoạt Giải pháp đối tượng. Họ cần kích hoạt danh sách được cung cấp nên nhà xuất bản phải đợi chút thời gian để bắt đầu thấy phân khúc đối tượng.

Bạn có thể tạo một tệp giá trị nhận dạng và tải tệp lên Google Ad Manager qua Google Cloud. Các giá trị nhận dạng hoặc mã nhận dạng có sẵn để tải lên bao gồm cookie, mã nhận dạng cho quảng cáo trên thiết bị di động (AdID (mã nhận dạng cho quảng cáo) hay IDFA) hoặc PPID (giá trị nhận dạng do nhà xuất bản cung cấp). Việc tải mã lên qua Google Cloud giúp tiết kiệm thời gian nếu bạn cần thêm nhiều mã cùng một lúc.

Cookie, PPID và mã quảng cáo thiết bị phải được đưa vào một yêu cầu quảng cáo AD Manager trước khi được thêm vào một phân khúc. Bạn có thể tải danh sách giá trị nhận dạng được mã hóa trong báo cáo Chuyển dữ liệu (chỉ dành cho Google Ad Manager 360) xuống hoặc lấy giá trị nhận dạng thô từ các hệ thống khác (ví dụ: mã quảng cáo thiết bị thô từ nhật ký của ứng dụng dành cho thiết bị di động).

Thời gian tồn tại tối đa của PPID đối với tính năng Tải lên hàng loạt là 180 ngày sau hoạt động gần đây nhất của người dùng, hoặc lần gần đây nhất mà giá trị này xuất hiện trong quá trình phân phát. Đối với mã thiết bị, tối đa là 540 ngày sau khi tạo, nói cách khác là 540 ngày sau lần đầu tiên thiết bị xuất hiện trong quá trình phân phát.

Xin lưu ý rằng việc dùng cả phương thức điền dựa trên ping sự kiện (ví dụ: đăng ký sự kiện, điền sẵn) và phương thức điền dựa trên cookie tải lên (là những danh sách CSV được cung cấp) có thể tạo ra xung đột khiến các PPID đã xóa có thể không giống như bị loại trừ hoàn toàn.

Bài viết này bao gồm các chủ đề sau:

• Điều kiện tiên quyết
• Tạo tệp tải lên
• Xóa hàng loạt giá trị nhận dạng
• Tải tệp lên
• Thời hạn của giá trị nhận dạng được tải lên hàng loạt
• Phương pháp hay nhất để tải lên hàng loạt

Điều kiện tiên quyết

Trước khi bạn có thể tải lên giá trị nhận dạng, hãy làm việc với người quản lý tài khoản của bạn để:

• Tìm và gửi mã mạng của bạn. Tìm mã mạng của bạn trong Ad Manager ở mục Quản trị, sau đó là Cài đặt chung, rồi chọn Mã mạng.
• Hãy chắc chắn rằng bạn đã tạo phân khúc đối tượng bên thứ nhất đang hoạt động mà bạn muốn liên kết với giá trị nhận dạng. Nếu bạn không muốn phân khúc này thu thập người dùng bằng cách sử dụng khoảng không quảng cáo của riêng bạn, hãy chọn "Do nhà xuất bản quản lý" làm phương thức Điền sẵn.
  
  Dự kiến bạn cần chờ tối đa 24 giờ từ khi tạo phân khúc cho đến khi có thể tải lên hàng loạt.
• Tạo một nhóm Google chứa tất cả Tài khoản Google sẽ có quyền tải lên và xem các tệp.

Sau khi người quản lý tài khoản đã hoàn tất thiết lập, bạn sẽ sẵn sàng tạo tệp gồm các giá trị nhận dạng bạn muốn tải lên.

Nhà xuất bản mới tải giá trị nhận dạng có thể gặp lỗi trong quá trình này. Điều này thường xảy ra do các video đó tải lên giá trị nhận dạng chưa được chuyển vào các yêu cầu quảng cáo trước khi tải lên. Trong trường hợp này, họ thấy thông báo sau trong tệp .fail: 
"Không tìm thấy <type ofidentifier> trong máy chủ của chúng tôi, thử lại sẽ không hữu ích”.

Tạo tệp tải lên

Thẻ bắt buộc về sự đồng ý

Tất cả nhà xuất bản đều phải cập nhật để truyền các tín hiệu đồng ý bắt buộc đến Ad Manager.

Để xác nhận rằng bạn đã thu thập sự đồng ý, hãy thêm thẻ process_consent vào tiêu đề của mọi tệp được tải lên. Các hàng phải chứa các giá trị cho cột tiêu đề này để tuân thủ tiêu chuẩn về CSV, nhưng những giá trị này sẽ không ảnh hưởng đến việc xử lý; bạn nên sử dụng một chuỗi trống. Mọi tệp thiếu cụm từ này sẽ đều được xem là chưa có sự đồng ý phù hợp của người dùng và sẽ không được Google xử lý.

Nội dung cập nhật này là bắt buộc:

• Đối với tất cả người dùng (bất kể vị trí), vì đây là một yêu cầu kỹ thuật.
• Đối với người dùng ở Liên minh Châu Âu (EU) hoặc Khu vực kinh tế Châu Âu (EEA), nhằm tuân thủ Chính sách về sự đồng ý của người dùng ở EU và tiếp tục tạo phân khúc đối tượng cho người dùng ở EEA.

Giới thiệu về giá trị nhận dạng

Quá trình tải lên hàng loạt hỗ trợ các loại giá trị nhận dạng khác nhau và điều quan trọng là loại giá trị nhận dạng được tải lên phân khúc bằng cách sử dụng định dạng tệp tải lên chính xác. Có hai danh mục giá trị nhận dạng:

• Giá trị nhận dạng đã mã hóa: mọi giá trị thu được từ hệ thống của Google
• Giá trị nhận dạng thô: lấy từ hệ thống hoặc nguồn bên ngoài

Giá trị nhận dạng đã mã hóa được tải lên bằng cách sử dụng định dạng tệp cookie_encrypted, trong khi giá trị nhận dạng thô được tải lên ở định dạng tệp tải lên theo từng loại cụ thể.

Giá trị nhận dạng đã mã hóa và PPID là các giá trị dành riêng cho từng mạng. Do đó, bạn không thể tải hàng loạt PPID hoặc giá trị nhận dạng đã mã hóa lấy từ một mạng lên một mạng khác. Điều này có nghĩa là bạn không thể tải hàng loạt giá trị nhận dạng người dùng có được từ Báo cáo chuyển dữ liệu của mạng A lên mạng B. Mặt khác, giá trị nhận dạng thiết bị không dành riêng cho từng mạng.

Bảng sau đây tóm tắt các giá trị nhận dạng có sẵn và cách tải lên:

Giá trị nhận dạng	Phần mô tả	Nguồn	Tải lên ở dạng
Cookie	Giá trị nhận dạng cookie	Chuyển dữ liệu UserId	cookie_encrypted
		Thô (nguồn bên ngoài)	Không áp dụng (phải mã hóa cookie để tải lên)
PPID	Giá trị nhận dạng do nhà xuất bản cung cấp	Chuyển dữ liệu PublisherProvidedID	cookie_encrypted
		Thô (nguồn bên ngoài)	ppid
IDFA	Giá trị nhận dạng cho quảng cáo	Chuyển dữ liệu UserId	cookie_encrypted
		Thô (nguồn bên ngoài)	cookie_idfa
Mã nhận dạng cho quảng cáo (AdID)	Giá trị nhận dạng Android TV	Chuyển dữ liệu UserId	cookie_encrypted
		Thô (nguồn bên ngoài)	cookie_adid
Mã Roku	Giá trị nhận dạng Roku	Chuyển dữ liệu UserId	cookie_encrypted
		Thô (nguồn bên ngoài)	cookie_rida
Mã tvOS	Giá trị nhận dạng Apple TV	Chuyển dữ liệu UserId	cookie_encrypted
		Thô (nguồn bên ngoài)	cookie_tvos
IFA Vizio	Giá trị nhận dạng Vizio	Chuyển dữ liệu UserId	cookie_encrypted
		Thô (nguồn bên ngoài)	cookie_vida
TIFA Samsung	Giá trị nhận dạng Samsung	Chuyển dữ liệu UserId	cookie_encrypted
		Thô (nguồn bên ngoài)	cookie_tifa

Sử dụng một trình chỉnh sửa văn bản, tạo tệp văn bản thuần túy và lưu tệp đó bằng bất kỳ tên tệp nào. Bạn có thể lưu tệp bằng bất kỳ đuôi tệp nào hoặc không cần đuôi tệp.

Tên tệp trên Google Cloud sẽ hiện công khai. Đừng đưa thông tin bí mật vào tên tệp của bạn.

Yêu cầu nội dung tệp

• Đảm bảo nội dung của tệp được phân tách bằng dấu phẩy.
• Dòng đầu tiên phải ghi:
  • Đối với cookie và giá trị nhận dạng được mã hoá thu được từ báo cáo Chuyển dữ liệu (chỉ dành cho Google Ad Manager 360): cookie_encrypted,list_id,process_consent
  • Đối với IDFA thô trên Apple: cookie_idfa,list_id,process_consent
  • Đối với mã nhận dạng cho quảng cáo (AdID) thô trên Android: cookie_adid,list_id,process_consent
  • Đối với PPID thô: ppid,list_id,process_consent
  • Đối với mã nhận dạng thô trên Roku: cookie_rida,list_id,process_consent
  • Đối với mã nhận dạng thô trên tvOS: cookie_tvos,list_id,process_consent
• Mỗi dòng tiếp theo sẽ chứa một giá trị nhận dạng, một dấu phẩy và mã của phân khúc đối tượng mà giá trị nhận dạng được liên kết.
• Mỗi dòng nên kết thúc với dòng unix loại chuyển dòng (LF), KHÔNG chứa ký tự đặt lại về đầu dòng (CR). Tùy thuộc vào phương pháp bạn sử dụng để tạo tệp tải lên, loại kết thúc dòng được thiết lập trong trình chỉnh sửa văn bản của bạn hoặc trong chương trình tạo tệp.
• Nhà xuất bản hiện có thể lấy giá trị nhận dạng đã mã hóa qua báo cáo Chuyển dữ liệu (chỉ dành cho Google Ad Manager 360). Bạn có thể đăng nhập vào tài khoản Google Ad Manager, chọn Khoảng không quảng cáo rồi chọn Phân khúc đối tượng để lấy mã phân khúc đối tượng.
• Cột "process_consent" phải là cột cuối cùng trong tệp tải lên.
• Các ô trong cột "process_consent" có thể để trống. Tuy nhiên, quan trọng là phải thêm cột có giá trị "process_consent" làm tiêu đề.
• Dung lượng của tệp tải lên hàng loạt không được lớn hơn 1GB. Tệp lớn hơn kích thước này có thể không được xử lý đúng cách.

Nội dung tệp mẫu cho các mã cookie đã mã hóa:

cookie_encrypted,list_id,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,
w2gsrUcwxF-OiJTRmQswQA,3153490,

 

Nội dung tệp mẫu cho AdID thô:

cookie_encrypted,list_id,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,
w2gsrUcwxF-OiJTRmQswQA,3153490,

Xoá hàng loạt giá trị nhận dạng

Bạn có thể sử dụng cùng tệp tải lên để xoá hàng loạt giá trị nhận dạng bằng cách thêm một cột có tên là xoá. Hãy nhập 1 vào cột xoá đối với mỗi giá trị nhận dạng bạn muốn xoá khỏi phân khúc và nhập 0 vào cột xoá cho từng mã bạn muốn giữ lại trong phân khúc.

Bạn phải đảm bảo mọi dòng trong tệp phải chứa 1 hoặc 0 trong cột xoá. Nếu không, quá trình tải lên sẽ không thành công.

Trong ví dụ bên dưới, cookie đầu tiên được giữ lại trong phân khúc nhưng cookie thứ hai bị huỷ liên kết khỏi phân khúc có id=3153490.

cookie_encrypted,list_id,delete,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,0,
w2gsrUcwxF-OiJTRmQswQA,3153490,1,

Trong ví dụ sau, IDFA đầu tiên bị huỷ liên kết khỏi phân khúc, nhưng IDFA thứ hai được giữ lại trong phân khúc.

cookie_idfa,list_id,delete,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,1,
w2gsrUcwxF-OiJTRmQswQA,3153490,0,

Mỗi dòng phải chứa nhiều trường được phân tách bằng dấu phẩy như hiện có trong tiêu đề. Lưu ý rằng giá trị nhận dạng không bao giờ chứa dấu phẩy hoặc các ký tự khác không đồng nhất với định dạng CSV.

Xin lưu ý rằng có thể mất vài giờ để Ad Manager xử lý các quá trình tải lên giá trị nhận dạng, cho dù bạn đang thêm hay xoá giá trị nhận dạng. Khi thêm giá trị nhận dạng, bạn cần chờ xử lý giá trị đó trước khi có thể xoá giá trị nhận dạng đó bằng quá trình tải lên tiếp theo.

Tải tệp lên

Sau khi đã tạo tệp, bạn cần tải tệp đó lên bộ chứa Google Storage (có cho phép thư mục con). Có ba cách để bạn có thể truy cập các bộ chứa lưu trữ trên đám mây của Ad Manager. Các cách đó (xếp theo thứ tự phức tạp) như sau:

• Trên web: Truy cập https://console.developers.google.com/storage/browser/gdfp_cookieupload_[Mã mạng Ad Manager]/
• gsutil là một công cụ dòng lệnh dựa trên Python, cung cấp các lệnh giống Unix để tương tác với bộ chứa lưu trữ. Quy trình xác thực bộ chứa được tóm tắt và xử lý tự động.
• API Google Cloud Storage là một API đầy đủ tính năng để chỉnh sửa bộ chứa lưu trữ, có sẵn trên giao diện web của JSON, XML hoặc RESTful. Thư viện ứng dụng API được cung cấp cho nhiều môi trường lập trình phổ biến, bao gồm cả Java, JavaScript, Python và Objective-C. Cách tiếp cận này hữu ích nhất nếu bạn cần chỉnh sửa bộ chứa lưu trữ theo chương trình để tích hợp với ứng dụng Google App Engine hoặc ứng dụng web Java.

Trong vòng 24 giờ, tệp nhật ký sẽ được tạo trong tài khoản Google Storage của bạn có cùng tên với tệp và một hậu tố cho biết liệu tất cả các giá trị nhận dạng trong tệp có được xử lý thành công hay không.

Ví dụ: nếu tệp của bạn có tên 1234_20130115_1, thì tệp tạo ra sẽ có tên là 1234_20130115_1.success hoặc 1234_20130115_1.fail. Tệp này sẽ liệt kê số lượng giá trị nhận dạng được xử lý thành công cùng thông báo lỗi chi tiết về các giá trị nhận dạng không thể xử lý được. Tải tệp nhật ký này xuống để biết thông tin chi tiết hơn về trạng thái.

Tên tệp thu được sẽ xuất hiện trong thư mục sau trong tài khoản Google Storage:

https://console.developers.google.com/storage/gdfp_cookieupload_result_[Ad Manager network code]/

Sau khi tải lên, các giá trị nhận dạng đã xử lý thành công trong tệp của bạn sẽ được coi là thành phần trong các phân khúc liên kết của giá trị nhận dạng khi nhắm đến khoảng không quảng cáo.

Tệp .fail hoặc .success chỉ cho biết tệp có được phân tích cú pháp thành công hay không chứ không cung cấp thông tin có ý nghĩa về mức tăng/giảm thực trong danh sách kích thước. Tệp này chỉ được đặt tên .success nếu mọi giá trị nhận dạng được tải lên thành công. Tuy nhiên, trong hầu hết các trường hợp, có ít nhất một lỗi, vì vậy tệp đầu ra chứa hậu tố .fail.

Các tệp tải lên và tệp nhật ký sẽ bị xoá sau 60 ngày.

Thời hạn của giá trị nhận dạng được tải lên hàng loạt

Giá trị nhận dạng được tải lên qua thao tác Tải lên hàng loạt tuân theo thời hạn đã định cấu hình cho phân khúc đối tượng thông qua giao diện người dùng Ad Manager.

Nếu phân khúc đối tượng được định cấu hình với một giá trị thời hạn là X ngày và giá trị nhận dạng không đáp ứng tiêu chí về thành viên phân khúc trong X ngày sau khi tải lên, thì giá trị nhận dạng đó sẽ hết hạn trong phân khúc đối tượng sau X ngày. Mỗi hoạt động tải lên sẽ đặt lại tư cách thành viên phân khúc và đếm ngược thời hạn cho các giá trị nhận dạng đã tải lên.

Phương pháp hay nhất để tải lên hàng loạt

Cấu trúc tệp

Giảm thiểu số lượng tệp dùng để tải lên. Xin lưu ý rằng có thể sử dụng một tệp duy nhất để tải giá trị nhận dạng lên nhiều danh sách vì mã danh sách được quy định cho mỗi dòng trong tệp.

Thông lượng tải lên

Chúng tôi yêu cầu bạn tuân thủ các giới hạn sau khi tải các tệp tin lên:

• Tải tối đa 500 tệp lên trong mỗi 24 giờ
• Tải tối đa 1 GB lên cho mỗi tệp tải lên hàng loạt
• Tải tối đa 5 GB tệp tải lên hoàng loạt lên trong 24 giờ

Tải lên gia tăng/hoàn tất

• Để tránh việc xử lý không cần thiết, bạn nên sử dụng hình thức tải lên tăng dần đối với (delta) các giá trị nhận dạng. Bạn nên chỉ thêm hoặc xoá các giá trị nhận dạng mà đã được thêm/bị xoá khỏi phân khúc này kể từ lần tải lên cuối cùng, chứ không tải danh sách giá trị nhận dạng phân khúc đầy đủ lên.
• Tuy nhiên, (không quá một lần mỗi tuần và vẫn phải tuân theo giới hạn thông lượng tải lên nói trên), bạn vẫn có thể tải đầy đủ tất cả dữ liệu giá trị nhận dạng phân khúc lên ở tần suất ít hơn. Việc tải lên đầy đủ sẽ làm mới tư cách thành viên phân khúc của bất kỳ đối tượng nào đã hết hạn trong phân khúc đó.
  • Bạn nên theo dõi các giá trị nhận dạng "mới" thông qua một số hệ thống khác và bạn cần phải có một số cách để loại trừ các giá trị nhận dạng khỏi lần tải lên làm mới nếu những giá trị nhận dạng đó đã bị bỏ qua (bạn không muốn thấy lại trong phân phát).

Thời gian xử lý

Bạn có thể phải chờ đến 24 giờ kể từ thời điểm tải lên hàng loạt đến thời điểm tất cả thay đổi hàng loạt được phản ánh trong phân phối. Nói cách khác, bạn cần tải các tệp lên ít nhất 24 giờ trước thời điểm bạn cần các phân khúc đó trong quá trình phân phát.

Ngoài ra, bạn cần chờ tối đa 48 giờ kể từ thời điểm tải lên hàng loạt trước khi các thay đổi xuất hiện trong giao diện người dùng Ad Manager.