Typ raportu: odwiedziny

Nieprzetworzone dane zdarzeń dotyczące wizyt. Wizyta ma miejsce za każdym razem, gdy klient kliknie reklamę i zostanie przekierowany na stronę docelową.

Ten raport może zostać zwrócony tylko przez żądanie asynchroniczne (tzn. za pomocą funkcji Reports.request()).

Wydarzenia mają miejsce w określonych dniach, więc żądanie tego raportu musi zawierać element timeRange. Możesz podać jedną z tych opcji:

Poproś o fragment

Wysyłaj regularnie Reports.request() treści żądania, ale określ "reportType": "visit".

{
...
  "reportType": "visit",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

Dla każdej kolumny, którą chcesz zwracać lub odfiltrować w raporcie, określ columnName wymienione w tabeli poniżej. Możesz też opcjonalnie określić headerText startDate, i endDate. Pamiętaj, że niektórych kolumn nie można filtrować. odnosi się do kategorii „Można filtrować”. w tabeli poniżej.

columnNameOpisZachowanieTypMożna filtrować
status Stan wizyty. Wizyty są stałe, więc wartość zawsze wynosi Active. atrybut Status Tak
deviceSegment Segment urządzeń, do którego została przypisana wizyta: Desktop, Mobile, Tablet lub Other. atrybut Device segment Tak
agency Nazwa agencji. atrybut String Tak
agencyId Identyfikator agencji DS. atrybut ID Tak
advertiser Nazwa reklamodawcy. atrybut String Tak
advertiserId Identyfikator reklamodawcy DS. atrybut ID Tak
account Nazwa konta wyszukiwarki. atrybut String Tak
accountId Identyfikator konta wyszukiwarki DS. atrybut ID Tak
accountEngineId Identyfikator konta na zewnętrznym koncie wyszukiwarki. atrybut String Tak
accountType Rodzaj konta wyszukiwarki: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu lub Comparison Shopping. atrybut Engine type Tak
campaign Nazwa kampanii. atrybut String Tak
campaignId Identyfikator kampanii DS. atrybut ID Tak
campaignStatus Stan kampanii zawierającej ten element. atrybut Status Tak
adGroup Nazwa grupy reklam. atrybut String Tak
adGroupId Identyfikator grupy reklam DS. atrybut ID Tak
adGroupStatus Stan grupy reklam zawierającej ten element. atrybut Status Tak
keywordId Identyfikator słowa kluczowego DS. Wartość 0 oznacza, że słowo kluczowe jest nieprzypisane. atrybut ID Tak
keywordMatchType Typ dopasowania słowa kluczowego: Broad, Exact, Phrase lub Content. atrybut Match type Tak
keywordText Tekst słowa kluczowego. atrybut String Tak
productTargetId Identyfikator celu produktowego DS. atrybut ID Tak
productGroupId Identyfikator grupy produktów powiązany z tą wizytą. Tylko wizyty z kampanii produktowych mają identyfikatory grup produktów. Identyfikatorów grup produktów nie należy używać do łączenia. atrybut ID Tak
ad Nazwa reklamy. atrybut String Tak
adId Identyfikator reklamy DS. Wartość 0 oznacza, że reklama jest nieprzypisana. atrybut ID Tak
isUnattributedAd Wskazuje, czy dane w tym wierszu nie są przypisane do konkretnej reklamy. Na przykład reklama o nieobsługiwanym formacie lub błędnym adresie URL serwera kliknięć może uniemożliwić DS przypisanie danych do reklamy. atrybut Boolean Tak
inventoryAccountId Identyfikator konta zasobów reklamowych DS zawierającego kliknięty produkt. DS generuje ten identyfikator po połączeniu konta zasobów reklamowych w DS. atrybut ID Tak
productId Identyfikator klikniętego produktu. atrybut String Tak
productCountry Kraj (w formacie ISO 3166) zarejestrowany w pliku danych o asortymencie zawierającym kliknięty produkt. atrybut String Tak
productLanguage Język (ISO 639-1) ustawiony w pliku danych Merchant Center zawierającym dane o produkcie. atrybut String Tak
productStoreId Sklep w reklamie lokalnego asortymentu produktów, który został kliknięty. Te informacje powinny być zgodne z identyfikatorami sklepów użytymi w pliku danych o produktach dostępnych lokalnie. atrybut String Tak
productChannel Kanał sprzedaży produktu, który został kliknięty: Online lub Local. atrybut Product channel Tak
visitId Identyfikator wizyty DS. atrybut ID Tak
visitSearchQuery Wyszukiwane hasło, które wygenerowało tę wizytę. atrybut String Tak
visitDate Data wizyty w strefie czasowej konta wyszukiwarki. Ta data jest używana do agregacji wizyt. Gdy na przykład DS podsumowuje wizyty z 1 maja, zlicza wszystkie wizyty, których visitDate ma wartość 1 maja. atrybut Date Tak
visitTimestamp Sygnatura czasowa UTC czasu wizyty. atrybut Timestamp Tak
visitNetworkType Sieć reklamowa, która wygenerowała tę wizytę: Content, Search lub Other. atrybut Network type Tak
visitReferrer Adres URL strony odsyłającej w przypadku wizyty. atrybut String Tak
visitExternalClickId Unikalny ciąg znaków przy każdej wizycie, który jest przekazywany do strony docelowej jako parametr adresu URL gclid. Włączona tylko dla reklamodawców, którzy korzystają z integracji z interfejsem API konwersji lub Google Analytics. atrybut String Tak
feedItemId Identyfikator wiersza elementu kanału powiązanego z tą wizytą. atrybut ID Tak
feedId Identyfikator tabeli kanału powiązanej z tą wizytą. atrybut ID Tak
feedType Typ kanału powiązany z tą wizytą. atrybut Feed type Tak