nieprzetworzone dane o zdarzeniach dotyczących konwersji,
Ten raport może być zwracany tylko przez żądanie asynchroniczne (czyli za pomocą metody Reports.request()).
Zdarzenia występują w określonych dniach, dlatego w żądaniu tego raportu musisz podać timeRange. Możesz podać jedną z tych opcji:
- startDate i endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp nie jest prawidłowy w przypadku zdarzeń).
Poproś o wyciąg
Prześlij zwykły strumień danych Reports.request(), ale określ parametr "reportType": "conversion"
.
{
...
"reportType": "conversion",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
W przypadku każdej kolumny, którą chcesz zwrócić lub odfiltrować w raporcie, określ columnName
wymieniony w tabeli poniżej.
Opcjonalnie możesz też podać parametry headerText, startDate i endDate.
Pamiętaj, że niektórych kolumn nie można filtrować. Informacje o możliwości filtrowania znajdziesz w tabeli poniżej.
columnName | Opis | Zachowanie | Typ | Można filtrować |
---|---|---|---|---|
status |
Stan konwersji: Active lub Removed . |
atrybut | Status |
Tak |
deviceSegment |
Segment urządzeń, do którego przypisana jest konwersja: Desktop , Mobile , Tablet lub Other . |
atrybut | Device segment |
Tak |
floodlightGroup |
Nazwa grupy Floodlight. | atrybut | String |
Tak |
floodlightGroupConversionType |
Typ konwersji wygenerowanych przez aktywności Floodlight w tej grupie: Action lub Transaction . |
atrybut | Conversion type |
Tak |
floodlightGroupId |
Identyfikator grupy Floodlight DS. | atrybut | ID |
Tak |
floodlightGroupTag |
Tag grupy Floodlight. | atrybut | String |
Tak |
floodlightActivity |
Nazwa aktywności Floodlight. | atrybut | String |
Tak |
floodlightActivityId |
Identyfikator aktywności Floodlight w DS. | atrybut | ID |
Tak |
floodlightActivityTag |
Tag aktywności Floodlight. | atrybut | String |
Tak |
agency |
Nazwa agencji. | atrybut | String |
Tak |
agencyId |
Identyfikator agencji DS. | atrybut | ID |
Tak |
advertiser |
Nazwa reklamodawcy. | atrybut | String |
Tak |
advertiserId |
Identyfikator reklamodawcy w DS. | atrybut | ID |
Tak |
account |
Nazwa konta wyszukiwarki. | atrybut | String |
Tak |
accountId |
Identyfikator konta wyszukiwarki DS. | atrybut | ID |
Tak |
accountEngineId |
Identyfikator konta w zewnętrznym koncie wyszukiwarki. | atrybut | String |
Tak |
accountType |
Typ konta silnika: 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, która zawiera ten element. | atrybut | Status |
Tak |
adGroup |
Nazwa grupy reklam. | atrybut | String |
Tak |
adGroupId |
Identyfikator grupy reklam 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 miejsca docelowego produktu w DS. | atrybut | ID |
Tak |
productGroupId |
Identyfikator grupy produktów powiązanej z tą konwersją. Identyfikatory grup produktów mają tylko konwersje z kampanii produktowych. Identyfikatorów grup produktów nie należy używać do złączania. | atrybut | ID |
Tak |
ad |
Nazwa reklamy. | atrybut | String |
Tak |
adId |
Identyfikator reklamy DS. Wartość 0 oznacza, że reklama nie jest przypisana. | atrybut | ID |
Tak |
isUnattributedAd |
Wskazuje, czy dane w tym wierszu nie można przypisać do konkretnej reklamy. Na przykład reklama o nieobsługiwanym formacie lub z nieprawidłowym adresem URL serwera kliknięć może uniemożliwić DS przypisanie danych do reklamy. | atrybut | Boolean |
Tak |
inventoryAccountId |
Identyfikator konta zasobów reklamowych w Doubleclick zawierający produkt powiązany z konwersją. DS generuje ten identyfikator, gdy połączysz konto asortymentu w DS. | atrybut | ID |
Tak |
productId |
Identyfikator produktu powiązanego z tą konwersją. | atrybut | String |
Tak |
productCountry |
Kraj (w formacie ISO 3166) zarejestrowany na potrzeby pliku danych o asortymencie zawierającego produkt powiązany z tą konwersją. | atrybut | String |
Tak |
productLanguage |
Język (ISO 639-1) produktu powiązanego z tą konwersją. | atrybut | String |
Tak |
productStoreId |
Sklep w reklamie lokalnego asortymentu produktów powiązany z konwersją. Temu sklepowi muszą odpowiadać identyfikatory sklepów użyte w pliku danych o produktach dostępnych lokalnie. | atrybut | String |
Tak |
productChannel |
Kanał sprzedaży produktu powiązanego z konwersją: Online lub Local . |
atrybut | Product channel |
Tak |
conversionId |
Identyfikator wygenerowany przez Search Ads 360 dla każdej konwersji. | atrybut | ID |
Tak |
advertiserConversionId |
W przypadku konwersji offline jest to identyfikator podany przez reklamodawców. Jeśli reklamodawca nie poda takiego identyfikatora, wygeneruje go Search Ads 360. W przypadku konwersji online kolumna ta jest równa kolumnie conversionId lub floodlightOrderId, w zależności od instrukcji Floodlight podanych przez reklamodawcę. | atrybut | String |
Tak |
conversionType |
Typ konwersji: Action lub Transaction . |
atrybut | Conversion type |
Tak |
conversionRevenue |
Łączna kwota w dolarach pochodząca z konwersji. | atrybut | Money |
Tak |
conversionQuantity |
Liczba produktów zarejestrowanych przez konwersję, określona przez parametr qty. Reklamodawca jest odpowiedzialny za dynamiczne wypełnianie tego parametru (np. liczby sprzedanych produktów w ramach konwersji). W przeciwnym razie jego wartość domyślna wynosi 1. | atrybut | Number |
Tak |
conversionDate |
Data konwersji w strefie czasowej sieci Campaign Manager. Ta data służy do agregacji danych o konwersjach. Gdy DS agreguje działania z 1 maja, zlicza wszystkie konwersje działań, których conversionDate to 1 maja. |
atrybut | Date |
Tak |
conversionTimestamp |
Sygnatura czasowa UTC konwersji. | atrybut | Timestamp |
Tak |
conversionLastModifiedTimestamp |
Sygnatura czasowa UTC ostatniej modyfikacji konwersji. | atrybut | Timestamp |
Tak |
conversionAttributionType |
Do czego jest przypisana konwersja: Visit lub Keyword+Ad . |
atrybut | Conversion attribution type |
Tak |
conversionVisitId |
Identyfikator wizyty w DS, do której przypisana jest konwersja. | atrybut | ID |
Tak |
conversionVisitTimestamp |
Sygnatura czasowa UTC wizyty, do której przypisana jest konwersja. | atrybut | Timestamp |
Tak |
conversionVisitExternalClickId |
Niepowtarzalny ciąg tekstowy, który odpowiada wizycie przypisanej do konwersji i jest przekazywany na stronę docelową jako parametr adresu URL gclid. Jest ona dostępna tylko dla reklamodawców, którzy mają integrację z interfejsem API konwersji lub z Google Analytics. | atrybut | String |
Tak |
conversionSearchTerm |
Wyszukiwane hasło, które doprowadziło do konwersji. | atrybut | String |
Tak |
floodlightOriginalRevenue |
Pierwotny, niezmieniony przychód powiązany ze zdarzeniem Floodlight (w walucie bieżącego raportu) przed modyfikacją instrukcji dotyczącej waluty Floodlight. | atrybut | Money |
Tak |
floodlightEventRequestString |
Ciąg znaków żądania Floodlight dotyczącego konwersji. | atrybut | String |
Tak |
floodlightReferrer |
Witryna odsyłająca Floodlight, w której nastąpiła konwersja. | atrybut | String |
Tak |
floodlightOrderId |
Identyfikator zamówienia Floodlight podany przez reklamodawcę dla danej konwersji. | atrybut | String |
Tak |
feedItemId |
Identyfikator wiersza elementu pliku danych powiązanego z tą konwersją. | atrybut | ID |
Tak |
feedId |
Identyfikator tabeli pliku danych powiązanej z tą konwersją. | atrybut | ID |
Tak |
feedType |
Typ pliku danych powiązanego z tą konwersją. | atrybut | Feed type |
Tak |