B2B-Namespaces und -Schemata

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 Sie im Handbuch unter Verwenden von Vorlagen in der Platform-Benutzeroberfläche.

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.

IMPORTANT
Sie müssen Zugriff auf Adobe Real-time Customer Data Platform B2B Edition , damit B2B-Schemata Echtzeit-Kundenprofil.

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.

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:

Variable
Beschreibung
Beispiel
CLIENT_SECRET
Eine eindeutige Kennung, mit der Ihre {ACCESS_TOKEN}. Siehe Tutorial zu Authentifizierung und Zugriff auf Experience Platform-APIs für Informationen zum Abrufen Ihrer {CLIENT_SECRET}.
{CLIENT_SECRET}
JWT_TOKEN
Das JSON Web Token (JWT) ist eine Authentifizierungsberechtigung, mit der Ihre {ACCESS_TOKEN}. Siehe Tutorial zu Authentifizierung und Zugriff auf Experience Platform-APIs für Informationen zur Generierung Ihrer {JWT_TOKEN}.
{JWT_TOKEN}
API_KEY
Eine eindeutige Kennung, mit der Aufrufe an Experience Platform-APIs authentifiziert werden. Siehe Tutorial zu Authentifizierung und Zugriff auf Experience Platform-APIs für Informationen zum Abrufen Ihrer {API_KEY}.
c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN
Das Autorisierungstoken, das zum Abschließen von Aufrufen an Experience Platform-APIs erforderlich ist. Siehe Tutorial zu Authentifizierung und Zugriff auf Experience Platform-APIs für Informationen zum Abrufen Ihrer {ACCESS_TOKEN}.
Bearer {ACCESS_TOKEN}
META_SCOPE
Im Hinblick auf Marketofestgelegt ist, ist dieser Wert fest und immer auf Folgendes festgelegt: ent_dataservices_sdk.
ent_dataservices_sdk
CONTAINER_ID
Die 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
Eine Berechtigung zum Authentifizieren Ihrer Postman -Instanz zu Experience Platform-APIs. Siehe Tutorial zum Einrichten der Entwicklerkonsole und Einrichten der Entwicklerkonsole und Postman Anweisungen zum Abrufen Ihrer {PRIVATE_KEY}.
{PRIVATE_KEY}
TECHNICAL_ACCOUNT_ID
Eine Berechtigung zur Integration in Adobe I/O.
D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS
Das Identity Management-System (IMS) stellt das Framework für die Authentifizierung bei Adobe-Diensten bereit. Im Hinblick auf Marketofestgelegt ist, wird dieser Wert festgelegt und immer auf Folgendes festgelegt: ims-na1.adobelogin.com.
ims-na1.adobelogin.com
IMS_ORG
Eine Unternehmenseinheit, die Produkte und Dienste besitzen oder lizenzieren und Zugriff auf ihre Mitglieder gewähren kann. Siehe Tutorial zu Einrichten der Entwicklerkonsole und Postman Anweisungen zum Abrufen Ihrer {ORG_ID} Informationen.
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME
Der Name der verwendeten virtuellen Sandbox-Partition.
prod
TENANT_ID
Eine ID, mit der sichergestellt wird, dass die von Ihnen erstellten Ressourcen den richtigen Namespace aufweisen und in Ihrem Unternehmen enthalten sind.
b2bcdpproductiontest
PLATFORM_URL
Der URL-Endpunkt, an den Sie API-Aufrufe durchführen. Dieser Wert ist fest festgelegt und immer auf Folgendes festgelegt: 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.

root-folder

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.

run-generator

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.

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen.
Anzeigename
Identitätssymbol
Identitätstyp
B2B Person
b2b_person
CROSS_DEVICE
B2B-Konto
b2b_account
B2B_ACCOUNT
B2B-Chancen
b2b_opportunity
B2B_OPPORTUNITY
B2B Opportunity-Personenbeziehung
b2b_opportunity_person_relation
B2B_OPPORTUNITY_PERSON
B2B-Kampagne
b2b_campaign
B2B_CAMPAIGN
B2B Campaign-Mitglied
b2b_campaign_member
B2B_CAMPAIGN_MEMBER
B2B-Marketingliste
b2b_marketing_list
B2B_MARKETING_LIST
B2B Marketing List Member
b2b_marketing_list_member
B2B_MARKETING_LIST_MEMBER
B2B-Konto-Personenbeziehung
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.

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen.
Schemaname
Basisklasse
Feldergruppen
Profile in Schema
Primäre Identität
Primärer Identitäts-Namespace
Sekundäre Identität
Sekundärer Identitäts-Namespace
Beziehung
Anmerkungen
B2B-Konto
XDM-Geschäftskonto
XDM-Geschäftskontodetails
Aktiviert
accountKey.sourceKey in der Basisklasse
B2B-Konto
extSourceSystemAudit.externalKey.sourceKey in der Basisklasse
B2B-Konto
  • accountParentKey.sourceKey in der Feldergruppe "XDM Business Account Details"
  • Ziel-Eigenschaft: /accountKey/sourceKey
  • Typ: 1:1
  • Referenzschema: B2B-Konto
  • Namespace: B2B-Konto
B2B Person
Individuelles XDM-Profil
  • XDM-Geschäftspersonendetails
  • XDM-Geschäftspersonenkomponenten
  • IdentityMap
  • Einverständnis und Präferenzdetails
Aktiviert
b2b.personKey.sourceKey in der Feldergruppe "XDM Business Person Details"
B2B Person
  1. extSourceSystemAudit.externalKey.sourceKey Feldergruppe XDM Business Person Details
  2. workEmail.address Feldergruppe XDM Business Person Details
  1. B2B Person
  2. E-Mail
  • 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
B2B-Chancen
XDM-Geschäftschancen
XDM-Geschäftsangebotsdetails
Aktiviert
opportunityKey.sourceKey in der Basisklasse
B2B-Chancen
extSourceSystemAudit.externalKey.sourceKey in der Basisklasse
B2B-Chancen
  • 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: Chancen
B2B Opportunity-Personenbeziehung
XDM Business Opportunity-Personenbeziehung
Keine
Aktiviert
opportunityPersonKey.sourceKey in der Basisklasse
B2B Opportunity-Personenbeziehung
extSourceSystemAudit.externalKey.sourceKey in der Basisklasse
B2B Opportunity-Personenbeziehung

Erste 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
B2B-Kampagne
XDM Business Campaign
XDM Business Campaign-Details
Aktiviert
campaignKey.sourceKey in der Basisklasse
B2B-Kampagne
extSourceSystemAudit.externalKey.sourceKey in der Basisklasse
B2B-Kampagne
B2B Campaign-Mitglied
XDM Business Campaign-Mitglieder
XDM Business Campaign-Mitgliederdetails
Aktiviert
ccampaignMemberKey.sourceKey in der Basisklasse
B2B Campaign-Mitglied
extSourceSystemAudit.externalKey.sourceKey in der Basisklasse
B2B Campaign-Mitglied

Erste 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
B2B-Marketingliste
XDM Business Marketing List
Keine
Aktiviert
marketingListKey.sourceKey in der Basisklasse
B2B-Marketingliste
Keine
Keine
Keine
Statische Liste wird nicht synchronisiert aus Salesforce und hat daher keine sekundäre Identität.
B2B Marketing List Member
XDM Business Marketing List-Mitglieder
Keine
Aktiviert
marketingListMemberKey.sourceKey in der Basisklasse
B2B Marketing List Member
Keine
Keine

Erste 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
Statisches Listenelement wird nicht synchronisiert aus Salesforce und hat daher keine sekundäre Identität.
B2B-Aktivität
XDM ExperienceEvent
  • 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
Aktiviert
personKey.sourceKey Feldergruppe "Person Identifier"
B2B Person
Keine
Keine

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.
B2B-Konto-Personenbeziehung
Personenbeziehung zwischen XDM-Geschäftskonto
Identitätszuordnung
Aktiviert
accountPersonKey.sourceKey in der Basisklasse
B2B-Konto-Personenbeziehung
Keine
Keine

Erste 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.

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