Wie bei anderen Kampagnentypen können Sie GoogleAdsService.SearchStream verwenden, um Attribute und Leistungsmesswerte für smarte Kampagnen abzurufen.
Messwerte für smarte Kampagnen sind über die Ressource campaign verfügbar und suchbegriffsspezifische Messwerte über die Ressource smart_campaign_search_term_view. Im smart_campaign_search_term_view enthält das Feld search_term alle übereinstimmenden Abfragen, die Ergebnisse generiert haben. Wenn Sie den Betriebsstatus und die Berechtigungsdetails einer smarten Kampagne abrufen möchten (z. B. den Überprüfungsstatus, Gründe für die Nichtberechtigung oder Impression-Zeitstempel), verwenden Sie SmartCampaignSettingService.GetSmartCampaignStatus, wie unter Kampagnenstatus beschrieben.
Impressionen und Klicks von Smart-Kampagnen in den letzten 30 Tagen
Mit der folgenden Abfrage werden Impressionen und Klicks für jeden Suchbegriff der letzten 30 Tage für alle Smart-Kampagnen abgerufen und nach Datum segmentiert.
SELECT
campaign.id,
campaign.name,
segments.date,
metrics.impressions,
metrics.clicks,
smart_campaign_search_term_view.search_term
FROM smart_campaign_search_term_view
WHERE segments.date DURING LAST_30_DAYS
Top 10 der Suchbegriffe nach Impressionen
Mit der folgenden Abfrage werden die zehn Suchbegriffe mit den meisten Impressionen in den letzten 30 Tagen sowie die zugehörigen Kosten abgerufen. Beachten Sie, dass segments.date in der SELECT-Klausel ausgelassen wird, damit Impressionen und Kosten für den gesamten 30-Tage-Zeitraum pro Suchbegriff zusammengefasst werden.
SELECT
campaign.id,
campaign.name,
metrics.impressions,
metrics.cost_micros,
smart_campaign_search_term_view.search_term
FROM smart_campaign_search_term_view
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 10
Attribute einer KeywordThemeConstant abrufen
Da KeywordThemeConstants aus einem großen, nicht kundenspezifischen Dataset abgerufen werden, ist es nicht möglich, die gesamte keyword_theme_constant-Ressource auf einmal zu scannen. Wenn Sie einzelne KeywordThemeConstants abrufen möchten, müssen Sie die Ressource campaign_criterion abfragen, um die Ressourcennamen der Keyword-Themen zu ermitteln, die mit Ihren Kampagnen verknüpft sind. Verwenden Sie diese Ressourcennamen dann, um die Ressource keyword_theme_constant abzufragen.
SELECT
campaign.id,
campaign_criterion.type,
campaign_criterion.status,
campaign_criterion.criterion_id,
campaign_criterion.keyword_theme.keyword_theme_constant
FROM campaign_criterion
WHERE campaign_criterion.type = 'KEYWORD_THEME'
Verwenden Sie dann den Ressourcennamen im Feld campaign_criterion.keyword_theme.keyword_theme_constant in der folgenden Abfrage:
SELECT
keyword_theme_constant.resource_name,
keyword_theme_constant.display_name,
keyword_theme_constant.country_code
FROM keyword_theme_constant
WHERE keyword_theme_constant.resource_name = 'keywordThemeConstants/40804~0'
Anforderungen an Berichtsfunktionen
Damit Sie smarte Kampagnen implementieren können, muss Ihre Anwendung eine Reihe von erforderlichen Mindestfunktionen erfüllen.
Für die Berichterstellung müssen dem Endnutzer eine Reihe von Berichtsfeldern zur Verfügung gestellt werden. So rufen Sie die erforderlichen Felder aus der Artikelnummer R.20 Campaign Performance im RMF ab:
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
metrics.clicks,
metrics.cost_micros,
metrics.impressions,
metrics.conversions,
metrics.all_conversions
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'
So rufen Sie die erforderlichen Felder aus der Artikelnummer R.70 Smart Campaign Search Term View (Bericht „Suchbegriffe für Smart-Kampagnen“) zusammen mit der zugehörigen Kampagne und dem Suchbegriff ab:
SELECT
campaign.id,
campaign.name,
smart_campaign_search_term_view.search_term,
metrics.clicks,
metrics.cost_micros
FROM smart_campaign_search_term_view
Messwerte pro Geschäft
Hier ist eine Abfrage, die alle verfügbaren Messwerte pro Geschäft für smarte Kampagnen enthält. Diese Felder können auch mit anderen Feldern in einer einzelnen Abfrage kombiniert werden:
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
metrics.all_conversions_from_click_to_call,
metrics.all_conversions_from_directions,
metrics.all_conversions_from_menu,
metrics.all_conversions_from_order,
metrics.all_conversions_from_other_engagement,
metrics.all_conversions_from_store_visit,
metrics.all_conversions_from_store_website
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'
Nach Stunde segmentierte Telefonanrufe
So rufen Sie alle Messwerte für Telefonanrufe zwischen 12:00 Uhr und 17:00 Uhr ab (segments.hour-Werte 12 bis 16, wobei jede Ganzzahl ein 1-Stunden-Fenster ab dieser Stunde darstellt):
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
segments.hour,
metrics.phone_calls
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'
AND segments.hour BETWEEN 12 AND 16