Đối với các lượt kéo dữ liệu tự động hoặc trên quy mô lớn cho các thử nghiệm GeoX, bạn phải sử dụng Google Ads API để kéo dữ liệu về chi phí và mức chi tiêu. Sau đó, bạn kết hợp dữ liệu này với dữ liệu lượt chuyển đổi hoặc doanh thu thô, chưa được lọc và không được phân bổ từ hệ thống quản lý quan hệ khách hàng (CRM) nội bộ, Điểm bán hàng (POS) hoặc cơ sở dữ liệu bán hàng nội bộ.
Cấu trúc quy trình công việc API được đề xuất
Để lấy chính xác dữ liệu chiến dịch và dữ liệu chi phí theo phân khúc địa lý, hãy làm theo cấu trúc sau:
- Dịch vụ: Sử dụng
GoogleAdsService, cụ thể là các phương thứcSearchhoặcSearchStream. Tài nguyên: Truy vấn
geographic_viewđể xem vị trí thực tế hoặc vị trí mà người dùng quan tâm, thường là tiêu chuẩn cho các thử nghiệm GeoX. Ngoài ra, hãy truy vấnlocation_viewđể xem hiệu suất dựa trên các mục tiêu vị trí cụ thể mà chiến dịch nhắm đến.Các trường cần thêm:
campaign.idsegments.datesegments.geo_target_city(hoặc khu vực hoặc quốc gia tuỳ thuộc vào mức độ chi tiết của GeoX)metrics.cost_micros
Ví dụ về truy vấn GAQL: Đối với GeoX, nhà quảng cáo sẽ lấy các chỉ số về chi phí bằng Google Ads API thay vì lượt chuyển đổi được phân bổ (lượt chuyển đổi này phải đến từ hệ thống CRM nội bộ hoặc hệ thống của bên thứ ba). Bạn có thể sử dụng truy vấn sau:
SELECT campaign.id, segments.date, segments.geo_target_city, metrics.cost_micros FROM geographic_view WHERE segments.date DURING LAST_30_DAYS
Xử lý hậu kỳ và trích xuất dữ liệu
Ánh xạ phân khúc địa lý: API không trả về tên văn bản thuần túy (như "New York") hoặc mã ngắn (như "501" hoặc "ES") trong chế độ xem báo cáo. Các trường như
segments.geo_target_cityhoặcsegments.geo_target_countrytrả về một chuỗi tên tài nguyên trỏ đếnGeoTargetConstant(ví dụ:geoTargetConstants/1023191). Trích xuất mã nhận dạng dạng số (1023191) và truy vấn tài nguyêngeo_target_constant:SELECT geo_target_constant.id, geo_target_constant.name, geo_target_constant.canonical_name FROM geo_target_constant WHERE geo_target_constant.id = 1023191Ngoài ra, để thực hiện phép nối cục bộ trong mã, hãy tải tệp CSV mục tiêu địa lý tĩnh xuống tại Mục tiêu địa lý.
Chuyển đổi chi phí: API trả về giá trị chi phí theo đơn vị một phần triệu. Bạn phải chia
metrics.cost_microscho 1.000.000 để có được giá trị tiền tệ chuẩn cần thiết trong tệp tải lên.
Mã vị trí địa lý cho các đột biến nhắm mục tiêu
Khi thực hiện các thay đổi về tiêu chí nhắm mục tiêu theo vị trí của chiến dịch hoặc nhóm quảng cáo, nhà quảng cáo phải tra cứu và truyền chính xác mã nhận dạng GeoTargetConstant (geoTargetConstants/ID) cho các khu vực đã chọn. Bạn không thể truyền mã ISO hoặc Nielsen thô.
| Loại khu vực | Mã API bắt buộc (GeoTargetConstant) |
Định dạng cũ (Đừng sử dụng) |
|---|---|---|
| Khu vực DMA | Mã nhận dạng 200501 (cho New York) |
Mã Nielsen (ví dụ: 501 cho New York) |
| Quốc gia | Mã nhận dạng 2724 (đối với Tây Ban Nha) |
Mã ISO (ví dụ: "ES" cho Tây Ban Nha) |
Các phương pháp hay nhất và lỗi định dạng thường gặp
- Định dạng ngày: Trường
segments.datetrả về chuỗi ngày ISO-8601 ở định dạngYYYY-MM-DD. Trong quy trình ETL, hãy chuyển đổi tuần tự các trường ngày một cách rõ ràng dưới dạng chuỗiYYYY-MM-DDvà tránh mở các tệp CSV đã xuất trong các ứng dụng bảng tính tự động định dạng lại các cột ngày. - Số 0 ở đầu trong mã bưu chính: Hãy coi mã bưu chính và mã ZIP (ví dụ:
01234) là loại chuỗi (VARCHARhoặcSTRING) trong toàn bộ quy trình dữ liệu thay vì số nguyên để số 0 ở đầu không bao giờ bị loại bỏ. - Tổng hợp: Nếu chạy một nghiên cứu đa ô, bạn phải cung cấp các chỉ số riêng biệt về mức chi tiêu cho từng nhóm can thiệp.
- Kết hợp dữ liệu lượt chuyển đổi: Khi kết hợp với dữ liệu lượt chuyển đổi từ hệ thống CRM nội bộ hoặc cơ sở dữ liệu bán hàng nội bộ, hãy đảm bảo rằng dữ liệu lượt chuyển đổi có các thuộc tính sau để đảm bảo quá trình xử lý dữ liệu diễn ra suôn sẻ với dữ liệu Google Ads API và GeoX:
- Chuỗi thời gian hằng ngày: Dữ liệu phải được tổng hợp theo ngày.
- Cấp độ địa lý: Mỗi lượt chuyển đổi phải được liên kết với chính xác đơn vị địa lý mà bạn đang thử nghiệm (ví dụ: so khớp mã ZIP giao hàng của khách hàng với DMA hoặc cụm bưu chính được sử dụng trong thiết kế).
- Giá trị tổng: Dữ liệu phải là giá trị tuyệt đối, không âm, chẳng hạn như Tổng doanh thu hoặc Tổng số lượt chuyển đổi. Nếu CRM của bạn theo dõi Doanh thu ròng bằng các giá trị âm cho các khoản hoàn tiền, bạn phải sử dụng số gộp cho thử nghiệm và áp dụng tỷ lệ hoàn tiền sau.