Bing UET Tag: konfiguracja i pomoc

Wgraj ZIP modułu w Moduły > "Module Manager". Zainstaluj go i otwórz "Configure" dla Bing UET Tag + Conversions API.

Pobierz liczbowy identyfikator tagu UET ze swojego konta Microsoft Advertising. Moduł nie tworzy na tym koncie tagu ani celów konwersji. Wybierz właściwy sklep przed zapisaniem ustawień.

Wpisz Identyfikator tagu UET, włącz Włączenie tagu Bing UET, wybierz zdarzenia przeglądarkowe i zapisz. ID musi być dodatnią liczbą. Po nowej instalacji śledzenie przeglądarkowe jest wyłączone do czasu konfiguracji.

Wszystkie te pola znajdują się na ekranie konfiguracji.

Integracja zgód obsługuje moduły zgód MPR i rozpoznane stany dostawców zgód. Nie wyświetla własnego banera. Przy włączonej opcji Respektowanie zgody marketingowej brak obsługiwanej decyzji o zgodzie nie jest pozwoleniem na wysyłkę.

Tracker sprawdza też przypisanie właściciela integracji w sklepie i politykę śledzenia wychodzącego. Sygnały pracownika i rezygnacji ze śledzenia mogą blokować wysyłkę. Nie oceniaj śledzenia klientów na podstawie przeglądarki rozpoznanej przez moduł jako wewnętrzna.

Po nowej instalacji te opcje są wyłączone. Włącz tylko sygnały dostarczane przez sklep.

Ustawienia zaangażowania sprawdzają progi galerii, wariantów i szczegółów od 1 do 20, czas od 5 do 600 sekund oraz ograniczenie częstotliwości opcji od 250 do 60000 ms. Pozostaw JSON pusty, aby użyć wartości domyślnych.

Przeglądarkowe UET i Conversions API włącza się osobno. Aby korzystać z zakupów serwerowych:

1. Pozostaw Włączenie tagu Bing UET i Śledzenie zakupów włączone.
2. Włącz "Capture durable buyer evidence", zanim złożysz testowe zamówienie.
3. Włącz Włączenie API konwersji i wpisz Token API konwersji.
4. Zapisz i sprawdź panele gotowości oraz kolejki.
5. Skonfiguruj wygenerowany wpis cron modułu w harmonogramie hostingu.
6. Zaakceptuj cookies w zwykłej sesji przeglądarki, złóż zamówienie jako klient lub gość, a następnie sprawdź, czy zakup pojawił się w kolejce.

Gdy powstaje zamówienie, moduł sprawdza sesję zamówienia i zgodę kupującego, zanim doda zakup do kolejki. Zakup bez zapisanych danych kupującego zostaje wstrzymany, więc włączenie CAPI nie wysyła każdego zamówienia.

Wzorzec endpointu:

https://capi.uet.microsoft.com/v1/{TAG_ID}/events

Zainstalowane zadanie to send_bing_uet_conversions, zaplanowane co 300 sekund. Instalacja tworzy wpis cron przez wspólny pakiet cron. Skopiuj rzeczywisty token i polecenie dostarczone przez zainstalowany moduł. Typowe polecenie serwerowe:

* * * * * php /var/www/html/modules/mprbinguet/cron.php --token=YOUR_TOKEN --max-seconds=300

Zastąp ścieżkę PHP, ścieżkę sklepu i token. Harmonogram wywołuje runner; zadania, których termin wykonania nadszedł, korzystają z własnego harmonogramu pięciominutowego.

Panel kolejki pokazuje Oczekujące, Wysyłanie, Wysłane, Nieudane, "Held", "Terminal" i "Suppressed". Użyj Ponów nieudane zdarzenia po usunięciu zgłoszonego błędu. Zdarzenia wstrzymane i pominięte czekają na brakujące dane kupującego albo zatrzymała je zgoda lub reguła; usuń tę przyczynę zamiast wysyłać ponownie.

Wyślij zdarzenie testowe obecnie niczego nie wysyła: pokazuje tylko komunikat, że tryb testowy Microsoft jest niedostępny. Aby sprawdzić śledzenie, złóż testowe zamówienie, obserwuj kolejkę i użyj narzędzi diagnostycznych na koncie Microsoft Advertising.

To opcjonalna konfiguracja w "Microsoft online refund and cancellation corrections".

Wypełnij "Microsoft customer ID", "Microsoft account ID", "Developer token", "OAuth client ID", "OAuth client secret", "OAuth refresh token" i "Exact purchase conversion goal name". Początkowo te pola są puste. "Use Microsoft adjustments sandbox" jest początkowo wyłączone.

Przełącznik "Enable online corrections" pojawia się tylko wtedy, gdy "Capture durable buyer evidence" jest włączone, wszystkie dane uwierzytelniające Microsoft i nazwa celu zakupu są wypełnione, a dla sklepu istnieje zapisane powiązanie konta Microsoft, tagu UET i celu zakupu. Ekran ustawień nie ma pola do utworzenia tego powiązania, więc w standardowej instalacji przełącznik pozostaje ukryty, a zwroty i anulowania nie są wysyłane do Microsoft.

Włącz Śledzenie zdarzeń niestandardowych i wpisz tablicę JSON w Reguły zdarzeń niestandardowych. Nazwy zdarzeń mogą zawierać litery, cyfry, podkreślenia i łączniki, maksymalnie 64 znaki. Możesz użyć do 15 różnych nazw i do 30 skonfigurowanych parametrów na regułę. Moduł wysyła tylko obsługiwane nazwy parametrów UET, w tym event_category, event_label, event_value, value, currency i pola pozycji e-commerce.

Reguła kliknięcia:

[
  {"event":"GalleryBrowse","trigger":"click","selector":".product-images img, .images-container img","params":{"event_category":"Product","event_label":"Gallery browse"}}
]

Reguła URL:

[
  {"event":"PromoPageView","trigger":"url","contains":["/promo/"],"params":{"event_category":"Campaign"}}
]

Reguła kontrolera:

[
  {"event":"CheckoutPageView","trigger":"controller","controllers":["order"],"params":{"event_category":"Checkout"}}
]

Reguła zdarzenia DOM:

[
  {"event":"QuoteRequest","trigger":"event","dom_event":"shop:quote-request","params":{"event_category":"Lead"}}
]

Motyw może wywołać odpowiednie zdarzenie:

document.dispatchEvent(new CustomEvent('shop:quote-request', {
  detail: {params: {event_label: 'Product page quote button'}}
}));

Używaj tych skonfigurowanych reguł do własnych wywołań. Moduł nie udostępnia starego helpera window.mprbinguetTrack ani nie odczytuje starych atrybutów data-mprbinguet-param-*. Reguły URL, kontrolera i DOM domyślnie uruchamiają się raz na stronę, a reguły kliknięć wielokrotnie. W razie potrzeby ustaw jawnie wartość once reguły.

Sprawdzaj panel gotowości po każdej zmianie konfiguracji. Sprawdź ID tagu, śledzenie przeglądarkowe, zgodę, własne reguły i stan CAPI.

Użyj osobnej przeglądarki klienta. Udziel wymaganej zgody, otwórz produkt i sprawdź w dzienniku sieciowym skrypt Microsoft UET pod bat.bing.com/bat.js oraz wybrane zdarzenia. Odmów zgody w nowym teście i potwierdź, że przy włączonej ochronie śledzenie jest wstrzymane.

Przetestuj udane dodanie do koszyka i listy życzeń. Nieudana akcja nie powinna stać się potwierdzonym zdarzeniem e-commerce. Jeśli motyw lub proces zamówienia używa własnych zdarzeń, potwierdź dostarczanie obsługiwanego sygnału sukcesu.

Dla zakupów porównaj numer transakcji, politykę wartości, walutę i pozycje z zamówieniem. Sprawdź kolejkę serwerową i logi oraz żądania przeglądarki. To Microsoft decyduje, które konwersje przyjmuje i pokazuje w raportach, więc sprawdź wyniki także na koncie Microsoft Advertising.

Jeśli tag się nie ładuje, sprawdź główny przełącznik, dodatnie liczbowe ID, zgodę, wykluczenie pracowników, rezygnację ze śledzenia i politykę przypisania właściciela w sklepie. Następnie sprawdź blokady skryptów i błędy przeglądarki. Jeśli CAPI oczekuje, sprawdź runner cron. Jeśli jest wstrzymane, sprawdź, czy kupujący wyraził zgodę i czy dane jego zamówienia zostały zapisane. Przy błędzie sprawdź token i odpowiedź przed ponowieniem.

Wyłącz śledzenie przeglądarkowe i serwerowe, jeśli chcesz tylko wstrzymać zbieranie danych. Przed odinstalowaniem zapisz potrzebne ustawienia i zapisy wysyłki. Odinstalowanie usuwa menu modułu, jego zaplanowane zadanie i konfigurację. Wspólna tabela kolejki konwersji jest usuwana tylko wtedy, gdy żaden inny moduł nie używa pakietu konwersji; dane kolejki mogą pozostać, gdy inny użytkownik zachowuje wspólną tabelę.

Wymaga PrestaShop 1.6.0.0 lub nowszego oraz PHP 7.1 lub nowszego.