Synchronizowanie członkostwa w grupie odbiorców

Użyj hurtowni danych, CRM lub aplikacji, aby ustalić, kto należy do kohorty, a następnie zastosuj ten wybór do grupy odbiorców Bird. Opublikowane API grup odbiorców przechowuje statyczne członkostwo. Ten wzorzec integracji utrzymuje jego zgodność ze źródłem oceniającym warunki, bez tworzenia drugiego zestawu reguł w procesie wysyłki.

Zanim zaczniesz

Potrzebujesz nazwanej grupy odbiorców Bird, odpowiednich rekordów kontaktów i dostępu do udokumentowanych operacji na grupach odbiorców. Ustal, które źródło odpowiada za wybór i kto może zmieniać jego warunki. Użyj małej kohorty testowej, zanim uruchomisz integrację dla grupy odbiorców kampanii.

Zapisz warunki włączenia, wykluczenia i czas oceny. Dla kohorty klientów, którzy odnawiają usługę w przyszłym tygodniu, określ strefę czasową i to, co ma się stać, gdy źródło zarejestruje ukończone odnowienie. Wybór musi być na tyle odtwarzalny, aby można było sprawdzić obecność nieoczekiwanego członka.

Dopasuj wybrane rekordy

Pobierz wynik ze źródła i zapisz w integracji jego czas oceny lub rewizję.
Utwórz lub zaktualizuj odpowiednie kontakty Bird za pomocą operacji zbiorczej na kontaktach. Świadomie użyj identyfikatora źródłowego do dopasowania.
Sprawdź wynik każdej pozycji. Zachowaj jej identyfikator źródłowy i wynikowy identyfikator kontaktu Bird w rejestrze uzgodnień integracji.
Rozwiąż konflikty identyfikatorów, zanim uznasz daną osobę za zsynchronizowaną. Żądanie zawierające pozycje zakończone sukcesem może też zawierać pozycje zakończone błędem.

Operacja zbiorcza na kontaktach przyjmuje audience_ids podczas dodawania rekordów do istniejących grup odbiorców. Używaj tego mechanizmu do dodawania, gdy pasuje do sytuacji. Usuwanie nadal wymaga osobnej decyzji o członkostwie. Import, który pomija osobę, nie jest poleceniem usunięcia jej z grupy ani skasowania kontaktu.

Uzgodnij dodawanie i usuwanie członków

Odczytaj istniejące członkostwo za pomocą operacji Wyświetl kontakty grupy odbiorców i pobierz wszystkie strony wyników. Porównaj identyfikatory kontaktów Bird z dopasowanym wyborem ze źródła.

Różnica	Działanie
Osoba wybrana w źródle, nieobecna w grupie odbiorców	Dodaj kontakt do grupy odbiorców
Osoba obecna w grupie odbiorców, nieobecna w źródle	Usuń członkostwo, jeśli źródło zarządza tą grupą odbiorców
Osoba obecna w obu miejscach	Zachowaj członkostwo
Nie udało się dopasować rekordu źródłowego	Zbadaj przyczynę przed ukończeniem odświeżenia

Zastosuj zmiany za pomocą operacji Dodaj kontakty do grupy odbiorców i Usuń kontakty z grupy odbiorców. Przestrzegaj aktualnych limitów operacji zbiorczych podanych w tej dokumentacji.

Nie usuwaj osoby tylko dlatego, że eksport ze źródła był niepełny. Przed wyznaczeniem kontaktów do usunięcia potwierdź, że masz pełny wybór ze źródła, łącznie z ostatnią stroną. Unikaj też niezależnych ręcznych zmian członkostwa w grupie zarządzanej przez integrację, chyba że masz jasno określoną zasadę zachowywania tych zmian.

Ukończ odświeżenie

Po zastosowaniu różnic sprawdź operacje zakończone błędem i ponownie odczytaj członkostwo, którego dotyczyły zmiany. Oznacz odświeżenie jako ukończone, gdy członkostwo jest zgodne z zamierzonym wyborem ze źródła. Zapisz wynik w integracji, aby następny przebieg mógł odróżnić odświeżenie ukończone od przerwanego.

Jeśli proces zatrzyma się w trakcie, wznów go na podstawie zapisanych działań lub ponownie oblicz różnicę względem aktualnej grupy odbiorców. Dodanie istniejącego członka pozostawia członkostwo bez zmian. Usunięcie członka zmienia członkostwo w tej grupie, a nie rekord kontaktu ani zgodę.

Ponownie sprawdź aktualne zasady idempotencji i specyfikację odpowiedzi operacji, zanim automatycznie ponowisz żądanie o niepewnym wyniku. Traktuj przyjęcie żądania, wyniki poszczególnych pozycji i końcowe uzgodnienie jako odrębne obserwacje.

Połącz grupę odbiorców z wysyłką

Użyj ukończonego wyboru w odpowiednim procesie kampanii. Zapisz, kiedy ostatnio odświeżono grupę odbiorców, i przed wysyłką sprawdź aktualny szacunek broadcastu. Dane kontaktowe, preferencje i suppresje mogą zmienić się po odświeżeniu członkostwa.

W przypadku broadcastu Email szacunek zawęża całkowitą liczbę członków najpierw do osób z adresem, a następnie do osób, do których można wysłać wiadomość. Ostateczny wynik dostarczenia jest odrębną obserwacją. Podczas analizy wyników rozpatruj łącznie kohortę źródłową, kontekst wysyłki i definicję wyniku biznesowego.

Rozwiązywanie problemów

Nieoczekiwane usunięcia: sprawdź, czy eksport ze źródła był niepełny lub czy drugi proces zapisujący zmienia tę samą grupę odbiorców.
Ten sam kontakt z błędem powraca przy każdym przebiegu: rozwiąż konflikt identyfikatora źródłowego lub popraw nieprawidłową właściwość zamiast stale pomijać kontakt bez wyjaśnienia.
Osoby pozostają po opuszczeniu segmentu: sprawdź, czy integracja zarówno usuwa, jak i dodaje członków.
Liczba osób, do których można wysłać wiadomość, jest mniejsza: sprawdź adresy, preferencje i suppresje zamiast ponownie dodawać osoby.

Kolejne kroki

Powiązane zasoby

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Obejrzyj przewodnikGetting started with email Poznaj możliwościEmail Podążaj ścieżką naukiBuild your first integration Przewodnik wdrożeniowySend your first email

Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy