Trong quá trình chạy quảng cáo Google Ads, việc theo dõi và đo lường lượt chuyển đổi là yếu tố quan trọng giúp đánh giá hiệu quả chiến dịch. Đặc biệt, tính năng lượt chuyển đổi nâng cao cho khách hàng tiềm năng đã được Google Ads giới thiệu nhằm tăng cường độ chính xác và hiệu quả trong việc ghi nhận lượt chuyển đổi ngoại tuyến. Bài viết này sẽ hướng dẫn chi tiết cách bạn có thể triển khai tính năng này, từ việc chuẩn bị dữ liệu, băm thông tin khách hàng cho đến tải các lượt chuyển đổi lên hệ thống.
Tính năng lượt chuyển đổi nâng cao cho khách hàng tiềm năng cho phép tối ưu hoá quá trình đo lường chuyển đổi ngoại tuyến, bằng cách tải lên các lượt chuyển đổi nhấp chuột chứa dữ liệu định danh người dùng đã được băm (hashed) và một số thông tin bổ sung tùy chọn. Điều này giúp Google Ads kết nối chính xác hơn giữa lượt chuyển đổi và chiến dịch quảng cáo đã tạo ra khách hàng tiềm năng đó.
Trước khi triển khai, hãy đảm bảo bạn đã tham khảo kỹ Hướng dẫn bắt đầu và đã hoàn tất các điều kiện tiên quyết cần thiết cho tính năng lượt chuyển đổi nâng cao cho khách hàng tiềm năng.
Lượt chuyển đổi nâng cao có thể được tải lên thông qua giao diện người dùng của Google Ads, như đã được nêu rõ trong phần trợ giúp, hoặc thông qua API Google Ads, theo các bước hướng dẫn chi tiết trong tài liệu kỹ thuật.
Thiết kế quy trình tích hợp
Quy trình sử dụng
Dưới đây là quy trình chi tiết để tải tính năng lượt chuyển đổi nâng cao cho khách hàng tiềm năng thông qua API Google Ads.
- Đảm bảo rằng bạn đã hoàn tất các điều kiện tiên quyết, bao gồm:
a. Kích hoạt tính năng theo dõi lượt chuyển đổi.
b. Chấp nhận các điều khoản sử dụng dữ liệu khách hàng.
c. Cấu hình thẻ theo dõi trên biểu mẫu khách hàng tiềm năng trên trang web của bạn.
Để biết thêm chi tiết, vui lòng xem hướng dẫn triển khai điều kiện tiên quyết.
- Chuẩn hoá và mã hóa (băm) dữ liệu khách hàng tiềm năng, bao gồm các thông tin như địa chỉ email, số điện thoại và địa chỉ gửi thư.
- Đưa dữ liệu khách hàng tiềm năng đã chuẩn hoá và băm vào các đối tượng ClickConversion. Đối với mỗi đối tượng ClickConversion, thực hiện các bước sau:
a. Điền thông tin user_identifiers với dữ liệu khách hàng đã chuẩn hoá và băm. Nếu có nhiều giá trị nhận dạng người dùng, tạo một UserIdentifier riêng cho từng giá trị, tối đa là 5 giá trị nhận dạng.
b. (Không bắt buộc nhưng khuyến nghị) Điền giá trị order_id.
c. (Không bắt buộc) Điền giá trị gclid để tăng độ chính xác trong việc đo lường.
d. Từ phiên bản v15 của API Google Ads, điền giá trị consent cho đối tượng ClickConversion để tuân thủ chính sách về sự đồng ý của người dùng.
e. Đặt trường conversion_action thành tên tài nguyên của ConversionAction có loại UPLOAD_CLICKS. Đây phải là tài nguyên mà bạn đã tạo khi thực hiện các điều kiện tiên quyết.
- Tải các đối tượng ClickConversion lên dịch vụ ConversionUploadService, đảm bảo đặt thuộc tính partial_failure thành true để xử lý các lỗi phát sinh trong quá trình tải lên.
- Kiểm tra và xem lại các tệp dữ liệu đã tải lên để đảm bảo quá trình thực hiện thành công.
Các phương pháp tối ưu
Dưới đây là các phương pháp tối ưu khi triển khai tính năng lượt chuyển đổi nâng cao cho khách hàng tiềm năng trong Google Ads.
Kiểm tra mã nhận dạng khách hàng
Khi tải lên lượt chuyển đổi, mã khách hàng cần được liên kết với tài khoản quản lý hành động chuyển đổi và theo dõi lượt chuyển đổi. Để kiểm tra, bạn có thể truy vấn tài nguyên ConversionTrackingSetting của khách hàng thông qua GoogleAdsService.SearchStream để xác minh giá trị của customer.conversion_tracking_setting.google_ads_conversion_customer.
Tối ưu hóa bằng nhiều giá trị nhận dạng
Nếu có order_id cho lượt chuyển đổi, bạn nên cung cấp để tăng tính chính xác. Nếu có gclid, hãy gửi cùng với user_identifiers để cải thiện khả năng trùng khớp. Ngoài ra, nếu có nhiều UserIdentifier, hãy bao gồm tất cả các giá trị nhận dạng trong một đối tượng ClickConversion để tăng tỷ lệ khớp chuyển đổi.
Xử lý lỗi không hoàn tất một phần
Khi tích hợp lần đầu, hãy theo dõi và xử lý các lỗi trong trường partial_failure_error từ phản hồi API. Nếu phát sinh vấn đề, cần điều tra và giải quyết trước khi tiếp tục. Tham khảo tài liệu về cách xử lý lỗi không hoàn tất một phần để biết thêm chi tiết và ví dụ cụ thể.
Sau khi xử lý xong các lỗi và hoàn tất tích hợp, sử dụng tính năng chẩn đoán dữ liệu ngoại tuyến để kiểm tra và theo dõi các sự kiện chuyển đổi, đảm bảo tính liên tục và chính xác.
Tải nhiều lượt chuyển đổi trong một yêu cầu
Nếu có nhiều lượt chuyển đổi cần tải lên, nhóm chúng thành một yêu cầu UploadClickConversionsRequest thay vì gửi từng yêu cầu riêng lẻ. Điều này giúp tối ưu hóa hiệu suất và dễ quản lý hơn. Sử dụng job_id chung cho các yêu cầu liên quan nếu bạn muốn nhóm các yêu cầu vào cùng một quy trình xử lý logic.
Tải lên tất cả sự kiện ngoại tuyến
Để đảm bảo dữ liệu chuyển đổi được ghi nhận đầy đủ, hãy tải lên tất cả các sự kiện ngoại tuyến, kể cả những sự kiện không đến từ Google Ads. Tuy nhiên, lưu ý rằng việc này có thể gây ra lỗi CLICK_NOT_FOUND cho các sự kiện không liên quan đến Google Ads.Trong giai đoạn phát triển và thử nghiệm, bạn có thể bật debug_enabled để phát hiện các lỗi như CLICK_NOT_FOUND. Khi quá trình tích hợp ổn định, nên đặt debug_enabled thành false để tránh gặp phải quá nhiều lỗi không cần thiết.
Không sử dụng dữ liệu phân bổ bên ngoài
Không nên đặt external_attribution_data trên ClickConversion hoặc sử dụng các mô hình phân bổ bên ngoài cho hành động chuyển đổi. Google Ads không hỗ trợ các mô hình phân bổ bên ngoài cho các lượt chuyển đổi được tải lên thông qua giá trị nhận dạng người dùng.
Chuẩn bị dữ liệu để tải lên
Để đảm bảo tính bảo mật và quyền riêng tư của người dùng, các dữ liệu sau phải được băm bằng thuật toán SHA-256 trước khi tải lên:
- Địa chỉ email
- Số điện thoại
- Tên
- Họ
- Địa chỉ đường phố
Tuy nhiên, các dữ liệu sau không cần băm:
- Quốc gia
- Tiểu bang
- Thành phố
- Mã vùng
Để đảm bảo quá trình băm dữ liệu chuẩn xác, bạn cần thực hiện các bước chuẩn hoá trước khi băm các giá trị này:
- Xoá khoảng trắng ở đầu và cuối chuỗi.
- Chuyển toàn bộ văn bản sang chữ thường.
- Định dạng số điện thoại theo tiêu chuẩn E164.
- Xoá tất cả dấu chấm (.) trước tên miền trong địa chỉ email có đuôi gmail.com hoặc googlemail.com.
private String normalizeAndHash(MessageDigest digest, String s)
throws UnsupportedEncodingException {
// Chuẩn hoá chuỗi bằng cách chuyển tất cả ký tự thành chữ thường và xoá khoảng trắng.
String normalized = s.toLowerCase();
// Xoá khoảng trắng ở đầu, cuối và giữa chuỗi.
normalized = normalized.replaceAll("\\s+", "");
// Băm chuỗi đã chuẩn hoá bằng thuật toán băm.
byte[] hash = digest.digest(normalized.getBytes("UTF-8"));
StringBuilder result = new StringBuilder();
for (byte b : hash) {
result.append(String.format("%02x", b));
}
return result.toString();
}* Trả về kết quả chuẩn hoá và băm một địa chỉ email. Google Ads yêu cầu xoá bất kỳ ký tự
* ‘.’ nào trước tên miền {@code gmail.com} hoặc {@code googlemail.com}.
*
* @param digest thuật toán băm sử dụng để băm chuỗi đã chuẩn hoá.
* @param emailAddress địa chỉ email cần chuẩn hoá và băm.
*/
private String normalizeAndHashEmailAddress(MessageDigest digest, String emailAddress)
throws UnsupportedEncodingException {
String normalizedEmail = emailAddress.toLowerCase();
String[] emailParts = normalizedEmail.split(“@”);
if (emailParts.length > 1 && emailParts[1].matches(“^(gmail|googlemail)\\.com\\s*”)) {
// Xoá các ký tự ‘.’ trước tên miền nếu tên miền là gmail.com hoặc googlemail.com.
emailParts[0] = emailParts[0].replaceAll(“\\.”, “”);
normalizedEmail = String.format(“%s@%s”, emailParts[0], emailParts[1]);
}
return normalizeAndHash(digest, normalizedEmail);
}
Tải lượt chuyển đổi nâng cao lên
Lưu ý: Việc thiết lập trường conversion_environment chỉ áp dụng cho các tài khoản có trong danh sách cho phép. Vui lòng liên hệ với đại diện của Google nếu bạn muốn sử dụng tính năng này.
Dưới đây là đoạn mã minh họa cách tạo tệp tải lượt chuyển đổi, bao gồm các giá trị nhận dạng người dùng như email và số điện thoại, với quy trình chuẩn hoá và băm dữ liệu khi cần thiết. Tốt nhất, bạn nên bổ sung thêm gclid và order_id vào lượt chuyển đổi nếu có.
Thêm giá trị nhận dạng người dùng vào lượt chuyển đổi từ lượt nhấp
// Tạo đối tượng builder để khởi tạo đối tượng click conversion.
ClickConversion.Builder clickConversionBuilder = ClickConversion.newBuilder();// Tạo một đối tượng UserIdentifier riêng biệt cho mỗi trường dữ liệu. Dữ liệu trong ví dụ này là cố định, nhưng trong thực tế bạn có thể đọc từ tệp dữ liệu đầu vào.
// (https://protobuf.dev/programming-guides/proto3/#oneof-features), bạn chỉ được thiết lập duy nhất một trong các giá trị hashedEmail, hashedPhoneNumber, mobileId, thirdPartyUserId, hoặc addressInfo.
// Thiết lập nhiều giá trị trên cùng một UserIdentifier sẽ xoá các giá trị khác. Ví dụ, đoạn mã sau là SAI và sẽ chỉ giữ lại giá trị hashedPhoneNumber.
//
// UserIdentifier incorrectlyPopulatedUserIdentifier =
// UserIdentifier.newBuilder()
// .setHashedEmail(“…”)
// .setHashedPhoneNumber(“…”)
// .build();
ImmutableMap.<String, String>builder()
// Địa chỉ email bao gồm dấu chấm (.) trước tên miền Gmail.
.put(“email”, “alex.2@example.com”)
// Số điện thoại cần được chuyển đổi sang định dạng E.164, với dấu ‘+’ ở đầu.
.put(“phone”, “+1 800 5550102”)
// Ví dụ này cho phép nhập chi tiết chuyển đổi dưới dạng đối số, nhưng thực tế bạn có thể lưu trữ dữ liệu này cùng với các dữ liệu khác của người dùng.
.put(“orderId”, orderId)
.put(“gclid”, gclid)
.put(“conversionActionId”, Long.toString(conversionActionId))
.put(“conversionDateTime”, conversionDateTime)
.put(“conversionValue”, Double.toString(conversionValue))
.put(“currencyCode”, “USD”)
.put(“adUserDataConsent”, adUserDataConsent == null ? null : adUserDataConsent.name())
.build();
MessageDigest sha256Digest = MessageDigest.getInstance(“SHA-256”);
List<UserIdentifier> userIdentifiers = new ArrayList<>();
UserIdentifier emailIdentifier =
UserIdentifier.newBuilder()
// Tuỳ chọn: chỉ định nguồn gốc của định danh người dùng.
.setUserIdentifierSource(UserIdentifierSource.FIRST_PARTY)
// Sử dụng phương thức chuẩn hoá và băm dành riêng cho địa chỉ email.
.setHashedEmail(normalizeAndHashEmailAddress(sha256Digest, rawRecord.get(“email”)))
.build();
userIdentifiers.add(emailIdentifier);
UserIdentifier hashedPhoneNumberIdentifier =
UserIdentifier.newBuilder()
.setHashedPhoneNumber(normalizeAndHash(sha256Digest, rawRecord.get(“phone”)))
.build();
// Thêm định danh số điện thoại đã băm vào danh sách định danh của đối tượng UserData.
userIdentifiers.add(hashedPhoneNumberIdentifier);
clickConversionBuilder.addAllUserIdentifiers(userIdentifiers);
Thêm thông tin chi tiết về lượt chuyển đổi vào ClickConversion
Dưới đây là cách chi tiết thêm thông tin cho đối tượng ClickConversion trong Google Ads API với ngôn ngữ Java
// Thêm thông tin chi tiết cho lượt chuyển đổi.
clickConversionBuilder.setConversionAction(
ResourceNames.conversionAction(
customerId, Long.parseLong(rawRecord.get("conversionActionId"))));
clickConversionBuilder.setConversionDateTime(rawRecord.get("conversionDateTime"));
clickConversionBuilder.setConversionValue(Double.parseDouble(rawRecord.get("conversionValue")));
clickConversionBuilder.setCurrencyCode(rawRecord.get("currencyCode"));if (rawRecord.get(“orderId”) != null) {
clickConversionBuilder.setOrderId(rawRecord.get(“orderId”));
}
if (rawRecord.get(“gclid”) != null) {
clickConversionBuilder.setGclid(rawRecord.get(“gclid”));
}
if (rawRecord.get(“adUserDataConsent”) != null) {
// Xác định người dùng đã đồng ý cho việc thu thập dữ liệu hay chưa.
// Xem thêm thông tin tại https://www.google.com/about/company/user-consent-policy.
clickConversionBuilder.setConsent(
Consent.newBuilder()
.setAdUserData(ConsentStatus.valueOf(rawRecord.get(“adUserDataConsent”))));
}
ClickConversion clickConversion = clickConversionBuilder.build();
Tải lượt chuyển đổi từ lượt nhấp lên
Sử dụng đoạn mã dưới đây để tải lượt chuyển đổi từ lượt nhấp thông qua API Google Ads.
// Tạo client để tải lượt chuyển đổi.
try (ConversionUploadServiceClient conversionUploadServiceClient =
googleAdsClient.getLatestVersion().createConversionUploadServiceClient()) {
// Tuy nhiên, nếu có nhiều lượt chuyển đổi, tốt nhất nên tải lên nhiều lượt trong một yêu cầu thay vì gửi riêng lẻ.
// Xem giới hạn cho mỗi yêu cầu tại:
// https://developers.google.com/google-ads/api/docs/best-practices/quotas#conversion_upload_service
conversionUploadServiceClient.uploadClickConversions(
UploadClickConversionsRequest.newBuilder()
.setCustomerId(Long.toString(customerId))
.addConversions(clickConversion)
// Bật chế độ partial_failure để xử lý các lỗi xảy ra một phần.
.setPartialFailure(true)
.build());
}
Xem lại các tệp đã tải lên
Sử dụng tính năng chẩn đoán dữ liệu ngoại tuyến trong Google Ads để đánh giá tình trạng tổng thể của các tệp chuyển đổi gần đây. Cần lưu ý rằng việc tải lên thành công không đồng nghĩa với việc tất cả dữ liệu chuyển đổi sẽ được đối chiếu chính xác.
Khi báo cáo các chỉ số chuyển đổi cho chiến dịch, hãy tham khảo tài liệu liên kết chỉ số người dùng giao diện để liên kết dữ liệu từ giao diện người dùng Google Ads với các trường báo cáo trong API Google Ads. Bạn cũng có thể thực hiện truy vấn tài nguyên conversion_action để xem tổng số lượt chuyển đổi và giá trị chuyển đổi cho từng hành động chuyển đổi cụ thể.
Các bước tiếp theo
Nếu bạn cần điều chỉnh các lượt chuyển đổi đã tải lên, hãy tham khảo hướng dẫn về tải mức điều chỉnh lượt chuyển đổi.
Để được hỗ trợ về các vấn đề gặp phải khi tích hợp tính năng lượt chuyển đổi nâng cao cho khách hàng tiềm năng, bạn có thể truy cập phần khắc phục sự cố của Google Ads để tìm hiểu thêm.
Tính năng lượt chuyển đổi nâng cao trong Google Ads mang lại nhiều lợi ích cho doanh nghiệp trong việc tối ưu hóa và đo lường hiệu quả chiến dịch. Việc triển khai chính xác các bước từ chuẩn hoá dữ liệu đến tải lên lượt chuyển đổi không chỉ giúp bạn cải thiện hiệu suất mà còn đảm bảo độ chính xác cao hơn trong việc theo dõi khách hàng tiềm năng. Đừng quên kiểm tra và sử dụng tính năng chẩn đoán dữ liệu ngoại tuyến để liên tục đánh giá kết quả và tối ưu các lượt chuyển đổi của mình.
