Sau khi thiết lập ứng dụng khách như mô tả trong phần Ứng dụng đầu tiên của tôi, bạn có thể sử dụng API Search Ads 360 để yêu cầu và tải báo cáo xuống. Bạn có thể đưa ra một trong các loại yêu cầu sau:
- Đồng bộ
Chỉ cần một yêu cầu duy nhất và trả về báo cáo ở định dạng JSON. Yêu cầu đồng bộ:
- Chỉ có thể trả về báo cáo của nhà quảng cáo và tài khoản công cụ
- Chặn khách hàng của bạn cho đến khi Search Ads 360 tạo báo cáo
Nếu đang yêu cầu báo cáo tài khoản công cụ hoặc nhà quảng cáo lớn, bạn nên sử dụng phương pháp không đồng bộ.
- Không đồng bộ
Yêu cầu bạn gửi yêu cầu ban đầu chỉ định dữ liệu bạn muốn có trong báo cáo. Sau đó, bạn gửi thêm các yêu cầu để thăm dò ý kiến về Search Ads 360. Khi Search Ads 360 tạo xong báo cáo, bạn sẽ gửi yêu cầu tải báo cáo xuống dưới dạng một hoặc nhiều tệp. Yêu cầu không đồng bộ:
- Có thể trả về bất kỳ loại báo cáo nào
- Phân đoạn các báo cáo rất lớn thành nhiều tệp
- Định dạng báo cáo dưới dạng CSV hoặc TSV
Mô hình dữ liệu: hàng và cột
Search Ads 360 sắp xếp dữ liệu trong báo cáo thành các hàng và cột. Loại báo cáo mà bạn yêu cầu xác định các hàng được trả về. Ví dụ: nếu bạn yêu cầu báo cáo từ khoá, thì mỗi hàng sẽ chứa dữ liệu về một từ khoá. Hãy xem tài liệu tham khảo về Loại báo cáo để biết danh sách tất cả các loại báo cáo. Bạn chỉ định cột mà bạn muốn đưa vào báo cáo bằng cách đặt tên cho từng cột trong yêu cầu báo cáo. Hãy xem tài liệu tham khảo về Loại báo cáo để biết danh sách các cột có thể được trả về cho từng loại báo cáo.
Hoạt động của cột
Hành vi của một cột phụ thuộc vào loại dữ liệu mà cột đó chứa (tài liệu tham khảo Loại báo cáo cho biết hành vi của từng cột):
Cột thuộc tính. Cột thuộc tính chứa dữ liệu giúp định cấu hình hoặc xác định một thực thể trong chiến dịch, chẳng hạn như tên chiến dịch hoặc giá thầu từ khoá. API Search Ads 360 luôn trả về giá trị hiện tại cho một cột thuộc tính, bất kể ngày hoặc phạm vi ngày bất kỳ được chỉ định trong yêu cầu. Ví dụ: nếu ngày hôm qua, bạn đã thay đổi giá thầu của từ khoá từ 2,00 thành 1,50, sau đó yêu cầu báo cáo dữ liệu của tháng trước, báo cáo sẽ trả về giá trị là 1,5 cho giá thầu từ khoá.
Cột chỉ số. Cột chỉ số chứa dữ liệu về hiệu suất của chiến dịch, chẳng hạn như số lượt nhấp vào quảng cáo, số lượt truy cập do thẻ Floodlight ghi lại hoặc doanh thu. Trừ phi bạn chỉ định phạm vi thời gian là của một ngày, API sẽ trả về giá trị tổng hợp cho các cột chỉ số. Ví dụ: nếu bạn yêu cầu báo cáo cho dữ liệu của tháng trước, thì API sẽ trả về tổng số lượt nhấp của tháng trước.
Cột phân đoạn. Cột phân đoạn chia dữ liệu thành các hàng riêng biệt. Ví dụ:
datelà cột phân đoạn mà bạn có thể chỉ định cho nhiều loại báo cáo. Nếu bạn chỉ định cộtdatetrong báo cáo từ khoá có phạm vi ngày từ 2013-01-01 đến 7-01-2013, thì API sẽ trả về 7 hàng cho mỗi từ khoá, mỗi hàng tương ứng với một ngày và hiển thị các chỉ số cho ngày đó. Hãy xem Báo cáo đã phân đoạn.
Đơn vị tiền tệ
Bạn phải chỉ định đơn vị tiền tệ của dữ liệu tiền tệ (cả các thuộc tính như dailyBudget và các chỉ số như
cost). Bạn có thể chỉ định một trong các yếu tố sau:
- Đơn vị tiền tệ của công ty quảng cáo, nếu báo cáo thuộc phạm vi của một công ty quảng cáo, nhà quảng cáo hoặc tài khoản công cụ.
- Đơn vị tiền tệ của nhà quảng cáo, nếu báo cáo phạm vi một tài khoản nhà quảng cáo hoặc công cụ.
- Đơn vị tiền tệ của tài khoản công cụ, nếu báo cáo chỉ dành cho một tài khoản công cụ.
- USD
Sử dụng thuộc tính yêu cầu Reports.request.statisticsCurrency để chỉ định đơn vị tiền tệ.
Bản thân báo cáo sẽ cho biết đơn vị tiền tệ trong thuộc tính Reports.statisticsCurrencyCode.
Múi giờ
Các chỉ số của Search Ads 360 được lưu trữ ở dạng ngày không có múi giờ. Những ngày này tương ứng với múi giờ
của tài khoản công cụ đối với các chỉ số về công cụ (chẳng hạn như số lượt nhấp, số lượt hiển thị và số lượt truy cập) và
múi giờ của mạng Campaign Manager cho các chỉ số về lượt chuyển đổi (chẳng hạn như các hành động,
giao dịch và doanh thu). Khi mọi chỉ số trong một báo cáo đều đến từ cùng một múi giờ,
múi giờ đó sẽ được trả về trong yêu cầu. Nếu không, hệ thống sẽ không trả về múi giờ.
Các yêu cầu của bạn có thể đặt Reports.request.verifySingleTimeZone: true thành những báo cáo không thành công trình bày chỉ số từ nhiều múi giờ.
Nếu tất cả các chỉ số có trong báo cáo đều thuộc một múi giờ, thì múi giờ đó sẽ được trả về theo Reports.statisticsTimeZoneReports.