Udostępnij za pośrednictwem


Odroczenie aktywacji zdarzeń

Ważne

Od 20 września 2023 r. nie będzie można tworzyć nowych zasobów usługi Personalizacja. Usługa Personalizacja jest wycofywana 1 października 2026 r.

Odroczona aktywacja zdarzeń umożliwia tworzenie spersonalizowanych witryn internetowych lub kampanii wysyłkowych, biorąc pod uwagę, że użytkownik może nigdy nie zobaczyć strony lub otworzyć wiadomość e-mail. W tych scenariuszach aplikacja może wymagać wywołania funkcji Rank, zanim będzie wiedzieć, czy wynik zostanie użyty lub wyświetlony użytkownikowi w ogóle. Jeśli zawartość nigdy nie jest wyświetlana użytkownikowi, nie należy zakładać domyślnej nagrody (zazwyczaj zero), aby uczyć się od niej. Odroczona aktywacja umożliwia korzystanie z wyników wywołania rangi w danym momencie i decydowanie, czy zdarzenie powinno zostać poznane później, czy w innym miejscu w kodzie.

Typowe scenariusze odroczonej aktywacji

Odroczenie aktywacji zdarzeń jest przydatne w następujących przykładowych scenariuszach:

  • Wstępnie renderujesz spersonalizowaną stronę internetową dla użytkownika, ale użytkownik może nigdy go nie zobaczyć, ponieważ niektóre logika biznesowa może zastąpić wybór akcji Personalizacja.
  • Personalizowanie zawartości "poniżej fałszowania" na stronie internetowej jest bardzo możliwe, że zawartość nigdy nie będzie widoczna przez użytkownika.
  • Personalizowanie wiadomości e-mail marketingowych jest konieczne, aby uniknąć szkolenia z wiadomości e-mail, które nigdy nie były otwierane przez użytkowników.
  • Spersonalizowano dynamiczny kanał multimedialny, a użytkownicy mogą przestać odtwarzać kanał przed przejściem do piosenek lub filmów wybranych przez usługę Personalizacja.

Ogólnie rzecz biorąc, te scenariusze występują w następujących sytuacjach:

  • Wstępnie renderujesz interfejs użytkownika, którego użytkownik może lub nie może zobaczyć z powodu ograniczeń interfejsu użytkownika lub czasu.
  • Aplikacja wykonuje personalizację predykcyjną, w której wykonujesz wywołania rangi, zanim dowiesz się, czy użyjesz danych wyjściowych.

Jak odroczyć aktywację, a później aktywować zdarzenia

Aby odroczyć aktywację dla zdarzenia, wywołaj metodę Rank w deferActivation = True treści żądania.

Gdy tylko wiesz, że użytkownicy byli wyświetlani spersonalizowaną zawartością lub multimediami i oczekują, że nagroda jest rozsądna, musisz aktywować to zdarzenie. W tym celu wywołaj interfejs API Aktywuj za pomocą identyfikatora eventId.

Wywołanie interfejsu API Aktywuj dla tego wywołania EventID musi zostać odebrane przed wygaśnięciem okna czasu oczekiwania na nagrodę.

Zachowanie z odroczonej aktywacji

Usługa Personalizacja będzie uczyć się od wydarzeń i nagród w następujący sposób:

  • Jeśli wywołasz metodę Rank z elementem deferActivation = Truei nie wywołasz interfejsu API dla tego identyfikatora eventId i wywołasz metodę Activate Reward, usługa Personalizacja nie uczy się na podstawie zdarzenia.
  • Jeśli wywołasz metodę Rank z elementem deferActivation = Truei wywołasz interfejs API dla tego identyfikatora eventId i wywołasz metodę Activate Reward, usługa Personalizacja będzie uczyć się na podstawie zdarzenia z określonym wynikiem nagrody.
  • Jeśli wywołasz metodę Rank z elementem deferActivation = Truei wywołasz interfejs API dla tego identyfikatora Activate eventId, ale pominięto wywołanie programu Reward, usługa Personalizacja będzie uczyć się od zdarzenia z domyślnym wynikiem nagrody ustawionym w konfiguracji.

Następne kroki