Berichtstyp: Besuch

Rohdaten zu Besuchen Ein Besuch findet immer dann statt, wenn ein Nutzer auf eine Anzeige klickt und auf eine Landingpage weitergeleitet wird.

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": "visit" an.

{
...
  "reportType": "visit",
  "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	Der Status des Besuchs. Besuche sind unveränderlich, sodass dieser Wert immer Active ist.	Attribut	Status	Ja
deviceSegment	Das Gerätesegment, dem der Besuch zugeordnet ist: 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	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 diesem Besuch zugewiesen ist Nur Besuche 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 Produkt, auf das geklickt wurde. DS generiert diese ID, wenn Sie ein Inventarkonto in DS verknüpfen.	Attribut	ID	Ja
productId	ID des Produkts, auf das geklickt wurde.	Attribut	String	Ja
productCountry	Das Land im ISO-3166-Format, das für den Inventarfeed registriert ist, der das angeklickte Produkt enthält.	Attribut	String	Ja
productLanguage	Die Sprache (ISO 639-1), die für den Merchant Center-Feed festgelegt wurde, der die Daten zum Produkt enthält.	Attribut	String	Ja
productStoreId	Das Geschäft in der Anzeige für lokales Inventar, auf das geklickt wurde. 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, 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 des Besuchs (in der Zeitzone des Engine-Kontos) Dieses Datum wird für die Besuchszusammenfassung verwendet. Wenn DS beispielsweise Besuche für den 1. Mai zusammenfasst, werden alle Besuche gezählt, deren visitDate der 1. Mai ist.	Attribut	Date	Ja
visitTimestamp	Der UTC-Zeitstempel für den Zeitpunkt des Besuchs.	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 URL-Parameter gclid an die Landingpage übergeben wird. Nur für Werbetreibende mit Conversion-API- oder Google Analytics-Integration aktiviert.	Attribut	String	Ja
feedItemId	Die ID der Zeile des Feedelements, die diesem Besuch zugeordnet ist.	Attribut	ID	Ja
feedId	Die ID der Feedtabelle, die diesem Besuch zugeordnet ist.	Attribut	ID	Ja
feedType	Der mit diesem Besuch verknüpfte Feedtyp.	Attribut	Feed type	Ja