Chuyển đến nội dung chính
GET
Lấy hiệu suất Google Ads trực tiếp, mỗi ngày một dòng, cho các chiến dịch, nhóm quảng cáo hoặc quảng cáo mà bạn đã tạo qua Ayrshare.
  • Số liệu được đọc từ Google tại thời điểm bạn gọi, không phải từ bản sao được tạo mỗi đêm.
  • Tất cả các giá trị tiền tệ đều tính theo đơn vị tiền tệ của tài khoản quảng cáo, được trả về trong currency trên mỗi hàng.
  • Google bỏ qua những ngày không có hoạt động, vì vậy một khoảng thời gian có thể trả về ít dòng hơn số ngày trong khoảng đó.
  • Google điều chỉnh chi phí và số chuyển đổi của một ngày trong vài ngày sau khi ngày đó kết thúc, vì vậy các ngày gần đây có thể thay đổi giữa các lần đọc.
  • Với chiến dịch Performance Max, hãy dùng level=campaign với id chiến dịch. Chiến dịch Performance Max không có quảng cáo riêng, vì vậy level=ad không trả về dòng nào.

Tham số Header

Tham số Query

string
bắt buộc
Đối tượng mà mỗi hàng báo cáo: campaign (campaignId từ Create), adSet (adGroupId từ Create) hoặc ad (adId từ Create).
string
bắt buộc
Các id chiến dịch, nhóm quảng cáo hoặc quảng cáo, phân tách bằng dấu phẩy, tối đa 50. Tất cả phải thuộc cùng một tài khoản quảng cáo.
string
Mã khách hàng Google Ads gồm 10 chữ số, có hoặc không có dấu gạch nối (123-456-7890).Báo cáo quảng cáo và nhóm quảng cáo đọc tài khoản quảng cáo bạn nêu ở đây. Nếu không có tham số này, báo cáo quảng cáo sẽ tìm trong mọi tài khoản quảng cáo mà liên kết Google Ads của bạn truy cập được, tối đa 25 tài khoản, và báo cáo nhóm quảng cáo chỉ hoạt động khi liên kết của bạn chỉ truy cập được một tài khoản quảng cáo. Hãy nêu tài khoản khi liên kết của bạn truy cập được hơn 25 tài khoản quảng cáo, hoặc hơn một tài khoản đối với báo cáo nhóm quảng cáo. Nếu không, yêu cầu sẽ trả về code: 101.
string
Các chỉ số cần trả về, phân tách bằng dấu phẩy. Bỏ qua tham số này để nhận tất cả. Xem Chỉ số.
string
mặc định:"30 ngày trước"
Ngày đầu tiên, theo định dạng YYYY-MM-DD. Google lưu số liệu hằng ngày trong 37 tháng; một startDate cũ hơn sẽ trả về code: 101.
string
mặc định:"hôm nay"
Ngày cuối cùng, theo định dạng YYYY-MM-DD.

Chỉ số

actions và conversionValue giữ nguyên 0 cho đến khi tính năng theo dõi chuyển đổi được thiết lập trong tài khoản Google Ads của bạn. reach không khả dụng vì Google không báo cáo phạm vi tiếp cận duy nhất cho Search, và breakdowns không khả dụng trên Google. Yêu cầu một trong hai sẽ trả về code: 101.

Phân trang

Mọi dòng được trả về trong một phản hồi duy nhất, vì vậy nextCursor luôn là null.

Lỗi