Raportowanie danych o celach kampanii i grup reklam

Dostępny jest już nowy interfejs Search Ads 360 Reporting API. Nowy interfejs API daje większą swobodę tworzenia raportów niestandardowych oraz integrowania danych z aplikacjami i procesami służącymi do raportowania. Dowiedz się więcej o przechodzeniu na nowy interfejs Search Ads 360 Reporting API i jego używaniu.

Cele to kryteria wyświetlania reklam oparte na lokalizacji, danych demograficznych i innych cechach wyszukiwanego hasła. Na przykład reklamodawca może kierować reklamy kampanii tak, aby wyświetlały się tylko w Nowym Jorku, Bostonie i Chicago. Reklamodawca może też zwiększyć stawki za wyszukiwania przeprowadzane przez użytkowników z określonej grupy odbiorców, co zwiększy prawdopodobieństwo wyświetlenia reklamy tym odbiorcom.

Niektóre rodzaje celów można stosować tylko w kampaniach, a inne – tylko w grupach reklam. Aby sprawdzić, które wartości docelowe są dostępne na poszczególnych poziomach, zapoznaj się z dokumentacją raportów campaignTarget i adGroupTarget.

Możesz poprosić o raporty zawierające dane o skuteczności w przypadku określonych typów wartości docelowych. Jeśli na przykład reklamodawca kieruje kampanię na lokalizacje geograficzne, uwzględnij w żądaniu campaignTarget kolumnę locationTargetName. Po pobraniu wygenerowanego raportu możesz sprawdzić skuteczność kampanii w każdej wybranej lokalizacji.

Cele wykluczające

Cele wykluczające zapobiegają wyświetlaniu reklam w wynikach wyszukiwania, które spełniają określone kryteria. Podobnie jak w przypadku celów, niektóre rodzaje celów wykluczających można stosować tylko w kampaniach, a inne – tylko w grupach reklam. Więcej informacji znajdziesz na stronach negativeCampaignTarget i negativeAdGroupTarget.

Możesz prosić o raporty, aby poznać kryteria, według których cele wykluczające są używane do wykluczania reklam. Jeśli na przykład reklamodawca używa celów wykluczających, aby uniemożliwić kampanii wyświetlanie reklam w określonych lokalizacjach geograficznych, uwzględnij kolumnę locationTargetName w żądaniu negativeCampaignTarget. Gdy pobierzesz wygenerowany raport, zobaczysz listę lokalizacji wykluczonych z kampanii.

Przykładowe żądania

Oto przykładowe żądania dotyczące różnych typów celów:

Raportowanie danych o lokalizacjach docelowych w kampanii

Poniżej znajduje się przykład żądania asynchronicznego, które zwraca liczbę kliknięć, wyświetleń i inne dane dotyczące lokalizacji docelowych (raportowanie na temat lokalizacji docelowych jest dostępne tylko w przypadku kampanii Google Ads). Search Ads 360 obsługuje kilka typów lokalizacji docelowych, np. cele kierowania geograficznego, zbliżone obszary kierowania i kierowanie na obszar o określonym promieniu w przypadku rozszerzeń lokalizacji Google Ads. Raporty dotyczące lokalizacji docelowych zawierają dane o wszystkich typach lokalizacji docelowych stosowanych w danym zakresie raportu.

Przykładowe żądanie

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "campaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

Przykładowy raport

Oto przykład raportu campaignTarget. Raport pokazuje skuteczność celu kierowania geograficznego oznaczonego jako „US” (zbliżonego obszaru) o długości 100,0 mil (37.4220041,-122.0862462) i innego celu lokalizacji geograficznej, który podaje kod pocztowy w Stanach Zjednoczonych (90210):

account,campaign,locationTargetName,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,US,10895,12895,1255.07000000,1157
Hooper's - Google,Accessories,"100.0 miles around (37.4220041,-122.0862462)",10816,12816,1285.07000000,1145
Hooper's - Google,Accessories,90210,12790,12790,1124.06000000,1147

cele remarketingowe we wszystkich grupach reklam na koncie,

Poniżej znajduje się przykład żądania asynchronicznego zwraca liczbę kliknięć, wyświetleń i inne dane dla wszystkich celów remarketingowych zdefiniowanych na potrzeby grup reklam w konkretnej kampanii Google Ads.

Przykładowe żądanie

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201", // Replace with your IDs
    "campaignId": "700000000058578" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "engineRemarketingList" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

Przykładowy raport

Oto przykład raportu adGroupTarget. Raport pokazuje, że cele remarketingowe są zdefiniowane w 3 grupach reklam w kampanii „Akcesoria”. Raport obejmuje też dane o skuteczności poszczególnych celów remarketingowych:

account,campaign,adGroup,engineRemarketingList,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,Summer 2016,Weekend Warriors,7707,26333,1255.07000000,3
Hooper's - Google,Accessories,$30 and Under,Email Subscribers,6992,29630,3170.18000000,8
Hooper's - Google,Accessories,Tote Bags,Repeat Buyers,4535,20504,1524.88000000,2

Cele reklam dynamicznych we wszystkich grupach reklam na koncie

Cel reklamy dynamicznej określa w Twojej witrynie strony, które chcesz reklamować za pomocą dynamicznych reklam w wyszukiwarce. Cele reklam dynamicznych są dostępne tylko na kontach wyszukiwarki Google Ads i zawsze tworzy się je w określonych grupach reklam. Google na podstawie indeksu wyszukiwania określa, kiedy wyszukiwanie przeprowadzone przez klienta pasuje do stron pasujących do celów reklam dynamicznych. Jeśli wyszukiwanie jest trafne, Google wyświetla dynamiczną reklamę w wyszukiwarce zdefiniowaną przez Ciebie w tej samej grupie reklam co cele.

Poniżej znajduje się przykład żądania asynchronicznego, które zwraca liczbę kliknięć, wyświetleń i inne dane w przypadku wszystkich celów reklam dynamicznych zdefiniowanych na potrzeby grup reklam na koncie wyszukiwarki.

Przykładowe żądanie

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "dynamicSearchAdsTargetConditions" },
    { "columnName": "dynamicSearchAdsTargetCoverage" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

Przykładowy raport

Oto przykład raportu adGroupTarget. Raport pokazuje, że jedna grupa reklam w kampanii „Google Store” definiuje dynamiczny cel reklamy. W raporcie uwzględniane są też dane o skuteczności celu:

account,campaign,adGroup,dynamicSearchAdsTargetConditions,dynamicSearchAdsTargetCoverage,clicks,impr,cost,dfaActions
Hooper's - Google,Google Stores,Chargers,"AND(CATEGORY = ""Electronics"",CATEGORY = ""Accessories"")",4535,20504,1524.88000000,2

Raportowanie danych o wykluczonych lokalizacjach docelowych w kampaniach

Poniżej znajduje się przykład żądania asynchronicznego, które zwraca lokalizacje wykluczone z kampanii na koncie wyszukiwarki (raporty o wykluczonych lokalizacjach docelowych są dostępne tylko w przypadku kampanii Google Ads). Wykluczone lokalizacje docelowe wykorzystują tylko cele kierowania geograficznego (nie mogą określać zbliżonych obszarów kierowania ani celów w określonym promieniu). Raporty o wykluczonych lokalizacjach docelowych zawierają więc tylko listę lokalizacji geograficznych, które zostały wykluczone z kampanii uwzględnionych w zakresie raportu.

Pamiętaj, że w żądaniu raportu o wykluczonych celach nie musisz określać zakresu czasowego. Raporty ujemne zawsze zwracają bieżące ustawienia. Nie możesz na przykład poprosić o raport pokazujący wykluczające cele, które były używane w ostatnim kwartale.

Przykładowe żądanie

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "negativeCampaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" }
  ],
  "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

Przykładowy raport

Oto przykład raportu negativeCampaignTarget. Raport wskazuje, że kampania „Duże otwarcia – NE” nie uwzględnia stanu Maine, a kampania „Duże otwarcia – zachód” – nie obejmuje stanu Kalifornia:

account,campaign,locationTargetName
Hooper's - Google,Grand openings - NE,US-ME
Hooper's - Google,Grand openings - West,US-CA