Ereignisrohdaten zu Conversions
Dieser Bericht kann nur bei einer asynchronen Anfrage (d. h. über die Methode Reports.request()) zurückgegeben werden.
Da Ereignisse an bestimmten Tagen auftreten, muss in einer Anfrage für diesen Bericht ein timeRange angegeben werden. Sie können eine der folgenden Optionen angeben:
- startDate und endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp ist für Ereignisse nicht gültig.)
Auszug anfordern
Einen regulären Reports.request()-Anfragetext senden, aber "reportType": "conversion" angeben.
{
...
"reportType": "conversion",
"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 Conversion: Active oder Removed. |
Attribut | Status |
Ja |
deviceSegment |
Das Gerätesegment, dem die Conversion zugeordnet wird: Desktop, Mobile, Tablet oder Other. |
Attribut | Device segment |
Ja |
floodlightGroup |
Name der Floodlight-Gruppe | Attribut | String |
Ja |
floodlightGroupConversionType |
Der Typ 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 |
ID der DS-Floodlight-Aktivität | 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 |
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 |
keywordId |
DS-Keyword-ID Ein Wert von 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 dieser Conversion zugeordnet ist. Nur Conversions aus Shopping-Kampagnen haben Produktgruppen-IDs. Produktgruppen-IDs sollten nicht für die Verknüpfung 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 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 |
inventoryAccountId |
Die DS-Inventarkonto-ID, die das Produkt enthält, das der Conversion zugeordnet ist. 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 (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 dieser Conversion zugeordnet ist. | Attribut | String |
Ja |
productStoreId |
Das Geschäft in der Anzeige für lokales Inventar, das der Conversion zugeordnet ist Sie sollte mit den Geschäfts-IDs in Ihrem Feed mit lokal erhältlichen Produkten übereinstimmen. | Attribut | String |
Ja |
productChannel |
Der Vertriebskanal des mit der Conversion verknüpften Produkts: 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 die vom Werbetreibenden bereitgestellte ID. Wenn ein Werbetreibender eine solche ID nicht angibt, generiert Search Ads 360 eine. Bei Online-Conversions entspricht dieser Wert je nach Floodlight-Anweisung des Werbetreibenden entweder der Spalte „conversionId“ oder der Spalte „FloodlightOrderId“. | Attribut | String |
Ja |
conversionType |
Der Typ der Conversion: Action oder Transaction. |
Attribut | Conversion type |
Ja |
conversionRevenue |
Der Gesamtbetrag aus der Conversion. | Attribut | Money |
Ja |
conversionQuantity |
Die Menge der von der Conversion erfassten Elemente, die durch den Parameter qty bestimmt wird. Der Werbetreibende muss den Parameter dynamisch ausfüllen, z. B. die Anzahl der bei 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 von Conversion-Messwerten verwendet. Wenn in DS beispielsweise Aktionen für den 1. Mai aggregiert werden, werden alle Aktions-Conversions gezählt, deren conversionDate der 1. Mai ist. |
Attribut | Date |
Ja |
conversionTimestamp |
Der UTC-Zeitstempel für die Conversion. | Attribut | Timestamp |
Ja |
conversionLastModifiedTimestamp |
Der UTC-Zeitstempel der letzten Änderung der Conversion. | Attribut | Timestamp |
Ja |
conversionAttributionType |
Die Conversion wird Visit oder Keyword+Ad zugeordnet. |
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 wird. | Attribut | Timestamp |
Ja |
conversionVisitExternalClickId |
Ein eindeutiger String für den Besuch, dem die Conversion zugeordnet wird. Er wird an die Landingpage als gclid-URL-Parameter übergeben. Nur aktiviert für Werbetreibende mit Conversion API-Integration oder Google Analytics-Integration. | Attribut | String |
Ja |
conversionSearchTerm |
Der Suchbegriff, der zur Conversion geführt hat. | Attribut | String |
Ja |
floodlightOriginalRevenue |
Der ursprüngliche unveränderte Umsatz, der dem Floodlight-Ereignis in der Währung des aktuellen Berichts zugeordnet ist, vor Änderungen an 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 Floodlight-Auftrags-ID, die der Werbetreibende für die Conversion angegeben hat. | Attribut | String |
Ja |
feedItemId |
Die ID der Feedelement-Zeile, die dieser Conversion zugeordnet ist. | Attribut | ID |
Ja |
feedId |
Die ID der mit dieser Conversion verknüpften Feedtabelle. | Attribut | ID |
Ja |
feedType |
Der Feedtyp, der dieser Conversion zugeordnet ist. | Attribut | Feed type |
Ja |