Kéo dữ liệu theo vị trí địa lý cho các thử nghiệm

Đối với các lượt kéo dữ liệu tự động hoặc trên quy mô lớn cho 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. Bạn sẽ cầ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ừ 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ộ.

Để trích xuất dữ liệu chiến dịch và dữ liệu chi phí một cách chính xác 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à phương thức Search hoặc SearchStream.

  • 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. Đây thường là tiêu chuẩn cho các thử nghiệm GeoX. Ngoài ra, hãy truy vấn location_view để xem hiệu suất dựa trên các vị trí cụ thể mà chiến dịch nhắm đến.

  • Các trường cần thêm:

  • Ví dụ về truy vấn GAQL: Đối với GeoX, nhà quảng cáo dự kiến sẽ kéo các chỉ số về chi phí bằng cách sử dụng Google Ads API thay vì lượt chuyển đổi được phân bổ (lượt chuyển đổi này sẽ đế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

Hậu xử lý và trích xuất dữ liệu

  • Ánh xạ phân khúc theo địa lý: API không trả về tên văn bản thuần tuý (chẳng hạn như "New York") hoặc mã ngắn (chẳng hạn như "501" hoặc "ES") trong các chế độ xem báo cáo. Các trường như segments.geo_target_city hoặc segments.geo_target_country trả về một chuỗi tên tài nguyên trỏ đến GeoTargetConstant (ví dụ: geoTargetConstants/1023191). Nhà phát triển có thể truy vấn trực tiếp bảng geo_target_constant:

    SELECT geo_target_constant.canonical_name
FROM geo_target_constant
WHERE geo_target_constant.resource_name = 'geoTargetConstants/{extracted_id}'

    Ngoài ra, để thực hiện thao tác kết hợp cục bộ trong mã, hãy tải tệp CSV tĩnh về mục tiêu địa lý xuống tại Mục tiêu địa lý.

  • Lượt chuyển đổi chi phí: API trả về các giá trị chi phí theo đơn vị một phần triệu. Bạn phải chia metrics.cost_micros cho 1.000.000 để xuất giá trị tiền tệ tiêu chuẩn bắt buộc trong tệp tải lên.

Mã nhắm mục tiêu (DMA và quốc gia)

Khi thực hiện các đột biến nhắm mục tiêu, nhà quảng cáo phải tra cứu và truyền chính xác mã GeoTargetConstant cho các khu vực đã chọn. Bạn không thể truyền mã ISO hoặc mã Nielsen thô.

Loại khu vực Mã API bắt buộc (GeoTargetConstant) Định dạng cũ (Không sử dụng)
Khu vực DMA Mã 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.date trả về dữ liệu ở định dạng YYYY-MM-DD. Các ứng dụng bảng tính như Excel thường tự động thay đổi định dạng ngày. Trước tiên, hãy tải tệp của bạn lên Google Trang tính để đảm bảo phạm vi ngày được đọc chính xác theo định dạng YYYY-MM-DD bắt buộc.
  • Số 0 ở đầu: Đảm bảo số 0 ở đầu trong mã bưu chính (ví dụ: 01234) không bị xoá. Sử dụng "Định dạng số tuỳ chỉnh" trong Google Trang tính để buộc một chuỗi có 5 chữ số.
  • 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 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 liền mạch với dữ liệu API Google Ads 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 các đơn vị địa lý mà bạn đang kiểm thử (ví dụ: khớp mã bưu chính giao hàng của khách hàng với DMA hoặc cụm mã bưu chính được dùng trong thiết kế).
    • Giá trị gộp: 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 thuần với giá trị âm cho các khoản tiền hoàn lại, thì bạn phải sử dụng số liệu tổng cho thử nghiệm và áp dụng tỷ lệ hoàn tiền sau này.