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:
- startDate i endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp nie jest prawidłowy dla zdarzeń).
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.
columnName | Opis | Zachowanie | Typ | Moż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 |