Ta metoda zwraca produkty, kt\u00f3re klienci kupili dzi\u0119ki rekomendacjom ECDP w wybranym zakresie dat. Ka\u017cdy rekord to jeden zakupiony produkt przypisany do rekomendacji wy\u015bwietlonej w wiadomo\u015bci e-mail, pop-upie lub banerze.<\/p>\n
Ka\u017cdy rekord zawiera informacje o zam\u00f3wieniu, kliencie, kanale oraz wiadomo\u015bci lub kampanii, kt\u00f3ra dostarczy\u0142a rekomendacj\u0119, a tak\u017ce warto\u015b\u0107 produktu. Opcjonalnie mo\u017cesz doda\u0107 opisowe pola przypisanego produktu oraz pe\u0142n\u0105 list\u0119 produkt\u00f3w z tego samego zam\u00f3wienia.<\/p>\n
U\u017cyj tej metody, aby weryfikowa\u0107 skuteczno\u015b\u0107 rekomendacji.<\/p>\n
GET \/reports\/attribution\/recommendations<\/p>\n
Host:<\/strong> https:\/\/api.ecdp.app<\/p>\n\n\n Odpowied\u017a zawiera tablic\u0119 data<\/em>. Ka\u017cdy element reprezentuje jeden zakupiony produkt przypisany do rekomendacji.<\/p>\n Obiekt customer<\/em> zawiera nast\u0119puj\u0105ce pola.<\/p>\n\n\n Gdy includeProductDetails=true<\/em>, ka\u017cdy rekord zawiera obiekt productDetails<\/em> opisuj\u0105cy przypisany produkt. Gdy includeOrderDetails=true<\/em>, ka\u017cdy rekord zawiera tablic\u0119 orderDetails<\/em> ze wszystkimi produktami z zam\u00f3wienia. Oba pola maj\u0105 t\u0119 sam\u0105 struktur\u0119, tak\u0105 sam\u0105 jak pozycje zam\u00f3wienia w raporcie atrybucji zam\u00f3wie\u0144. Je\u015bli ustawisz oba parametry na true, przypisany produkt pojawi si\u0119 zar\u00f3wno w productDetails<\/em>, jak i w orderDetails<\/em>.<\/p>\n\n\n Zakupy przypisane do rekomendacji w wybranym zakresie dat<\/strong><\/p>\n\n\nParametry zapytania<\/h2>\n\n\n
Parametr<\/strong><\/td> Lokalizacja<\/strong><\/td> Typ<\/strong><\/td> Wymagany<\/strong><\/td> Opis<\/strong><\/td> Dozwolone warto\u015bci \/ Uwagi<\/strong><\/td><\/tr><\/thead> x-api-key<\/td> header<\/td> string<\/td> tak<\/td> Klucz API do uwierzytelniania<\/td> Dost\u0119pny w Ustawienia > API<\/strong><\/td><\/tr> startDate<\/td> query<\/td> string<\/td> tak<\/td> Pocz\u0105tek okna raportowania<\/td> Format: YYYY-MM-DD. Interpretowana w strefie czasowej jednostki biznesowej. Musi by\u0107 wcze\u015bniejsza lub r\u00f3wna endDate<\/td><\/tr> endDate<\/td> query<\/td> string<\/td> tak<\/td> Koniec okna raportowania<\/td> Format: YYYY-MM-DD. Interpretowana w strefie czasowej jednostki biznesowej. Uwzgl\u0119dniany jest ca\u0142y dzie\u0144 ko\u0144cowy<\/td><\/tr> website<\/td> query<\/td> string<\/td> nie<\/td> Filtruje wyniki po ID lub nazwie strony<\/td> ID strony (liczba ca\u0142kowita)<\/td><\/tr> channel<\/td> query<\/td> enum<\/td> warunkowy<\/td> Ogranicza wyniki do jednego kana\u0142u<\/td> Email, PopUp, Banner, Sms, WebPush. Wielko\u015b\u0107 liter nie ma znaczenia. Wymagany, gdy podano messageType, messageId lub campaignId. Warto\u015bci Sms i WebPush s\u0105 akceptowane, ale rekomendacje nie s\u0105 dost\u0119pne dla tych kana\u0142\u00f3w, wi\u0119c odpowied\u017a jest pusta<\/td><\/tr> messageType<\/td> query<\/td> enum<\/td> nie<\/td> Ogranicza wyniki do jednego typu wiadomo\u015bci<\/td> Newsletter, Scenario, Confirmation. Wymaga channel=Email, Sms lub WebPush. Confirmation dost\u0119pny wy\u0142\u0105cznie dla kana\u0142u Email<\/td><\/tr> messageId<\/td> query<\/td> integer<\/td> nie<\/td> Ogranicza wyniki do konkretnej wiadomo\u015bci<\/td> Wymaga channel=Email, Sms lub WebPush<\/td><\/tr> campaignId<\/td> query<\/td> integer<\/td> nie<\/td> Ogranicza wyniki do konkretnej kampanii pop-up lub baneru<\/td> Wymaga channel=PopUp lub Banner<\/td><\/tr> includeProductDetails<\/td> query<\/td> boolean<\/td> nie<\/td> Uwzgl\u0119dnia opisowe pola przypisanego produktu<\/td> true lub false. Domy\u015blnie: false<\/td><\/tr> includeOrderDetails<\/td> query<\/td> boolean<\/td> nie<\/td> Uwzgl\u0119dnia wszystkie produkty z zam\u00f3wienia dla ka\u017cdego rekordu<\/td> true lub false. Domy\u015blnie: false<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Odpowied\u017a<\/h2>\n
Dane raportu atrybucji rekomendacji<\/h3>\n\n\n
Pole<\/strong><\/td> Typ<\/strong><\/td> Opis<\/strong><\/td><\/tr><\/thead> dateTime<\/td> string<\/td> Data i godzina rekordu w strefie czasowej jednostki biznesowej. Format: YYYY-MM-DDThh:mm:ss, bez przesuni\u0119cia UTC<\/td><\/tr> websiteId<\/td> integer<\/td> Strona, z kt\u00f3rej pochodzi zam\u00f3wienie<\/td><\/tr> channel<\/td> string<\/td> Kana\u0142, kt\u00f3ry dostarczy\u0142 rekomendacj\u0119: Email, PopUp lub Banner<\/td><\/tr> messageType<\/td> string<\/td> Typ wiadomo\u015bci: Newsletter, Scenario lub Confirmation. Pomijane dla PopUp i Banner<\/td><\/tr> messageId<\/td> integer<\/td> Identyfikator przypisanej wiadomo\u015bci. Pomijane dla PopUp i Banner<\/td><\/tr> campaignId<\/td> integer<\/td> Identyfikator przypisanej kampanii pop-up lub baneru. Pomijane dla Email<\/td><\/tr> orderId<\/td> string<\/td> Identyfikator zam\u00f3wienia zawieraj\u0105cego przypisany produkt<\/td><\/tr> customer<\/td> object<\/td> Dane klienta. Zobacz tabel\u0119 Dane klienta<\/strong>. Pomijane, gdy zam\u00f3wienie nie jest powi\u0105zane z klientem<\/td><\/tr> productId<\/td> string<\/td> Identyfikator przypisanego produktu zgodny ze \u017ar\u00f3d\u0142em e-commerce<\/td><\/tr> productValueConverted<\/td> number<\/td> Warto\u015b\u0107 przypisanego produktu przeliczona na walut\u0119 raportowania jednostki biznesowej<\/td><\/tr> productDetails<\/td> object<\/td> Obecne, gdy includeProductDetails=true. Ma struktur\u0119 opisan\u0105 w tabeli Szczeg\u00f3\u0142y produktu<\/strong><\/td><\/tr> orderDetails<\/td> array<\/td> Obecne, gdy includeOrderDetails=true. Ka\u017cdy element ma struktur\u0119 opisan\u0105 w tabeli Szczeg\u00f3\u0142y produktu<\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Dane klienta<\/h3>\n
Pole<\/strong><\/td> Typ<\/strong><\/td> Opis<\/strong><\/td><\/tr><\/thead> id<\/td> integer<\/td> Wewn\u0119trzny identyfikator klienta w ECDP<\/td><\/tr> email<\/td> string<\/td> Adres e-mail klienta<\/td><\/tr> phone<\/td> string<\/td> Numer telefonu klienta<\/td><\/tr> crmId<\/td> string<\/td> Identyfikator klienta w systemie CRM<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Szczeg\u00f3\u0142y produktu<\/h3>\n
Pole<\/strong><\/td> Typ<\/strong><\/td> Opis<\/strong><\/td><\/tr><\/thead> id<\/td> string<\/td> Identyfikator produktu zgodny ze \u017ar\u00f3d\u0142em e-commerce<\/td><\/tr> name<\/td> string<\/td> Nazwa produktu<\/td><\/tr> price<\/td> number<\/td> Cena jednostkowa w oryginalnej walucie transakcji<\/td><\/tr> quantity<\/td> integer<\/td> Zakupiona ilo\u015b\u0107<\/td><\/tr> returned<\/td> integer<\/td> Zwr\u00f3cona ilo\u015b\u0107. Pomijane, je\u015bli nie ustawiono<\/td><\/tr> category<\/td> string<\/td> Kategoria produktu. Pomijane, je\u015bli nie ustawiono<\/td><\/tr> productAttributes<\/td> array<\/td> Tablica par { name, value } z niestandardowymi cechami produktu. Pomijane, je\u015bli brak<\/td><\/tr> recommendationAttribution<\/td> object<\/td> Obecne, gdy produkt zosta\u0142 dodany za po\u015brednictwem rekomendacji ECDP. Zobacz struktur\u0119 poni\u017cej<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Obiekt atrybucji rekomendacji<\/h4>\n\n\n
Pole<\/strong><\/td> Typ<\/strong><\/td> Opis<\/strong><\/td><\/tr><\/thead> scope<\/td> string<\/td> Zakres atrybucji: Channel (Email) lub Onsite (PopUp, Banner)<\/td><\/tr> type<\/td> string<\/td> Typ rekomendatora: Personalized, Complementary, Bestsellers, Popular, SimilarProducts, CrossSell, VisuallySimilar, SimilarProperties, Emailing lub RecentlyViewed<\/td><\/tr> id<\/td> integer<\/td> Identyfikator wiadomo\u015bci (Email) lub kampanii (PopUp, Banner), kt\u00f3ra dostarczy\u0142a rekomendacj\u0119<\/td><\/tr> channel<\/td> string<\/td> Powierzchnia rekomendacji: Email, PopUp lub Banner<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Przyk\u0142adowe zapytania i odpowiedzi<\/h2>\n