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 của dự án Google Cloud luôn đượ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 khi 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.
Để 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 trên Google Cloud 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 bằng cách chạy các thao tác hàng loạt và gửi các đối tượng thưa thớt (nếu thích 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 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 biến đổ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 thực hiện và các 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ì đưa ra 50.000 yêu cầu với 1 từ khoá cho mỗi yêu cầu, hãy đưa ra 100 yêu cầu với 500 từ khoá cho mỗi yêu cầu, hoặc thậm chí là 10 yêu cầu với 5.000 từ khoá cho mỗi yêu cầu. 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 chuyển đổi tuần tự, xác thực và lưu trữ trong cơ sở dữ liệu. Việc truyền toàn bộ các đối tượng 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, Google Ads API 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 bắt buộc phải thay đổi.
Các bản cập nhật thưa thớt sẽ xử lý nhanh hơn và ít có khả năng gây ra lỗi. 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 sẵ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, có thể bạn sẽ 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 để tích hợp 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 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 thực hiện trong giao diện người dùng. Những ứng dụng khác chủ yếu hoạt động ngoại tuyến, đưa ra các lệnh gọi API trong quá trình định kỳ ở phần phụ trợ. 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. 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 mà ứng dụng của bạn có thể gặp phải. Luôn thêm một 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 cách hay để tạo 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 để nhân viên vận 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 nắm rõ 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 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à Các lỗi thường gặp để biết thêm thông tin.
Các dịch vụ phụ trợ đồng bộ hoá
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 bị mất đồng bộ hoá. Như đã lưu ý trong hướng dẫn về Các loại lỗi, bạn có thể chủ động giải quyết 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ể cố gắng ngăn chặn các lỗi này một cách chủ động. Một chiến lược chủ động là chạy một tác vụ đồng bộ hoá định kỳ để đối chiếu cơ sở dữ liệu cục bộ với các đối tượng Google Ads trong tài khoản của bạn. Đối với các hệ thống 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 để ngăn việc 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ố.
Lỗi nhật ký
Bạn nên ghi nhật ký tất cả các lỗi để hỗ trợ việc gỡ lỗi và giám sát. Ở mức tối thiểu, hãy ghi nhật ký mã nhận dạng 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ã nhận dạng 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 cũng như phản hồi thô đã được dọn dẹp (đảm bảo rằng bạn đã biên tập thông tin đăng nhập nhạy cảm như mã thông báo OAuth, mã thông báo nhà phát triển nếu vẫn có trong tiêu đề yêu cầu cũ 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 về 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 tự xây dựng giải pháp hoặc sử dụng một trong nhiều công cụ thương mại hiện có có thể dùng nhật ký của bạn để tạo ra các 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 kiểm thử để 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 có quyền truy cập Kiểm thử để sử dụng trên tài khoản kiểm thử. Vì vậy, bạn có thể bắt đầu phát triển bằng API Google Ads ngay lập tức trong khi chờ Google xem xét ứng dụng của bạn để cấp quyền truy cập API ở cấp cao hơn.