Phân đoạn

Bạn có thể triển khai các phân đoạn (có trong giao diện người dùng Google Ads dưới dạng một trình đơn riêng) trong API Google Ads bằng cách thêm trường thích hợp vào truy vấn. Ví dụ: thêm segments.device vào truy vấn, dẫn đến một báo cáo có một hàng cho từng tổ hợp thiết bị và tài nguyên được chỉ định trong mệnh đề FROM và các giá trị thống kê (lượt hiển thị, lượt nhấp, lượt chuyển đổi, v.v.) được phân chia.

Mặc dù trong giao diện người dùng Google Ads, bạn chỉ có thể sử dụng một phân khúc tại một thời điểm, nhưng với API, bạn có thể chỉ định nhiều phân khúc trong cùng một truy vấn.

SELECT
  campaign.name,
  campaign.status,
  segments.device,
  metrics.impressions
FROM campaign

Kết quả từ việc gửi truy vấn này đến GoogleAdsService.SearchStream sẽ có dạng như chuỗi JSON sau:

{
  "results":[
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"10922"
      },
      "segments":{
        "device":"MOBILE"
      }
    },
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"28297"
      },
      "segments":{
        "device":"DESKTOP"
      }
    },
    ...
  ]
}

Lưu ý rằng trong kết quả mẫu ở trên, các thuộc tính cho đối tượng thứ nhất và thứ hai (bao gồm cả tên tài nguyên) là giống nhau. Các lượt hiển thị được phân đoạn theo thiết bị và do đó, hệ thống có thể trả về 2 hoặc nhiều đối tượng cho cùng một chiến dịch.

Phân đoạn ngầm ẩn

Ban đầu, mỗi báo cáo được phân đoạn theo tài nguyên được chỉ định trong mệnh đề FROM. Trường resource_name của tài nguyên trong mệnh đề FROM được trả về và các chỉ số được phân đoạn theo trường đó, ngay cả khi trường resource_name không được đưa vào truy vấn một cách rõ ràng. Ví dụ: khi bạn chỉ định ad_group làm tài nguyên trong mệnh đề FROM, ad_group.resource_name sẽ tự động được trả về và các chỉ số sẽ ngầm phân đoạn dựa trên tài nguyên đó ở cấp nhóm quảng cáo.

Đối với truy vấn này,

SELECT metrics.impressions
FROM ad_group

bạn sẽ nhận được một chuỗi JSON như sau:

{
  "results":[
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/2222222222"
      },
      "metrics":{
        "impressions":"237"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/33333333333"
      },
      "metrics":{
        "impressions":"15"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/44444444444"
      },
      "metrics":{
        "impressions":"0"
      }
    }
  ]
}

Xin lưu ý rằng trường resource_name của adGroup luôn được trả về vì ad_group đã được chỉ định làm tài nguyên trong mệnh đề FROM.

Các trường phân đoạn có thể chọn

Không phải trường phân đoạn nào cũng có thể chọn cho một tài nguyên nhất định trong mệnh đề FROM. Ví dụ: chúng ta sẽ tiếp tục truy vấn từ tài nguyên ad_group. Để có thể chọn một trường phân đoạn từ tài nguyên ad_group, trường đó cần phải tồn tại trong danh sách Segments cho ad_group. Danh sách Segments là phần màu vàng của bảng trường có sẵn trên trang siêu dữ liệu của tài nguyên ad_group.

Tài nguyên phân đoạn

Khi chọn trong số một số tài nguyên, bạn có thể tham gia ngầm những tài nguyên liên quan bằng cách chọn các trường của những tài nguyên đó cùng với các trường của tài nguyên trong mệnh đề FROM. Bạn có thể tìm thấy các tài nguyên liên quan này trong danh sách Attributed Resources của tài nguyên trên trang siêu dữ liệu của mệnh đề FROM. Trong trường hợp của tài nguyên ad_group, bạn sẽ thấy rằng mình cũng có thể chọn các trường từ tài nguyên campaign. Trường resource_name của bất kỳ Attributed Resources nào có ít nhất 1 trường trong mệnh đề SELECT sẽ tự động được trả về, ngay cả khi trườngresource_name không được đưa vào rõ ràng trong truy vấn.

Tương tự như việc chọn trường Attributed Resource, bạn cũng có thể chọn trường Segmenting Resource. Nếu một tài nguyên cụ thể có danh sách Segmenting Resources trên trang siêu dữ liệu, thì việc chọn các trường từ một trong các tài nguyên được liệt kê đó sẽ khiến truy vấn được phân đoạn thêm theo resource_name được trả về của Segmenting Resource đó. Ví dụ: bạn sẽ thấy tài nguyên campaign được liệt kê dưới dạng Segmenting Resource cho tài nguyên campaign_budget. Việc chọn bất kỳ trường chiến dịch nào (chẳng hạn như campaign.name) từ tài nguyên campaign_budget sẽ không chỉ khiến trường campaign.name được trả về mà còn khiến trường campaign.resource_name được trả về và phân đoạn.

Khả năng lựa chọn giữa các phân khúc và chỉ số

Một trường phân đoạn nhất định có thể không tương thích với một số trường phân đoạn khác hoặc với một số trường chỉ số. Để xác định trường phân đoạn nào tương thích với nhau, bạn có thể xem danh sách selectable_with của các phân đoạn trong mệnh đề SELECT.

Trong trường hợp tài nguyên ad_group, bạn có thể chọn hơn 50 phân đoạn. Tuy nhiên, danh sách selectable_with cho segments.hotel_check_in_date là một tập hợp các phân khúc tương thích nhỏ hơn nhiều. Điều này có nghĩa là nếu thêm trường segments.hotel_check_in_date vào mệnh đề SELECT, bạn sẽ giới hạn các phân đoạn có sẵn mà bạn còn lại để chọn thành giao điểm của hai danh sách này.

Khi bạn thêm một số phân đoạn, các chỉ số trong hàng tóm tắt có thể giảm

Khi bạn thêm segments.keyword.info.match_type vào truy vấn bằng FROM ad_group_ad, phân đoạn đó sẽ yêu cầu truy vấn chỉ lấy các hàng dữ liệu có từ khoá và xoá mọi hàng không liên kết với từ khoá. Trong trường hợp này, chỉ số sẽ thấp hơn vì sẽ loại trừ mọi chỉ số không phải từ khoá.

Quy tắc cho các phân đoạn trong mệnh đề WHERE

Khi một phân đoạn nằm trong mệnh đề WHERE, phân đoạn đó cũng phải nằm trong mệnh đề SELECT. Trường hợp ngoại lệ đối với quy tắc này là các phân đoạn ngày sau đây, được gọi là phân đoạn ngày chính:

• segments.date
• segments.week
• segments.month
• segments.quarter
• segments.year

Quy tắc cho các trường phân đoạn ngày chính

Các phân đoạn segments.date, segments.week, segments.month, segments.quarter và segments.year hoạt động như sau:

• Bạn có thể lọc các phân đoạn này trong mệnh đề WHERE mà không cần xuất hiện trong mệnh đề SELECT.

• Nếu bất kỳ phân đoạn nào trong số này nằm trong mệnh đề SELECT, thì bạn phải chỉ định phạm vi ngày hữu hạn gồm các phân đoạn ngày chính trong mệnh đề WHERE (phân đoạn ngày không cần phải giống như phân đoạn được chỉ định trong SELECT).

Ví dụ

SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign

SELECT
  campaign.name,
  metrics.clicks
FROM campaign
WHERE segments.date > '2020-01-01'
  AND segments.date < '2020-02-01'

SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign
WHERE segments.date > '2020-01-01'
  AND segments.date < '2020-02-01'

SELECT
  campaign.name,
  metrics.clicks,
  segments.month
FROM campaign
WHERE segments.date > '2020-01-01'
  AND segments.date < '2020-02-01'

SELECT
  campaign.name,
  metrics.clicks,
  segments.quarter,
  segments.month
FROM campaign
WHERE segments.year > 2015
  AND segments.year < 2020

search_term_view

Xin lưu ý rằng đối với tài nguyên search_term_view, tài nguyên đó cũng được phân đoạn ngầm theo nhóm quảng cáo, không chỉ theo cụm từ tìm kiếm, như được phản ánh trong cấu trúc của tên tài nguyên (cũng bao gồm cả nhóm quảng cáo). Do đó, bạn sẽ nhận được một số hàng dường như trùng lặp với cùng một cụm từ tìm kiếm xuất hiện trong kết quả nhưng thực tế thì các hàng sẽ thuộc về một nhóm quảng cáo khác:

{
  "results":[
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~2222222222~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"3"
      },
      "segments":{
        "date":"2015-06-15"
      }
    },
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~33333333333~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"2"
      },
      "segments":{
        "date":"2015-06-15"
      }
    }
  ]
}

Mặc dù 2 đối tượng được trả về trong ví dụ này có vẻ như trùng lặp, nhưng tên tài nguyên của các đối tượng này thực sự khác nhau, đặc biệt là trong phần "nhóm quảng cáo". Điều này có nghĩa là cụm từ tìm kiếm "google ảnh" được phân bổ cho hai nhóm quảng cáo (mã 2222222222 và 33333333333) vào cùng một ngày (15/06/2015). Do đó, chúng ta có thể kết luận rằng API hoạt động như dự kiến và không trả về các đối tượng trùng lặp trong trường hợp này.