Hướng dẫn này trình bày một số phương pháp hay nhất mà bạn có thể triển khai để tối ưu hoá hiệu quả và hiệu suất của ứng dụng.
Duy trì ứng dụng
Để đảm bảo ứng dụng của bạn chạy liên tục, hãy làm như sau:
Đảm bảo rằng danh sách chủ sở hữu và người chỉnh sửa dự án Google Cloud của bạn là danh sách mới nhất. Chúng tôi sẽ liên hệ với những người dùng này trong trường hợp khẩn cấp hoặc có các chủ đề liên quan đến việc tuân thủ Điều khoản và điều kiện của API. Nếu chúng tôi không thể liên hệ với bạn về việc tuân thủ Điều khoản và điều kiện của API, thì quyền truy cập API của bạn có thể bị hạ cấp hoặc thu hồi.
Để được thông báo về các vấn đề như thay đổi sản phẩm, thời gian ngừng hoạt động để bảo trì và ngày ngừng cung cấp, hãy đăng ký blog API và Blog sản phẩm của chúng tôi.
Đảm bảo ứng dụng của bạn tuân thủ Điều khoản và điều kiện (T&C) của API Google Ads. Nếu cần, nhóm tuân thủ API sẽ liên hệ với chủ sở hữu và người chỉnh sửa dự án Google Cloud của bạn có quyền truy cập API. Nếu có câu hỏi hoặc mối lo ngại về Điều khoản và điều kiện, bạn có thể liên hệ với nhóm tuân thủ bằng cách trả lời email mà họ gửi cho bạn khi xem xét đơn đăng ký quyền truy cập API của bạn.
Tối ưu hoá
Bạn có thể tối ưu hoá ứng dụng của mình bằng cách chạy các thao tác theo đợt và nếu thích hợp, hãy gửi các đối tượng thưa thớt.
Thao tác theo đợt
Việc đưa ra yêu cầu đối với API sẽ phải chịu một số chi phí cố định, chẳng hạn như độ trễ mạng khứ hồi, quá trình xử lý tuần tự hoá và giải tuần tự hoá cũng như các lệnh gọi đến hệ thống phụ trợ. Để giảm tác động của các chi phí cố định này và tăng hiệu suất tổng thể, hầu hết các phương thức thay đổi trong API đều được thiết kế để chấp nhận một mảng các thao tác. Bằng cách gộp nhiều thao tác vào mỗi yêu cầu, bạn có thể giảm số lượng yêu cầu mà bạn đưa ra và các chi phí cố định liên quan. Nếu có thể, hãy tránh đưa ra các yêu cầu chỉ có một thao tác.
Ví dụ: giả sử bạn đang thêm 50.000 từ khoá vào một chiến dịch trên nhiều nhóm quảng cáo. Thay vì đưa ra 50.000 yêu cầu,mỗi yêu cầu có 1 từ khoá, hãy đưa ra 100 yêu cầu, mỗi yêu cầu có 500 từ khoá hoặc thậm chí 10 yêu cầu,mỗi yêu cầu có 5.000 từ khoá. Có giới hạn về số lượng thao tác được phép trong một yêu cầu, vì vậy, bạn có thể cần điều chỉnh kích thước lô để đạt được hiệu suất tối ưu.
Gửi các đối tượng thưa thớt
Khi các đối tượng được gửi đến API, các trường phải được giải tuần tự hoá, xác thực và lưu trữ trong cơ sở dữ liệu. Việc truyền các đối tượng đầy đủ khi bạn chỉ muốn cập nhật một vài trường có thể dẫn đến thời gian xử lý bổ sung và giảm hiệu suất. Để giảm thiểu vấn đề này, API Google Ads hỗ trợ các bản cập nhật thưa thớt, cho phép bạn chỉ điền các trường trong một đối tượng mà bạn cần thay đổi hoặc các trường bắt buộc.
Các bản cập nhật thưa thớt xử lý nhanh hơn và ít có khả năng gây ra lỗi hơn. Các trường không có trong update_mask (còn gọi là FieldMask) sẽ không thay đổi.
Ví dụ: một ứng dụng cập nhật giá thầu ở cấp từ khoá có thể hưởng lợi từ việc sử dụng các bản cập nhật thưa thớt, vì chỉ cần điền các trường mã nhóm quảng cáo, mã tiêu chí và giá thầu.
Xử lý và quản lý lỗi
Trong quá trình phát triển, bạn có thể gặp phải lỗi. Phần này mô tả các điểm cần cân nhắc và chiến lược để xây dựng tính năng quản lý lỗi vào ứng dụng của bạn. Ngoài phần này, hãy truy cập vào Hướng dẫn khắc phục sự cố để biết thêm thông tin về cách quản lý lỗi.
Phân biệt các nguồn yêu cầu
Một số ứng dụng chủ yếu là tương tác, đưa ra các lệnh gọi API trực tiếp để phản hồi các hành động do người dùng khởi tạo trong giao diện người dùng. Các ứng dụng khác chủ yếu hoạt động ở chế độ ngoại tuyến, đưa ra các lệnh gọi API như một phần của quy trình phụ trợ định kỳ. Nhiều ứng dụng kết hợp cả hai. Khi nghĩ về việc quản lý lỗi, bạn nên phân biệt các loại yêu cầu này.
Đối với các yêu cầu do người dùng khởi tạo, mối quan tâm chính của bạn là mang lại trải nghiệm tốt cho người dùng. Hãy sử dụng lỗi cụ thể đã xảy ra để cung cấp cho người dùng nhiều ngữ cảnh nhất có thể trong giao diện người dùng. Đưa ra các bước rõ ràng mà họ có thể thực hiện để giải quyết lỗi (xem các đề xuất sau).
Đối với các yêu cầu được khởi tạo trên phần phụ trợ, hãy triển khai trình xử lý cho các loại lỗi mà ứng dụng của bạn có thể gặp phải. Luôn thêm trình xử lý mặc định để giải quyết các lỗi hiếm gặp hoặc chưa từng gặp phải. Một phương pháp hay cho trình xử lý mặc định là thêm thao tác và lỗi không thành công vào hàng đợi để người điều hành xem xét và xác định giải pháp phù hợp.
Phân biệt các loại lỗi
Việc biết sự khác biệt giữa các loại lỗi trong API Google Ads là rất quan trọng khi xây dựng quy trình xử lý lỗi mạnh mẽ. Một số loại lỗi thường gặp nhất là:
Hãy tham khảo phần Các loại lỗi và Lỗi thường gặp để biết thêm chi tiết.
Đồng bộ hoá phần phụ trợ
Nếu người dùng ứng dụng của bạn có quyền truy cập thủ công vào tài khoản Google Ads, thì họ có thể thực hiện các thay đổi mà ứng dụng của bạn không biết, khiến cơ sở dữ liệu cục bộ của ứng dụng bị mất đồng bộ. Như đã lưu ý trong hướng dẫn Các loại lỗi, bạn có thể giải quyết
các lỗi liên quan đến việc đồng bộ hoá một cách phản ứng khi chúng xảy ra, nhưng bạn cũng có thể chủ động ngăn chặn
chúng. Một chiến lược chủ động là chạy công việc đồng bộ hoá định kỳ để đối chiếu cơ sở dữ liệu cục bộ của bạn với các đối tượng Google Ads trong tài khoản của bạn. Đối với
các hệ phân cấp tài khoản lớn, hãy tránh kéo tất cả các đối tượng trên mọi tài khoản
hằng đêm để tránh hết hạn mức hằng ngày; thay vào đó, hãy truy vấn
ChangeStatus hoặc lọc các thực thể được sửa đổi gần đây để đồng bộ hoá các
thay đổi theo gia số.
Ghi nhật ký lỗi
Bạn nên ghi nhật ký tất cả các lỗi để tạo điều kiện thuận lợi cho việc gỡ lỗi và giám sát. Ít nhất, hãy ghi nhật ký mã yêu cầu, các thao tác gây ra lỗi và chính lỗi đó. Các thông tin khác cần ghi nhật ký bao gồm mã khách hàng, dịch vụ API, độ trễ yêu cầu khứ hồi, số lần thử lại và yêu cầu và phản hồi thô đã được làm sạch (đảm bảo chỉnh sửa các thông tin xác thực nhạy cảm như mã thông báo OAuth và mọi thông tin nhận dạng cá nhân).
Theo dõi xu hướng
Hãy nhớ theo dõi các xu hướng về lỗi API để bạn có thể phát hiện và giải quyết các vấn đề với ứng dụng của mình. Hãy cân nhắc xây dựng giải pháp của riêng bạn hoặc sử dụng một trong nhiều công cụ thương mại hiện có có thể sử dụng nhật ký của bạn để tạo trang tổng quan tương tác và gửi cảnh báo tự động.
Quá trình phát triển
Sử dụng tài khoản thử nghiệm trong quá trình phát triển.
Sử dụng tài khoản thử nghiệm
Tài khoản thử nghiệm là tài khoản Google Ads không thực sự phân phát quảng cáo. Bạn có thể sử dụng tài khoản thử nghiệm để thử nghiệm Google Ads API và kiểm tra xem khả năng kết nối, logic quản lý chiến dịch hoặc quy trình xử lý khác của ứng dụng có hoạt động như mong đợi hay không. Dự án Google Cloud của bạn chỉ cần quyền truy cập Thử nghiệm để sử dụng trên tài khoản thử nghiệm, vì vậy, bạn có thể bắt đầu phát triển ngay lập tức bằng API Google Ads trong khi chờ Google xem xét đơn đăng ký của bạn để có cấp quyền truy cập API cao hơn.