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 không bị gián đoạn, 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 của bạn trên Google Cloud đã được cập 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 về 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.
Để nắm được thông tin về các vấn đề như thay đổi về sản phẩm, thời gian ngừng hoạt động để bảo trì và ngày ngừng hoạt động, hãy đăng ký theo dõi blog về API và blog về 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 Google Ads API. 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 thắc mắc 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 bằng cách chạy các thao tác theo lô và gửi các đối tượng thưa thớt (nếu phù hợp).
Thao tác theo đợt
Việc gửi yêu cầu đến API sẽ phát sinh một số chi phí cố định, chẳng hạn như độ trễ mạng khứ hồi, quá trình chuyển đổi tuần tự và chuyển đổi tuần tự ngược, 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 và chi phí cố định liên quan. Nếu có thể, hãy tránh đưa ra 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ì thực hiện 50.000 yêu cầu, mỗi yêu cầu có 1 từ khoá, hãy thực hiện 100 yêu cầu, mỗi yêu cầu có 500 từ khoá, hoặc thậm chí là 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 đố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ự, xác thực và lưu trữ trong cơ sở dữ liệu. Việc truyền vào 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ý tăng thêm và hiệu suất giảm. Để giảm thiểu vấn đề này, Google Ads API hỗ trợ các bản cập nhật thưa, 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 bắt buộc.
Quá trình cập nhật thưa thớt diễn ra nhanh hơn và ít có khả năng xảy ra lỗi hơn. Các trường không có trong update_mask (còn gọi là FieldMask) sẽ được giữ nguyên.
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 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 mang tính tương tác, đưa ra lệnh gọi API trực tiếp để phản hồi các hành động do người dùng thực hiện trong giao diện người dùng. Một số ứng dụng khác chủ yếu hoạt động khi không có mạng, đưa ra lệnh gọi API trong một quy trình định kỳ ở phần phụ trợ. Nhiều ứng dụng kết hợp cả hai. Khi nghĩ đến 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 thực hiện, 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. Sử dụng lỗi cụ thể đã xảy ra để cung cấp cho người dùng nhiều bối 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 bắt đầu trên phần phụ trợ, hãy triển khai trình xử lý cho các loại lỗi khác nhau 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 trước đây. Một phương pháp hay cho trình xử lý mặc định là thêm thao tác không thành công và lỗi vào hàng đợi để người vận hành xem xét và xác định giải pháp thích hợp.
Phân biệt các loại lỗi
Việc biết được sự khác biệt giữa các loại lỗi trong Google Ads API là rất quan trọng khi xây dựng quy trình xử lý lỗi hiệu quả. Một số loại lỗi phổ biến nhất là:
Hãy tham khảo phần Các loại lỗi và Các lỗi thường gặp để biết thêm thông tin.
Đồ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 những 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 không đồng bộ hoá. Như đã lưu ý trong hướng dẫn về Các loại lỗi, bạn có thể xử lý các lỗi liên quan đến việc đồng bộ hoá 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 một công việc đồng bộ hoá định kỳ để điều chỉnh 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
hệ thống phân cấp tài khoản lớn, hãy tránh lấy tất cả đối tượng trên mọi tài khoản
hằng đêm để tránh làm cạn kiệ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 thời gian.
Lỗi nhật ký
Tất cả lỗi phải được ghi nhật ký để hỗ trợ việc gỡ lỗi và giám sát. Ở mức tối thiểu, hãy ghi lại mã yêu cầu, các thao tác gây ra lỗi và chính lỗi đó. Thông tin khác cần ghi lại 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, cũng như yêu cầu và phản hồi thô đã được dọn dẹp (đảm bảo loại bỏ 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 xu hướng lỗi API để có thể phát hiện và giải quyết các vấn đề với ứng dụng của bạn. Hãy cân nhắc việ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 có sẵn 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à những 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 của ứng dụng, logic quản lý chiến dịch hoặc các quy trình xử lý khác có hoạt động như mong đợi hay không. Dự án Google Cloud của bạn chỉ cần có quyền truy cập thử nghiệm để sử dụng trên tài khoản thử nghiệm. Nhờ đó, bạn có thể bắt đầu phát triển bằng Google Ads API ngay lập tức trong khi chờ Google xem xét đơn đăng ký của bạn để có cấp truy cập API cao hơn.