DokumentationExperience PlatformAnleitung zu Quell-Connectoren

B2B-Namespaces und -Schemata

Last update: Tue Dec 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler
AVAILABILITY
Sie müssen Zugriff auf Adobe Real-time Customer Data Platform B2B edition haben, damit Ihre B2B-Schemata im Echtzeit-Kundenprofil)werden können.
NOTE
Sie können Vorlagen in der Adobe Experience Platform-Benutzeroberfläche verwenden, um die Asset-Erstellung für B2B- und B2C-Daten zu beschleunigen. Weitere Informationen finden sich im Handbuch unter Verwenden von Vorlagen in der Platform-Benutzeroberfläche.

In diesem Dokument finden Sie Informationen zum zugrunde liegenden Setup für die Namespaces und Schemata, die mit B2B-Quellen verwendet werden sollen. In diesem Dokument finden Sie auch Informationen zum Einrichten Ihres Postman-Automatisierungsdienstprogramms, das zum Generieren von B2B-Namespaces und -Schemata erforderlich ist.

Einrichten von B2B-Namespaces und des Dienstprogramms zur automatischen Schemaerstellung

IMPORTANT
Anmeldedaten für Service-Konten (JWT) werden nicht mehr unterstützt. Sie müssen sicherstellen, dass Sie Ihre Anwendung oder Integration vor dem 27. Januar 2025 zu den neuen OAuth Server-zu-Server-Anmeldedaten migrieren. Lesen Sie die folgende Dokumentation für detaillierte Schritte Migrieren Ihrer JWT-Anmeldedaten zu OAuth-Server-zu-Server-Anmeldedaten.

In der folgenden Dokumentation finden Sie vorausgesetzte Informationen zum Einrichten Ihrer Postman-Umgebung zur Unterstützung des B2B-Namespace und des Dienstprogramms zur automatischen Schemaerstellung.

  • Sie können den Namespace und die Dienstprogrammsammlung zur automatischen Schemaerstellung sowie die Umgebung aus diesem GitHubRepository.
  • Informationen zur Verwendung von Platform-APIs, einschließlich Details zum Erfassen von Werten für erforderliche Kopfzeilen und zum Lesen von Beispiel-API-Aufrufen, finden Sie im Handbuch Erste Schritte mit Platform-APIs.
  • Informationen zum Generieren Ihrer Anmeldeinformationen für Platform-APIs finden Sie im Tutorial zum Authentifizieren und Zugreifen auf Experience Platform-APIs.
  • Informationen zum Einrichten von Postman für Platform-APIs finden Sie im Tutorial zum Einrichten Entwicklerkonsole und Postman.

Wenn eine Platform-Entwicklerkonsole und Postman eingerichtet sind, können Sie jetzt damit beginnen, die entsprechenden Umgebungswerte auf Ihre Postman anzuwenden.

Die folgende Tabelle enthält Beispielwerte sowie zusätzliche Informationen zum Ausfüllen Ihrer Postman:

Variable
Beschreibung
Beispiel
CLIENT_SECRET
Eine eindeutige Kennung, die zum Generieren Ihres {ACCESS_TOKEN} verwendet wird. Weitere Informationen zum Abrufen Experience Platform-APIs finden Sie im TutorialAuthentifizieren und Zugreifen auf {CLIENT_SECRET}".
{CLIENT_SECRET}
API_KEY
Eine eindeutige Kennung, die zum Authentifizieren von Aufrufen an Experience Platform-APIs verwendet wird. Weitere Informationen zum Abrufen Experience Platform-APIs finden Sie im TutorialAuthentifizieren und Zugreifen auf {API_KEY}".
c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN
Das zum Abschließen von Aufrufen an Experience Platform-APIs erforderliche Autorisierungs-Token. Weitere Informationen zum Abrufen Experience Platform-APIs finden Sie im TutorialAuthentifizieren und Zugreifen auf {ACCESS_TOKEN}".
Bearer {ACCESS_TOKEN}
META_SCOPE
In Bezug auf Marketo ist dieser Wert fest und wird immer auf ent_dataservices_sdk festgelegt.
ent_dataservices_sdk
CONTAINER_ID
Der global-Container enthält alle von standardmäßigen Adobe- und Experience Platform-Partnern bereitgestellten Klassen, Schemafeldgruppen, Datentypen und Schemata. In Bezug auf Marketo ist dieser Wert fest und wird immer auf global festgelegt.
global
TECHNICAL_ACCOUNT_ID
Eine Berechtigung für die Integration mit Adobe I/O.
D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS
Das Identity Management-System (IMS) stellt das Framework für die Authentifizierung für Adobe-Services bereit. In Bezug auf Marketo ist dieser Wert fest und wird immer auf ims-na1.adobelogin.com festgelegt.
ims-na1.adobelogin.com
IMS_ORG
Eine Unternehmenseinheit, die Produkte und Dienstleistungen besitzen oder lizenzieren und ihren Mitgliedern Zugang gewähren kann. Anweisungen zum Abrufen Ihrer {ORG_ID} finden im Tutorial zum Einrichten Postman Entwicklerkonsole und .
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME
Der Name der virtuellen Sandbox-Partition, die Sie verwenden.
prod
TENANT_ID
Eine ID, mit der sichergestellt wird, dass die von Ihnen erstellten Ressourcen über den richtigen Namespace verfügen und in Ihrer Organisation enthalten sind.
b2bcdpproductiontest
PLATFORM_URL
Der URL-Endpunkt, an den Sie API-Aufrufe durchführen. Dieser Wert ist fest und immer auf http://platform.adobe.io/ festgelegt.
http://platform.adobe.io/

Skripte ausführen

Nachdem Sie Ihre Postman und Umgebung eingerichtet haben, können Sie das Skript jetzt über die Postman ausführen.

Wählen Sie in der Postman den Stammordner des Dienstprogramms zur automatischen Generierung und dann Run aus der oberen Kopfzeile aus.

Der Stammordner des Generators Namespaces und Schemata in der Postman-Benutzeroberfläche. „Ausführungen“ ist in der oberen Menüleiste hervorgehoben.

Die Runner wird angezeigt. Stellen Sie von hier aus sicher, dass alle Kontrollkästchen aktiviert sind, und wählen Sie dann Run Namespaces and Schemas Autogeneration Utility aus.

Die Runner-Oberfläche der Postman-Benutzeroberfläche mit mehreren Anforderungen in der Sammlung „Namespaces und Schemata“ aktiviert und die Schaltfläche „Namespaces und Schemata ausführen“ auf der rechten Seite hervorgehoben.

Bei einer erfolgreichen Anfrage werden die für B2B erforderlichen Namespaces und Schemata erstellt.

B2B-Namespaces

Identity-Namespaces sind eine Komponente von Identity Service, die dazu dienen, den Kontext einer Identität zu unterscheiden. Eine vollqualifizierte Identität enthält einen Identitätswert und einen Namespace. Weitere Informationen finden in derzu Namespaces .

B2B-Namespaces werden in der primären Identität der Entität verwendet.

Die folgende Tabelle enthält Informationen zur zugrunde liegenden Einrichtung für B2B-Namespaces.

NOTE
Bitte nach links/rechts scrollen, um den vollständigen Inhalt der Tabelle anzuzeigen.
Anzeigename
Identitätssymbol
Identitätstyp
B2B-Person
b2b_person
CROSS_DEVICE
B2B-Konto
b2b_account
B2B_ACCOUNT
B2B-Opportunity
b2b_opportunity
B2B_OPPORTUNITY
B2B-Opportunity-Person-Beziehung
b2b_opportunity_person_relation
B2B_OPPORTUNITY_PERSON
B2B-Kampagne
b2b_campaign
B2B_CAMPAIGN
B2B-Kampagnenmitglied
b2b_campaign_member
B2B_CAMPAIGN_MEMBER
B2B-Marketing-Liste
b2b_marketing_list
B2B_MARKETING_LIST
B2B-Marketing-Listenmitglied
b2b_marketing_list_member
B2B_MARKETING_LIST_MEMBER
B2B-Konto-Personen-Beziehung
b2b_account_person_relation
B2B_ACCOUNT_PERSON

B2B-Schemata

Schemata dienen in Experience Platform zur konsistenten und wiederverwendbaren Beschreibung der Struktur von Daten. Durch die systemübergreifende einheitliche Definition von Daten wird es einfacher, deren Bedeutung beizubehalten und somit Wert aus Daten zu ziehen.

Bevor Daten in Platform aufgenommen werden können, muss ein Schema erstellt werden, das die Datenstruktur beschreibt und den Datentyp entsprechend des jeweiligen Feldes einschränkt. Schemata bestehen aus einer Basisklasse und keiner oder mehreren Schema-Feldergruppen.

Weitere Informationen zum Schemaaufbaumodell, einschließlich Planungsgrundsätzen und Best Practices, finden Sie in den Grundlagen des Schemaaufbaus.

Die folgende Tabelle enthält Informationen zur zugrunde liegenden Einrichtung von B2B-Schemata.

NOTE
Bitte nach links/rechts scrollen, um den vollständigen Inhalt der Tabelle anzuzeigen.
Schemaname
Basisklasse
Feldergruppen
In Schema Profile
Primäre Identität
Primärer Identity-Namespace
Sekundäre Identität
Sekundärer Identity-Namespace
Beziehung
Anmerkungen
B2B-Konto
XDM Business-Konto
Details zum XDM Business-Konto
Aktiviert
accountKey.sourceKey der Basisklasse
B2B-Konto
extSourceSystemAudit.externalKey.sourceKey der Basisklasse
B2B-Konto
  • accountParentKey.sourceKey in der Feldergruppe XDM Business-Kontodetails .
  • Zieleigenschaft: /accountKey/sourceKey
  • Typ: Eins-zu-eins
  • Referenzschema: B2B-Konto
  • Namespace: B2B-Konto
B2B-Person
Individuelles XDM-Profil
  • XDM-Geschäftspersonendetails
  • XDM-Geschäftspersonenkomponenten
  • IdentityMap
  • Details zu Einverständnis und Voreinstellungen
Aktiviert
b2b.personKey.sourceKey in der Feldergruppe „XDM-Geschäftspersonendetails“
B2B-Person
  1. extSourceSystemAudit.externalKey.sourceKey der Feldergruppe „XDM-Geschäftspersonendetails“
  2. workEmail.address der Feldergruppe „XDM-Geschäftspersonendetails“
  1. B2B-Person
  2. E-Mail
  • personComponents.sourceAccountKey.sourceKey der Feldergruppe XDM-Geschäftspersonenkomponenten
  • Typ: Viele-zu-eins
  • Referenzschema: B2B-Konto
  • Namespace: B2B-Konto
  • Ziel-Eigenschaft: accountKey.sourceKey
  • Beziehungsname aus aktuellem Schema: Konto
  • Beziehungsname aus Referenzschema: Personen
B2B-Opportunity
XDM Business-Opportunity
XDM Business-Opportunity-Details
Aktiviert
opportunityKey.sourceKey der Basisklasse
B2B-Opportunity
extSourceSystemAudit.externalKey.sourceKey der Basisklasse
B2B-Opportunity
  • accountKey.sourceKey der Basisklasse
  • Typ: Viele-zu-eins
  • Referenzschema: B2B-Konto
  • Namespace: B2B-Konto
  • Zieleigenschaft: accountKey.sourceKey
  • Beziehungsname aus aktuellem Schema: Konto
  • Beziehungsname aus Referenzschema: Opportunities
B2B-Opportunity-Person-Beziehung
XDM Business Opportunity Person Relation
Keine
Aktiviert
opportunityPersonKey.sourceKey der Basisklasse
B2B-Opportunity-Person-Beziehung
extSourceSystemAudit.externalKey.sourceKey der Basisklasse
B2B-Opportunity-Person-Beziehung

Erste Beziehung

  • personKey.sourceKey der Basisklasse
  • Typ: Viele-zu-eins
  • Referenzschema: B2B-Person
  • Namespace: B2B-Person
  • Zieleigenschaft: b2b.personKey.sourceKey
  • Beziehungsname aus aktuellem Schema: Person
  • Beziehungsname aus Referenzschema: Opportunities

Zweite Beziehung

  • opportunityKey.sourceKey der Basisklasse
  • Typ: Viele-zu-eins
  • Referenzschema: B2B-Opportunity
  • Namespace: B2B-Opportunity
  • Zieleigenschaft: opportunityKey.sourceKey
  • Beziehungsname aus aktuellem Schema: Opportunity
  • Beziehungsname aus Referenzschema: Personen
B2B-Kampagne
XDM Business Campaign
XDM Business Campaign-Details
Aktiviert
campaignKey.sourceKey der Basisklasse
B2B-Kampagne
extSourceSystemAudit.externalKey.sourceKey der Basisklasse
B2B-Kampagne
B2B-Kampagnenmitglied
XDM Business Campaign Members
Abonnentendetails zur XDM Business-Kampagne
Aktiviert
ccampaignMemberKey.sourceKey der Basisklasse
B2B-Kampagnenmitglied
extSourceSystemAudit.externalKey.sourceKey der Basisklasse
B2B-Kampagnenmitglied

Erste Beziehung

  • personKey.sourceKey der Basisklasse
  • Typ: Viele-zu-eins
  • Referenzschema: B2B-Person
  • Namespace: B2B-Person
  • Zieleigenschaft: b2b.personKey.sourceKey
  • Beziehungsname aus aktuellem Schema: Person
  • Beziehungsname aus Referenzschema: Kampagnen

Zweite Beziehung

  • campaignKey.sourceKey der Basisklasse
  • Typ: Viele-zu-eins
  • Referenzschema: B2B-Kampagne
  • Namespace: B2B-Kampagne
  • Zieleigenschaft: campaignKey.sourceKey
  • Beziehungsname aus aktuellem Schema: Kampagne
  • Beziehungsname aus Referenzschema: Personen
B2B-Marketing-Liste
XDM Business Marketing List
Keine
Aktiviert
marketingListKey.sourceKey der Basisklasse
B2B-Marketing-Liste
Keine
Keine
Keine
Statische Liste wird nicht mit Salesforce synchronisiert und hat daher keine sekundäre Identität.
B2B-Marketing-Listenmitglied
XDM Business Marketing List Members
Keine
Aktiviert
marketingListMemberKey.sourceKey der Basisklasse
B2B-Marketing-Listenmitglied
Keine
Keine

Erste Beziehung

  • PersonKey.sourceKey der Basisklasse
  • Typ: Viele-zu-eins
  • Referenzschema: B2B-Person
  • Namespace: B2B-Person
  • Zieleigenschaft: b2b.personKey.sourceKey
  • Beziehungsname aus aktuellem Schema: Person
  • Beziehungsname aus Referenzschema: Marketing-Listen

Zweite Beziehung

  • marketingListKey.sourceKey der Basisklasse
  • Typ: Viele-zu-eins
  • Referenzschema: B2B-Marketing-Liste
  • Namespace: B2B-Marketing-Liste
  • Zieleigenschaft: marketingListKey.sourceKey
  • Beziehungsname aus aktuellem Schema: Marketing-Liste
  • Beziehungsname aus Referenzschema: Personen
Statisches Listenelement wird nicht mit Salesforce synchronisiert und hat daher keine sekundäre Identität.
B2B-Aktivität
XDM ExperienceEvent
  • Web-Seite besuchen
  • Neuer Lead
  • Lead konvertieren
  • Zur Liste hinzufügen
  • Von Liste entfernen
  • Zur Opportunity hinzufügen
  • Aus der Opportunity entfernen
  • Formular ausgefüllt
  • Link-Klicks
  • E-Mail zugestellt
  • E-Mail geöffnet
  • E-Mail angeklickt
  • E-Mail gebounct
  • E-Mail nicht zugestellt (Soft-Bounce)
  • E-Mail abbestellt
  • Bewertung wurde geändert
  • Opportunity aktualisiert
  • Status im Kampagnenfortschritt geändert
  • Personenkennung
  • Marketo Web-URL
  • Interessanter Moment
  • Webhook aufrufen
  • Kampagnenkadenz ändern
  • Umsatzschritt geändert
  • Leads zusammenführen
  • E-Mail gesendet
  • Kampagnen-Stream ändern
  • Zu Kampagne hinzufügen
Aktiviert
personKey.sourceKey der Feldergruppe „Personenkennung“
B2B-Person
Keine
Keine

Erste Beziehung

  • listOperations.listKey.sourceKey
  • Typ: Eins-zu-eins
  • Referenzschema: B2B-Marketing-Liste
  • Namespace: B2B-Marketing-Liste

Zweite Beziehung

  • opportunityEvent.opportunityKey.sourceKey
  • Typ: Eins-zu-eins
  • Referenzschema: B2B-Opportunity
  • Namespace: B2B-Opportunity

Dritte Beziehung

  • leadOperation.campaignProgression.campaignKey.sourceKey
  • Typ: Eins-zu-eins
  • Referenzschema: B2B-Kampagne
  • Namespace: B2B-Kampagne
ExperienceEvent unterscheidet sich von Entitäten. Die Identität des Erlebnisereignisses ist die Person, die die Aktivität durchgeführt hat.
B2B-Konto-Personen-Beziehung
Personenbeziehung für XDM Business-Konto
Identitätszuordnung
Aktiviert
accountPersonKey.sourceKey der Basisklasse
B2B-Konto-Personen-Beziehung
Keine
Keine

Erste Beziehung

  • personKey.sourceKey der Basisklasse
  • Typ: Viele-zu-eins
  • Referenzschema: B2B-Person
  • Namespace: B2B-Person
  • Zieleigenschaft: b2b.personKey.SourceKey
  • Beziehungsname aus aktuellem Schema: Personen
  • Beziehungsname aus Referenzschema: Konto

Zweite Beziehung

  • accountKey.sourceKey der Basisklasse
  • Typ: Viele-zu-eins
  • Referenzschema: B2B-Konto
  • Namespace: B2B-Konto
  • Zieleigenschaft: accountKey.sourceKey
  • Beziehungsname aus aktuellem Schema: Konto
  • Beziehungsname aus Referenzschema: Personen

Nächste Schritte

Informationen zum Verbinden Ihrer Marketo mit Platform finden Sie im Tutorial zum eines Marketo-Quell-Connectors in der Benutzeroberfläche.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089