Raporty zawierają informacje o wszystkich zasobach na Twoim koncie. Możesz m.in. pobierać informacje o kampaniach, grupach reklam i ich statystykach, a także historię zmian na koncie. Infrastruktura raportowania korzysta z interfejsu Google Ads API i używa GAQL do określania pól, danych i warunków, które chcesz ustawić.
Raport a wyszukiwanie
Istnieją 2 główne mechanizmy raportowania. Akceptują one te same rodzaje zapytań i różnią się przede wszystkim sposobem zwracania wyników.
W obu przypadkach użyjemy następującego zapytania:
SELECT
campaign.id,
campaign.status,
metrics.clicks,
metrics.impressions,
customer.id
FROM campaign
WHERE
metrics.impressions > 0
AdsApp.report()
- Spowoduje to wyświetlenie wyników wyszukiwania w formie płaskiej, przypominającej słownik. Dostęp do pól możesz uzyskać tak, jak przy użyciu słownika, np.
row["campaign.id"]
czyrow["metrics.impressions"]
. W tym formacie możesz eksportować wyniki bezpośrednio do arkusza kalkulacyjnego przy użyciu metodyexportToSheet()
. Nie jest to format natywny, w którym wyniki są zwracane przez interfejs Google Ads API, więc w niektórych przypadkach niektóre pola mogą być niedostępne w tym formacie. W takim przypadku użyj elementusearch
. AdsApp.search()
- Spowoduje to zwrócenie listy obiektów
GoogleAdsRow
z różnymi polami, z których każdy może mieć pola podrzędne. Aby pobrać dane, musisz wejść na stronęrow.campaign.id
irow.metrics.impressions
. Jest to zwykle bardziej przydatne, jeśli planujesz przetwarzać dane w sposób zautomatyzowany. Niektóre pola mogą być dostępne w formaciesearch
tylko wtedy, gdy nie można ich przekonwertować na płaską reprezentację.
Przykład raportu
let report = AdsApp.report(
"SELECT " +
" ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
"FROM search_term_view " +
"WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");
let rows = report.rows();
while (rows.hasNext()) {
let row = rows.next();
let query = row["search_term_view.search_term"];
let impressions = row["metrics.impressions"];
}
Szczegółowe informacje o korzystaniu z tego widoku znajdziesz w dokumentacji AdsApp.report
.
Przykład wyszukiwania
let search = AdsApp.search(
"SELECT " +
" ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
"FROM search_term_view " +
"WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");
while (search.hasNext()) {
let row = search.next();
let query = row.searchTermView.searchTerm;
let impressions = row.metrics.impressions;
}
Informacje o wszystkich możliwych ustawieniach znajdziesz w pełnej dokumentacji Adsapp.search
.