Przegląd raportów

Film: warsztaty GAQL

Ujednolicając raportowanie i zapytania, nie musisz już definiować raportu. Możesz bezpośrednio przesyłać zapytania dotyczące danych za pomocą SearchGoogleAdsStreamRequest lub SearchGoogleAdsRequest.

Rozpocznij migrację raportu, korzystając z odpowiednich tabel mapowania pól. W poniższych tabelach znajdziesz nazwę pola interfejsu AdWords API i jego odpowiednik w interfejsie Google Ads API.

Przykład

Dwa raporty najczęściej używane w interfejsie AdWords API to raporty skuteczności grupy reklam i kampanii. Porównujemy równoważne zapytania w języku zapytań AdWords (AWQL) i języku zapytań Google Ads (GAQL):

Raport skuteczności grupy reklam
# AWQL
SELECT CampaignId, AdGroupId, Impressions, Clicks, Cost
FROM ADGROUP_PERFORMANCE_REPORT
DURING LAST_7_DAYS

# Google Ads Query Language
SELECT campaign.id, ad_group.id, metrics.impressions, metrics.clicks,
       metrics.cost_micros
FROM ad_group
WHERE segments.date DURING LAST_7_DAYS
Raport skuteczności kampanii
# AWQL
SELECT CampaignName, CampaignStatus, Device, Impressions, Clicks,
       Ctr, AverageCpc, Cost
FROM CAMPAIGN_PERFORMANCE_REPORT
DURING LAST_30_DAYS

# Google Ads Query Language
SELECT campaign.name, campaign.status, segments.device, metrics.impressions,
       metrics.clicks, metrics.ctr, metrics.average_cpc, metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Raporty pojedynczego i wielu atrybucji

W trakcie migracji niektóre raporty dotyczące określonych kryteriów interfejsu API AdWords mogą wymagać uwagi, np. raportu skuteczności słów kluczowych lub raportu skuteczności w zakresie wieku. Są 2 rodzaje takich raportów:

  • Pojedyncze raporty, np. Raport skuteczności kryteriów czy Raport skuteczności słów kluczowych, w przypadku których zarejestrowane jest tylko jedno kryterium wywołujące (np. miejsce docelowe, wiek, słowo kluczowe itp.) dla danego wyświetlenia: wyświetlenie może być aktywowane przez wiele kryteriów, ale w jednym raporcie atrybucji wyświetlenie i wszystkie jego statystyki są przypisane tylko do jednego kryterium.

  • wiele raportów atrybucji, np. raport skuteczności wg płci i raport skuteczności miejsc docelowych, w którym maksymalnie jedno kryterium w każdym wymiarze wywołującym wyświetlenie ma zarejestrowane wyświetlenie: kilka raportów atrybucji można traktować jako raporty dotyczące różnych typów kryteriów. W przeciwieństwie do jednej atrybucji, w której wiersz może zawierać różne typy kryteriów, każdy raport atrybucji zawiera tylko kryteria jednego typu.

W interfejsie Google Ads API nie ma jednego raportu atrybucji. Wszystkie raporty na poziomie kryteriów w interfejsie Google Ads API są wielokrotnym atrybucją w tym sensie, że każdy raport jest specyficzny dla jednej grupy typów kryteriów i podsumowuje statystyki zgodnie z kryteriami tego typu. Nie dodawaj statystyk z różnych zasobów criteria_view, ponieważ spowodowałoby to podwójne zliczanie i nieprawidłowe sumy.

Dodanie nagłówka HTTP zeroZeroImpressions

Interfejs API AdWords

W interfejsie AdWords API możesz użyć nagłówka includeZeroImpressions, aby kontrolować, czy wiersze raportu, w których wszystkie określone pola danych w zapytaniu mają zerowe wartości, mają być zwracane.

Ustaw nagłówek raportu na true, a wynik raportu będzie zawierał te wiersze. W przypadku false nie będzie.

Mimo że w nazwie nagłówka jest wymieniona „Wyświetlenia”, to wiersz raportu musi zawierać zero w wszystkich określonych polach danych w żądaniu (a nie tylko w wyświetleniach), by raport został wykluczony, gdy nagłówek ma wartość false.

Nie ma takiego nagłówka w interfejsie Google Ads API, więc nie można mapować zapytań AdWords API bezpośrednio do zapytań w tym interfejsie.

W ramach przybliżenia możesz wskazać predykat metrics.impressions > 0w zapytaniu, aby wykluczyć wiersze raportu, w których wyświetlenia wynoszą zero. W większości przypadków zwraca to identyczne wyniki, bo ustawienie nagłówka includeZeroImpressions interfejsu API AdWords na false pokazuje wartość zero, gdy wartości wyświetleń są inne niż 0.

Uważaj jednak na to, że parametr metrics.impressions ma wartość zero, ale inne wartości danych (takie jak metrics.search_impression_share na podstawie prognozy) mogą nie być, więc wiersz raportu może zostać zwrócony.