Integracja Quora Pixel: konfiguracja i pomoc

Wykonaj kroki opisane w sekcji Szybki start.

• "Enable Quora Pixel". Włącza lub wyłącza śledzenie Pixela w przeglądarce; domyślnie: 0. Ustaw w konfiguracji modułu po wpisaniu prawidłowego Pixel ID.
• Pixel ID. Przechowuje identyfikator Quora Pixel z "Quora Ads Manager"; domyślnie: empty. Musi zawierać od 4 do 128 liter, cyfr, podkreśleń lub łączników.
• "Advanced match email". Wysyła do Quora e-mail klienta zahaszowany SHA-256, gdy dostępny jest zalogowany klient; domyślnie: 1.
• "Exclude employee browsing". Zapobiega śledzeniu, gdy pracownik zaplecza przegląda sklep; domyślnie: 1.
• "Respect marketing consent". Po włączeniu wymaga zgody marketingowej. Wyłączenie pozwala na śledzenie bez osobnej decyzji o zgodzie tylko wtedy, gdy nie wykryto obsługiwanego menedżera zgód; domyślnie: 1.
• "Track page visits". Wysyła odwiedziny jako zdarzenia Quora Generic z event_label=PageVisit; domyślnie: 1.
• "Track ViewContent". Wysyła wyświetlenia stron produktów z ID produktu, nazwą, kategorią, wartością i walutą, jeśli dostępne; domyślnie: 1.
• "Track AddToCart". Śledzi potwierdzone udane dodania do koszyka z udowodnionym zwiększeniem ilości; domyślnie: 1.
• "Track AddToWishlist". Śledzi dodania do listy życzeń na podstawie potwierdzonych udanych operacji dodania; domyślnie: 1.
• "Track InitiateCheckout". Wysyła InitiateCheckout, gdy klient dociera do strony rozpoczęcia zamówienia; domyślnie: 1.
• "Track Search". Wysyła zdarzenia Search z przesłanym ciągiem wyszukiwania, jeśli jest dostępny; domyślnie: 1.
• "Track Purchase". Wysyła zdarzenia zakupu przy potwierdzeniu zamówienia i może kolejkować zakupy po stronie serwera, gdy skonfigurowano Conversions API; domyślnie: 1.
• "Track CompleteRegistration". Wysyła CompleteRegistration po utworzeniu konta klienta; domyślnie: 1.
• "Track custom events". Włącza własne reguły zdarzeń JSON; domyślnie: 0.
• Reguły zdarzeń niestandardowych. Przechowuje reguły JSON do niestandardowego śledzenia kliknięć, URL, kontrolerów i zdarzeń DOM; domyślnie: empty.
• "Enable Conversions API events". Włącza kolejkowanie i wysyłanie po stronie serwera dla zdarzeń z prawidłowym ID kliknięcia Quora; domyślnie: 0.
• ID konta reklamowego Quora. Przechowuje liczbowy ID konta reklamowego Quora wymagany przez Conversions API; domyślnie: empty.
• Token dostępu Conversions API. Przechowuje token wygenerowany w "Quora Ads Manager" do serwerowego przesyłania konwersji; domyślnie: empty.
• "Test qclid". Przechowuje rzeczywisty ID kliknięcia Quora do diagnostyki; nie wysyła konwersji testowej; domyślnie: empty.
• "Queue batch limit". Ogranicza liczbę zdarzeń na przebieg przetwarzania kolejki, od 1 do 100; zdarzenia handlowe i potwierdzone formularze mają osobne kolejki; domyślnie: 20.

Po zmianie ustawień kliknij Zapisz. ID konta reklamowego musi być dodatnią liczbą całkowitą, nie większą niż 9007199254740991. "Test qclid" akceptuje do 500 liter, cyfr, kropek, podkreśleń, dwukropków i łączników.

Obecny formularz udostępnia też te ustawienia. Wszystkie przełączniki sygnałów mają domyślnie wartość Nie. Włącz tylko działania, które chcesz obserwować.

Wspólne progi to trzy wyświetlenia galerii, jedna zmiana wariantu, jedno kliknięcie szczegółów, 45 sekund przebywania i ograniczenie częstotliwości opcji do 1500 ms. Liczniki galerii, wariantów i szczegółów mają zakres od 1 do 20. Czas przebywania wynosi od 5 do 600 sekund. Ograniczenie częstotliwości wynosi od 250 do 60000 ms. Na przykład:

{"min_gallery_views":3,"min_variant_changes":1,"min_detail_clicks":1,"dwell_seconds":45,"option_throttle_ms":1500}

Możesz też podać gallery_selectors, variant_selectors i detail_selectors. Zachowaj wartości domyślne, chyba że motyw wymaga innych selektorów. Te opcjonalne sygnały wymagają kontroli zgody, zasad dotyczących pracowników i odpowiedzialności za śledzenie tak jak zdarzenia handlowe.

Podczas pierwszej konfiguracji pozostaw włączone ustawienia zgody i wykluczania pracowników. Testuj w zwykłej przeglądarce odwiedzającego bez oznaczenia pracownika. Zalogowana sesja zaplecza, reguła ruchu wewnętrznego lub rezygnacja odwiedzającego może blokować śledzenie.

Moduł obsługuje integracje zgód MPR i dodatkowe adaptery CMP. Po wykryciu obsługiwanego menedżera zgód śledzenie wymaga prawidłowej decyzji marketingowej dla miejsca docelowego. Nieznana, nieaktualna lub odmowna decyzja wstrzymuje zdarzenia. Moduł nie dostarcza banera cookies. Wyłączenie "Respect marketing consent" nie pozwala obejść odmowy z wykrytego menedżera zgód.

Moduł musi odpowiadać za skonfigurowane miejsce docelowe we wspólnym koordynatorze śledzenia. Brak, niejednoznaczność lub konflikt odpowiedzialności może wstrzymać dostarczanie z przeglądarki i serwera. Usuń powielone tagi motywu lub ustal odpowiedzialny moduł, gdy inne rozszerzenie MPR zarządza tym samym kontem.

Wysyłanie produkcyjne podlega też zasadom ruchu wychodzącego. Tryb demonstracyjny i rozpoznane domeny podglądu lub testowe blokują wysyłanie do konta reklamowego. Zakupy i serwerowe zdarzenia formularzy korzystają z upoważnienia zapisanego w chwili działania kupującego; późniejsze uruchomienie cron nie może zapewnić brakującego upoważnienia.

Moduł ładuje https://a.quora.com/qevents.js, gdy pozwala na to zgoda marketingowa i pozostałe warunki śledzenia. Klienci nie widzą widżetu w sklepie.

Odwiedziny używają Quora Generic z etykietą wizyty. Strony produktów, potwierdzone dodania do koszyka i listy życzeń, wejście do zamówienia, wyszukiwanie, rejestracja i potwierdzenie zamówienia używają ViewContent, AddToCart, AddToWishlist, InitiateCheckout, Search, CompleteRegistration i Purchase. Kontekst produktu i zamówienia może zawierać ID, nazwy, kategorie, ilości, wartość, walutę i numer referencyjny zamówienia. Odpowiednie zdarzenie musi być włączone, a jego dane dostępne.

Kwalifikujące się zakupy trafiają do kolejki wysyłki serwerowej przy zatwierdzeniu zamówienia i są śledzone w przeglądarce na potwierdzeniu zamówienia. Utworzenie konta jest śledzone przy następnym kwalifikującym się załadowaniu strony. Potwierdzone wysłania formularzy również są śledzone.

Atrybucja kliknięć reklam Quora używa qclid. Gdy śledzenie jest dozwolone, moduł zapisuje go w cookie mprqrpx_qclid na 30 dni i w pamięci lokalnej przeglądarki bez automatycznego wygaśnięcia. Odmowa zgody usuwa te dane atrybucji. Śledzenie w przeglądarce działa bez CAPI, ale zdarzenia serwerowe wymagają prawidłowego przechwyconego ID kliknięcia.

"Advanced match email" włącza dopasowanie po e-mailu zahaszowanym SHA-256, gdy jest to dozwolone i dane klienta są dostępne. Podlega też odrębnym kontrolom zgody na dopasowanie; samo zalogowanie klienta nie stanowi upoważnienia.

Włącz "Track custom events", wklej tablicę JSON do Reguły zdarzeń niestandardowych i zapisz. Dostosuj selektory i ścieżki do sklepu. Używaj wyzwalaczy click, url, controller lub event. Reguła kontrolera może też zawierać listę modules. Nazwy zdarzeń dopuszczają litery, cyfry, podkreślenia i łączniki, do 64 znaków. Limit wynosi 15 różnych nazw. once ogranicza regułę w bieżącym czasie działania strony.

[
  {
    "event": "GalleryBrowse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "params": {
      "property": "product_gallery"
    },
    "once": false,
    "capi": true
  },
  {
    "event": "LandingView",
    "trigger": "url",
    "contains": [
      "/special-offer"
    ],
    "params": {
      "property": "special_offer"
    },
    "once": true,
    "capi": true
  },
  {
    "event": "ContactView",
    "trigger": "controller",
    "controllers": [
      "contact"
    ],
    "params": {
      "property": "contact_page"
    },
    "once": true,
    "capi": true
  },
  {
    "event": "SizeGuideOpen",
    "trigger": "event",
    "dom_event": "mprquora:custom",
    "params": {
      "property": "size_guide"
    },
    "once": false,
    "capi": true
  }
]

Wywołaj regułę DOM z motywu po inicjalizacji śledzenia:

document.dispatchEvent(new CustomEvent('mprquora:custom'));

Quora otrzymuje własne reguły jako Generic z metadanymi custom_event_name. Reguły URL dopasowują location.pathname; fragmenty zapytania takie jak utm_campaign=quora nie są dopasowywane przez obecny runtime reguł własnych. Umieść obsługiwane parametry statyczne, takie jak value, w params. Dowolne klucze, takie jak property w przykładach, nie są przekazywane do Pixela w przeglądarce; dane serwerowe zachowują nazwę, czas i identyfikator zdarzenia, identyfikator kliknięcia oraz opcjonalną wartość. Handler DOM akceptuje odpowiednie detail.event_id, lecz nie scala dowolnych wartości detail.params. Ten runtime nie odczytuje starszych przykładów atrybutów danych kliknięć.

Zdarzenia przeglądarki i serwera używają zgodnych event_id, gdy pierwotne zdarzenie kwalifikuje się do obu. Własne żądanie capi nadal wymaga przechwyconej atrybucji kliknięcia, zaakceptowanej tożsamości zdarzenia i bieżącego upoważnienia kupującego.

Zadanie send_quora_conversions jest zarejestrowane z harmonogramem every:300. Staje się wymagalne co pięć minut. Wspólny runner cron MPR musi wykonywać wymagalne zadania; sama deklaracja harmonogramu nie uruchamia procesu roboczego. Limit partii ogranicza liczbę wierszy na przebieg przetwarzania kolejki do 1-100, domyślnie 20. Kolejki zdarzeń handlowych i potwierdzonych formularzy są przetwarzane osobno dla każdego sklepu.

Moduł korzysta ze wspólnego harmonogramu skonfigurowanego dla sklepu i nie ma osobnego pliku cron.php. Potwierdź w nim wykonanie zadań i sprawdź znaczniki czasu oraz stan kolejki na stronie konfiguracji modułu.

Diagnostyka obejmuje kontrole gotowości, liczniki kolejki, ostatnie wiersze, Wyślij próbę API i Ponów nieudane zdarzenia. Przed ponowieniem usuń przyczynę błędu. Przywrócenie nieudanych wierszy do oczekujących nie omija bieżących kontroli zgody, zasad pracowników, odpowiedzialności za konto ani miejsca docelowego.

Klient serwerowy wysyła do https://api.quora.com/ads/v0/conversion. Skonfiguruj liczbowy ID konta i jego token. Wyślij próbę API niczego nie wysyła, ponieważ ta integracja nie ma trybu wysyłki testowej ani trybu samej walidacji. "Test qclid" nie wysyła konwersji testowej.

1. Sprawdź powiadomienia o wymaganej konfiguracji, gotowość, integralność i odpowiedzialność za miejsce docelowe.
2. W zwykłej przeglądarce odwiedzającego udziel zgody marketingowej i otwórz produkt. Potwierdź załadowanie qevents.js i wysłanie zdarzenia produktu.
3. Wykonaj rzeczywiste udane dodanie do koszyka i sprawdź zdarzenie przeglądarki.
4. Do testowania serwera użyj autoryzowanego rzeczywistego przebiegu z atrybucją reklamy i prawidłowym qclid. Sprawdź stan zdarzenia w kolejce i rzeczywistą diagnostykę platformy po przetworzeniu przez cron.
5. Potwierdź ID przeglądarki i serwera, gdy dopuszczono oba zdarzenia.

Jeśli brakuje zdarzeń przeglądarki, sprawdź Pixel ID, przełączniki, stan zgody, oznaczenia pracowników, odpowiedzialny moduł śledzenia, zasady ruchu wychodzącego i blokady przeglądarki. Jeśli brakuje zdarzeń serwerowych, sprawdź atrybucję kliknięcia, dane dostępowe, zapisaną zgodę kupującego i uruchomienia harmonogramu. Zdarzenia serwerowe wymagają identyfikatora kliknięcia qclid, więc zwykła wizyta bez niego nie tworzy zdarzenia CAPI. Ponawiaj dopiero po poprawieniu zapisanego błędu.

Jeśli własna reguła nie działa, zweryfikuj JSON i składnię selektora oraz sprawdź, czy chodziło o dopasowanie ścieżki, czy zapytania. Obecny runtime nie udostępnia window.mprquoraTrack.

Wyłącz przełączniki przeglądarki i serwera i zapisz, aby zatrzymać śledzenie z zachowaniem konfiguracji. Odinstaluj w "Module Manager", aby usunąć ustawienia modułu, wpisy menu i zarejestrowane zadania.

Odinstalowanie wywołuje wspólne czyszczenie kolejki konwersji. Wspólna tabela kolejki pozostaje, gdy używa jej inny moduł konwersji, i może zostać usunięta po usunięciu ostatniego użytkownika. Wyeksportuj potrzebną diagnostykę przed odinstalowaniem. Wysłane zdarzenia pozostają na platformie reklamowej. Odinstalowanie nie usuwa danych atrybucji w przeglądarce.

Wymaga PrestaShop 1.6 lub nowszego i PHP 7.1 lub nowszego.