[Eingeschränkte Verfügbarkeit]{class="badge informative"}
Konfigurieren von Databricks Delta Share für die Zielgruppen-Beschaffung
Verwenden Sie dieses Handbuch, um Databricks Delta Share über die Benutzeroberfläche mit Adobe Real-Time CDP Collaboration zu verbinden und Erstanbieter-Zielgruppen zu beziehen.
Wenn Sie Databricks Delta Share verbinden, liest Collaboration Zielgruppendaten direkt aus Ihrer Unity-Katalogfreigabe. Nach Abschluss der Beschaffung können Sie die Zielgruppen für die Aktivierung und Überschneidungsanalyse in Kooperationsprojekten verwenden.
In diesem Handbuch wird erläutert, wie Sie Voraussetzungen vorbereiten, Ihre Delta Share verbinden, Quelltabellen angeben, Identitätsfelder zuordnen und überprüfen, ob die Zielgruppen-Beschaffung erfolgreich gestartet wird.
Zielgruppen, die von Databricks bezogen werden, folgen denselben Governance- und Datenverarbeitungsregeln wie Zielgruppen, die von Adobe Experience Platform und anderen unterstützten Cloud-Quellen bezogen werden.
Andere verfügbare Beschaffungsmethoden sind Experience Platform, Amazon S3, Google Cloud Storage, Snowflake, Azure Storage und CSV-Datei-Upload. Weitere Informationen zu allen verfügbaren Quellen in Collaboration finden Sie unter Quellen - Übersicht.
Voraussetzungen prerequisites
Sie müssen die Voraussetzungen in diesem Abschnitt erfüllen, bevor Sie den Konfigurations-Workflow starten. Fehlende Voraussetzungen sind ein häufiger Grund dafür, dass die Einrichtung fehlschlägt oder Zielgruppen nach der Beschaffung nicht angezeigt werden. Bevor Sie diese Anleitung befolgen, schließen Sie Onboarding und Einrichten von Konten ab.
Für einige Aufgaben in diesem Handbuch ist die Hilfe eines Databricks-Administrators erforderlich. Wenn Sie keine Databricks für Ihr Unternehmen verwalten, wenden Sie sich an den entsprechenden Administrator, bevor Sie beginnen.
Databricks Delta Share databricks-delta-share-access
Bevor Sie fortfahren, bestätigen Sie Folgendes mit Ihrem Databricks:
- Ihr Unternehmen hat ein Delta Share im Databricks-Konto von Adobe veröffentlicht, in dem native Datenblöcke-zu-Datenblöcke-Freigaben (Unity-Katalog) verwendet werden. Collaboration unterstützt für diesen Workflow nicht den Eintrag von Bearer-Token oder OIDC-Anmeldeinformationen in der Benutzeroberfläche.
- Sie kennen den Provider-Namen, der im Metastore des Adobe-Unity-Katalogs registriert ist, den Freigabenamen und das Schema, das Ihre Zielgruppentabellen enthält.
- Databricks Delta Share Zielgruppen-Sourcing ist für Ihr Collaboration-Konto und Ihre Region verfügbar. Wenn Databricks-Beschaffung in Ihrer Region noch nicht verfügbar ist, wenden Sie sich an Ihren Adobe-Kundenbetreuer, um einen Zeitplan zu bestätigen.
Eine schrittweise Anleitung zum Veröffentlichen einer Freigabe in Adobe finden Sie im Abschnitt Veröffentlichen Ihrer Delta-Freigabe in Adobe in diesem Handbuch.
Zielgruppendaten vorbereiten prepare-audience-data
Strukturieren Sie Ihre Zielgruppentabellen so, dass Collaboration Zielgruppen erkennen und Identitäten korrekt zuordnen kann.
- Mitgliedschaftstabelle (erforderlich): Eine Tabelle innerhalb Ihres freigegebenen Schemas, die eine Zeile pro Profil-Zielgruppen-Paar enthält. Diese Tabelle muss eine Spalte enthalten, die
AUDIENCE_IDzugeordnet werden kann, und mindestens eine unterstützte Spalte für Übereinstimmungsschlüssel. Collaboration verwendet diese Tabelle für die Vorschau von Quelldaten und die Feldzuordnung. - Metadatentabelle (optional): Wenn Sie einen separaten Zielgruppenkatalog verwalten (eine Zeile pro Zielgruppe mit der Zielgruppen-ID, dem Namen, der Anzahl oder ähnlichen Metadaten), können Sie diese Tabelle bereitstellen, damit Collaboration Zielgruppendefinitionen daraus liest, anstatt einzelne Zielgruppen-IDs nur aus der Mitgliedschaftstabelle abzuleiten.
- Unterstützte Übereinstimmungsschlüssel:
HASHED_EMAIL_SHA_256,HASHED_PHONE_SHA_256,HASHED_IPV4_SHA_256,CRM_ID,LOYALTY_ID,ADFIXUS_IDund andere Übereinstimmungsschlüssel, die für Ihr Collaboration-Konto aktiviert sind. - Hash-Anforderungen: Alle Übereinstimmungsschlüsselwerte müssen gekürzt, in Kleinbuchstaben geschrieben und SHA256-gehasht werden, bevor sie in Databricks gespeichert werden. Collaboration hasht oder normalisiert Daten nicht vor der Aufnahme.
- Spaltenkonsistenz: Die Mitgliedschaftstabelle muss stabile Spaltennamen bereitstellen, die Collaboration Ihren aktivierten Übereinstimmungsschlüsseln zuordnen kann.
Alle in Ihrer Mitgliedschaftstabelle vorhandenen Übereinstimmungsschlüssel müssen auch für Ihr Collaboration-Konto aktiviert werden. Informationen zum Hinzufügen oder Aktivieren von Übereinstimmungsschlüsseln finden Sie Einrichten von Übereinstimmungsschlüsseln.
Vor dem Start erforderliche Werte required-values
Halten Sie die folgenden Werte bereit, bevor Sie den Konfigurationsassistenten starten.
Konfigurieren der Databricks configure-databricks-connection
Der Konfigurations-Workflow ist ein mehrstufiger Assistent im Setup-Arbeitsbereich. Führen Sie die einzelnen Schritte nacheinander aus.
Neue Datenverbindung hinzufügen add-data-connection
Wählen Sie auf der Registerkarte Meine" im Setup-Arbeitsbereich das Symbol zum Hinzufügen aus (
Wenn dies Ihre erste Zielgruppe ist, können Sie auch die Option Hinzufügen auswählen.
Der Workflow „Zielgruppe hinzufügen“ wird angezeigt. Wählen Sie Neue Datenverbindung hinzufügen und dann Weiter aus.
Auswählen von Databricks Delta Share als Datenquelle select-databricks-delta-share
Im Bildschirm zur Auswahl der Datenquelle werden alle verfügbaren Verbindungstypen aufgelistet. Wählen Sie Databricks Delta Share und dann Weiter aus.
Delta Share verbinden connect-delta-share
Geben Sie die Details an, die erforderlich sind, damit Collaboration auf Ihre Delta Share zugreifen kann. Geben Sie den Provider, die Freigabe, das Schema und die Tabellendetails aus Ihrer Databricks Delta Share ein. Die erforderliche Mitgliedschaftstabelle muss im freigegebenen Schema verfügbar sein. Wenn Sie eine Metadatentabelle verwenden, muss sie auch im selben freigegebenen Schema verfügbar sein.
Klicken Sie nach Eingabe der erforderlichen Informationen auf Verbinden.
Collaboration validiert die Freigabe und mountet sie in Adobe Workspace. Dieser Schritt kann bis zu einer Minute dauern. Während der Verbindungsherstellung wird eine Fortschrittsanzeige angezeigt.
Wenn die Freigabe nicht gefunden werden kann oder das Schema noch nicht sichtbar ist, wird eine Fehlermeldung angezeigt. Überprüfen Sie die Werte mit Ihrem Databricks und versuchen Sie es erneut.
Einverständnis und Bestätigung der Datennutzung bestätigen confirm-consent
Bevor Sie fortfahren, bestätigen Sie, dass Sie alle gesetzlich vorgeschriebenen Opt-outs auf die Zielgruppendaten angewendet haben, die Sie an Collaboration senden. Wenn Sie sich nicht sicher sind, ob Ihre Daten diese Anforderung erfüllen, lesen Sie das Handbuch Governance-Richtlinie und Durchsetzungsaktionen , bevor Sie fortfahren. Aktivieren Sie das Bestätigungs-Kontrollkästchen und klicken Sie dann auf OK, um fortzufahren.
Angeben von Verbindungsdetails provide-connection-details
Geben Sie einen Namen und eine optionale Beschreibung für diese Datenverbindung ein. Der von Ihnen angegebene Name wird auf der Registerkarte Meine Datenverbindungen angezeigt und hilft bei der Unterscheidung dieser Quelle, wenn Sie mehrere Datenverbindungen verwalten.
- Name der Datenverbindung (erforderlich)
- Beschreibung der Datenverbindung (optional)
Klicken Sie auf Weiter, um fortzufahren.
Identitätsfelder zuordnen map-identity-fields
Der Bildschirm Zuordnung zeigt, wie Collaboration Quellspalten aus Ihrer Mitgliedschaftstabelle Ziel-Identitätsfeldern zuordnet. Collaboration ordnet Felder automatisch anhand der Spaltennamen und der für Ihr Konto aktivierten Übereinstimmungsschlüssel zu.
Bestätigen Sie, dass die angezeigten Zuordnungen die Spalten in Ihrer Mitgliedschaftstabelle widerspiegeln. Klicken Sie auf Weiter, um fortzufahren.
Aktualisierungshäufigkeit und Datumsbereich planen schedule-refresh
Die Zeitplan-Ansicht wird angezeigt. Wählen Sie im Dropdown-Menü eine Aktualisierungshäufigkeit zwischen einem und sechs Tagen aus und legen Sie dann den aktiven Datumsbereich fest. Verwenden Sie das Kalendersymbol, um Start- und Enddatum anzugeben.
Überprüfen und Abschließen der Verbindung review-and-complete
Prüfen Sie die Konfigurationsübersicht, bevor Sie die Verbindung erstellen. Der Bildschirm Zusammenfassung zeigt die folgenden Abschnitte an:
- Datenverbindung: Der Verbindungsname, der Anbietername, der Freigabename und das von Ihnen konfigurierte Schema.
- Zuordnung: Die Quell- und Zielidentitätsfeld-Zuordnungen.
- Zeitplan: Aktualisierungshäufigkeit und aktiver Datumsbereich.
Stellen Sie sicher, dass alle Abschnitte korrekt sind, und wählen Sie Fertig stellen.
Es wird ein Bestätigungsdialogfeld angezeigt, das angibt, dass Collaboration die Datenverbindung erstellt hat und dass die Zielgruppen-Beschaffung in Bearbeitung ist.
Überprüfen der Quellzielgruppen review-sourced-audiences
Nach Abschluss des Konfigurationsassistenten beginnt Collaboration mit der asynchronen Beschaffung von Zielgruppen aus Ihren Databricks. Navigieren Sie zu Setup > Meine Zielgruppen, um den Fortschritt zu überwachen. Die Beschaffung wird nicht sofort abgeschlossen. Der Zeitaufwand hängt von der Größe Ihrer Daten ab.
Fortschritt der Zielgruppenbeschaffung überwachen monitor-sourcing-progress
Während Collaboration Ihre Zielgruppendaten abruft, zeigt ein Banner oben im Arbeitsbereich Meine Zielgruppen an, dass die Beschaffung gerade läuft. Einzelne Zielgruppen werden erst in der Liste angezeigt, nachdem die Beschaffung für jede Zielgruppe abgeschlossen ist.
Anzeigen von Details zur Quellzielgruppe view-audience-details
Nach Abschluss der Beschaffung werden Ihre Databricks Zielgruppen auf der Registerkarte Meine Zielgruppen neben Zielgruppen angezeigt, die aus anderen Verbindungen bezogen wurden. Wählen Sie ein Zeilenelement oder Zielgruppe anzeigen aus, um die Detailansicht für eine bestimmte Zielgruppe zu öffnen.
In der Detailansicht werden der Status, die Quelle und der Name der Datenverbindung der Zielgruppe zusammen mit den folgenden Bedienfeldern angezeigt:
- Identitäten: Die Gesamtzahl der Identitäten und die Aufschlüsselung für die Zielgruppe, sobald Daten verfügbar sind.
- Kategorien: Alle Tags, die zum Organisieren oder Filtern der Zielgruppe angewendet werden.
- Verbindungszugriff: Ob die Zielgruppe privat, öffentlich oder für bestimmte Mitarbeiter freigegeben ist.
- Metadatensichtbarkeit: Welche Zielgruppeninformationen, wie z. B. Anzahl der Identitäten, Überschneidungsprozentsatz und Index, für Mitwirkende sichtbar sind.
Überprüfen Sie diese Einstellungen, bevor Sie die Zielgruppe in einem Collaboration-Projekt verwenden. Informationen zum Aktualisieren von Kategorien, Verbindungszugriff oder Metadatensichtbarkeit finden Sie unter Anzeigen und Verwalten einzelner Zielgruppen.
Audience-Einstellungen bearbeiten edit-audience-settings
Sie können Zielgruppen-Metadaten direkt in der Listenansicht Meine Zielgruppen bearbeiten, ohne die Detailansicht zu öffnen. Aktivieren Sie das Kontrollkästchen einer Audience, um die Aktionssymbolleiste anzuzeigen, und wählen Sie dann eine Aktion aus: Bearbeiten der Metadatensichtbarkeit, Bearbeiten des Verbindungszugriffs, Bearbeiten des Namens und der Beschreibung, Bearbeiten der Kategorien oder Löschen.
Databricks Datenverbindung anzeigen view-databricks-connection
Um die Verbindung selbst einschließlich ihrer Übereinstimmungsschlüssel zu überprüfen, navigieren Sie zu Setup > Meine Datenverbindungen. Dort ist Ihre neue Databricks-Verbindung verfügbar. Die Zielgruppenquelle wird als Databricks Delta Share angezeigt.
Bekannte Einschränkungen known-limitations
Beachten Sie die folgenden Einschränkungen bei der Konfiguration und Verwendung Databricks Delta Share Zielgruppen-Sourcing:
- Nur native Freigabe: Die Benutzeroberfläche unterstützt nur native Datenblöcke-zu-Datenblöcke-Delta Sharing. Die Authentifizierungsflüsse für Bearer-Token und OIDC sind im Konfigurationsassistenten nicht verfügbar.
- Kein Tabellen-Browser im Assistenten: Sie müssen Tabellennamen manuell eingeben. Collaboration validiert Tabellennamen, wenn Sie Tabellen in der Vorschau anzeigen. Nicht alle Tabellen in Ihrer Freigabe werden automatisch aufgelistet.
- Zeilenbeschränkung für Metadatentabellen: Wenn Sie eine Metadatentabelle zur Zielgruppenerkennung verwenden, importiert Collaboration bis zu 100.000 Zielgruppenzeilen aus dieser Tabelle. Wenden Sie sich an den Adobe-Support, wenn Ihr Katalog dieses Limit überschreitet.
- Einschränkungen für Übereinstimmungsschlüssel: Sobald ein Übereinstimmungsschlüssel für eine Datenverbindung aktiviert ist, kann er nicht mehr entfernt werden. Sie können Übereinstimmungsschlüssel zu einer vorhandenen Verbindung hinzufügen, sie jedoch nicht deaktivieren oder löschen. Um die aktiven Übereinstimmungsschlüssel zu ändern, müssen die Datenverbindung löschen und eine neue erstellen.
- Mitgliedschaftstabelle erforderlich: Selbst wenn Sie eine Metadatentabelle zur Zielgruppenerkennung verwenden, müssen Sie eine Mitgliedschaftstabelle angeben. Collaboration liest Identitätszeilen während der Aufnahme aus der Mitgliedschaftstabelle.
Fehlerbehebung troubleshooting
Verwenden Sie diesen Abschnitt, um Probleme zu beheben, die während oder nach der Konfiguration auftreten. Überprüfen Sie bei Fehlern während der Freigabe der Verbindung Ihren Anbieternamen, den Freigabenamen und das Schema mit Ihrem Databricks.
Freigabe der Verbindung schlägt fehl oder es kommt zu einer Zeitüberschreitung
- Stellen Sie sicher, dass Ihr Delta Share im Databricks-Konto von Adobe veröffentlicht wurde und dass der Anbietername, der Freigabename und das Schema korrekt sind.
- Vergewissern Sie sich, dass das Schema in der Freigabe sichtbar ist. Es kann einige Zeit dauern, bis neu veröffentlichte Freigaben propagiert werden.
- Wenn die Verbindung nach einigen Minuten immer noch fehlschlägt, starten Sie das Setup neu und versuchen Sie es erneut, oder wenden Sie sich an den Kunden-Support von Adobe und geben Sie den Anbieternamen, den Freigabenamen, das Schema und alle relevanten Fehlerdetails an. Schließen Sie keine vertraulichen Anmeldeinformationen ein.
Tabellenvorschau schlägt fehl
- Vergewissern Sie sich, dass der Tabellenname richtig geschrieben ist und in dem von Ihnen angegebenen Schema vorhanden ist.
- Stellen Sie sicher, dass die Tabelle in den in Adobe veröffentlichten Delta Share enthalten ist.
- Für die metadatengesteuerte Erkennung sollten Sie sowohl die Mitgliedschaftstabelle als auch die Metadatentabelle in der Vorschau anzeigen, bevor Sie fortfahren.
Die Validierung der Feldzuordnung blockiert den Fortschritt
- Bestätigen Sie, dass Ihre Mitgliedschaftstabelle eine Spalte enthält, die
AUDIENCE_IDzugeordnet werden kann. - Stellen Sie sicher, dass mindestens zwei Identitätsfelder vollständig zugeordnet sind (Quelle und Ziel).
- Verwenden Sie Vorschau der Quelldaten, um zu überprüfen, ob die Spaltennamen mit den aktivierten Übereinstimmungsschlüsseln übereinstimmen.
Zielgruppen werden nicht angezeigt oder die Beschaffung dauert länger als erwartet
- Die Beschaffungszeit skaliert mit dem Datenvolumen. Bei großen Mitgliedstabellen wird eine längere Verarbeitungszeit erwartet.
- Wenn Zielgruppen nicht innerhalb von 24 Stunden angezeigt werden, überprüfen Sie die Registerkarte Meine Datenverbindungen auf Fehleranzeigen für die Verbindung.
- Stellen Sie sicher, dass die Struktur Ihrer Mitgliedschaftstabelle und die Feldzuordnungen den Anforderungen in Vorbereiten Ihrer Zielgruppendaten entsprechen.
- Wenn das Problem weiterhin besteht, wenden Sie sich an den Kunden-Support von Adobe und geben Sie den Namen der Datenverbindung und die Tabellendetails an.
Die Datenverbindung zeigt nach anfänglichem Erfolg den Status Fehlgeschlagen an
- Vergewissern Sie sich, dass die Delta Share und Tabellen seit der Erstellung der Verbindung in Databricks nicht entfernt oder umbenannt wurden.
- Stellen Sie sicher, dass der Zugriff von Adobe auf die Freigabe nicht widerrufen wurde.
- Wenn das Problem weiterhin besteht, wenden Sie sich an den Kunden-Support von Adobe.
Veröffentlichen Ihres Delta Share in Adobe publish-delta-share
Mit Databricks Unity Catalog Delta Sharing können Sie Tabellen sicher mit anderen Databricks-Konten teilen, ohne Daten zu kopieren. Damit Collaboration Ihre Zielgruppendaten lesen kann, muss Ihr Databricks eine Delta Share im Databricks-Verbraucherkonto von Adobe veröffentlichen.
Vor der Veröffentlichung before-you-publish
Wenden Sie sich an Ihren Adobe-Kundenbetreuer oder Onboarding-Ansprechpartner, um Folgendes zu erhalten:
- Bestätigung, dass Adobe bereit ist, Ihren Anteil in Ihrer Region zu erhalten.
- Der Anbietername, den Adobe im Metastore seines Unity-Katalogs verwendet, um Ihr Unternehmen als Freigabeanbieter zu identifizieren.
Bereiten Sie in Ihrem Databricks-Arbeitsbereich Folgendes vor:
- Ein Delta Share, das das Schema und die Tabellen enthält, die Collaboration lesen wird.
- Eine Mitgliedschaftstabelle mit einer Zeile pro Profil-Zielgruppen-Paar und Spalten für
AUDIENCE_IDund Übereinstimmungsschlüssel. - Eine optionale Metadatentabelle, wenn Sie die metadatengesteuerte Zielgruppenerkennung verwenden möchten.
Freigabe veröffentlichen publish
Befolgen Sie die Databricks Delta Sharing Ihres Unternehmens, um dem Adobe-Verbraucherkonto Zugriff auf die Freigabe zu gewähren. Die genauen Schritte hängen von Ihrem Databricks Bereitstellungs- und Governance-Modell ab. Im Allgemeinen:
- Erstellen oder identifizieren Sie im Unity-Katalog die Freigabe, die Ihr Zielgruppenschema und Ihre Tabellen enthält.
- Fügen Sie das Schema (oder einzelne Tabellen) zur Freigabe hinzu.
- Gewähren Sie die Freigabe für das Databricks-Verbraucherkonto von Adobe mithilfe der nativen Datenblöcke-zu-Datenblöcke-Freigabe.
- Bestätigen Sie mit Ihrem Adobe-Kontakt, dass die Freigabe auf der Verbraucherseite sichtbar ist, und notieren Sie sich den Anbieternamen und den Freigabenamen für den Collaboration-Konfigurationsassistenten.
- Databricks Produktdokumentation zu Delta Sharing finden Sie unter Databricks-Delta-Freigabe-Dokumentation.
Erfassen von Databricks für Collaboration collect-databricks-details
Nachdem Sie die Freigabe veröffentlicht haben, stellen Sie sicher, dass der Anbietername, der Freigabename, das Schema und die Tabellennamen für den Collaboration-Konfigurations-Workflow verfügbar sind.
Sammeln Sie die folgenden Details, bevor Sie den Collaboration-Konfigurationsassistenten starten.
your_org_provideraudience_share_prodcollaboration_audiencesaudience_membersaudience_catalogNächste Schritte next-steps
Sie haben Databricks Delta Share als Datenquelle in Collaboration konfiguriert. Nach Abschluss der Beschaffung sind Ihre Zielgruppen im Arbeitsbereich Meine Zielgruppen verfügbar und können in Kooperationsprojekten verwendet werden.
Hier sind die folgenden Aktionen möglich:
Weitere Methoden zur Zielgruppen-Beschaffung finden Sie unter: