Nieprzetworzone dane o wizytach. Wizyta ma miejsce za każdym razem, gdy konsument kliknie reklamę i zostanie przekierowany na stronę docelową.
Ten raport może zostać zwrócony tylko przez żądanie asynchroniczne (czyli metodą Reports.request()).
Zdarzenia mają miejsce w określonych dniach, dlatego żądanie dotyczące tego raportu musi określać timeRange. Możesz wybrać jedną z tych opcji:
- startDate i endDate.
- changedMetricsFromTimestamp (zdarzenia changedAttributesFromTimestamp nie są poprawne w przypadku zdarzeń).
Poproś o fragment
Wyślij standardową treść żądania Reports.request(), ale określ "reportType": "visit"
.
{ ... "reportType": "visit", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
W każdej kolumnie, którą chcesz zwrócić lub odfiltrować w raporcie, określ columnName
w tabeli poniżej.
Możesz też określić właściwości headerText, startDate i endDate.
Pamiętaj, że niektórych kolumn nie można filtrować. Więcej informacji znajdziesz w tabeli „Filtrowalne”.
columnName | opis, | Sposób działania | Typ | Możliwe do filtrowania |
---|---|---|---|---|
status |
Stan wizyty. Wizyty są nieodwracalne, więc zawsze ma wartość Active . |
atrybut | Status |
Tak |
deviceSegment |
Segment urządzeń, z którymi wizyta została przypisana: Desktop , Mobile , Tablet lub Other . |
atrybut | Device segment |
Tak |
agency |
Nazwa agencji. | atrybut | String |
Tak |
agencyId |
Identyfikator agencji w 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 |
Typ 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 dany element. | atrybut | Status |
Tak |
adGroup |
Nazwa grupy reklam. | atrybut | String |
Tak |
adGroupId |
Identyfikator grupy reklam w DS. | atrybut | ID |
Tak |
adGroupStatus |
Stan grupy reklam, która zawiera ten element. | atrybut | Status |
Tak |
keywordId |
Identyfikator słowa kluczowego DS. Wartość 0 oznacza, że słowo kluczowe nie jest przypisane. | 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ązanej z tą wizytą. Tylko wizyty z kampanii produktowych mają identyfikatory grup produktów. Do dołączania nie należy używać identyfikatorów grup produktów. | atrybut | ID |
Tak |
ad |
Nazwa reklamy. | atrybut | String |
Tak |
adId |
Identyfikator reklamy w DS. Wartość 0 oznacza, że reklama nie jest przypisana. | atrybut | ID |
Tak |
isUnattributedAd |
Wskazuje, czy dane w tym wierszu nie są przypisane do konkretnej reklamy. Na przykład reklama z nieobsługiwanym formatem lub błędnym adresem URL serwera kliknięć może uniemożliwić przypisywanie danych do reklamy przez DS. | atrybut | Boolean |
Tak |
inventoryAccountId |
Identyfikator konta asortymentowego DS zawierającego kliknięty produkt. DS generuje ten identyfikator, gdy łączysz konto asortymentu w DS. | atrybut | ID |
Tak |
productId |
Identyfikator klikniętego produktu. | atrybut | String |
Tak |
productCountry |
Kraj (format ISO 3166) zarejestrowany dla pliku danych o asortymencie zawierającego kliknięty produkt. | atrybut | String |
Tak |
productLanguage |
Język (ISO 639-1) ustawiony dla pliku danych Merchant Center, który zawiera dane o produkcie. | atrybut | String |
Tak |
productStoreId |
Kliknięty sklep w reklamie lokalnego asortymentu produktów. Te produkty powinny być zgodne z identyfikatorami sklepów 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 w DS. | atrybut | ID |
Tak |
visitSearchQuery |
Wyszukiwane hasło, które wywołało tę wizytę. | atrybut | String |
Tak |
visitDate |
Data w strefie czasowej konta wyszukiwarki. Ta data jest używana do agregacji wizyt. Jeśli na przykład DS gromadzi wizyty z 1 maja, zlicza wszystkie wizyty, których visitDate to 1 maja. |
atrybut | Date |
Tak |
visitTimestamp |
Sygnatura czasowa UTC określająca wizytę. | atrybut | Timestamp |
Tak |
visitNetworkType |
Sieć reklamowa, która przyniosła tę wizytę: Content , Search lub Other . |
atrybut | Network type |
Tak |
visitReferrer |
Adres URL strony odsyłającej wizyty. | atrybut | String |
Tak |
visitExternalClickId |
Niepowtarzalny ciąg każdej wizyty przekazywany do strony docelowej jako parametr adresu URL gclid. Opcja dostępna tylko dla reklamodawców korzystających z integracji interfejsu 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ązanego z tą wizytą. | atrybut | ID |
Tak |
feedType |
Typ kanału powiązanego z tą wizytą. | atrybut | Feed type |
Tak |