Podział na segmenty

Segmentacja jest dostępna w interfejsie Google Ads jako osobne menu. Segmentację możesz wdrożyć w interfejsie Google Ads API, dodając odpowiednie pole do zapytania. Załóżmy na przykład, że do zapytania dodasz segments.device. W wyniku tego otrzymasz raport z wierszem dla każdej kombinacji urządzenia i określonego zasobu w klauzuli FROM oraz wartości statystyczne (wyświetlenia, kliknięcia, konwersje itp.) podzielone między te kombinacje.

W interfejsie Google Ads można używać tylko jednego segmentu naraz, ale za pomocą interfejsu API możesz określić wiele segmentów w tym samym zapytaniu.

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

Wyniki wysłania tego zapytania do GoogleAdsService.SearchStream będą podobne do tego ciągu JSON:

{
  "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"
      }
    }
  ]
}

W tym przykładowym wyniku atrybuty pierwszego i drugiego obiektu, w tym nazwa zasobu, są takie same. Wyświetlenia są segmentowane według urządzenia, dlatego w przypadku tej samej kampanii można zwrócić co najmniej 2 obiekty.

Niejawny podział na segmenty

Każdy raport jest początkowo segmentowany według zasobu określonego w klauzuli FROM. Pole resource_name zasobu w klauzuli FROM jest zwracane, a dane są segmentowane według tego pola, nawet jeśli nie jest ono wyraźnie uwzględnione w zapytaniu.resource_name Jeśli na przykład w klauzuli FROM określisz ad_group jako zasób, ad_group.resource_name zostanie automatycznie zwrócony, a dane będą niejawnie segmentowane względem niego na poziomie ad_group.

W przypadku tego zapytania:

SELECT metrics.impressions
FROM ad_group

Otrzymasz ciąg JSON podobny do tego:

{
  "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"
      }
    }
  ]
}

Pole resource_name w obiekcie adGroup jest zawsze zwracane, ponieważ ad_group jest określone jako zasób w klauzuli FROM.

search_term_view

Zasób search_term_view jest też niejawnie segmentowany według grupy reklam, a nie tylko wyszukiwanego hasła, co odzwierciedla struktura jego nazwy zasobu, która również zawiera grupę reklam. Dlatego w wynikach możesz zobaczyć pozornie zduplikowane wiersze z tymi samymi wyszukiwanymi hasłami, jeśli należą one do różnych grup reklam:

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

Chociaż w tym przykładzie 2 zwrócone obiekty wyglądają na duplikaty, ich nazwy zasobów są w rzeczywistości różne, zwłaszcza w części dotyczącej identyfikatora grupy reklam. Oznacza to, że termin wyszukiwania "google photos" jest przypisany do 2 grup reklam (o identyfikatorach 2222222222 i 33333333333) w tym samym dniu (2024-06-15). W tym przypadku interfejs API działał zgodnie z przeznaczeniem i nie zwracał zduplikowanych obiektów.

Pola segmentu, które można wybrać

Nie wszystkie pola segmentu można wybrać w przypadku danego zasobu w klauzuli FROM. Załóżmy na przykład, że nadal wysyłasz zapytania z zasobu ad_group. Aby pole segmentu można było wybrać z zasobu ad_group, musi ono znajdować się na liście Segments w przypadku ad_group. Segments lista to żółta część tabeli dostępnych pól na stronie metadanych zasobu ad_group.

Zasoby segmentu

Wybierając niektóre zasoby, możesz mieć możliwość niejawnego łączenia powiązanych zasobów, wybierając ich pola obok pól zasobu w klauzuli FROM. Te powiązane zasoby znajdziesz na liście Attributed Resources na stronie metadanych klauzuli FROM. W przypadku zasobu ad_group zobaczysz, że możesz też wybrać pola z zasobu campaign. Pole resource_name dowolnego Attributed Resources z co najmniej 1 polem w klauzuli SELECT jest zwracane automatycznie, nawet jeśli pole resource_name nie jest wyraźnie uwzględnione w zapytaniu.

Podobnie jak w przypadku pól Attributed Resource, możesz też wybrać pola Segmenting Resource. Jeśli dany zasób ma Segmenting Resourceslistę na stronie metadanych, wybranie pól z jednego z tych zasobów powoduje dalsze segmentowanie zapytania według zwróconego resource_name tego Segmenting Resource. Na przykład zasób campaign jest wymieniony jako Segmenting Resource w przypadku zasobu campaign_budget. Wybranie dowolnego pola kampanii, np. campaign.name, z zasobu campaign_budget powoduje nie tylko zwrócenie pola campaign.name, ale też zwrócenie i segmentowanie pola campaign.resource_name.

Możliwość wyboru segmentów i danych

Dane segmentu mogą być niezgodne z niektórymi innymi danymi segmentu lub z niektórymi danymi. Aby sprawdzić, które pola segmentu są ze sobą zgodne, przejrzyj listę segmentów selectable_with w klauzuli SELECT.

W przypadku zasobu ad_group możesz wybrać ponad 50 dostępnych segmentów. Lista selectable_with dla segments.hotel_check_in_date to jednak znacznie mniejszy zbiór zgodnych segmentów. Oznacza to, że jeśli dodasz pole segments.hotel_check_in_date do klauzuli SELECT, ograniczysz dostępne segmenty, które możesz wybrać, do przecięcia tych 2 list.

Ograniczenia dotyczące segmentów wspólnych

Niektóre pola segmentu mają wyraźne ograniczenia wyboru, które wymagają, aby były one wysyłane w zapytaniu wraz z segmentem nadrzędnym w klauzuli SELECT:

• Wybranie opcji segments.ad_sub_network_type (która dzieli podsieci reklamowe YouTube, takie jak In-Stream, In-Feed i Shorts) wymaga też wybrania opcji segments.ad_network_type.
• W wersji 25 i nowszych wybranie segments.ad_sub_format_type (które dzieli reklamy In-Stream niemożliwe do pominięcia w YouTube według czasu trwania) wymaga też wybrania segments.ad_format_type.

Filtrowanie domyślne według wybranego segmentu

Gdy w zapytaniu wybierzesz określone pola segmentu, interfejs Google Ads API może niejawnie filtrować wyniki, aby uwzględniać tylko wiersze, w których ten segment ma zastosowanie i ma wartość.

Wpływ segments.keyword.*

Typowy i ważny przykład takiego zachowania występuje podczas wybierania dowolnego pola w sekcji segments.keyword (np. segments.keyword.info.text i segments.keyword.ad_group_criterion):

• Wykluczanie ruchu niezwiązanego ze słowami kluczowymi: jeśli w klauzuli SELECT umieścisz dowolne pole segments.keyword.*, ograniczy to wyniki tylko do wierszy bezpośrednio powiązanych z kryterium grupy reklam w sieci wyszukiwania, które jest słowem kluczowym.
• Typy kampanii, których to dotyczy: w związku z tym dane z typów kampanii lub grup reklam, które nie korzystają ze słów kluczowych w wyszukiwarce, są wykluczane z wyników. Obejmuje to m.in.:
  • Dynamiczne reklamy w wyszukiwarce: ponieważ cele DSA są oparte na treści witryny, a nie na słowach kluczowych.
  • Kampanie produktowe: w których zamiast słów kluczowych używa się grup produktów.
  • Kampanie Performance Max: kampanie Performance Max mogą wyświetlać reklamy w sieci wyszukiwania, ale raporty dotyczące tych kampanii nie są zwykle segmentowane według tych samych kryteriów słów kluczowych.
• Sieć reklamowa: pola segments.keyword.* dotyczą słów kluczowych używanych w sieci wyszukiwania. Nie są one segmentowane według słów kluczowych w sieci reklamowej ani innych metod kierowania w sieci reklamowej.

Reguły dotyczące segmentów w klauzuli WHERE

Jeśli segment znajduje się w klauzuli WHERE, musi też znajdować się w klauzuli SELECT. Wyjątkiem od tej reguły są te segmenty dat, które są nazywane podstawowymi segmentami dat:

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

Reguły dotyczące podstawowych pól segmentu dat

Segmenty segments.date, segments.week, segments.month, segments.quarter i segments.year działają w ten sposób:

• Te segmenty można filtrować w klauzuli WHERE bez wyświetlania ich w klauzuli SELECT.
• Jeśli którykolwiek z tych segmentów znajduje się w klauzuli SELECT, w klauzuli WHERE musi być określony skończony zakres dat składający się z podstawowych segmentów dat. Segmenty dat nie muszą być takie same jak te określone w SELECT.

Przykłady

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

SELECT
  campaign.name,
  metrics.clicks
FROM campaign
WHERE segments.date >= '2024-01-01'
  AND segments.date <= '2024-01-31'

SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign
WHERE segments.date >= '2024-01-01'
  AND segments.date <= '2024-01-31'

SELECT
  campaign.name,
  metrics.clicks,
  segments.month
FROM campaign
WHERE segments.date >= '2024-01-01'
  AND segments.date <= '2024-01-31'

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