Berichtstyp: Anzeige

Leistungsmesswerte und Konfigurationsattribute für Anzeigen.

Dieser Bericht kann nur über eine asynchrone Anfrage zurückgegeben werden, also über die Methode Reports.request().

Auszug anfordern

Senden Sie einen regulären Reports.request()-Anfragetext, geben Sie aber "reportType": "ad" an.

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

Geben Sie für jede Spalte, die im Bericht zurückgegeben oder gefiltert werden soll, den in der folgenden Tabelle 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“.

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 Engine-Konto. Mögliche Status (je nach Art des externen Kontos) sind active, eligible, creative deleted, creative approved family safe usw. Attribut String Ja
creationTimestamp Zeitstempel der Erstellung der Anzeige im ISO 8601-Format. Attribut Timestamp Ja
lastModifiedTimestamp Zeitstempel der letzten Änderung der Anzeige 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 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 Typ des Engine-Kontos: 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 Messwerte in dieser Zeile keiner bestimmten Anzeige zugeordnet werden können. So kann beispielsweise eine Anzeige mit einem nicht unterstützten Format oder eine fehlerhafte Clickserver-URL verhindern, dass DS Messwerte einer Anzeige zuordnet. Attribut Boolean Ja
adHeadline Anzeigentitel. Attribut String Ja
adHeadline2 Anzeigentitel 2; für einige Suchmaschinen nicht verfügbar. Attribut String Ja
adHeadline3 Anzeigentitel 3; für einige Suchmaschinen nicht verfügbar. Attribut String Ja
adDescription1 Textzeile 1 der Anzeigenbeschreibung. Attribut String Ja
adDescription2 Textzeile 2 der Anzeigenbeschreibung; für einige 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 sind nicht enthalten. 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 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 Der Gesamtumsatz, der über Campaign Manager-Transaktionen erzielt 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 Campaign Manager-Aktionen, die plattformübergreifend ausgeführt wurden. Messwert Number Ja
dfaRevenueCrossEnv Der Gesamtumsatz, der über Campaign Manager-Transaktionen erzielt wurde, die mehrere Plattformen umfassen. Messwert Money Ja
dfaTransactionsCrossEnv Die Gesamtzahl der Campaign Manager-Transaktionen, die geräteübergreifend erfasst wurden. Messwert Number Ja
dfaWeightedActionsCrossEnv Gewichtete Summe der Campaign Manager-Aktionen, die plattformübergreifend ausgeführt wurden. 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 Klicks zusammenfassen Messwert Integer Ja
cost Gesamtkosten, die an das Engine-Konto bzw. die Engine-Konten gezahlt wurden. Messwert Money Ja
ctr Durchschnittliche Klickrate. Messwert Number Ja
impr Die Gesamtzahl der Impressionen. Messwert Integer Ja
adWordsConversions Die Daten, die der Werbetreibende für die Berichterstellung in der Google Ads-Spalte „Conversions“ festgelegt hat. Beim Erstellen einer Google Ads-Conversion-Aktion kann der Werbetreibende festlegen, ob diese Conversions in der Berichtsspalte „Conversions“ gezählt werden sollen. Messwert Number Ja
adWordsConversionValue Der Gesamtwert von Google Ads-Conversions. Messwert Number Ja
adWordsViewThroughConversions Die Gesamtzahl der Google Ads-View-through-Conversions. Messwert Integer Ja
visits Die Gesamtzahl der DS-Besuche. Messwert Integer Ja
date Der Bericht wird nach Tagen segmentiert. Jede Zeile und ihre zusammengefassten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jeden Tag. Diese Spalte gibt das Datum der jeweiligen Zeile zurück. Segmentieren Date Ja
monthStart Der Bericht wird nach Monaten segmentiert. Jede Zeile und ihre zusammengefassten Messwerte werden in mehrere Zeilen unterteilt, eine für jeden Monat. In dieser Spalte wird der erste Tag des Monats jeder Zeile zurückgegeben. Segmentieren Date Ja
monthEnd Der Bericht wird nach Monaten segmentiert. Jede Zeile und ihre zusammengefassten Messwerte werden in mehrere Zeilen unterteilt, eine für jeden Monat. In dieser Spalte wird der letzte Tag des Monats für jede Zeile zurückgegeben. Segmentieren Date Ja
quarterStart Der Bericht wird nach Quartalen segmentiert. Jede Zeile und die zugehörigen zusammengefassten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jedes Quartal. In dieser Spalte wird der erste Tag des Quartals jeder Zeile zurückgegeben. Segmentieren Date Ja
quarterEnd Der Bericht wird nach Quartalen segmentiert. Jede Zeile und die zugehörigen zusammengefassten Messwerte werden in mehrere Zeilen aufgeteilt, eine für jedes Quartal. In dieser Spalte wird der letzte Tag des Quartals für jede Zeile zurückgegeben. Segmentieren Date Ja
weekStart Der Bericht wird nach Wochen (Sonntag bis Samstag) segmentiert. Jede Zeile und die zugehörigen zusammengefassten Messwerte werden in mehrere Zeilen unterteilt, 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 zusammengefassten Messwerte werden in mehrere Zeilen unterteilt, eine für jede Woche. In dieser Spalte wird der letzte Tag (Samstag) jeder Zeile zurückgegeben. Segmentieren Date Ja
yearStart Der Bericht wird nach Jahren segmentiert. Jede Zeile und ihre zusammengefassten Messwerte werden in mehrere Zeilen unterteilt, eine für jedes Jahr. In dieser Spalte wird der erste Tag des Jahres jeder Zeile zurückgegeben. Segmentieren Date Ja
yearEnd Der Bericht wird nach Jahren segmentiert. Jede Zeile und ihre zusammengefassten Messwerte werden in mehrere Zeilen unterteilt, eine für jedes Jahr. Diese Spalte gibt den letzten Tag des Jahres für jede Zeile zurück. Segmentieren Date Ja
deviceSegment Der Bericht wird nach Gerät segmentiert. Jede Zeile und die zugehörigen zusammengefassten Messwerte werden in mehrere Zeilen unterteilt, bis zu einer pro 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. Jede Zeile und ihre zusammengefassten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Floodlight-Gruppe. In dieser Spalte wird der Name der Floodlight-Gruppe jeder Zeile zurückgegeben. Für einige Messwerte gibt es keine nach Floodlight segmentierten Werte, z. B. für Klicks und Besuche. Segmentieren String Ja
floodlightGroupId Der Bericht wird nach Floodlight-Gruppen segmentiert. Jede Zeile und ihre zusammengefassten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Floodlight-Gruppe. In dieser Spalte wird die DS-Floodlight-Gruppen-ID jeder Zeile zurückgegeben. Für einige Messwerte gibt es keine nach Floodlight segmentierten Werte, z. B. für Klicks und Besuche. Segmentieren ID Ja
floodlightGroupTag Der Bericht wird nach Floodlight-Gruppen segmentiert. Jede Zeile und die zugehörigen zusammengefassten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Floodlight-Gruppe. In dieser Spalte wird das Floodlight-Gruppen-Tag jeder Zeile zurückgegeben. Für einige Messwerte gibt es keine nach Floodlight segmentierten Werte, z. B. für Klicks und Besuche. Segmentieren String Ja
floodlightActivity Der Bericht wird nach Floodlight-Aktivitäten segmentiert. Jede Zeile und ihre zusammengefassten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Floodlight-Aktivität. In dieser Spalte wird der Name der Floodlight-Aktivität jeder Zeile zurückgegeben. Für einige Messwerte gibt es keine nach Floodlight segmentierten Werte, z. B. für Klicks und Besuche. Segmentieren String Ja
floodlightActivityId Der Bericht wird nach Floodlight-Aktivitäten segmentiert. Jede Zeile und ihre zusammengefassten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Floodlight-Aktivität. In dieser Spalte wird die DS-Floodlight-Aktivitäts-ID jeder Zeile zurückgegeben. Für einige Messwerte gibt es keine nach Floodlight segmentierten Werte, z. B. für Klicks und Besuche. Segmentieren ID Ja
floodlightActivityTag Der Bericht wird nach Floodlight-Aktivitäten segmentiert. Jede Zeile und ihre zusammengefassten Messwerte werden in mehrere Zeilen aufgeteilt, bis zu einer pro Floodlight-Aktivität. In dieser Spalte wird das Floodlight-Aktivitäts-Tag jeder Zeile zurückgegeben. Für einige Messwerte gibt es keine nach Floodlight segmentierten Werte, z. B. für Klicks und Besuche. Segmentieren String Ja