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 zur automatischen Schemaerstellung besteht darin, Ihre Platform-Entwicklerkonsole und Ihre Postman -Umgebung einzurichten.
- Sie können die Sammlung und Umgebung des Dienstprogramms für die automatische Generierung von Namespace- und Schemas von diesem GitHub-Repository herunterladen.
- 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 Leitfaden zu den ersten Schritten 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 der Entwicklerkonsole und Postman.
Mit der Einrichtung einer Platform-Entwicklerkonsole und Postman können Sie jetzt mit der Anwendung der entsprechenden Umgebungswerte auf Ihre Postman -Umgebung beginnen.
Die folgende Tabelle enthält Beispielwerte sowie zusätzliche Informationen zum Ausfüllen Ihrer Postman -Umgebung:
CLIENT_SECRET
{ACCESS_TOKEN}
generiert wird. Informationen zum Abrufen Ihrer {CLIENT_SECRET}
finden Sie im Tutorial zum Authentifizieren und Zugreifen auf Experience Platform-APIs .{CLIENT_SECRET}
JWT_TOKEN
{JWT_TOKEN}
finden Sie im Tutorial zum Authentifizieren und Zugreifen auf Experience Platform-APIs .{JWT_TOKEN}
API_KEY
{API_KEY}
finden Sie im Tutorial zum Authentifizieren und Zugreifen auf Experience Platform-APIs .c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN
{ACCESS_TOKEN}
finden Sie im Tutorial zum Authentifizieren und Zugreifen auf Experience Platform-APIs .Bearer {ACCESS_TOKEN}
META_SCOPE
ent_dataservices_sdk
festgelegt.ent_dataservices_sdk
CONTAINER_ID
global
-Container enthält alle vom Experience Platform-Partner bereitgestellten Standardklassen, Schemafeldgruppen, Datentypen und Schemata. In Bezug auf Marketo ist dieser Wert festgelegt und immer auf global
gesetzt.global
PRIVATE_KEY
{PRIVATE_KEY}
TECHNICAL_ACCOUNT_ID
D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS
ims-na1.adobelogin.com
festgelegt.ims-na1.adobelogin.com
IMS_ORG
{ORG_ID}
-Informationen finden Sie im Tutorial zum Einrichten der Entwicklerkonsole mit und Postman .ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME
prod
TENANT_ID
b2bcdpproductiontest
PLATFORM_URL
http://platform.adobe.io/
festgelegt.http://platform.adobe.io/
Scripts ausführen
Nachdem Sie die Postman -Sammlung und -Umgebung eingerichtet haben, können Sie das Skript jetzt über die Postman -Oberfläche ausführen.
Wählen Sie in der Benutzeroberfläche von Postman den Stammordner des Autogenerator-Dienstprogramms aus und wählen Sie dann Run aus der oberen Kopfzeile aus.
Die Oberfläche 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.
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 dient, den Kontext einer Identität zu unterscheiden. Eine voll qualifizierte Identität umfasst einen Identitätswert und einen Namespace. Weitere Informationen finden Sie in der Namespaces - Übersicht .
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-Geschäftskontodetails"- Ziel-Eigenschaft:
/accountKey/sourceKey
- Typ: 1:1
- Referenzschema: B2B-Konto
- Namespace: B2B-Konto
- XDM-Geschäftspersonendetails
- XDM-Geschäftspersonenkomponenten
- IdentityMap
- Details zu Einverständnis und Voreinstellungen
b2b.personKey.sourceKey
in der Feldergruppe "XDM Business Person Details"extSourceSystemAudit.externalKey.sourceKey
der Feldergruppe "XDM Business Person Details"workEmail.address
der Feldergruppe "XDM Business Person Details"
- B2B Person
personComponents.sourceAccountKey.sourceKey
der 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
- 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 in 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 Campaign hinzufügen
personKey.sourceKey
der Feldergruppe "Personen-ID"Erste Beziehung
- Feld
listOperations.listKey.sourceKey
- Typ: 1:1
- Referenzschema: B2B Marketing List
- Namespace: B2B-Marketingliste
Zweite Beziehung
- Feld
opportunityEvent.opportunityKey.sourceKey
- Typ: 1:1
- Referenzschema: B2B-Chancen
- Namespace: B2B-Chancen
Dritte Beziehung
- Feld
leadOperation.campaignProgression.campaignKey.sourceKey
- 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
Informationen zum Verbinden Ihrer Marketo -Daten mit Platform finden Sie im Tutorial zum Erstellen eines Marketo-Quell-Connectors in der Benutzeroberfläche 🔗.