Nieprzetworzone dane o konwersjach.
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": "conversion"
.
{ ... "reportType": "conversion", "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 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 w 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 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 |
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ą konwersją. Tylko konwersje 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 produkt powiązany z konwersją. DS generuje ten identyfikator po połączeniu konta zasobów reklamowych w DS. | atrybut | ID |
Tak |
productId |
Identyfikator produktu powiązanego z tą konwersją. | atrybut | String |
Tak |
productCountry |
Kraj (w formacie ISO 3166) zarejestrowany w pliku danych o asortymencie zawierającym 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ą. 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 powiązanego z konwersją: Online lub Local . |
atrybut | Product channel |
Tak |
conversionId |
Identyfikator generowany przez Search Ads 360 dla każdej konwersji. | atrybut | ID |
Tak |
advertiserConversionId |
W przypadku konwersji offline jest to identyfikator podawany przez reklamodawców. Jeśli reklamodawca nie określi takiego identyfikatora, Search Ads 360 go wygeneruje. W przypadku konwersji online ta wartość jest równa wartości w kolumnie conversionId lub w kolumnie floodlightOrderId w zależności od instrukcji Floodlight reklamodawcy. | atrybut | String |
Tak |
conversionType |
Typ konwersji: Action lub Transaction . |
atrybut | Conversion type |
Tak |
conversionRevenue |
Łączna kwota pozyskana z konwersji. | atrybut | Money |
Tak |
conversionQuantity |
Liczba produktów zarejestrowanych w konwersji, określona przez parametr qty. Reklamodawca jest odpowiedzialny za dynamiczne wprowadzanie parametru (np. liczby produktów sprzedanych w ramach konwersji). W przeciwnym razie domyślna wartość to 1. | atrybut | Number |
Tak |
conversionDate |
Data wystąpienia konwersji podana w strefie czasowej sieci Campaign Managera. Ta data służy do agregacji danych o konwersjach. Jeśli na przykład DS połączy działania z 1 maja, policzy wszystkie konwersje polegające na działaniu, dla których conversionDate to 1 maja. |
atrybut | Date |
Tak |
conversionTimestamp |
Sygnatura czasowa UTC wskazująca czas, w którym nastąpiła konwersja. | atrybut | Timestamp |
Tak |
conversionLastModifiedTimestamp |
Sygnatura czasowa UTC ostatniej modyfikacji konwersji. | atrybut | Timestamp |
Tak |
conversionAttributionType |
Do czego przypisana jest konwersja: Visit lub Keyword+Ad . |
atrybut | Conversion attribution type |
Tak |
conversionVisitId |
Identyfikator wizyty w DS, do którego została przypisana konwersja. | atrybut | ID |
Tak |
conversionVisitTimestamp |
Sygnatura czasowa UTC wizyty, do której została przypisana konwersja. | atrybut | Timestamp |
Tak |
conversionVisitExternalClickId |
Unikalny ciąg znaków używany w przypadku wizyty, do której przypisana jest konwersja, przekazywany na stronę docelową 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 |
conversionSearchTerm |
Wyszukiwane hasło, które doprowadziło do konwersji. | atrybut | String |
Tak |
floodlightOriginalRevenue |
Pierwotne, niezmienione przychody powiązane ze zdarzeniem Floodlight (w walucie bieżącego raportu) sprzed modyfikacji instrukcji dotyczących waluty Floodlight. | atrybut | Money |
Tak |
floodlightEventRequestString |
Ciąg znaków żądania Floodlight powiązany z konwersją. | atrybut | String |
Tak |
floodlightReferrer |
Witryna Floodlight odsyłająca konwersji. | atrybut | String |
Tak |
floodlightOrderId |
Identyfikator zamówienia Floodlight podany przez reklamodawcę na potrzeby 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ązany z tą konwersją. | atrybut | Feed type |
Tak |