Ta metoda zwraca metryki dostarczalno\u015bci i zaanga\u017cowania dla pojedynczej wys\u0142anej wiadomo\u015bci e-mail. Dzi\u0119ki niej mo\u017cesz sprawdzi\u0107 najwa\u017cniejsze wyniki, takie jak liczba dostarczonych wiadomo\u015bci, otwarcia i klikni\u0119cia, razem z ich warto\u015bciami procentowymi.<\/p>\n\n\n\n
Statystyki s\u0105 dost\u0119pne dla ca\u0142ej wiadomo\u015bci, ale mo\u017cesz te\u017c zobaczy\u0107 je w podziale na domen\u0119 odbiorcy, rodzin\u0119 domen lub adres IP, z kt\u00f3rego zosta\u0142a wys\u0142ana wiadomo\u015b\u0107. W razie potrzeby metoda zwraca r\u00f3wnie\u017c podstawowe informacje o wiadomo\u015bci, takie jak temat, parametry UTM czy data wysy\u0142ki.<\/p>\n\n\n\n
GET \/reports\/email\/singleMessage\/{id}<\/p>\n\n\n\n
Host:<\/strong> https:\/\/api.ecdp.app<\/p>\n\n\n\n W jednym zapytaniu dozwolony jest tylko jeden typ filtra, a ka\u017cdy filtr przyjmuje dok\u0142adnie jedn\u0105 warto\u015b\u0107. Podanie kilku filtr\u00f3w lub kilku warto\u015bci zwraca b\u0142\u0105d 400 Bad Request.<\/p>\n\n\n\n W jednym zapytaniu dozwolona jest dok\u0142adnie jedna warto\u015b\u0107 grupowania. Grupowanie okre\u015bla, kt\u00f3ra kolumna pojawi si\u0119 w ka\u017cdym wierszu tablicy data[].<\/p>\n\n\n\n Domy\u015blnie:<\/strong> grouping=Message<\/p>\n\n\n\n Ka\u017cdy obiekt w tablicy data zawiera dok\u0142adnie jedn\u0105 kolumn\u0119 grupowania (okre\u015blon\u0105 przez parametr grouping), po kt\u00f3rej nast\u0119puj\u0105 pola KPI opisane poni\u017cej.<\/p>\n\n\n\n Obecne tylko gdy includeDetails=true.<\/p>\n\n\n\n Newsletter z domy\u015blnym grupowaniem i szczeg\u00f3\u0142ami wiadomo\u015bci<\/strong><\/p>\n\n\n\n GET \/reports\/email\/singleMessage\/12345?includeDetails=true<\/p>\n\n\n\n Odpowied\u017a: OK 200<\/strong><\/p>\n\n\n\nParametry zapytania<\/h2>\n\n\n\n
Parametr<\/strong><\/td> Typ<\/strong><\/td> Wymagany<\/strong><\/td> Opis<\/strong><\/td> Dozwolone warto\u015bci \/ Uwagi<\/strong><\/td><\/tr><\/thead> x-api-key<\/td> string<\/td> tak<\/td> Klucz API do uwierzytelniania<\/td> Klucz API do uwierzytelniania<\/td><\/tr> id<\/td> integer<\/td> tak<\/td> Identyfikator wiadomo\u015bci w ECDP<\/td> Parametr \u015bcie\u017cki. Nie mo\u017ce by\u0107 pusty.<\/td><\/tr> startDate<\/td> string<\/td> warunkowy<\/td> Pocz\u0105tek zakresu dat raportu<\/td> YYYY-MM-DD. Wymagany dla Scenario i Confirmation. Niedozwolony dla Newsletter.<\/td><\/tr> endDate<\/td> string<\/td> warunkowy<\/td> Koniec zakresu dat raportu<\/td> YYYY-MM-DD. Wymagany dla Scenario i Confirmation. Niedozwolony dla Newsletter. endDate musi by\u0107 p\u00f3\u017aniejszy ni\u017c startDate.<\/td><\/tr> grouping<\/td> enum<\/td> nie<\/td> Poziom agregacji danych w odpowiedzi<\/td> Message (domy\u015blnie), Domain, DomainFamily, IP<\/td><\/tr> domain<\/td> string<\/td> nie<\/td> Filtruje wyniki do okre\u015blonej domeny odbiorcy<\/td> Pojedyncza warto\u015b\u0107, np. gmail.com. Nie mo\u017cna \u0142\u0105czy\u0107 z innymi filtrami.<\/td><\/tr> domainFamily<\/td> string<\/td> nie<\/td> Filtruje wyniki do rodziny domen<\/td> Pojedyncza warto\u015b\u0107, np. gmail. Nie mo\u017cna \u0142\u0105czy\u0107 z innymi filtrami.<\/td><\/tr> ip<\/td> string<\/td> nie<\/td> Filtruje wyniki do okre\u015blonego IP nadawcy lub jego typu<\/td> Pojedyncza warto\u015b\u0107: Premium, Shared lub konkretny adres IP, np. 1.2.3.4. Nie mo\u017cna \u0142\u0105czy\u0107 z innymi filtrami.<\/td><\/tr> includeDetails<\/td> boolean<\/td> nie<\/td> Czy uwzgl\u0119dni\u0107 metadane wiadomo\u015bci w odpowiedzi<\/td> true lub false (domy\u015blnie: false). Akceptuje te\u017c 1 lub 0.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Filtry<\/h3>\n\n\n\n
Filtr<\/strong><\/td> Typ<\/strong><\/td> Opis<\/strong><\/td><\/tr><\/thead> domain<\/td> string<\/td> Uwzgl\u0119dnia tylko zdarzenia dla podanej domeny odbiorcy, np. gmail.com.<\/td><\/tr> domainFamily<\/td> string<\/td> Uwzgl\u0119dnia tylko zdarzenia dla podanej rodziny domen, np. gmail.<\/td><\/tr> ip<\/td> string<\/td> Uwzgl\u0119dnia tylko zdarzenia wys\u0142ane z podanego adresu IP lub typu IP: Premium, Shared lub konkretny adres.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Opcje grupowania<\/h3>\n\n\n\n
Warto\u015b\u0107 grupowania<\/strong><\/td> Kolumna grupowania w odpowiedzi<\/strong><\/td><\/tr><\/thead> Message<\/td> messageId, messageSubject<\/td><\/tr> Domain<\/td> domain<\/td><\/tr> DomainFamily<\/td> domainFamily<\/td><\/tr> IP<\/td> ip<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Odpowied\u017a<\/h2>\n\n\n\n
Email report data<\/h3>\n\n\n\n
Pole<\/strong><\/td> Typ<\/strong><\/td> Opis<\/strong><\/td><\/tr><\/thead> messageId<\/td> string<\/td> Obecne gdy grouping=Message.<\/td><\/tr> messageSubject<\/td> string<\/td> Temat wiadomo\u015bci. Obecne gdy grouping=Message.<\/td><\/tr> domain<\/td> string<\/td> Obecne gdy grouping=Domain.<\/td><\/tr> domainFamily<\/td> string<\/td> Obecne gdy grouping=DomainFamily.<\/td><\/tr> ip<\/td> string<\/td> Obecne gdy grouping=IP.<\/td><\/tr> bounced<\/td> integer<\/td> Liczba odbitych wiadomo\u015bci.<\/td><\/tr> bouncedPercent<\/td> number<\/td> Udzia\u0142 odbitych wiadomo\u015bci w \u0142\u0105cznej liczbie wys\u0142anych.<\/td><\/tr> delivered<\/td> integer<\/td> Liczba skutecznie dostarczonych wiadomo\u015bci.<\/td><\/tr> deliveredPercent<\/td> number<\/td> Udzia\u0142 dostarczonych wiadomo\u015bci w \u0142\u0105cznej liczbie wys\u0142anych.<\/td><\/tr> opens<\/td> integer<\/td> \u0141\u0105czna liczba otwar\u0107 (wliczaj\u0105c wielokrotne otwarcia).<\/td><\/tr> opensPercent<\/td> number<\/td> Udzia\u0142 otwar\u0107 w liczbie dostarczonych wiadomo\u015bci.<\/td><\/tr> uniqueOpens<\/td> integer<\/td> Liczba odbiorc\u00f3w, kt\u00f3rzy otworzyli wiadomo\u015b\u0107 co najmniej raz.<\/td><\/tr> clicks<\/td> integer<\/td> \u0141\u0105czna liczba klikni\u0119\u0107 w linki.<\/td><\/tr> clicksPercent<\/td> number<\/td> Udzia\u0142 klikni\u0119\u0107 w liczbie dostarczonych wiadomo\u015bci.<\/td><\/tr> uniqueClicks<\/td> integer<\/td> Liczba odbiorc\u00f3w, kt\u00f3rzy klikn\u0119li co najmniej raz.<\/td><\/tr> clicksToOpensPercent<\/td> number<\/td> Udzia\u0142 klikni\u0119\u0107 w liczbie otwar\u0107.<\/td><\/tr> unsubscribes<\/td> integer<\/td> Liczba wypisa\u0144.<\/td><\/tr> complaints<\/td> integer<\/td> Liczba zg\u0142osze\u0144 spamu.<\/td><\/tr> revenue<\/td> number<\/td> Przych\u00f3d przypisany do tej wiadomo\u015bci.<\/td><\/tr> currency<\/td> string<\/td> Kod waluty dla warto\u015bci przychodu (ISO 4217).<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Message details<\/h3>\n\n\n\n
Pole<\/strong><\/td> Typ<\/strong><\/td> Opis<\/strong><\/td><\/tr><\/thead> messageId<\/td> string<\/td> Identyfikator wiadomo\u015bci.<\/td><\/tr> type<\/td> string<\/td> Typ wiadomo\u015bci: Newsletter, Scenario lub Confirmation.<\/td><\/tr> subject<\/td> string<\/td> Temat wiadomo\u015bci e-mail.<\/td><\/tr> utms[]<\/td> array<\/td> Tablica obiekt\u00f3w parametr\u00f3w UTM, ka\u017cdy z polami name i value.<\/td><\/tr> sentDate<\/td> string (ISO-8601 UTC)<\/td> Data i godzina wys\u0142ania wiadomo\u015bci. Obecne tylko dla wiadomo\u015bci typu Newsletter.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Przyk\u0142adowe zapytania i odpowiedzi<\/h2>\n\n\n\n