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.
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 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 |