Leistungsmesswerte und Konfigurationsattribute für Anzeigen
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": "ad"
angeben.
{ ... "reportType": "ad", "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 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 Art des externen Kontos) sind active , eligible , creative deleted , creative approved family safe usw. |
Attribut | String |
Ja |
creationTimestamp |
Zeitstempel der Anzeigenerstellung im ISO-8601-Format. | Attribut | Timestamp |
Ja |
lastModifiedTimestamp |
Zeitstempel der letzten Änderung der Anzeige gemäß 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 |
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 |
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 Suchmaschinenkonto. | Attribut | ID |
Ja |
isUnattributedAd |
Gibt an, ob Messwerte in dieser Zeile einer bestimmten Anzeige nicht zugeordnet werden können. Beispielsweise kann eine Anzeige mit einem nicht unterstützten Format oder einer fehlerhaften Clickserver-URL verhindern, dass einer Anzeige Messwerte in DS zugeordnet werden. | 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 Anzeige | Attribut | String |
Ja |
adDescription2 |
Textzeile 2 der Anzeige; für einige Suchmaschinen nicht verfügbar. | Attribut | String |
Ja |
adDisplayUrl |
Angezeigte URL der Anzeige | Attribut | String |
Ja |
adLandingPage |
Landingpage der Anzeige. Siehe 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 die Bewerbung der Anzeige. 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 der Anzeigeanzeige-URL kombiniert, um die in einer Anzeige angezeigte URL zu bilden. | Attribut | String |
Ja |
adPathField2 |
Anzeigenpfad-Feld 2. Die Pfadfelder 1 und 2 werden mit der Anzeigeanzeige-URL kombiniert, um die in einer Anzeige angezeigte URL zu bilden. | 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 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 |
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 |