Ereignisrohdaten zu Besuchen Jedes Mal, wenn ein Nutzer auf eine Anzeige klickt und auf eine Landingpage weitergeleitet wird, findet ein Besuch statt.
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": "visit"
angeben.
{ ... "reportType": "visit", "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 des Besuchs Besuche sind unveränderlich, also immer Active . |
Attribut | Status |
Ja |
deviceSegment |
Das Gerätesegment, dem der Besuch zugeordnet wird: Desktop , Mobile , Tablet oder Other . |
Attribut | Device segment |
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 ID der Produktgruppe, die diesem Besuch zugewiesen ist. Nur Besuche 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 angeklickte Produkt enthält. DS generiert diese ID, wenn Sie ein Inventarkonto in DS verknüpfen. | Attribut | ID |
Ja |
productId |
Die ID des angeklickten Produkts. | Attribut | String |
Ja |
productCountry |
Das Land (ISO 3166-Format), das für den Inventarfeed registriert ist, das das angeklickte Produkt enthält. | Attribut | String |
Ja |
productLanguage |
Die Sprache (ISO 639-1), die für den Merchant Center-Feed festgelegt wurde, der Daten zum Produkt enthält. | Attribut | String |
Ja |
productStoreId |
Das Geschäft in der Anzeige für lokales Inventar, auf das geklickt wurde Sie sollte mit den Geschäfts-IDs in Ihrem Feed mit lokal erhältlichen Produkten übereinstimmen. | Attribut | String |
Ja |
productChannel |
Der Vertriebskanal des Produkts, auf das geklickt wurde: Online oder Local . |
Attribut | Product channel |
Ja |
visitId |
DS-Besuchs-ID. | Attribut | ID |
Ja |
visitSearchQuery |
Die Suchanfrage, die diesen Besuch generiert hat | Attribut | String |
Ja |
visitDate |
Das Datum in der Zeitzone des Engine-Kontos, zu dem der Besuch stattfand. Dieses Datum wird für die Zusammenfassung von Besuchen verwendet. Wenn in DS beispielsweise Besuche für den 1. Mai aggregiert werden, werden alle Besuche gezählt, deren visitDate der 1. Mai ist. |
Attribut | Date |
Ja |
visitTimestamp |
Der UTC-Zeitstempel für den Besuch. | Attribut | Timestamp |
Ja |
visitNetworkType |
Das Werbenetzwerk, von dem dieser Besuch generiert wurde: Content , Search oder Other . |
Attribut | Network type |
Ja |
visitReferrer |
Die Verweis-URL des Besuchs. | Attribut | String |
Ja |
visitExternalClickId |
Ein eindeutiger String für jeden Besuch, der als gclid-URL-Parameter an die Landingpage übergeben wird. Nur aktiviert für Werbetreibende mit Conversion API-Integration oder Google Analytics-Integration. | Attribut | String |
Ja |
feedItemId |
Die ID der Feedelementposition, die mit diesem Besuch verknüpft ist. | Attribut | ID |
Ja |
feedId |
Die ID der mit diesem Besuch verknüpften Feedtabelle. | Attribut | ID |
Ja |
feedType |
Der Feedtyp, der diesem Besuch zugewiesen ist. | Attribut | Feed type |
Ja |