Berichtstyp: productGroup

Leistungsmesswerte und Konfigurationsattribute für Produktgruppen Produktgruppenberichte unterscheiden sich in mehreren Punkten von Keyword-Berichten: Weitere Informationen

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

{
...
  "reportType": "productGroup",
  "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 Produktgruppe. Es ist immer Active. Attribut Status Ja
engineStatus Zusätzlicher Status der Produktgruppe im externen Engine-Konto. Mögliche Status (je nach Typ des externen Kontos) sind review, campaign paused usw. Attribut String Ja
creationTimestamp Zeitstempel für die Erstellung der Produktgruppe im Format ISO 8601. Attribut Timestamp Ja
lastModifiedTimestamp Zeitstempel der letzten Änderung der Produktgruppe 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
productGroupId DS-Produktgruppen-ID. DS generiert diese IDs, die sich ändern können, auch wenn die resultierende Produktgruppenstruktur unverändert ist. Weitere Informationen Attribut ID Ja
productGroup Die Kriterien, die zum Definieren der Produktgruppe verwendet wurden, z. B. AND(CATEGORY="Elektronik",BRAND = "beispiel"). Attribut String Nein
productGroupPartitionType Der Partitionstyp für die Produktgruppe: Subdivided, Excluded oder Biddable. Attribut Product group partition type Ja
productGroupLandingPage Landingpage der Produktgruppe. Weitere Informationen finden Sie unter Landingpage- und Clickserver-URLs. Attribut String Ja
productGroupClickserverUrl 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
productGroupMaxCpc Gibt den max. CPC zurück, der für diese Produktgruppe festgelegt wurde, falls vorhanden. Wenn für diese Produktgruppe kein max. CPC festgelegt wurde, ist dieses Feld leer und die Produktgruppe übernimmt die Einstellung für den max. CPC von der Anzeigengruppe. Attribut Money Ja
effectiveProductGroupMaxCpc Der maximale CPC (maximaler Cost-per-Click), der für diese Produktgruppe gilt. Der Wert entspricht entweder dem max. CPC der Anzeigengruppe oder, falls das Produktziel die Einstellung der Anzeigengruppe überschreibt, dem eigenen max. CPC des Produktziels. Attribut Money Ja
productGroupMaxBid Wenn diese Produktgruppe von einer DS-Gebotsstrategie verwaltet wird, werden die Gebote niemals über dieses Limit hinaus erhöht. Weitere Informationen finden Sie unter Gebotsstrategie auf eine Produktgruppe anwenden. Attribut Money Ja
productGroupMinBid Wenn diese Produktgruppe von einer DS-Gebotsstrategie verwaltet wird, werden Gebote niemals unter diesem Limit gesenkt. Weitere Informationen finden Sie unter Gebotsstrategie auf eine Produktgruppe anwenden. 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 dieser Produktgruppe ü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