Berichtstyp: Besuch

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