# Zielgruppenmitgliedschaften synchronisieren

Bestimmen Sie in Ihrem Data Warehouse, CRM oder Ihrer Anwendung, wer zu einer Kohorte gehört, und übertragen Sie diese Auswahl auf eine Bird-Zielgruppe. Die veröffentlichte Zielgruppen-API speichert statische Mitgliedschaften. Dieses Integrationsmuster gleicht sie mit der Quelle ab, die Ihre Bedingungen auswertet. So benötigen Sie keinen zweiten Regelsatz im Versandablauf.

## Bevor Sie beginnen

Sie benötigen eine benannte Bird-Zielgruppe, die zugehörigen Kontaktdatensätze und Zugriff auf die dokumentierten Zielgruppenoperationen. Legen Sie fest, welche Quelle für die Auswahl maßgeblich ist und wer ihre Bedingungen ändern darf. Verwenden Sie eine kleine Testkohorte, bevor Sie die Integration für eine Kampagnenzielgruppe ausführen.

Halten Sie Einschlussbedingungen, Ausschlüsse und Auswertungszeitpunkt fest. Legen Sie für eine Kohorte von Kunden, die nächste Woche verlängern, die Zeitzone fest und bestimmen Sie, was geschieht, wenn die Quelle eine abgeschlossene Verlängerung erfasst. Die Auswahl muss sich so weit reproduzieren lassen, dass Sie ein unerwartetes Mitglied untersuchen können.

## Die ausgewählten Datensätze zuordnen

1. Rufen Sie das Ergebnis der Quelle ab und speichern Sie dessen Auswertungszeitpunkt oder Revision in Ihrer Integration.
2. Erstellen oder aktualisieren Sie die entsprechenden Bird-Kontakte mit der [Batch-Operation für Kontakte](/docs/api/reference/create-contact-batch). Verwenden Sie für den Abgleich gezielt Ihre Quellkennung.
3. Prüfen Sie das Ergebnis jedes Eintrags. Speichern Sie seine Quell-ID und die resultierende Bird-Kontakt-ID im Abgleichsprotokoll der Integration.
4. Lösen Sie Kennungskonflikte, bevor Sie die Person als synchronisiert behandeln. Eine Anfrage mit erfolgreichen Einträgen kann auch fehlgeschlagene Einträge enthalten.

Der Kontakt-Batch akzeptiert `audience_ids`, um Datensätze zu bekannten Zielgruppen hinzuzufügen. Nutzen Sie dies für passende Ergänzungen. Entfernungen erfordern weiterhin eine separate Entscheidung über die Mitgliedschaft. Wenn eine Person in einem Import fehlt, ist das keine Anweisung, sie zu entfernen oder zu löschen.

## Ergänzungen und Entfernungen abgleichen

Lesen Sie die bestehenden Mitgliedschaften mit [Kontakte einer Zielgruppe auflisten](/docs/api/reference/list-audience-contacts) aus und berücksichtigen Sie alle Ergebnisseiten. Vergleichen Sie die Bird-Kontakt-IDs mit der zugeordneten Auswahl aus der Quelle.

| Unterschied                                       | Aktion                                                                                |
| ------------------------------------------------- | ------------------------------------------------------------------------------------- |
| In der Quelle ausgewählt, nicht in der Zielgruppe | Fügen Sie den Kontakt zur Zielgruppe hinzu                                            |
| In der Zielgruppe vorhanden, nicht in der Quelle  | Entfernen Sie die Mitgliedschaft, wenn die Quelle für diese Zielgruppe maßgeblich ist |
| In beiden vorhanden                               | Behalten Sie die Mitgliedschaft bei                                                   |
| Quelldatensatz konnte nicht zugeordnet werden     | Untersuchen Sie die Ursache, bevor Sie die Aktualisierung abschließen                 |

Wenden Sie Änderungen über [Kontakte zu einer Zielgruppe hinzufügen](/docs/api/reference/assign-audience-contacts) und [Kontakte aus einer Zielgruppe entfernen](/docs/api/reference/unassign-audience-contacts) an. Beachten Sie die aktuellen Batch-Grenzen in diesen Referenzen.

Entfernen Sie niemanden allein deshalb, weil ein Quellexport unvollständig war. Stellen Sie sicher, dass die Auswahl aus der Quelle vollständig ist, einschließlich ihrer letzten Seite, bevor Sie Entfernungen berechnen. Vermeiden Sie außerdem unabhängige manuelle Änderungen an Mitgliedschaften einer von der Integration verwalteten Zielgruppe, sofern Sie keine ausdrückliche Regel zum Erhalt dieser Änderungen haben.

## Die Aktualisierung abschließen

Prüfen Sie nach dem Anwenden der Unterschiede fehlgeschlagene Operationen und lesen Sie die betroffenen Mitgliedschaften erneut aus. Markieren Sie die Aktualisierung als abgeschlossen, sobald sie der vorgesehenen Auswahl aus der Quelle entsprechen. Speichern Sie das Ergebnis in Ihrer Integration, damit der nächste Durchlauf eine abgeschlossene von einer unterbrochenen Aktualisierung unterscheiden kann.

Wenn der Prozess vorzeitig abbricht, setzen Sie ihn anhand der protokollierten Schritte fort oder berechnen Sie die Unterschiede zur aktuellen Zielgruppe neu. Das Hinzufügen eines bestehenden Mitglieds lässt die Mitgliedschaft unverändert. Das Entfernen eines Mitglieds ändert die Mitgliedschaft in dieser Zielgruppe, jedoch weder den Kontaktdatensatz noch die Einwilligung.

Prüfen Sie die aktuellen Regeln zur Idempotenz und zur Antwort der Operation erneut, bevor Sie eine Anfrage mit ungewissem Ergebnis automatisch wiederholen. Betrachten Sie die Annahme der Anfrage, die Ergebnisse der einzelnen Einträge und den abschließenden Abgleich als getrennte Beobachtungen.

## Die Zielgruppe für den Versand verwenden

Verwenden Sie die fertig abgeglichene Auswahl im jeweiligen Kampagnenablauf. Erfassen Sie die letzte Aktualisierung der Zielgruppe und prüfen Sie vor dem Versand die aktuelle Schätzung des Broadcasts. Kontaktdaten, Präferenzen und Unterdrückungen können sich nach der Aktualisierung der Mitgliedschaften ändern.

Bei einem Email-Broadcast grenzt die Schätzung die Gesamtzahl der Mitglieder zunächst auf Mitglieder mit Adresse und dann auf anschreibbare Mitglieder ein. Das spätere Zustellergebnis ist eine separate Beobachtung. Berücksichtigen Sie bei der Ergebnisanalyse die Quellkohorte, den Versandkontext und die Definition des Geschäftsergebnisses gemeinsam.

## Fehlerbehebung

- **Unerwartete Entfernungen:** Prüfen Sie, ob der Quellexport unvollständig war oder eine zweite schreibende Instanz dieselbe Zielgruppe verändert.
- **Derselbe fehlerhafte Kontakt erscheint bei jedem Durchlauf:** Beheben Sie den Konflikt der Quellkennung oder die ungültige Eigenschaft, statt den Kontakt dauerhaft stillschweigend zu überspringen.
- **Personen bleiben nach dem Verlassen des Segments enthalten:** Prüfen Sie, ob Ihre Integration sowohl Entfernungen als auch Ergänzungen anwendet.
- **Die Zahl anschreibbarer Mitglieder ist kleiner:** Prüfen Sie Adressen, Präferenzen und Unterdrückungen, statt Personen erneut hinzuzufügen.

## Nächste Schritte

- [Zielgruppenmitgliedschaften und Mitgliederzahlen](/docs/guides/email/audiences)
- [Kontaktimport: Ergebnisse und Abgleich](/docs/guides/email/contacts)
- [Produktleitfaden zur Zielgruppenauswahl](/data/segmentation)

## Related resources

- [Getting started with email](/learn/email/getting-started-with-email) (video)
- [Email](/products/email) (product)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=email)