API Google Ads là một công cụ mạnh mẽ giúp các nhà quảng cáo có thể quản lý, sửa đổi và tối ưu hóa các chiến dịch quảng cáo trực tiếp từ hệ thống của họ. Việc hiểu rõ cấu trúc của API Google Ads và cách thức hoạt động của các dịch vụ sẽ giúp bạn tận dụng tối đa hiệu quả quảng cáo, đồng thời tiết kiệm thời gian thông qua việc tự động hóa quy trình. Bài viết này cung cấp tổng quan về API Google Ads, từ cấu trúc đến cách truy xuất và thay đổi tài nguyên, cũng như các dịch vụ API hỗ trợ quản lý chiến dịch và truy xuất số liệu hiệu suất.
Lưu ý: Hướng dẫn này dành cho những người dùng đã có kinh nghiệm sử dụng Google Ads. Nếu bạn chưa quen với hệ thống này, hãy tham khảo các bài viết trong Trung tâm trợ giúp để nắm rõ cách tổ chức tài khoản và hiểu các thành phần cơ bản của hệ thống. Ngoài ra, loạt bài viết cơ bản về Google Ads cũng là một nguồn tài liệu hữu ích để tìm hiểu thêm.
Các hướng dẫn trong loạt bài này cung cấp tổng quan về các đối tượng, phương thức và dịch vụ có sẵn trong API Google Ads. Sau khi đọc, bạn sẽ nắm được những khái niệm quan trọng sau:
- Cấu trúc của API Google Ads.
- Cách hoạt động của các phiên bản API Google Ads.
- Dịch vụ API nào được sử dụng để chỉnh sửa một đối tượng.
- Dịch vụ API nào được sử dụng để truy xuất dữ liệu đối tượng và số liệu thống kê hiệu suất.
- Dịch vụ API nào được sử dụng để truy xuất siêu dữ liệu của API.
- Cách cấu trúc và thực hiện lệnh gọi API.
- Cách thay đổi và quản lý tài nguyên thông qua API.
Tài nguyên
Tài nguyên trong Google Ads đại diện cho các thực thể chính trong tài khoản của bạn, chẳng hạn như Campaign và AdGroup. Các tài nguyên này là các thành phần cơ bản mà bạn sẽ tương tác khi quản lý và tối ưu hóa chiến dịch quảng cáo.
Mã đối tượng
Mỗi đối tượng trong Google Ads đều được gán một mã nhận dạng duy nhất. Một số mã nhận dạng này có tính độc nhất toàn cầu, trong khi những mã khác chỉ duy nhất trong phạm vi nhất định.
| Mã đối tượng | Phạm vi tính duy nhất | Độc nhất toàn cầu? |
|---|---|---|
| ID ngân sách | Toàn cầu | Có |
| Mã chiến dịch | Toàn cầu | Có |
| ID nhóm quảng cáo | Toàn cầu | Có |
| ID quảng cáo | Nhóm quảng cáo | Không, nhưng cặp (AdGroupId, AdId) là duy nhất trên toàn hệ thống |
| ID tiêu chí nhóm quảng cáo | Nhóm quảng cáo | Không, nhưng cặp (AdGroupId, CriterionId) là duy nhất trên toàn hệ thống |
| ID tiêu chí chiến dịch | Chiến dịch | Không, nhưng cặp (CampaignId, CriterionId) là duy nhất trên toàn hệ thống |
| Phần mở rộng quảng cáo | Chiến dịch | Không, nhưng cặp (CampaignId, AdExtensionId) là duy nhất trên toàn hệ thống |
| ID nguồn cấp dữ liệu | Toàn cầu | Có |
| Mã mục nguồn cấp dữ liệu | Toàn cầu | Có |
| Mã thuộc tính nguồn cấp dữ liệu | Nguồn cấp dữ liệu | Không |
| ID mối liên kết nguồn cấp dữ liệu | Toàn cầu | Có |
| ID nhãn | Toàn cầu | Có |
| ID danh sách người dùng | Toàn cầu | Có |
Những quy tắc về mã nhận dạng này có vai trò quan trọng trong việc thiết kế bộ nhớ cục bộ cho các hoạt động trên Google Ads.
Một số đối tượng trong Google Ads có thể đại diện cho nhiều loại thực thể khác nhau. Trong những trường hợp này, trường type sẽ mô tả loại thực thể. Ví dụ, đối tượng AdGroupAd có thể đề cập đến quảng cáo văn bản, quảng cáo khách sạn hoặc quảng cáo địa phương. Bạn có thể truy xuất thông tin này thông qua AdGroupAd.ad.type để nhận giá trị tương ứng từ Enum AdType.
Tên tài nguyên
Mỗi tài nguyên trong Google Ads được xác định duy nhất bằng một chuỗi resource_name. Chuỗi này kết hợp tài nguyên và phần tử mẹ của nó để tạo thành một đường dẫn cụ thể. Ví dụ, tên tài nguyên cho một chiến dịch có cấu trúc như sau:
customers/customer_id/campaigns/campaign_id
Vì vậy, nếu chiến dịch của bạn có mã là 987654 và tài khoản Google Ads của bạn có mã khách hàng là 1234567, thì tên tài nguyên đầy đủ sẽ là:
customers/1234567/campaigns/987654
Dịch vụ
Google Ads API cung cấp các dịch vụ cho phép bạn truy xuất và sửa đổi các thực thể trong tài khoản. Có 3 loại dịch vụ chính:
Sửa đổi (thay đổi) đối tượng
Dịch vụ này sử dụng phương thức mutate để sửa đổi các bản sao của tài nguyên. Đồng thời, bạn có thể sử dụng yêu cầu get để truy xuất thông tin của một tài nguyên cụ thể. Điều này rất hữu ích trong việc kiểm tra cấu trúc của tài nguyên.
Lưu ý: Lệnh get bị giới hạn ở mức 1.000 yêu cầu mỗi ngày. Đối với các trường hợp thực tế, bạn nên sử dụng GoogleAdsService để yêu cầu báo cáo thay vì sử dụng quá nhiều lệnh get.
Một số ví dụ về các dịch vụ sửa đổi bao gồm:
- CustomerService: Sửa đổi thông tin khách hàng.
- CampaignService: Sửa đổi chiến dịch.
- AdGroupService: Sửa đổi nhóm quảng cáo.
Mỗi yêu cầu mutate cần đi kèm với một hoặc nhiều đối tượng operation tương ứng. Ví dụ, phương thức CampaignService.MutateCampaigns yêu cầu một hoặc nhiều bản sao của CampaignOperation. Điều này giúp thực hiện các thao tác thay đổi trên chiến dịch. Bạn có thể tham khảo tài liệu về “Thay đổi và kiểm tra đối tượng” để hiểu rõ hơn về quy trình này.
Thay đổi đồng thời
Trong Google Ads API, bạn không thể thực hiện thay đổi đồng thời một đối tượng từ nhiều nguồn khác nhau. Điều này có thể gây ra lỗi nếu nhiều người dùng hoặc nhiều luồng trong ứng dụng của bạn cố gắng cập nhật cùng một đối tượng. Việc thay đổi đồng thời bao gồm các trường hợp như cập nhật đối tượng từ nhiều luồng trong một phiên hoặc từ các ứng dụng khác nhau (ví dụ: ứng dụng của bạn và giao diện người dùng Google Ads cùng lúc).
Google Ads API không cung cấp cơ chế khoá đối tượng trước khi thực hiện thay đổi. Nếu hai nguồn khác nhau cố gắng cập nhật đồng thời một đối tượng, API sẽ trả về lỗi DatabaseError.CONCURRENT_MODIFICATION_ERROR.
Thay đổi không đồng bộ và đồng bộ
Các phương thức thay đổi trong API Google Ads hoạt động theo phương thức đồng bộ. Điều này có nghĩa là lệnh gọi API chỉ trả về phản hồi sau khi các thay đổi đã hoàn tất, đòi hỏi hệ thống phải chờ kết quả của từng thao tác. Mặc dù phương thức này dễ dàng để lập trình, nhưng có thể gây tác động xấu đến hiệu suất hệ thống và lãng phí tài nguyên khi phải chờ quá lâu cho các cuộc gọi API hoàn tất.
Giải pháp thay thế là thực hiện thay đổi không đồng bộ bằng cách sử dụng BatchJobService, cho phép xử lý hàng loạt các thao tác trên nhiều dịch vụ mà không cần chờ kết quả từng thao tác. Khi bạn gửi công việc hàng loạt, máy chủ Google Ads API sẽ thực hiện các thao tác này theo cách không đồng bộ, giúp giảm tải hệ thống và tăng hiệu suất. Bạn có thể kiểm tra định kỳ trạng thái của các công việc đã gửi để theo dõi tiến độ và kết quả.
Tham khảo hướng dẫn về Xử lý hàng loạt để biết thêm chi tiết về quy trình xử lý không đồng bộ trong Google Ads API.
Xác thực thay đổi
Hầu hết các yêu cầu thay đổi trong Google Ads API có thể được xác thực mà không cần thực hiện lệnh gọi thực tế với dữ liệu thật. Điều này cho phép bạn kiểm tra xem yêu cầu có thiếu tham số hoặc có thông tin không chính xác mà không cần thực hiện thay đổi thực tế.
Để sử dụng tính năng này, bạn cần đặt trường boolean validate_only của yêu cầu thành true. Khi đó, yêu cầu sẽ được xác thực đầy đủ như thể lệnh gọi API được thực thi, nhưng thay đổi thực tế sẽ không diễn ra. Nếu không có lỗi, API sẽ trả về phản hồi trống. Nếu có lỗi, các thông báo lỗi trong phản hồi sẽ chỉ ra những điểm cần sửa.
Tính năng validate_only đặc biệt hữu ích khi thử nghiệm các quảng cáo trước khi chạy thực tế, nhằm đảm bảo tuân thủ các chính sách của Google Ads. Ví dụ, quảng cáo có thể bị từ chối nếu vi phạm các quy tắc về từ ngữ, dấu câu, cách viết hoa hoặc độ dài văn bản. Nếu một quảng cáo không hợp lệ, nó có thể làm cho toàn bộ lô bị từ chối. Việc sử dụng validate_only để kiểm tra quảng cáo mới sẽ giúp phát hiện mọi vi phạm trước khi thực thi, giúp tránh những lỗi không mong muốn. Hãy tham khảo mã ví dụ xử lý lỗi vi phạm chính sách để hiểu rõ hơn cách áp dụng trong thực tế.
Nhận đối tượng và số liệu thống kê hiệu suất
GoogleAdsService là dịch vụ duy nhất và toàn diện để truy xuất đối tượng cũng như số liệu thống kê về hiệu suất trong Google Ads. Khi sử dụng Search và SearchStream trong GoogleAdsService, bạn cần cung cấp truy vấn xác định các tài nguyên, thuộc tính của tài nguyên, các chỉ số hiệu suất cần lấy, cùng với các điều kiện lọc và phân đoạn để phân tích số liệu hiệu suất. Để nắm rõ hơn về cú pháp truy vấn, bạn có thể tham khảo hướng dẫn về Ngôn ngữ truy vấn Google Ads.
Truy xuất siêu dữ liệu
GoogleAdsFieldService là dịch vụ hỗ trợ truy xuất siêu dữ liệu của các tài nguyên trong Google Ads API, bao gồm các thuộc tính có sẵn và kiểu dữ liệu của tài nguyên đó. Dịch vụ này cung cấp các thông tin cần thiết để tạo truy vấn cho GoogleAdsService. Bạn cũng có thể sử dụng GoogleAdsFieldService để tra cứu tài liệu tham khảo về các trường và thuộc tính cần thiết trong quá trình tạo truy vấn.
Việc nắm vững cấu trúc và các dịch vụ của API Google Ads giúp bạn tối ưu hóa chiến dịch quảng cáo một cách hiệu quả, thông qua việc tự động hóa quy trình và tối ưu hóa chiến lược quảng cáo. Các dịch vụ API không chỉ hỗ trợ việc quản lý, truy xuất đối tượng mà còn cung cấp các công cụ để theo dõi số liệu thống kê và kiểm tra hiệu suất. Để khai thác tối đa tiềm năng của API Google Ads, hãy liên tục cập nhật các tính năng mới và sử dụng các phương pháp tốt nhất nhằm đảm bảo chiến dịch quảng cáo của bạn luôn đạt hiệu quả cao nhất.
