B2B-Namespaces und -Schemata
Dieses Dokument enthält Informationen über die zugrunde liegende Einrichtung für Namespaces und Schemas, die mit B2B-Quellen verwendet werden sollen. In diesem Dokument finden Sie außerdem Informationen zum Einrichten Ihres Automatisierungsdienstprogramms für Postman, das zum Generieren von B2B-Namespaces und -Schemas erforderlich ist.
Einrichten von B2B-Namespaces und des Dienstprogramm zur automatischen Schemaerstellung
Der erste Schritt bei der Verwendung des Namespace B2B und des Dienstprogramms für die automatische Schemaerstellung besteht darin, Ihre Platform-Entwicklerkonsole einzurichten und Postman Umgebung.
- Sie können die Sammlung und Umgebung des Dienstprogramms für die automatische Generierung von Namespaces und Schemas von dieser GitHub-Repository.
- Informationen zur Verwendung von Platform-APIs, einschließlich Details zum Sammeln von Werten für erforderliche Kopfzeilen und zum Lesen von Beispiel-API-Aufrufen, finden Sie im Handbuch unter Erste Schritte mit Platform-APIs.
- Informationen zum Generieren Ihrer Anmeldeinformationen für Platform-APIs finden Sie im Tutorial zu Authentifizierung und Zugriff auf Experience Platform-APIs.
- Informationen zur Einrichtung von Postman Informationen zu Platform-APIs finden Sie im Tutorial zu Einrichten der Entwicklerkonsole und Postman.
Mit der Platform-Entwicklerkonsole und Postman eingerichtet haben, können Sie jetzt mit der Anwendung der entsprechenden Umgebungswerte auf Ihre Postman Umgebung.
Die folgende Tabelle enthält Beispielwerte sowie zusätzliche Informationen zum Ausfüllen Ihrer Postman Umgebung:
CLIENT_SECRET
{ACCESS_TOKEN}
. Siehe Tutorial zu Authentifizierung und Zugriff auf Experience Platform-APIs für Informationen zum Abrufen Ihrer {CLIENT_SECRET}
.{CLIENT_SECRET}
JWT_TOKEN
{JWT_TOKEN}
.{JWT_TOKEN}
API_KEY
{API_KEY}
.c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN
{ACCESS_TOKEN}
.Bearer {ACCESS_TOKEN}
META_SCOPE
ent_dataservices_sdk
.ent_dataservices_sdk
CONTAINER_ID
global
-Container enthält alle vom Experience Platform-Partner bereitgestellten Standardklassen, Schemafeldgruppen, Datentypen und Schemas, die vom Adobe- und -Partner bereitgestellt werden. Im Hinblick auf Marketofestgelegt ist, wird dieser Wert festgelegt und immer auf global
.global
PRIVATE_KEY
{PRIVATE_KEY}
TECHNICAL_ACCOUNT_ID
D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS
ims-na1.adobelogin.com
.ims-na1.adobelogin.com
IMS_ORG
{ORG_ID}
Informationen.ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME
prod
TENANT_ID
b2bcdpproductiontest
PLATFORM_URL
http://platform.adobe.io/
.http://platform.adobe.io/
Scripts ausführen
Mit Postman Sammlung und Umgebung eingerichtet sind, können Sie das Skript jetzt über das Postman -Schnittstelle.
Im Postman -Benutzeroberfläche, wählen Sie den Stammordner des AutoGenerator-Dienstprogramms aus und klicken Sie dann auf Run aus der oberen Kopfzeile.
Die Runner -Benutzeroberfläche angezeigt. Vergewissern Sie sich von hier aus, dass alle Kontrollkästchen aktiviert sind, und wählen Sie dann Run Namespaces and Schemas Autogeneration Utility.
Eine erfolgreiche Anfrage erstellt die für B2B erforderlichen Namespaces und Schemas.
B2B-Namespaces
Identity-Namespaces sind eine Komponente von Identity Service , die dazu dienen, den Kontext einer Identität zu unterscheiden. Eine voll qualifizierte Identität umfasst einen Identitätswert und einen Namespace. Lesen Sie die Namespaces - Übersicht für weitere Informationen.
B2B-Namespaces werden in der primären Identität der Entität verwendet.
Die folgende Tabelle enthält Informationen zum zugrunde liegenden Setup für B2B-Namespaces.
b2b_person
CROSS_DEVICE
b2b_account
B2B_ACCOUNT
b2b_opportunity
B2B_OPPORTUNITY
b2b_opportunity_person_relation
B2B_OPPORTUNITY_PERSON
b2b_campaign
B2B_CAMPAIGN
b2b_campaign_member
B2B_CAMPAIGN_MEMBER
b2b_marketing_list
B2B_MARKETING_LIST
b2b_marketing_list_member
B2B_MARKETING_LIST_MEMBER
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-Schemas.
accountKey.sourceKey
in der BasisklasseextSourceSystemAudit.externalKey.sourceKey
in der BasisklasseaccountParentKey.sourceKey
in der Feldergruppe "XDM Business Account Details"- Ziel-Eigenschaft:
/accountKey/sourceKey
- Typ: 1:1
- Referenzschema: B2B-Konto
- Namespace: B2B-Konto
- XDM-Geschäftspersonendetails
- XDM-Geschäftspersonenkomponenten
- IdentityMap
- Einverständnis und Präferenzdetails
b2b.personKey.sourceKey
in der Feldergruppe "XDM Business Person Details"extSourceSystemAudit.externalKey.sourceKey
Feldergruppe XDM Business Person DetailsworkEmail.address
Feldergruppe XDM Business Person Details
- B2B Person
personComponents.sourceAccountKey.sourceKey
Feldergruppe XDM Business Person Components- Typ: Viele-zu-eins
- Referenzschema: B2B-Konto
- Namespace: B2B-Konto
- Ziel-Eigenschaft: accountKey.sourceKey
- Beziehungsname aus dem aktuellen Schema: Konto
- Beziehungsname aus Referenzschema: Personen
opportunityKey.sourceKey
in der BasisklasseextSourceSystemAudit.externalKey.sourceKey
in der BasisklasseaccountKey.sourceKey
in der Basisklasse- Typ: Viele-zu-eins
- Referenzschema: B2B-Konto
- Namespace: B2B-Konto
- Ziel-Eigenschaft:
accountKey.sourceKey
- Beziehungsname aus dem aktuellen Schema: Konto
- Beziehungsname aus Referenzschema: Chancen
opportunityPersonKey.sourceKey
in der BasisklasseextSourceSystemAudit.externalKey.sourceKey
in der BasisklasseErste Beziehung
personKey.sourceKey
in der Basisklasse- Typ: Viele-zu-eins
- Referenzschema: B2B Person
- Namespace: B2B Person
- Ziel-Eigenschaft: b2b.personKey.sourceKey
- Beziehungsname aus dem aktuellen Schema: Person
- Beziehungsname aus Referenzschema: Chancen
Zweite Beziehung
opportunityKey.sourceKey
in der Basisklasse- Typ: Viele-zu-eins
- Referenzschema: B2B-Chancen
- Namespace: B2B-Chancen
- Ziel-Eigenschaft:
opportunityKey.sourceKey
- Beziehungsname aus aktuellem Schema: Chancen
- Beziehungsname aus Referenzschema: Personen
campaignKey.sourceKey
in der BasisklasseextSourceSystemAudit.externalKey.sourceKey
in der BasisklasseccampaignMemberKey.sourceKey
in der BasisklasseextSourceSystemAudit.externalKey.sourceKey
in der BasisklasseErste Beziehung
personKey.sourceKey
in der Basisklasse- Typ: Viele-zu-eins
- Referenzschema: B2B Person
- Namespace: B2B Person
- Ziel-Eigenschaft:
b2b.personKey.sourceKey
- Beziehungsname aus dem aktuellen Schema: Person
- Beziehungsname aus Referenzschema: Kampagnen
Zweite Beziehung
campaignKey.sourceKey
in der Basisklasse- Typ: Viele-zu-eins
- Referenzschema: B2B-Kampagne
- Namespace: B2B-Kampagne
- Ziel-Eigenschaft:
campaignKey.sourceKey
- Beziehungsname aus dem aktuellen Schema: Kampagne
- Beziehungsname aus Referenzschema: Personen
marketingListKey.sourceKey
in der BasisklassemarketingListMemberKey.sourceKey
in der BasisklasseErste Beziehung
PersonKey.sourceKey
in der Basisklasse- Typ: Viele-zu-eins
- Referenzschema: B2B Person
- Namespace: B2B Person
- Ziel-Eigenschaft:
b2b.personKey.sourceKey
- Beziehungsname aus dem aktuellen Schema: Person
- Beziehungsname aus dem Referenzschema: Marketinglisten
Zweite Beziehung
marketingListKey.sourceKey
in der Basisklasse- Typ: Viele-zu-eins
- Referenzschema: B2B Marketing List
- Namespace: B2B-Marketingliste
- Ziel-Eigenschaft:
marketingListKey.sourceKey
- Beziehungsname aus dem aktuellen Schema: Marketingliste
- Beziehungsname aus Referenzschema: Personen
- Website besuchen
- Lead neu
- Blei konvertieren
- Zu Liste hinzufügen
- Aus Liste löschen
- Zu Chancen hinzufügen
- Aus Opportunity entfernen
- Ausgefülltes Formular
- Link-Klicks
- Zugestellt E-Mail
- E-Mail geöffnet
- E-Mail angeklickt
- E-Mail Bounce
- E-Mail-Bounce Soft
- E-Mail-Abmeldung
- Score geändert
- Chancen aktualisiert
- Status in Kampagnenfortschritt geändert
- Personen-ID
- Marketo Web URL
- Interessanter Moment
- Webhook aufrufen
- Ändern der Kampagnenkadenz
- Umsatzstatus geändert
- Leads zusammenführen
- E-Mail gesendet
- Campaign-Stream ändern
- Zu Campaign hinzufügen
personKey.sourceKey
Feldergruppe "Person Identifier"Erste Beziehung
listOperations.listKey.sourceKey
field- Typ: 1:1
- Referenzschema: B2B Marketing List
- Namespace: B2B-Marketingliste
Zweite Beziehung
opportunityEvent.opportunityKey.sourceKey
field- Typ: 1:1
- Referenzschema: B2B-Chancen
- Namespace: B2B-Chancen
Dritte Beziehung
leadOperation.campaignProgression.campaignKey.sourceKey
field- Typ: 1:1
- 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.accountPersonKey.sourceKey
in der BasisklasseErste Beziehung
personKey.sourceKey
in der Basisklasse- Typ: Viele-zu-eins
- Referenzschema: B2B Person
- Namespace: B2B Person
- Ziel-Eigenschaft:
b2b.personKey.SourceKey
- Beziehungsname aus dem aktuellen Schema: Personen
- Beziehungsname aus dem Referenzschema: Konto
Zweite Beziehung
accountKey.sourceKey
in der Basisklasse- Typ: Viele-zu-eins
- Referenzschema: B2B-Konto
- Namespace: B2B-Konto
- Ziel-Eigenschaft:
accountKey.sourceKey
- Beziehungsname aus dem aktuellen Schema: Konto
- Beziehungsname aus Referenzschema: Personen
Nächste Schritte
Erfahren Sie, wie Sie Ihre Marketo Daten an Platform weiterleiten, siehe Tutorial zu Erstellen eines Quell-Connectors für Marketo über die Benutzeroberfläche.