Ereignisrohdaten zu Conversions
Dieser Bericht kann nur durch eine asynchrone Anfrage zurückgegeben werden (d. h. über die Reports.request()-Methode.
Da Ereignisse an bestimmten Daten auftreten, muss in einer Anfrage für diesen Bericht ein timeRange aus. Sie können eine der folgenden Optionen angeben:
- startDate und endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp ist für Ereignisse nicht gültig).
Auszug anfordern
Regulären
Reports.request()
Anfragetext, aber geben Sie "reportType": "conversion"
an.
{ ... "reportType": "conversion", "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 |
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 |
Der Typ der Conversions, die durch Floodlight-Aktivitäten in dieser Gruppe generiert wurden: Action oder Transaction . |
Attribut | Conversion type |
Ja |
floodlightGroupId |
Die DS-Floodlight-Gruppen-ID. | Attribut | ID |
Ja |
floodlightGroupTag |
Floodlight-Gruppen-Tag. | Attribut | String |
Ja |
floodlightActivity |
Name der Floodlight-Aktivität. | Attribut | String |
Ja |
floodlightActivityId |
Die ID der Floodlight-Aktivität in DS. | 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 |
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 |
keywordId |
DS-Keyword-ID. Ein Wert von 0 bedeutet, dass das Keyword keine Zuordnung hat. | 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 dieser Conversion zugeordnet ist. Nur Conversions aus Shopping-Kampagnen haben Produktgruppen-IDs. Produktgruppen-IDs sollten nicht für die Zusammenführung 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 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 |
inventoryAccountId |
Die DS-Inventarkonto-ID mit dem mit der Conversion verknüpften Produkt. DS generiert diese ID, wenn Sie ein Inventarkonto in DS verknüpfen. | Attribut | ID |
Ja |
productId |
Die ID des Produkts, das mit dieser Conversion verknüpft ist. | Attribut | String |
Ja |
productCountry |
Das Land im 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, die der Conversion zugeordnet 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 der Conversion zugeordnet ist: Online oder Local . |
Attribut | Product channel |
Ja |
conversionId |
ID, die Search Ads 360 für jede Conversion generiert. | 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 dieser Wert der Spalte "conversionId" oder "FloodlightOrderId", je nach den Floodlight-Anweisungen des Werbetreibenden. | Attribut | String |
Ja |
conversionType |
Der Typ der Conversion: Action oder Transaction . |
Attribut | Conversion type |
Ja |
conversionRevenue |
Der Gesamtbetrag der Conversion in Dollar. | Attribut | Money |
Ja |
conversionQuantity |
Die Anzahl der durch die Conversion erfassten 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 (in der Zeitzone des Campaign Manager-Netzwerks), an dem die Conversion stattfand. Dieses Datum wird für die Aggregation des Conversion-Messwerts verwendet. Wenn in DS beispielsweise Aktionen für den 1. Mai zusammengefasst werden, werden alle Aktions-Conversions gezählt, deren conversionDate der 1. Mai ist. |
Attribut | Date |
Ja |
conversionTimestamp |
Der UTC-Zeitstempel für das Datum, an dem die Conversion stattfand. | Attribut | Timestamp |
Ja |
conversionLastModifiedTimestamp |
Der UTC-Zeitstempel der letzten Änderung der Conversion. | Attribut | Timestamp |
Ja |
conversionAttributionType |
Dem, was die Conversion zugeordnet ist: 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 ist, der als URL-Parameter gclid an die Landingpage übergeben wird. 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-Verweis-Website 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 Zeile des Feedelements, die dieser Conversion zugeordnet ist. | Attribut | ID |
Ja |
feedId |
Die ID der Feedtabelle, die dieser Conversion zugeordnet ist. | Attribut | ID |
Ja |
feedType |
Der Feedtyp, der dieser Conversion zugeordnet ist. | Attribut | Feed type |
Ja |