Berichtstyp: Anzeige

Leistungsmesswerte und Konfigurationsattribute für Anzeigen

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": "ad" an.

{
...
  "reportType": "ad",
  "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 der Anzeige: Active, Paused oder Removed. Kampagnen, Anzeigengruppen, Keywords und Anzeigen haben jeweils einen eigenen Status. Siehe Status. Attribut Status Ja
engineStatus Zusätzlicher Status der Anzeige im externen Suchmaschinenkonto. Mögliche Status (je nach Typ des externen Kontos) sind active, eligible, creative deleted, creative approved family safe usw. Attribut String Ja
creationTimestamp Zeitstempel der Anzeigenerstellung, formatiert nach ISO 8601. Attribut Timestamp Ja
lastModifiedTimestamp Zeitstempel der letzten Anzeigenänderung, formatiert nach 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
ad Anzeigenname. Attribut String Ja
adId DS-Anzeigen-ID. Der Wert 0 gibt an, dass die Anzeige nicht zugeordnet ist. Attribut ID Ja
adEngineId ID der Anzeige im externen Engine-Konto. Attribut ID Ja
isUnattributedAd Gibt an, ob die Messwerte in dieser Zeile keiner bestimmten Anzeige zugeordnet werden können. Beispielsweise kann eine Anzeige mit einem nicht unterstützten Format oder einer fehlerhaften Clickserver-URL verhindern, dass DS einer Anzeige Messwerte zuordnet. Attribut Boolean Ja
adHeadline Anzeigentitel Attribut String Ja
adHeadline2 Anzeigentitel 2; für manche Suchmaschinen nicht verfügbar. Attribut String Ja
adHeadline3 Anzeigentitel 3; für manche Suchmaschinen nicht verfügbar. Attribut String Ja
adDescription1 Textzeile 1 der Anzeige Attribut String Ja
adDescription2 Anzeigenbeschreibung (Zeile 2) für manche Suchmaschinen nicht verfügbar. Attribut String Ja
adDisplayUrl Angezeigte URL der Anzeige Attribut String Ja
adLandingPage Landingpage der Anzeige. Weitere Informationen finden Sie unter Landingpage- und Clickserver-URLs. Attribut String Ja
adType Der Anzeigentyp: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text oder Expanded dynamic search. Attribut Ad type Ja
adPromotionLine Zeile für Werbetext. Eine kurze Werbebotschaft für eine Produktanzeige. Attribut String Ja
adLabels Namen von Labels, die dieser Anzeige direkt zugewiesen sind übernommene Labels werden nicht berücksichtigt. Attribut String list Ja
adPathField1 Anzeigenpfad-Feld 1 Die Pfadfelder 1 und 2 werden mit adDisplayUrl kombiniert, um die URL zu bilden, die in einer Anzeige zu sehen ist. Attribut String Ja
adPathField2 Anzeigenpfad – Feld 2 Die Pfadfelder 1 und 2 werden mit adDisplayUrl kombiniert, um die URL zu bilden, die in einer Anzeige zu sehen ist. Attribut String Ja
effectiveLabels Die Namen aller Labels, die dieser Anzeige ü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
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 pro 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 pro 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 pro 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