Berichtstyp: Keyword

Leistungsmesswerte und Konfigurationsattribute für Keywords

Dieser Bericht kann nur durch eine asynchrone Anfrage zurückgegeben werden (d. h. über die Reports.request()-Methode.

Auszug anfordern

Regulären Reports.request() Anfragetext, aber geben Sie "reportType": "keyword" an. 

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

Für jede Spalte, die im Bericht zurückgegeben oder gefiltert werden soll, geben Sie die columnName an, die in der Tabelle unten aufgeführt sind. Sie können auch angeben, headerText startDate, und endDate. Beachten Sie, dass einige Spalten nicht gefiltert werden können. siehe „Filterbar“ in der Tabelle unten.

columnNameBeschreibungVerhaltenTypFilterbar
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 Engine-Konto. Mögliche Status (je nach Typ 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 Erstellung des Keywords im Format ISO 8601. Attribut Timestamp Ja
lastModifiedTimestamp Zeitstempel der letzten Änderung des Keywords im Format ISO 8601. 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 DS-Werbetreibenden-ID. Attribut ID Ja
account Name des Engine-Kontos. Attribut String Ja
accountId DS-Engine-Konto-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 bedeutet, dass das Keyword keine Zuordnung hat. 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 Engine-Konto. Attribut ID Ja
keywordMaxCpc Überschreibt den max. CPC der Anzeigengruppe und legt einen maximalen Betrag fest, den Sie zu zahlen bereit sind, wenn jemand auf eine Anzeige für dieses bestimmte Keyword klickt. Wenn dieses Feld leer ist, verwendet das Keyword den max. CPC der Anzeigengruppe. Attribut Money Ja
effectiveKeywordMaxCpc Der maximale CPC (maximaler Cost-per-Click), der für dieses Keyword gilt. Der Wert entspricht entweder dem maximalen CPC der Anzeigengruppe oder, wenn das Keyword die Einstellung der Anzeigengruppe überschreibt, dem eigenen max. CPC des Keywords. Attribut Money Ja
keywordLandingPage Die finale URL, zu der ein Nutzer nach dem Klicken auf Ihre Anzeige gelangt. Weitere Informationen finden Sie unter Landingpage- und Clickserver-URLs. Attribut String Ja
keywordClickserverUrl Die URL, die DS zum Tracking von Aktivitäten verwendet. Ein Nutzer, der auf eine Anzeige klickt, würde zuerst die Clickserver-URL aufrufen und dann zur endgültigen Landingpage weitergeleitet werden. Weitere Informationen finden Sie unter 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 niemals über dieses Limit hinaus erhöht. Weitere Informationen finden Sie unter Gebotsstrategie auf Keywords anwenden. Attribut Money Ja
keywordMinBid Wenn dieses Keyword von einer DS-Gebotsstrategie verwaltet wird, werden Gebote niemals unter diesem Limit gesenkt. Weitere Informationen finden Sie unter Gebotsstrategie auf Keywords anwenden. Attribut Money Ja
keywordUrlParams Der Landingpage 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 werden nicht berücksichtigt. Attribut String list Ja
qualityScoreCurrent Nur Google Ads und Bing Ads. Der aktuellste Wert des Qualitätsfaktors der Suchmaschine für ein Keyword. Beachten Sie, dass diese Spalte unabhängig vom Berichtszeitraum immer den aktuellen Qualitätsfaktor für ein Keyword anzeigt. Attribut Integer Ja
topOfPageBidCurrent Nur Google Ads In dieser Spalte steht das geschätzte CPC-Gebot, das erforderlich ist, damit Ihre Anzeige regelmäßig an den Top-Positionen oberhalb der Suchergebnisse erscheint. In dieser Spalte wird immer der aktuell erforderliche CPC angezeigt, unabhängig vom Berichtszeitraum. Attribut Money Ja
effectiveBidStrategyId DS-ID der Gebotsstrategie, die dieser Entität zugewiesen oder von ihr übernommen wurde. Attribut ID Ja
effectiveBidStrategy Der Name der Gebotsstrategie, die dieser Entität zugewiesen oder von ihr übernommen wurde. Attribut String Ja
bidStrategyInherited Gibt an, ob die Gebotsstrategie dieser Entität übernommen wird. Attribut Boolean Ja
effectiveLabels Die 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 Gesamtumsatz, der durch Campaign Manager-Transaktionen generiert wurde. 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 wurde. 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 Aggregierte Klicks: Messwert Integer Ja
cost Zusammengefasste Kosten, die an Engine-Konten gezahlt werden. Messwert Money Ja
ctr Durchschnittliche Klickrate Messwert Number Ja
impr Die Gesamtzahl der Impressionen. Messwert Integer Ja
adWordsConversions Die Daten, die der Werbetreibende so eingerichtet hat, dass er in der Spalte „Google Ads-Conversions“ erfasst wird. Nach dem Erstellen einer Google Ads-Conversion-Aktion kann der Werbetreibende auswählen, ob diese Conversions in der Berichtsspalte „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 für alle Tage und Keywords im Berichtszeitraum. Messwert Number Ja
topOfPageBidAvg Nur Google Ads In dieser Spalte wird das durchschnittliche CPC-Gebot angegeben, das erforderlich ist, damit Ihre Anzeigen im Berichtszeitraum regelmäßig an den Top-Positionen oberhalb der Suchergebnisse erscheinen. Messwert Money Ja
date Der Bericht wird nach Tagen segmentiert. jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jeden Tag. Diese Spalte gibt das Datum jeder Zeile zurück. Segmentieren Date Ja
monthStart Den Bericht nach Monaten segmentieren jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jeden Monat. Diese Spalte gibt den ersten Tag des Monats für jede Zeile zurück. Segmentieren Date Ja
monthEnd Den Bericht nach Monaten segmentieren jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jeden Monat. Diese Spalte gibt den letzten Tag des Monats für jede Zeile zurück. Segmentieren Date Ja
quarterStart Der Bericht wird nach Quartalen segmentiert. jede Zeile und die zugehörigen 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 die zugehörigen 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 die zugehörigen 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 die zugehörigen 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 die zugehörigen 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 die zugehörigen 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 Den Bericht nach Gerät segmentieren jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Gerätesegment. Diese Spalte gibt das Gerätesegment jeder Zeile zurück. Segmentieren Device segment Ja
floodlightGroup Den Bericht nach Floodlight-Gruppen segmentieren jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Floodlight-Gruppe. Diese Spalte gibt den Floodlight-Gruppennamen jeder Zeile zurück. Beachten Sie, dass einige Messwerte keine segmentierten Floodlight-Werte enthalten, z. B. Klicks und Besuche. Segmentieren String Ja
floodlightGroupId Den Bericht nach Floodlight-Gruppen segmentieren jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Floodlight-Gruppe. Diese Spalte gibt die DS-Floodlight-Gruppen-ID jeder Zeile zurück. Beachten Sie, dass einige Messwerte keine segmentierten Floodlight-Werte enthalten, z. B. Klicks und Besuche. Segmentieren ID Ja
floodlightGroupTag Den Bericht nach Floodlight-Gruppen segmentieren jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Floodlight-Gruppe. Diese Spalte gibt das Floodlight-Gruppen-Tag jeder Zeile zurück. Beachten Sie, dass einige Messwerte keine segmentierten Floodlight-Werte enthalten, z. B. Klicks und Besuche. Segmentieren String Ja
floodlightActivity Den Bericht nach Floodlight-Aktivitäten segmentieren jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer für jede Floodlight-Aktivität. Diese Spalte gibt den Floodlight-Aktivitätsnamen jeder Zeile an. Beachten Sie, dass einige Messwerte keine segmentierten Floodlight-Werte enthalten, z. B. Klicks und Besuche. Segmentieren String Ja
floodlightActivityId Den Bericht nach Floodlight-Aktivitäten segmentieren jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer für jede Floodlight-Aktivität. Diese Spalte enthält die ID der DS-Floodlight-Aktivität für jede Zeile. Beachten Sie, dass einige Messwerte keine segmentierten Floodlight-Werte enthalten, z. B. Klicks und Besuche. Segmentieren ID Ja
floodlightActivityTag Den Bericht nach Floodlight-Aktivitäten segmentieren jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer für jede Floodlight-Aktivität. Diese Spalte gibt das Floodlight-Aktivitäts-Tag jeder Zeile zurück. Beachten Sie, dass einige Messwerte keine segmentierten Floodlight-Werte enthalten, z. B. Klicks und Besuche. Segmentieren String Ja
ad Segmentiert den Bericht nach Anzeigen jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Anzeige. Diese Spalte gibt den Namen der Anzeige in jeder Zeile zurück. Segmentieren String Ja
adId Segmentiert den Bericht nach Anzeigen jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Anzeige. Diese Spalte gibt die DS-ID der Anzeige in jeder Zeile zurück. Segmentieren ID Ja
isUnattributedAd Segmentiert den Bericht nach Anzeigen jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Anzeige. In dieser Spalte wird angegeben, ob die Messwerte in dieser Zeile keiner bestimmten Anzeige zugeordnet werden können. Segmentieren Boolean Ja
adHeadline Segmentiert den Bericht nach Anzeigen jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Anzeige. Diese Spalte gibt den Anzeigentitel der Anzeige in jeder Zeile zurück. Segmentieren String Ja
adHeadline2 Segmentiert den Bericht nach Anzeigen jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro 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 Segmentiert den Bericht nach Anzeigen jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Anzeige. Diese Spalte gibt den dritten Anzeigentitel der Anzeige in jeder Zeile zurück. Für einige Suchmaschinen nicht verfügbar. Segmentieren String Ja
adDescription1 Segmentiert den Bericht nach Anzeigen jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Anzeige. Diese Spalte gibt die erste Textzeile der Anzeige in jeder Zeile zurück. Segmentieren String Ja
adDescription2 Segmentiert den Bericht nach Anzeigen jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Anzeige. Diese Spalte gibt die zweite Textzeile der Anzeige in jeder Zeile zurück. Segmentieren String Ja
adDisplayUrl Segmentiert den Bericht nach Anzeigen jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Anzeige. Diese Spalte gibt in jeder Zeile die angezeigte URL der Anzeige zurück. Segmentieren String Ja
adLandingPage Segmentiert den Bericht nach Anzeigen jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Anzeige. Diese Spalte gibt die Landingpage der Anzeige in jeder Zeile zurück. Segmentieren String Ja
adType Segmentiert den Bericht nach Anzeigen jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Anzeige. Diese Spalte gibt den Typ der Anzeige in jeder Zeile zurück: Text oder Product. Segmentieren Ad type Ja
adPromotionLine Segmentiert den Bericht nach Anzeigen jede Zeile und die zugehörigen aggregierten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Anzeige. Diese Spalte gibt die Zeile für die Bewerbung der Produktanzeige in jeder Zeile zurück. Segmentieren String Ja