Berichtstyp: Conversion

Rohe Ereignisdaten zu Conversions.

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

Da Ereignisse an bestimmten Tagen auftreten, muss für eine Anfrage für diesen Bericht ein timeRange angegeben werden. Sie können einen der folgenden Werte angeben:

Auszug anfordern

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

{
...
  "reportType": "conversion",
  "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 Conversion: Active oder Removed. Attribut Status Ja
deviceSegment Das Gerätesegment, dem die Conversion zugeordnet ist: Desktop, Mobile, Tablet oder Other. Attribut Device segment Ja
floodlightGroup Name der Floodlight-Gruppe. Attribut String Ja
floodlightGroupConversionType Die Art der Conversions, die von Floodlight-Aktivitäten in dieser Gruppe generiert wurden: Action oder Transaction. Attribut Conversion type Ja
floodlightGroupId DS-Floodlight-Gruppen-ID. Attribut ID Ja
floodlightGroupTag Floodlight-Gruppen-Tag Attribut String Ja
floodlightActivity Name der Floodlight-Aktivität. Attribut String Ja
floodlightActivityId DS-Floodlight-Aktivitäts-ID. Attribut ID Ja
floodlightActivityTag Floodlight-Aktivitäts-Tag Attribut String 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
keywordId DS-Keyword-ID. Der Wert 0 gibt an, dass das Keyword nicht zugeordnet ist. Attribut ID Ja
keywordMatchType Keyword-Option: Broad, Exact, Phrase oder Content Attribut Match type Ja
keywordText Keyword-Text Attribut String Ja
productTargetId DS-Produktziel-ID. Attribut ID Ja
productGroupId Die Produktgruppen-ID, die mit dieser Conversion verknüpft ist. Nur Conversions aus Shopping-Kampagnen haben Produktgruppen-IDs. Produktgruppen-IDs sollten nicht für Zusammenführungen verwendet werden. Attribut ID Ja
ad Anzeigenname Attribut String Ja
adId DS-Anzeigen-ID. Der Wert 0 gibt an, dass die Anzeige nicht zugeordnet ist. 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
inventoryAccountId Die DS-Inventarkonto-ID mit dem Produkt, das mit der Conversion verknüpft ist. Diese ID wird in Data Studio generiert, wenn Sie ein Inventarkonto in Data Studio verknüpfen. Attribut ID Ja
productId Die ID des Produkts, das mit dieser Conversion verknüpft ist. Attribut String Ja
productCountry Das Land (ISO 3166-Format), das für den Inventarfeed registriert ist, der das mit dieser Conversion verknüpfte Produkt enthält. Attribut String Ja
productLanguage Die Sprache (ISO 639-1) des Produkts, das mit dieser Conversion verknüpft ist. Attribut String Ja
productStoreId Das Geschäft in der Anzeige für lokales Inventar, das mit der Conversion verknüpft ist. Dieser sollte den Geschäfts-IDs entsprechen, die in Ihrem Feed mit lokal erhältlichen Produkten verwendet werden. Attribut String Ja
productChannel Der Vertriebskanal des Produkts, das mit der Conversion verknüpft ist: Online oder Local. Attribut Product channel Ja
conversionId ID, die in Search Ads 360 für jede Conversion generiert wird. Attribut ID Ja
advertiserConversionId Bei Offline-Conversions ist dies eine ID, die von Werbetreibenden bereitgestellt wird. Wenn ein Werbetreibender eine solche ID nicht angibt, generiert Search Ads 360 eine. Bei Online-Conversions entspricht dies der Spalte „conversionId“ oder der Spalte „floodlightOrderId“, je nach Floodlight-Anweisungen des Werbetreibenden. Attribut String Ja
conversionType Der Conversion-Typ: Action oder Transaction. Attribut Conversion type Ja
conversionRevenue Der Gesamtbetrag der Conversion in US-Dollar. Attribut Money Ja
conversionQuantity Die Anzahl der von der Conversion aufgezeichneten Elemente, wie durch den Parameter qty festgelegt. Der Werbetreibende ist dafür verantwortlich, Parameter dynamisch auszufüllen, z. B. die Anzahl der in der Conversion verkauften Artikel. Andernfalls wird standardmäßig 1 verwendet. Attribut Number Ja
conversionDate Das Datum, an dem die Conversion in der Zeitzone des Campaign Manager-Netzwerks stattgefunden hat. Dieses Datum wird für die Aggregation von Conversion-Messwerten verwendet. Wenn in der Datenanalyse beispielsweise Aktionen für den 1. Mai zusammengefasst werden, werden alle Conversion-Aktionen gezählt, deren conversionDate der 1. Mai ist. Attribut Date Ja
conversionTimestamp Der UTC-Zeitstempel für den Zeitpunkt, zu dem die Conversion stattgefunden hat. Attribut Timestamp Ja
conversionLastModifiedTimestamp Der UTC-Zeitstempel der letzten Änderung der Conversion. Attribut Timestamp Ja
conversionAttributionType Wozu wird die Conversion zugeordnet: Visit oder Keyword+Ad. Attribut Conversion attribution type Ja
conversionVisitId Die DS-Besuchs-ID, der die Conversion zugeordnet ist. Attribut ID Ja
conversionVisitTimestamp Der UTC-Zeitstempel des Besuchs, dem die Conversion zugeordnet ist. Attribut Timestamp Ja
conversionVisitExternalClickId Ein eindeutiger String für den Besuch, dem die Conversion zugeordnet wird, und der als Landingpage-URL-Parameter an die Landingpage übergeben wird.gclid Nur für Werbetreibende mit Conversion API- oder Google Analytics-Integration aktiviert. Attribut String Ja
conversionSearchTerm Der Suchbegriff, der zur Conversion geführt hat. Attribut String Ja
floodlightOriginalRevenue Der ursprüngliche, unveränderte Umsatz, der mit dem Floodlight-Ereignis (in der Währung des aktuellen Berichts) verknüpft ist, vor der Änderung der Floodlight-Währungsanweisung. Attribut Money Ja
floodlightEventRequestString Der Floodlight-Anfragestring der Conversion. Attribut String Ja
floodlightReferrer Die Floodlight-Referenzwebsite der Conversion. Attribut String Ja
floodlightOrderId Die ID des Floodlight-Auftrags, der vom Werbetreibenden für die Conversion bereitgestellt wurde. Attribut String Ja
feedItemId Die ID der Feedelementzeile, die mit dieser Conversion verknüpft ist. Attribut ID Ja
feedId Die ID der Feedtabelle, die mit dieser Conversion verknüpft ist. Attribut ID Ja
feedType Der Feedtyp, der mit dieser Conversion verknüpft ist. Attribut Feed type Ja