Die vorherige Search Ads 360 Reporting API wird eingestellt und am 30. Juni 2024 außer Betrieb genommen. Die Search Ads 360 Conversion API ist davon nicht betroffen und wird weiterhin unterstützt. Verwenden Sie bei jeder neuen Berichterstellung die neue Search Ads 360 Reporting API.

Ab April 2024 wird beim Anfordern eines Berichts der Fehler „Nicht unterstützte ApiVersion“ zurückgegeben. Weitere Informationen

Außerdem empfehlen wir Ihnen dringend, alle vorhandenen Search Ads 360-Implementierungen zur neuen API zu migrieren. Weitere Informationen finden Sie unter Erste Schritte und im Migrationsleitfaden zur neuen Search Ads 360 Reporting API.

Diese Seite wurde von der Cloud Translation API übersetzt.

Berichtstyp: Keyword

Leistungsmesswerte und Konfigurationsattribute für Keywords

Dieser Bericht kann nur bei einer asynchronen Anfrage (d. h. über die Methode Reports.request()) zurückgegeben werden.

Auszug anfordern

Einen regulären Reports.request()-Anfragetext senden, aber "reportType": "keyword" angeben.

{
...
  "reportType": "keyword",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

Geben Sie für jede Spalte, die Sie im Bericht zurückgeben oder filtern möchten, die in der Tabelle unten aufgeführten columnName an. Optional können Sie auch headerText, startDate und endDate angeben. Einige Spalten können nicht gefiltert werden. Weitere Informationen finden Sie in der Tabelle unten unter „Filterbar“.

`columnName`	Beschreibung	Verhalten	Typ	Filterbar
`status`	Der Status des Keywords: `Active`, `Paused` oder `Removed`. Kampagnen, Anzeigengruppen, Keywords und Anzeigen haben jeweils einen eigenen Status. Siehe Status.	Attribut	`Status`	Ja
`engineStatus`	Zusätzlicher Status des Keywords im externen Suchmaschinenkonto. Mögliche Status (je nach Art des externen Kontos) sind `criterion rarely served`, `criterion below first page bid`, `criterion low quality score`, `review`, `campaign paused` usw.	Attribut	`String`	Ja
`creationTimestamp`	Zeitstempel der Keyword-Erstellung im ISO-8601-Format.	Attribut	`Timestamp`	Ja
`lastModifiedTimestamp`	Zeitstempel der letzten Änderung des Keywords, im ISO-8601-Format.	Attribut	`Timestamp`	Ja
`agency`	Name der Agentur.	Attribut	`String`	Ja
`agencyId`	DS-Agentur-ID.	Attribut	`ID`	Ja
`advertiser`	Name des Werbetreibenden.	Attribut	`String`	Ja
`advertiserId`	ID des DS-Werbetreibenden	Attribut	`ID`	Ja
`account`	Name des Engine-Kontos.	Attribut	`String`	Ja
`accountId`	DS-Suchmaschinenkonto-ID.	Attribut	`ID`	Ja
`accountEngineId`	ID des Kontos im externen Engine-Konto.	Attribut	`String`	Ja
`accountType`	Engine-Kontotyp: `Google AdWords`, `Bing Ads`, `Yahoo Japan Listing Ads`, `Yahoo Search Marketing`, `Yahoo Gemini`, `Baidu` oder `Comparison Shopping`.	Attribut	`Engine type`	Ja
`campaign`	Kampagnenname:	Attribut	`String`	Ja
`campaignId`	DS-Kampagnen-ID.	Attribut	`ID`	Ja
`campaignStatus`	Der Status der Kampagne, die dieses Element enthält.	Attribut	`Status`	Ja
`adGroup`	Anzeigengruppenname:	Attribut	`String`	Ja
`adGroupId`	DS-Anzeigengruppen-ID.	Attribut	`ID`	Ja
`adGroupStatus`	Der Status der Anzeigengruppe, die dieses Element enthält.	Attribut	`Status`	Ja
`keywordId`	DS-Keyword-ID Ein Wert von 0 gibt an, dass das Keyword nicht zugeordnet ist.	Attribut	`ID`	Ja
`keywordMatchType`	Keyword-Option: `Broad`, `Exact`, `Phrase` oder `Content`.	Attribut	`Match type`	Ja
`keywordText`	Keyword-Text.	Attribut	`String`	Ja
`keywordEngineId`	ID des Keywords im externen Suchmaschinenkonto.	Attribut	`ID`	Ja
`keywordMaxCpc`	Überschreibt den max. CPC der Anzeigengruppe und legt den Höchstbetrag fest, den Sie für einen Klick auf eine Anzeige für dieses Keyword zu zahlen bereit sind. Wenn dieses Feld leer ist, verwendet das Keyword den maximalen CPC der Anzeigengruppe.	Attribut	`Money`	Ja
`effectiveKeywordMaxCpc`	Der maximale CPC (Cost-per-Click), der für dieses Keyword gilt. Sie entspricht entweder dem maximalen CPC der Anzeigengruppe oder, wenn die Einstellung der Anzeigengruppe mit dem Keyword überschrieben wird, dem maximalen CPC des Keywords.	Attribut	`Money`	Ja
`keywordLandingPage`	Die finale URL, die ein Nutzer aufrufen würde, nachdem er auf Ihre Anzeige geklickt hat. Siehe Landingpage- und Clickserver-URLs.	Attribut	`String`	Ja
`keywordClickserverUrl`	Die URL, mit der DS Aktivitäten erfasst. Ein Nutzer, der auf eine Anzeige klickt, ruft zuerst die Clickserver-URL auf und wird dann auf die endgültige Landingpage weitergeleitet. Siehe Landingpage- und Clickserver-URLs.	Attribut	`String`	Ja
`isDisplayKeyword`	Gibt an, ob es sich um ein Platzhalter-Keyword handelt, das für Display- und Placement-Berichte verwendet wird	Attribut	`Boolean`	Ja
`keywordMaxBid`	Wenn dieses Keyword von einer DS-Gebotsstrategie verwaltet wird, werden die Gebote nie über dieses Limit hinaus erhöht. Weitere Informationen finden Sie unter Gebotsstrategie auf Keywords anwenden.	Attribut	`Money`	Ja
`keywordMinBid`	Wenn dieses Keyword über eine DS-Gebotsstrategie verwaltet wird, werden die Gebote nie unter dieses Limit gesenkt. Weitere Informationen finden Sie unter Gebotsstrategie auf Keywords anwenden.	Attribut	`Money`	Ja
`keywordUrlParams`	Der URL wurden zusätzliche URL-Parameter hinzugefügt. Siehe URL-Parameter hinzufügen.	Attribut	`String`	Ja
`bingKeywordParam2`	Param2 eines Bing Ads-Keywords.	Attribut	`String`	Ja
`bingKeywordParam3`	Param3 eines Bing Ads-Keywords.	Attribut	`String`	Ja
`keywordLabels`	Namen von Labels, die diesem Keyword direkt zugewiesen sind. Übernommene Labels sind nicht enthalten.	Attribut	`String list`	Ja
`qualityScoreCurrent`	Nur Google Ads und Bing Ads. Der aktuelle Wert des Qualitätsfaktors der Suchmaschine für ein Keyword. In dieser Spalte wird unabhängig von dem Berichtszeitraum immer der aktuelle Qualitätsfaktor für ein Keyword angezeigt.	Attribut	`Integer`	Ja
`topOfPageBidCurrent`	Nur Google Ads. In dieser Spalte wird annähernd das aktuelle CPC-Gebot angegeben, das erforderlich ist, damit Ihre Anzeige regelmäßig an den Top-Positionen oberhalb der Suchergebnisse erscheint. In dieser Spalte wird unabhängig vom Berichtszeitraum immer der CPC angegeben, der derzeit benötigt wird.	Attribut	`Money`	Ja
`effectiveBidStrategyId`	DS-ID der Gebotsstrategie, die dieser Entität zugewiesen oder von dieser Entität übernommen wurde.	Attribut	`ID`	Ja
`effectiveBidStrategy`	Der Name der Gebotsstrategie, die dieser Entität zugewiesen oder von dieser Entität übernommen wurde.	Attribut	`String`	Ja
`bidStrategyInherited`	Gibt an, ob die Gebotsstrategie dieser Entität übernommen wird.	Attribut	`Boolean`	Ja
`effectiveLabels`	Namen aller Labels, die diesem Keyword übernommen oder direkt zugewiesen wurden.	Attribut	`String list`	Ja
`dfaActions`	Die Gesamtzahl der Campaign Manager-Aktionen	Messwert	`Integer`	Ja
`dfaRevenue`	Der von Campaign Manager-Transaktionen generierte Gesamtumsatz.	Messwert	`Money`	Ja
`dfaTransactions`	Die Gesamtzahl der Campaign Manager-Transaktionen	Messwert	`Integer`	Ja
`dfaWeightedActions`	Gewichtete Summe der Campaign Manager-Aktionen.	Messwert	`Number`	Ja
`dfaActionsCrossEnv`	Die Gesamtzahl der umgebungsübergreifenden Campaign Manager-Aktionen	Messwert	`Number`	Ja
`dfaRevenueCrossEnv`	Gesamtumsatz, der durch umgebungsübergreifende Campaign Manager-Transaktionen generiert wird.	Messwert	`Money`	Ja
`dfaTransactionsCrossEnv`	Die Gesamtzahl der umgebungsübergreifenden Campaign Manager-Transaktionen.	Messwert	`Number`	Ja
`dfaWeightedActionsCrossEnv`	Gewichtete Summe der umgebungsübergreifenden Campaign Manager-Aktionen.	Messwert	`Number`	Ja
`avgCpc`	Durchschnittlicher Cost-per-Click	Messwert	`Money`	Ja
`avgCpm`	Durchschnittlicher Cost-per-1000-Impressions.	Messwert	`Money`	Ja
`avgPos`	Durchschnittliche Position	Messwert	`Number`	Ja
`clicks`	Zusammengefasste Klicks.	Messwert	`Integer`	Ja
`cost`	Aggregierte Kosten an Engine-Konten.	Messwert	`Money`	Ja
`ctr`	Durchschnittliche Klickrate	Messwert	`Number`	Ja
`impr`	Die Gesamtzahl der Impressionen.	Messwert	`Integer`	Ja
`adWordsConversions`	Die Daten, die der Werbetreibende in der Spalte „Google Ads-Conversions“ eingerichtet hat Beim Erstellen einer Google Ads-Conversion-Aktion kann der Werbetreibende in der Berichtsspalte „Conversions“ auswählen, ob diese Conversions gezählt werden sollen.	Messwert	`Number`	Ja
`adWordsConversionValue`	Gesamtwert der Google Ads-Conversions	Messwert	`Number`	Ja
`adWordsViewThroughConversions`	Die Gesamtzahl der View-through-Conversions in Google Ads.	Messwert	`Integer`	Ja
`visits`	Die Gesamtzahl der DS-Besuche.	Messwert	`Integer`	Ja
`qualityScoreAvg`	Nur Google Ads und Bing Ads. Der nach Impressionen gewichtete Durchschnitt des Qualitätsfaktors der Suchmaschine über alle Tage und Keywords im Geltungsbereich des Berichts.	Messwert	`Number`	Ja
`topOfPageBidAvg`	Nur Google Ads. In dieser Spalte wird annähernd das CPC-Gebot angegeben, das erforderlich ist, damit Ihre Anzeigen im Berichtszeitraum regelmäßig an oberster Position über den Suchergebnissen erscheinen.	Messwert	`Money`	Ja
`date`	Der Bericht wird nach Tagen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jeden Tag. In dieser Spalte wird das Datum jeder Zeile zurückgegeben.	Segmentieren	`Date`	Ja
`monthStart`	Der Bericht wird nach Monaten segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jeden Monat. Diese Spalte gibt den ersten Tag des Monats jeder Zeile zurück.	Segmentieren	`Date`	Ja
`monthEnd`	Der Bericht wird nach Monaten segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jeden Monat. Diese Spalte gibt den letzten Tag des Monats jeder Zeile zurück.	Segmentieren	`Date`	Ja
`quarterStart`	Der Bericht wird nach Quartalen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jedes Quartal. Diese Spalte gibt den ersten Tag des Quartals jeder Zeile zurück.	Segmentieren	`Date`	Ja
`quarterEnd`	Der Bericht wird nach Quartalen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jedes Quartal. Diese Spalte gibt den letzten Tag des Quartals jeder Zeile zurück.	Segmentieren	`Date`	Ja
`weekStart`	Der Bericht wird nach Wochen (Sonntag bis Samstag) segmentiert; jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jede Woche. Diese Spalte gibt den ersten Tag (Sonntag) jeder Zeile zurück.	Segmentieren	`Date`	Ja
`weekEnd`	Der Bericht wird nach Wochen (Sonntag bis Samstag) segmentiert; jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jede Woche. Diese Spalte gibt den letzten Tag (Samstag) jeder Zeile zurück.	Segmentieren	`Date`	Ja
`yearStart`	Der Bericht wird nach Jahren segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jedes Jahr. Diese Spalte gibt den ersten Tag des Jahres jeder Zeile zurück.	Segmentieren	`Date`	Ja
`yearEnd`	Der Bericht wird nach Jahren segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jedes Jahr. Diese Spalte gibt den letzten Tag des Jahres jeder Zeile zurück.	Segmentieren	`Date`	Ja
`deviceSegment`	Der Bericht wird nach Gerät segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu eine für jedes Gerätesegment. In dieser Spalte wird das Gerätesegment jeder Zeile zurückgegeben.	Segmentieren	`Device segment`	Ja
`floodlightGroup`	Der Bericht wird nach Floodlight-Gruppen segmentiert, wobei jede Zeile und ihre aggregierten Messwerte in mehrere Zeilen aufgeteilt werden (maximal eine für jede Floodlight-Gruppe). Diese Spalte gibt den Floodlight-Gruppennamen jeder Zeile zurück. Einige Messwerte haben keine segmentierten Floodlight-Werte wie Klicks und Besuche.	Segmentieren	`String`	Ja
`floodlightGroupId`	Der Bericht wird nach Floodlight-Gruppen segmentiert, wobei jede Zeile und ihre aggregierten Messwerte in mehrere Zeilen aufgeteilt werden (maximal eine für jede Floodlight-Gruppe). Diese Spalte gibt die Floodlight-Gruppen-ID jeder Zeile in DS zurück. Einige Messwerte haben keine segmentierten Floodlight-Werte wie Klicks und Besuche.	Segmentieren	`ID`	Ja
`floodlightGroupTag`	Der Bericht wird nach Floodlight-Gruppen segmentiert, wobei jede Zeile und ihre aggregierten Messwerte in mehrere Zeilen aufgeteilt werden (maximal eine für jede Floodlight-Gruppe). Diese Spalte gibt das Floodlight-Gruppen-Tag jeder Zeile zurück. Einige Messwerte haben keine segmentierten Floodlight-Werte wie Klicks und Besuche.	Segmentieren	`String`	Ja
`floodlightActivity`	Der Bericht wird nach Floodlight-Aktivitäten segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jede Floodlight-Aktivität. Diese Spalte gibt den Floodlight-Aktivitätsnamen jeder Zeile zurück. Einige Messwerte haben keine segmentierten Floodlight-Werte wie Klicks und Besuche.	Segmentieren	`String`	Ja
`floodlightActivityId`	Der Bericht wird nach Floodlight-Aktivitäten segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jede Floodlight-Aktivität. Diese Spalte gibt die Floodlight-Aktivitäts-ID jeder Zeile zurück. Einige Messwerte haben keine segmentierten Floodlight-Werte wie Klicks und Besuche.	Segmentieren	`ID`	Ja
`floodlightActivityTag`	Der Bericht wird nach Floodlight-Aktivitäten segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jede Floodlight-Aktivität. Diese Spalte gibt das Floodlight-Aktivitäts-Tag jeder Zeile zurück. Einige Messwerte haben keine segmentierten Floodlight-Werte wie Klicks und Besuche.	Segmentieren	`String`	Ja
`ad`	Der Bericht wird nach Anzeigen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu eine für jede Anzeige. In dieser Spalte wird in jeder Zeile der Name der Anzeige zurückgegeben.	Segmentieren	`String`	Ja
`adId`	Der Bericht wird nach Anzeigen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu eine für jede Anzeige. Diese Spalte gibt die DS-ID der Anzeige in jeder Zeile zurück.	Segmentieren	`ID`	Ja
`isUnattributedAd`	Der Bericht wird nach Anzeigen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu eine für jede Anzeige. Diese Spalte gibt an, ob die Messwerte in dieser Zeile einer bestimmten Anzeige nicht zugeordnet werden können.	Segmentieren	`Boolean`	Ja
`adHeadline`	Der Bericht wird nach Anzeigen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu eine für jede Anzeige. In dieser Spalte wird in jeder Zeile der Anzeigentitel zurückgegeben.	Segmentieren	`String`	Ja
`adHeadline2`	Der Bericht wird nach Anzeigen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu eine für jede Anzeige. Diese Spalte gibt den Anzeigentitel 2 der Anzeige in jeder Zeile zurück. Für einige Suchmaschinen nicht verfügbar.	Segmentieren	`String`	Ja
`adHeadline3`	Der Bericht wird nach Anzeigen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu eine für jede Anzeige. Diese Spalte gibt den Anzeigentitel 3 der Anzeige in jeder Zeile zurück. Für einige Suchmaschinen nicht verfügbar.	Segmentieren	`String`	Ja
`adDescription1`	Der Bericht wird nach Anzeigen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu eine für jede Anzeige. Diese Spalte gibt Textzeile 1 der Anzeige in jeder Zeile zurück.	Segmentieren	`String`	Ja
`adDescription2`	Der Bericht wird nach Anzeigen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu eine für jede Anzeige. Diese Spalte gibt Textzeile 2 der Anzeige in jeder Zeile zurück.	Segmentieren	`String`	Ja
`adDisplayUrl`	Der Bericht wird nach Anzeigen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu eine für jede Anzeige. In dieser Spalte wird die angezeigte URL der Anzeige in jeder Zeile zurückgegeben.	Segmentieren	`String`	Ja
`adLandingPage`	Der Bericht wird nach Anzeigen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu eine für jede Anzeige. In dieser Spalte wird die Landingpage der Anzeige in jeder Zeile zurückgegeben.	Segmentieren	`String`	Ja
`adType`	Der Bericht wird nach Anzeigen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu eine für jede Anzeige. In dieser Spalte wird der Typ der Anzeige in jeder Zeile zurückgegeben: `Text` oder `Product`.	Segmentieren	`Ad type`	Ja
`adPromotionLine`	Der Bericht wird nach Anzeigen segmentiert. Jede Zeile und ihre aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu eine für jede Anzeige. In dieser Spalte wird die Zeile für die Bewerbung der Produktanzeige in jeder Zeile zurückgegeben.	Segmentieren	`String`	Ja