Gdy pobierasz dane edrone przez MCP Connector, wiele pól zawiera liczbowe identyfikatory (ID) zamiast nazw. W tym artykule znajdziesz znaczenie każdego ID, dzięki czemu Ty (i Claude) poprawnie odczytacie dane o atrybucji.
MCP Connector łączy Twoje konto edrone z asystentami AI, takimi jak Claude. Możesz też spotkać się z nazwą AI Connector. Nie masz jeszcze połączenia? Instrukcję znajdziesz w artykule „Zintegruj się z Claude / ChatGPT!”.
📌 Wskazówka: Zawsze traktuj ID z tego artykułu jako punkt odniesienia, a nie przykładowe wartości, które możesz zobaczyć gdzie indziej.
Które pola korzystają z której listy
Pole | Co oznacza ID | Sekcja |
engagementTypeId, attributedByEngagementTypeId | Typ engagementu, czyli rodzaj kampanii lub automatyzacji | Typy engagementu |
channelTypeId, attributedByChannelTypeId, channelId | Kanał | Kanały |
attributionReasonId | Dlaczego zamówienie zostało przypisane do wiadomości | Powody atrybucji |
isSocialProof, isSmartRecommendation, isRecommendationFrame, isAIAgent | Elementy onsite, z którymi klient miał kontakt przed zakupem | Flagi onsite w zamówieniach |
Typy engagementu
Pola: engagementTypeId i attributedByEngagementTypeId. To jeden słownik, używany wszędzie: w automatyzacjach, raportach i zamówieniach. Niektóre starsze typy mogą nigdy nie pojawić się na Twoim koncie.
Kampanie
ID | Nazwa techniczna | Co to jest |
6 | NEWSLETTER | Newsletter |
8 | SMS_NEWSLETTER | Kampania SMS |
11 | CUSTOM_NEWSLETTER | Newsletter dedykowany |
13 | NEWSLETTER_AB | Newsletter A/B |
14 | NEWSLETTER_CATEGORIES | Newsletter kategorii |
17 | PUSH_NEWSLETTER | Kampania push |
22 | NEWSLETTER_HUB | Kampania newslettera e-mail (Newsletter Hub) – dziś najczęstszy typ |
30 | WHATSAPP_NEWSLETTER | Kampania WhatsApp |
37 | CUSTOMERS_ACTIVATION |
Custom Flow
ID | Nazwa techniczna | Co to jest |
21 | CUSTOM_FLOW | Custom Flow – automatyzacje, które budujesz w kreatorze flow |
Gotowe automatyzacje (Ready Flows)
Jeśli scenariusz ma swój artykuł w Help Center, nazwa prowadzi do niego i jest zgodna z nazwą użytą w artykule. Nazwy bez linku to zwykłe opisy.
ID | Nazwa techniczna | Scenariusz |
1 | RESTORE_CUSTOMERS | |
2 | LOYALTY_PROGRAM | |
3 | BIGGEST_SPENDERS | Klienci, którzy wydają najwięcej |
4 | FREQUENT_BUYERS | Klienci, którzy kupują najczęściej |
5 | ABANDONED_CARTS | |
7 | ADVANCED_RESTORE_CUSTOMERS | |
9 | AFTER_SALE | |
10 | NEWSLETTER_SUBSCRIPTION | |
12 | WISH_LIST | |
15 | RECOMMENDATIONS | |
16 | CROSS_SELLING_TRANSACTIONAL | |
18 | CHAT_SUBSCRIPTION | Zapis przez czat |
19 | BIRTHDAY | |
20 | REFER_A_FRIEND | Poleć znajomemu |
23 | NEWSLETTER_SIGN_UP_AFTER_PURCHASE | |
24 | PRICE_CHANGE_UP | |
25 | PRICE_CHANGE_DOWN | |
26 | LOW_STOCK_PRODUCTS | |
27 | NEWEST_PRODUCTS | |
28 | ASK_FOR_REVIEW | |
29 | BACK_IN_STOCK | |
31 | SMS_SUBSCRIPTION | |
32 | RECOVER_UNPAID_ORDER | Odzyskiwanie nieopłaconych zamówień |
33 | REVIEW_REQUEST | Prośba o opinię |
34 | CALL_ME_BACK | |
35 | PRIVACY_POLICY | Polityka prywatności |
36 | WHATSAPP_SUBSCRIPTION | |
38 | CUSTOMER_REACTIVATION | |
39 | CASHBACK | |
40 | CYCLIC_LOYALTY_PROGRAM |
Gdzie szukać poszczególnych typów
list_engagements zwraca gotowe automatyzacje, po jednym wierszu na typ, ale nie wszystkie. Prośba o opinię (33) nigdy się tam nie pojawia. Wishlist (12), Zapis przez czat (18) i Poleć znajomemu (20) pojawiają się tylko wtedy, gdy Twoje konto ma do nich dostęp. Starsze typy 3, 4 i 34 się nie pojawiają. Custom Flow (21) i wszystkie typy kampanii nigdy się tam nie pojawią, nawet jeśli są do nich przypisane zamówienia.
get_automation_reports obejmuje Custom Flow i gotowe automatyzacje, bez newsletterów. Nie obejmuje scenariuszy Wishlist (12), Zapis przez czat (18), Poleć znajomemu (20) ani Polityka prywatności (35).
Kampanie 6, 8, 11, 13, 14, 22, 30 i 37 znajdziesz w get_newsletter_reports, razem z ID kanału. Kampanii push (17) tam nie ma: użyj get_push_newsletter_report lub get_push_newsletter_statistics.
⚠️ Ważne: Jeśli zamówienie jest przypisane do typu 21, 22 lub 33, a w list_engagements nie ma tego typu, to nic nie zginęło. Sprawdź get_automation_reports (Custom Flow i Prośba o opinię) albo get_newsletter_reports (kampanie).
Kanały
Pola: channelTypeId, attributedByChannelTypeId i channelId.
ID | Kanał |
1 | |
2 | SMS |
4 | Push |
8 | Czat |
16 | |
32 | Messenger |
64 | Allegro |
128 | AI Agent |
Nie ma kanału 3.
attributedByChannelTypeId to kanał tej konkretnej wiadomości, do której przypisano zamówienie. Przykład: Custom Flow (typ 21) może wysyłać wiadomości WhatsApp, więc typ 21 z kanałem 16 to normalna sytuacja.
Powody atrybucji
Pole: attributionReasonId. Pokazuje, co klient zrobił z wiadomością.
ID | Kanał | Zdarzenie |
1 | Otwarcie | |
4 | Kliknięcie | |
8 | SMS | Dostarczenie |
16 | SMS | Kliknięcie |
32 | Dostarczenie | |
64 | Otwarcie (odczytanie) | |
128 | Kliknięcie |
Zamówienie może więc zostać przypisane do wiadomości WhatsApp lub SMS bez kliknięcia.
⚠️ Ważne: Powód 1 dotyczy e-maili. Jeśli szukasz atrybucji WhatsApp z samym powodem 1, nie dostaniesz żadnych wyników.
W get_engagement_attributions pole attributionReasonId działa jak suma ID. Podaj 0, aby dostać wszystkie powody, albo dodaj ID do siebie, aby je połączyć. Na przykład 224 (32 + 64 + 128) to wszystkie powody WhatsApp, a 5 (1 + 4) to wszystkie powody e-mail.
clickRevenue i supportedRevenue
Raporty automatyzacji i raporty newsletterów dzielą przypisany przychód na dwa pola. O podziale nie decyduje sam powód atrybucji, tylko to, czy zarejestrowano kliknięcie w wiadomość.
Pole | Co obejmuje |
clickRevenue | Przypisany przychód, gdy klient kliknął w wiadomość: powody 4, 16 i 128, a także każda atrybucja e-mail, SMS lub WhatsApp, przy której zarejestrowano kliknięcie w link z wiadomości. |
supportedRevenue | Przypisany przychód bez zarejestrowanego kliknięcia: otwarcie, dostarczenie lub odczytanie (powody 1, 8, 32, 64). |
Oba pola obejmują tylko wiadomości. Elementy onsite nie są w nich uwzględniane (zobacz następną sekcję).
Flagi onsite w zamówieniach
Zamówienie może mieć cztery flagi onsite:
Flaga | Element onsite |
isSocialProof | Social proof |
isSmartRecommendation | Smart Rekomendacje |
isRecommendationFrame | Ramka rekomendacji |
isAIAgent | AI Agent |
Gdy flaga ma wartość true, oznacza to:
isSocialProof i isSmartRecommendation: klient zobaczył lub kliknął dany element w ciągu 1 dnia przed zamówieniem.
isRecommendationFrame: klient zobaczył lub kliknął ramkę rekomendacji w ciągu 30 dni przed zamówieniem.
Przy tych trzech flagach liczą się tylko zdarzenia po poprzednim zamówieniu klienta.
isAIAgent: AI Agent polecił klientowi produkty albo klient kliknął polecany produkt lub dodał go do koszyka.
Te flagi to nie jest atrybucja do wiadomości. Nie mają ID typu engagementu i nie zmieniają tego, do której wiadomości przypisane jest zamówienie.
Przykład: zamówienie z social proof, bez interakcji z wiadomością, ma attributedByEngagementTypeId: null. Nie liczy się ani do clickRevenue, ani do supportedRevenue.
Wartość null oznacza, że statystyki onsite dla tego zamówienia nie są dostępne, np. przy bardzo świeżych zamówieniach, które nie zostały jeszcze przetworzone. Nie oznacza false.
Obok tych flag znajdziesz liczniki dla zamówienia: emailsCount, smsCount i whatsappCount.
Praktyczne wskazówki
Przychód per kanał: Użyj get_revenue_by_channel. Zwraca e-mail, SMS i WhatsApp, a każdy z tych kanałów obejmuje wszystkie kampanie i automatyzacje wysłane tym kanałem. Nie zawiera kanału push.
Konkretna kampania: Gdy podasz engagementTypeId, get_engagement_attributions pokazuje najnowszą kampanię danego typu. Aby wskazać konkretną kampanię, podaj engagementId.
📌 Wskazówka: Zaczynasz analizę atrybucji z Claude? Najpierw wklej do czatu tabele z tego artykułu, aby Claude poprawnie odczytał ID.
Potrzebujesz dodatkowej pomocy?
Jeśli masz jakiekolwiek dodatkowe pytania dotyczące danych z MCP Connectora, skontaktuj się z nami na hello@edrone.me