Outbrain Pixel + S2S Postback: konfiguracja i pomoc

1. Prześlij i zainstaluj ZIP w Moduły > "Module Manager", a następnie otwórz Outbrain Pixel + S2S Postback > "Configure".
2. Wprowadź Outbrain Marketer ID, w razie potrzeby oddzielając wiele identyfikatorów przecinkami.
3. Sprawdź przełączniki śledzenia zdarzeń i ustawienie Nazwa zdarzenia zakupu.
4. Ustaw "Enable Outbrain Pixel" na Tak i kliknij Zapisz.
5. Udziel zgody marketingowej w zwykłej przeglądarce odwiedzającego i otwórz produkt.
6. Potwierdź załadowanie obtp.js i wysłanie zdarzenia przeglądarki "View Content".
7. Jeśli używasz S2S, najpierw sprawdź, czy odwiedzający przychodzą z identyfikatorami kliknięć Outbrain i czy zgoda kupującego jest zapisywana, a potem włącz "Enable S2S postback events" i znajdź rzeczywisty zakup w kolejce i w raportach Outbrain.

Ustaw je w Moduły > Outbrain Pixel + S2S Postback > "Configure".

• "Enable Outbrain Pixel". Włącza lub wyłącza śledzenie w przeglądarce; domyślnie: 0.

• Outbrain Marketer ID. Przechowuje alfanumeryczny Marketer ID o długości od 10 do 50 znaków lub istniejący identyfikator dziesiętny do 32 cyfr; domyślnie: empty. Wiele identyfikatorów można oddzielić przecinkami.

• "Exclude employees". Zatrzymuje śledzenie, gdy zalogowany pracownik panelu administracyjnego przegląda sklep; domyślnie: 1.

• "Respect cookie consent". Czeka na zgodę marketingową z mprcookiesrevolution lub mprcookiebanner, gdy jeden z tych modułów jest aktywny; domyślnie: 1.

• "Track PageView". Wysyła zdarzenie Outbrain PAGE_VIEW z nagłówka strony; domyślnie: 1.

• "Track View Content". Wysyła zdarzenie wyświetlenia produktu na stronach produktów; domyślnie: 1.

• "Track View Category". Wysyła zdarzenia wyświetlenia kategorii po wykryciu bieżącej kategorii; domyślnie: 1.

• "Track Add To Cart". Wysyła przeglądarkowe zdarzenia dodania do koszyka po potwierdzonym udanym dodaniu; domyślnie: 1.

• "Track Checkout". Wysyła zdarzenie rozpoczęcia realizacji zamówienia, gdy moduł wykryje stronę jej rozpoczęcia, a koszyk zawiera produkty; domyślnie: 1.

• "Track Purchase". Wysyła zdarzenia zakupu przy potwierdzeniu zamówienia i może kolejkować postbacki zakupów dla S2S; domyślnie: 1.

• "Track Search". Wysyła zdarzenia wyszukiwania w kontrolerze wyszukiwania, gdy występuje s lub search_query; domyślnie: 1.

• "Track Add To Wishlist". Wysyła zdarzenia listy życzeń po potwierdzonym udanym dodaniu; domyślnie: 1.

• "Track Sign Up". Wysyła zdarzenie rejestracji po utworzeniu nowego konta klienta; domyślnie: 1.

• Nazwa zdarzenia zakupu. Określa nazwę zdarzenia Outbrain dla zakupów; domyślnie: Purchase.

• "Track custom events". Włącza niestandardowe reguły konwersji definiowane w JSON; domyślnie: 0.

• Reguły zdarzeń niestandardowych. Przechowuje tablicę JSON niestandardowych reguł kliknięcia, URL, kontrolera lub zdarzenia DOM; domyślnie: empty.

• "Enable S2S postback events". Kolejkuje kwalifikujące się zdarzenia konwersji po stronie serwera, gdy dostępny jest identyfikator kliknięcia Outbrain; domyślnie: 0.

• "S2s Test Click Id". Pole zachowane dla zgodności; domyślnie: puste. Produkcyjna sonda zakupu jest wyłączona.

• "Legacy IP/user-agent preference". Domyślnie: 1. Preferencja zachowana dla zgodności. Adresy IP i dane przeglądarki nie są kolejkowane ani wysyłane.

• "Queue batch limit". Określa liczbę zdarzeń konwersji z kolejki przetwarzanych przez procesor cron w jednym uruchomieniu; domyślnie: 20. Dopuszczalny zakres: 1-1000.

• "Persist marketing consent withdrawals". Domyślnie: 0. Zapisuj wycofania zgody marketingowej, aby zdarzenia w kolejce je uwzględniały.

Kliknij Zapisz. Nazwa zdarzenia zakupu ma domyślną wartość Purchase. Dopasuj nazwy do konta Outbrain. Moduł pozostawia konfigurację kampanii i raportowanie na tym zewnętrznym koncie.

Bieżący formularz udostępnia też te ustawienia. Wszystkie przełączniki sygnałów mają domyślną 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 na stronie i minimalny odstęp 1500 ms między interakcjami z opcjami. Liczniki galerii, wariantów i szczegółów mają zakres od 1 do 20. Czas przebywania ma zakres od 5 do 600 sekund. Odstęp ma zakres 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ą sprawdzenia 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, która nie jest oznaczona jako pracownik. Zalogowana sesja panelu administracyjnego, reguła ruchu wewnętrznego lub rezygnacja odwiedzającego mogą zablokować śledzenie.

Wspólna warstwa zgody obsługuje integracje zgody MPR i dodatkowe adaptery CMP. Musi uzyskać użyteczną decyzję marketingową dla miejsca docelowego. Nieznana, nieaktualna lub odmowna decyzja może wstrzymać zdarzenia. Moduł nie dostarcza banera cookies. Starsze ustawienie zgody nie zastępuje aktualnej odmowy z wykrytej CMP.

Moduł musi odpowiadać za skonfigurowane miejsce docelowe we wspólnym koordynatorze śledzenia. Brak, niejednoznaczność lub konflikt odpowiedzialności mogą wstrzymać wysyłanie z przeglądarki i serwera. Usuń powielone tagi motywu lub rozstrzygnij odpowiedzialność, gdy inny moduł MPR zarządza tym samym kontem.

Wysyłanie produkcyjne podlega też zasadom ruchu wychodzącego. Dostarczenie zdarzeń demonstracyjnych i podglądowych do konta reklamowego zależy od tych zasad. Zakupy i serwerowe zdarzenia formularzy są wysyłane tylko ze zgodą, której kupujący udzielił w danym momencie; późniejsze uruchomienie cron nie może jej zastąpić.

Gdy jest to dozwolone, moduł ładuje https://amplify.outbrain.com/cp/obtp.js. Moduł nie dodaje typowego widżetu dla klientów. Wysyła włączone zdarzenia przeglądarki dotyczące stron, produktów, kategorii, potwierdzonego dodania do koszyka, rozpoczęcia realizacji zamówienia, zakupów, wyszukiwań, potwierdzonego dodania do listy życzeń, rejestracji oraz skonfigurowane zdarzenia niestandardowe z dostępnym kontekstem produktu i zamówienia.

Wizyty na stronach używają PAGE_VIEW. Pozostałe wbudowane nazwy to View Content, View Category, Add To Cart, Checkout, skonfigurowana nazwa zakupu, Search, Add To Wishlist i Sign Up. Kontekst zakupu obejmuje wartość zamówienia, walutę, numer referencyjny i pozycje, o ile są dostępne.

Możesz wprowadzić wiele Marketer ID oddzielonych przecinkami, na przykład 123456, 789012. Każde miejsce docelowe ma własne kontrole odpowiedzialności za śledzenie.

Mechanizm wykonawczy akceptuje ob_click_id, OutbrainClickId, outbrain_click_id i dicbo z adresów docelowych i po sprawdzeniu uprawnień zapisuje prawidłową wartość w mproutbr_ob_click_id na 90 dni. Użyj rzeczywistego podstawienia kliknięcia swojej kampanii, na przykład:

https://www.example.com/product.html?ob_click_id={{ob_click_id}}

Śledzenie w przeglądarce może działać bez atrybucji kliknięć. Postbacki serwera jej wymagają. PageView pozostaje wyłącznie w przeglądarce.

Włącz "Track custom events", wprowadź tablicę JSON w Reguły zdarzeń niestandardowych i zapisz. Używaj dokładnych nazw zdarzeń konta zawierających od 1 do 100 liter, cyfr, spacji lub łączników. Podkreślenia są odrzucane w nazwach niestandardowych. Te przykłady obejmują wyzwalacze kliknięcia, URL, kontrolera i zdarzenia DOM. Reguły kontrolera mogą ograniczać moduł frontowy przez modules.

[
  {
    "event": "Gallery Browse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "once": false,
    "s2s": false,
    "params": {
      "property": "custom_interaction"
    }
  },
  {
    "event": "Landing Page View",
    "trigger": "url",
    "contains": [
      "/sale"
    ],
    "s2s": false,
    "params": {
      "property": "custom_interaction"
    }
  },
  {
    "event": "Contact Page View",
    "trigger": "controller",
    "controllers": [
      "contact"
    ],
    "modules": [],
    "s2s": false,
    "params": {
      "property": "custom_interaction"
    }
  },
  {
    "event": "Lead",
    "trigger": "event",
    "dom_event": "mproutbr:lead",
    "s2s": false,
    "params": {
      "property": "custom_interaction"
    }
  }
]

Wywołaj regułę DOM po inicjalizacji:

document.dispatchEvent(new CustomEvent('mproutbr:lead'));

Reguły URL sprawdzają ścieżkę. Fragmenty zapytania takie jak utm_campaign=outbrain nie są dopasowaniami ścieżki. once ogranicza powtarzające się wyzwalacze kliknięcia lub DOM w bieżącym środowisku wykonawczym.

Przykłady ustawiają s2s na false dla śledzenia interakcji wyłącznie w przeglądarce. Most od strony sklepu może kolejkować kwalifikujące się zdarzenia tylko z wystawionym przez serwer potwierdzeniem wystąpienia zdarzenia, powiązanym z natywną sesją kupującego i bieżącą autoryzacją. Sam token lub dowolne przesłane dane produktu nie wystarczają.

Zachowaj obsługiwane parametry statyczne w params. Bieżący kod wyzwalania nie scala dowolnych wartości data-outbrain-param-* ani DOM detail.params. Funkcja pomocnicza window.mproutbrTrack nie jest udostępniana.

Włącz "Enable S2S postback events" dopiero, gdy identyfikatory kliknięć Outbrain i zgody kupujących są zapisywane. Przy walidacji zamówienia moduł zapisuje te dane i dodaje zakup do kolejki serwerowej. Postback trafia do https://tr.outbrain.com/unifiedPixel z dozwolonymi wartościami atrybucji i zdarzeń. Nie przekazuje adresu IP ani user agent.

Outbrain nie potrafi deduplikować zakupu wysłanego jednocześnie z przeglądarki i z serwera, więc moduł używa jednego kanału na zakup. Przy włączonym S2S strona potwierdzenia zamówienia nie wysyła zakupu z przeglądarki, a jedynie dodaje postback serwerowy do kolejki; zakup bez ID kliknięcia lub zapisanej zgody nie jest więc w ogóle wysyłany. Przy wyłączonym S2S zakup jest wysyłany z przeglądarki na stronie potwierdzenia zamówienia.

Zadanie send_outbrain_conversions jest zarejestrowane z harmonogramem every:300. Staje się gotowe do wykonania co pięć minut. Wspólny wykonawca cron MPR musi wykonywać zadania, których termin nadszedł; sama deklaracja harmonogramu nie uruchamia procesu roboczego. Limit partii ogranicza liczbę wierszy kolejki na uruchomienie do zakresu od 1 do 1000, domyślnie 20.

Użyj współdzielonego harmonogramu skonfigurowanego dla sklepu; moduł nie ma osobnego punktu wejścia cron.php. Przeglądaj wykonanie zadań w tym harmonogramie oraz znaczniki czasu i status kolejki na stronie konfiguracji modułu.

Diagnostyka obejmuje kontrole gotowości, liczniki kolejki, ostatnie wiersze, Wyślij próbę S2S 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 dotyczących pracowników, odpowiedzialności za konto ani miejsca docelowego.

Zadanie ma limit czasu 30 sekund. Wyślij próbę S2S jest wyłączone, ponieważ Outbrain nie ma trybu testowego, który trzymałby konwersje testowe poza raportami. Wypełnienie pola kliknięcia testowego nie wysyła zakupu testowego.

1. Sprawdź wymagane pola, gotowość, integralność i odpowiedzialność dla każdego Marketer ID.
2. Użyj zwykłej przeglądarki odwiedzającego, udziel zgody marketingowej i otwórz produkt.
3. Potwierdź załadowanie obtp.js i wysłanie oczekiwanego zdarzenia przeglądarki.
4. Wykonaj rzeczywiste udane dodanie do koszyka i sprawdź zdarzenie.
5. Dla S2S zweryfikuj rzeczywisty autoryzowany zakup przypisany do reklamy. Sprawdź jego potwierdzenie, wynik kolejki, wykonanie cron i raporty Outbrain.

Jeśli brakuje piksela przeglądarki, sprawdź przełącznik włączenia, Marketer ID, zgodę, zasady dotyczące pracowników, zasady ruchu wychodzącego, powielone tagi i blokowanie w przeglądarce. Jeśli brakuje zakupów S2S, sprawdź atrybucję kliknięć i zapisaną zgodę kupującego. Nie oczekuj awaryjnej wysyłki zakupu z przeglądarki przy włączonym S2S. Przed zresetowaniem nieudanych wierszy sprawdź, czy wysyłka dotarła do Outbrain, bo powtórzony postback może policzyć zakup dwa razy.

Jeśli reguła niestandardowa nie działa, zweryfikuj dokładną nazwę zdarzenia i JSON. Dla wyzwalaczy URL używaj warunków ścieżki. Dla niestandardowych zdarzeń serwerowych sprawdź potwierdzenie wystawione przez serwer i jego powiązanie zamiast dostarczać zmyślone potwierdzenie z JavaScript.

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

Odinstalowanie wywołuje wspólne czyszczenie kolejki konwersji. Wspólna tabela kolejki pozostaje, dopóki korzysta z niej inny moduł konwersji, i może zostać usunięta po usunięciu ostatniego użytkownika. Przed odinstalowaniem wyeksportuj potrzebne dane diagnostyczne. Nie zakładaj, że odinstalowanie usuwa zdarzenia już wysłane do platformy reklamowej lub wszystkie dane atrybucji w przeglądarce.

Wymaga PrestaShop 1.6 lub nowszego i PHP 7.1 lub nowszego.