Câu hỏi thường gặp

Có quy định hạn chế nào về nội dung tôi có thể tải lên không?

Có một số quy định hạn chế cần lưu ý:

  • Mỗi yêu cầu batchinsert và batchupdate chỉ được chứa tối đa 1.000 lượt chuyển đổi.
  • Dấu thời gian của một lượt chuyển đổi tối đa là 28 ngày tính từ thời điểm gửi.
  • Bạn chỉ có thể gửi lượt chuyển đổi đến một cấu hình Floodlight mà hồ sơ người dùng của bạn trong Campaign Manager 360 có quyền truy cập.
Tôi nên sử dụng Campaign Manager 360 hay Search Ads 360 để tải lượt chuyển đổi lên?

Tham khảo Trung tâm trợ giúp của Search Ads 360 để xem thông tin so sánh chi tiết về các tính năng của cả hai sản phẩm.

Điều gì xảy ra nếu tôi chèn cùng một lượt chuyển đổi vào cả Campaign Manager 360 và Search Ads 360?

Nếu bạn chèn cùng một lượt chuyển đổi vào cả Campaign Manager 360 và Search Ads 360, thì các mục nhập sẽ không được loại bỏ trùng lặp. Trong trường hợp này, hãy sử dụng các hoạt động Floodlight riêng biệt.

Tôi nên sử dụng API nào để tải lượt chuyển đổi ngoại tuyến lên?

Bạn nên sử dụng Data Manager API để cải thiện trải nghiệm của nhà phát triển và sử dụng các tính năng bổ sung.

Giá trị thứ tự là gì và được sử dụng như thế nào?

Giá trị thứ tự kiểm soát cách xử lý các lượt chuyển đổi trùng lặp. Nếu nhiều lượt chuyển đổi được chèn bằng cùng một hoạt động Floodlight, mã cấu hình Floodlight, giá trị nhận dạng người dùng và dấu thời gian chuyển đổi, thì số thứ tự sẽ được dùng để xác định xem:

  • Các lượt chuyển đổi được loại bỏ trùng lặp và chỉ còn lại một lượt chuyển đổi. Điều này xảy ra nếu tất cả lượt chuyển đổi đều có cùng giá trị thứ tự.
  • Các lượt chuyển đổi được xử lý riêng lẻ và tất cả đều được giữ lại. Điều này xảy ra nếu tất cả lượt chuyển đổi đều có giá trị thứ tự khác nhau.

Bản thân các giá trị không cần phải có ý nghĩa. Nhìn chung, việc sử dụng một giá trị cố định (chẳng hạn như 1) cho tất cả lượt chuyển đổi sẽ cho phép loại bỏ trùng lặp. Nếu bạn sử dụng một giá trị ngẫu nhiên hoặc riêng biệt cho mỗi lượt chuyển đổi, thì tính năng này sẽ bị tắt.

Tôi nên xử lý lỗi trong phản hồi của API như thế nào và nên thử lại những lỗi nào?

batchinsert và batchupdate xử lý lượt chuyển đổi theo nguyên tắc nỗ lực tối đa: một yêu cầu theo lô có thể trả về phản hồi HTTP 200 OK trong khi các lượt chuyển đổi riêng lẻ trong lô không thành công. Luôn kiểm tra hasFailures trên phản hồi và kiểm tra danh sách errors[] trên mỗi đối tượng ConversionStatus:

  • INTERNAL (Thử lại): Đã xảy ra lỗi tạm thời trong hệ thống của Google khi xử lý lượt chuyển đổi. Lượt chuyển đổi chưa được chèn hoặc cập nhật. Thử lại các lượt chuyển đổi không thành công bằng cách sử dụng thời gian đợi luỹ thừa (ví dụ: bắt đầu sau vài phút và thử lại trong vài giờ), giữ nguyên ordinal, timestampMicros, floodlightActivityId và giá trị nhận dạng người dùng hoặc lượt nhấp.
  • NOT_FOUND (Thử lại sau): Chưa tìm thấy giá trị nhận dạng (gclid, dclid, matchId hoặc mobileDeviceId) hoặc lượt chuyển đổi hiện có đang được chỉnh sửa. Vì lượt nhấp trực tuyến, thẻ Floodlight và lượt chuyển đổi có thể mất từ 1 đến 2 giờ để xử lý và lập chỉ mục, nên hãy thử lại lượt chuyển đổi NOT_FOUND theo định kỳ (ví dụ: cứ sau 1 đến 3 giờ, tối đa 6 giờ). Nếu NOT_FOUND vẫn tồn tại sau 6 giờ, hãy xem các phần sau để biết các nguyên nhân phổ biến theo loại giá trị nhận dạng.
  • INVALID_ARGUMENT và PERMISSION_DENIED (Không thử lại): Dữ liệu lượt chuyển đổi không hợp lệ (ví dụ: dấu thời gian của lượt chuyển đổi cũ hơn 28 ngày hoặc trường không đúng định dạng) hoặc hồ sơ người dùng của bạn không có quyền đối với cấu hình Floodlight mục tiêu. Đừng thử lại các lượt chuyển đổi này nếu chưa khắc phục vấn đề cơ bản.

Nếu toàn bộ yêu cầu HTTP không thành công do lỗi phía máy chủ 5xx hoặc lỗi hạn mức/giới hạn tốc độ 429, hãy thử lại yêu cầu bằng thuật toán thời gian đợi luỹ thừa.

Thử lại và loại bỏ trùng lặp một cách an toàn: Khi thử lại một lượt chuyển đổi không thành công với INTERNAL hoặc NOT_FOUND (hoặc sau khi hết thời gian chờ HTTP 5xx mà không rõ kết quả), hãy luôn gửi chính xác cùng một ordinal và timestampMicros. Nếu một lượt chuyển đổi đã được ghi nhận, thì Campaign Manager 360 sẽ tự động loại bỏ lượt chuyển đổi trùng lặp dựa trên ordinal, giá trị nhận dạng người dùng, hoạt động Floodlight và ngày chuyển đổi.

Lỗi NOT_FOUND khiến quá trình tải mobileDeviceId lên không thành công có nghĩa là gì?

Nguyên nhân phổ biến nhất gây ra lỗi này là:

  • mobileDeviceId không hợp lệ.
  • Search Ads 360 không biết mobileDeviceId. Điều này có nghĩa là thiết bị chưa được Campaign Manager 360 phân phát quảng cáo.
Việc không tải được gclid lên do lỗi NOT_FOUND có nghĩa là gì?

Nguyên nhân phổ biến nhất gây ra lỗi này là:

  • gclid không hợp lệ.
  • gclid không được liên kết với một chiến dịch Search Ads 360 hoặc một mục hàng YouTube trong Display & Video 360. Điều này có thể xảy ra nếu gclid được thu thập từ một lệnh chuyển hướng lượt nhấp trên Google Ads không đi qua Search Ads 360 (ví dụ: lượt nhấp vào phần mở rộng về địa điểm) hoặc được thu thập từ một lệnh chuyển hướng lượt nhấp vào quảng cáo trên YouTube không liên kết với một mục hàng YouTube trên Display & Video 360.
  • Lượt nhấp được liên kết với gclid đã xảy ra quá lâu trong quá khứ. Bạn chỉ có thể chèn lượt chuyển đổi cho những lượt nhấp xảy ra trong vòng 60 ngày trở lại đây.
  • Lượt nhấp được liên kết với gclid xảy ra quá gần đây. Bạn nên trì hoãn việc tải lượt chuyển đổi dựa trên gclid lên trong 1 giờ để đảm bảo rằng gclid được xử lý và có sẵn để so khớp.
Lỗi NOT_FOUND khiến quá trình tải dclid lên không thành công có nghĩa là gì?

Nguyên nhân phổ biến nhất gây ra lỗi này là:

  • dclid không hợp lệ.
  • Lượt nhấp được liên kết với dclid đã xảy ra quá lâu trong quá khứ. Bạn chỉ có thể chèn lượt chuyển đổi cho những lượt nhấp xảy ra trong vòng 60 ngày trở lại đây.
  • Lượt nhấp được liên kết với dclid xảy ra quá gần đây. Bạn nên trì hoãn việc tải lượt chuyển đổi dựa trên dclid lên 1 giờ để đảm bảo rằng dclid được xử lý và có sẵn để so khớp.
Lỗi NOT_FOUND khiến quá trình tải matchId lên không thành công có nghĩa là gì?

Nguyên nhân phổ biến nhất gây ra lỗi này là:

  • matchId không xác định được đối với Campaign Manager 360. Điều này có thể xảy ra nếu matchId được thu thập từ một lệnh gọi Floodlight không được chuyển đúng cách qua Campaign Manager 360 (hãy đảm bảo các lệnh gọi Floodlight của bạn đang hoạt động chính xác, bao gồm cả thông số thẻ matchId).
  • Lệnh gọi Floodlight liên kết với matchId không chứa cookie. Lệnh gọi Floodlight phải chứa cookie / mã nhận dạng để Campaign Manager 360 lưu trữ matchId một cách chính xác (tức là người dùng có thể đã chặn cookie hoặc chọn không tham gia).
  • Lệnh gọi Floodlight liên kết với matchId đã xảy ra quá lâu trong quá khứ. Bạn phải tải Lượt chuyển đổi ngoại tuyến lên trong vòng 60 ngày kể từ ngày gọi Floodlight có chứa matchId.
  • Lệnh gọi Floodlight liên kết với matchId xảy ra quá gần đây. Bạn nên trì hoãn việc tải lượt chuyển đổi dựa trên matchId lên trong 2 giờ để đảm bảo rằng matchId được xử lý và có thể so khớp.
Lượt chuyển đổi ngoại tuyến có dấu thời gian trước khi tạo Hoạt động Floodlight có được đưa vào báo cáo không?

Lượt chuyển đổi ngoại tuyến được tải lên có dấu thời gian trước khi tạo Hoạt động Floodlight có thể được báo cáo là lượt hiển thị Floodlight và là lượt chuyển đổi không được phân bổ/được phân bổ, tối đa 28 ngày trước thời điểm gửi. Tuy nhiên, hành vi này không được đảm bảo và bạn không nên dựa vào hành vi này. Phương pháp hay nhất là tạo Hoạt động Floodlight trước dấu thời gian sớm nhất của một lượt chuyển đổi ngoại tuyến.

Bạn cần có sự đồng ý nào để sử dụng tính năng Chèn lượt chuyển đổi ngoại tuyến cho việc tạo danh sách đối tượng?

Ngoài sự đồng ý về dữ liệu người dùng quảng cáo, bạn phải đặt rõ trường nonPersonalizedAd thành false để bật tính năng tạo danh sách đối tượng.