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 Postman-Automatisierungsdienstprogramms, das zum Generieren von B2B-Namespaces und -Schemas erforderlich ist.

WICHTIG

Sie müssen Zugriff auf 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 Informationen zum Abrufen Ihrer {CLIENT_SECRET}. {CLIENT_SECRET}
JWT_TOKEN Das JSON-Web-Token (JWT) ist eine Authentifizierungsberechtigung, die zum Generieren Ihres {ACCESS_TOKEN} verwendet wird. Siehe Tutorial zu Authentifizierung und Zugriff auf Experience Platform-APIs Informationen zur Generierung Ihrer {JWT_TOKEN}. {JWT_TOKEN}
API_KEY Eine eindeutige Kennung, die zum Authentifizieren von Aufrufen an Experience Platform-APIs verwendet wird. Siehe Tutorial zu Authentifizierung und Zugriff auf Experience Platform-APIs 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 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 Standardpartner für Adoben und Experience Platformen bereitgestellten Klassen, Schemafeldgruppen, Datentypen und Schemas. 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 für Anweisungen zum Abrufen Ihres {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) bietet das Framework für die Authentifizierung bei Adobe-Diensten. 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 {IMS_ORG} Informationen. ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME Der Name der von Ihnen 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 Ihrer IMS-Organisation 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

Identitäts-Namespaces sind eine Komponente von Identity Service , die dazu dienen, den Kontext oder den Typ einer Identität zu unterscheiden. Eine vollqualifizierte Identität umfasst einen ID-Wert und einen Namespace. Siehe 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.

HINWEIS

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

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

Bevor Daten in Platform erfasst werden können, muss ein Schema erstellt werden, das die Datenstruktur beschreibt und Einschränkungen für den Datentyp enthält, der in jedem Feld enthalten sein kann. Schemas bestehen aus einer Basisklasse und keiner oder mehr Schemafeldgruppen.

Weitere Informationen zum Schema-Kompositionsmodell, einschließlich Designgrundsätzen und Best Practices, finden Sie in der Grundlagen der Schemakomposition.

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

HINWEIS

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: Eins-zu-eins
  • Referenzschema: B2B-Konto
  • Namespace: B2B-Konto
B2B Person XDM Individual Profile
  • 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 aktuellem 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 aktuellem 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 aktuellem 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-Geschäftskampagnendetails Aktiviert campaignKey.sourceKey in der Basisklasse B2B-Kampagne extSourceSystemAudit.externalKey.sourceKey in der Basisklasse B2B-Kampagne
B2B Campaign-Mitglied XDM Business Campaign-Mitglieder Details zu XDM-Business-Campaign-Mitgliedern 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 aktuellem 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 aktuellem 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 aktuellem Schema: Person
  • Beziehungsname aus Referenzschema: Marketinglisten
Zweite Beziehung
  • marketingListKey.sourceKey in der Basisklasse
  • Typ: Viele-zu-eins
  • Referenzschema: B2B-Marketingliste
  • Namespace: B2B-Marketingliste
  • Ziel-Eigenschaft: marketingListKey.sourceKey
  • Beziehungsname aus aktuellem 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
  • Neuer Lead
  • 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
Aktiviert personKey.sourceKey Feldergruppe "Person Identifier" B2B Person Keine Keine Erste Beziehung
  • listOperations.listKey.sourceKey field
  • Typ: Eins-zu-eins
  • Referenzschema: B2B-Marketingliste
  • Namespace: B2B-Marketingliste
Zweite Beziehung
  • opportunityEvent.opportunityKey.sourceKey field
  • Typ: Eins-zu-eins
  • Referenzschema: B2B-Chancen
  • Namespace: B2B-Chancen
Dritte Beziehung
  • leadOperation.campaignProgression.campaignKey.sourceKey field
  • 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-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 aktuellem Schema: Personen
  • Beziehungsname aus 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 aktuellem 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.

Auf dieser Seite