DokumentationExperience PlatformAnleitung zu Quell-Connectoren

B2B-Namespaces und -Schemata

Last update: Tue Oct 08 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-Schemas in Echtzeit-Kundenprofil qualifiziert sind.
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 zum Verwenden von Vorlagen in der Platform-Benutzeroberfläche 🔗.

In diesem Dokument finden Sie Informationen zum zugrunde liegenden Setup 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

IMPORTANT
Die Anmeldedaten für Dienstkonten (JWT) werden nicht mehr unterstützt. Sie müssen sicherstellen, dass Sie Ihre Anwendung oder Integration vor dem 27. Januar 2025 in die neue OAuth-Server-zu-Server-Berechtigung migrieren. In der folgenden Dokumentation finden Sie ausführliche Schritte zum Migrieren Ihrer JWT-Berechtigung zu OAuth-Server-zu-Server-Anmeldedaten.

Informationen zur Einrichtung Ihrer Postman -Umgebung zur Unterstützung des B2B-Namespace und des Dienstprogramm zur automatischen Schemaerstellung finden Sie in der folgenden Dokumentation .

  • 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:

Variable
Beschreibung
Beispiel
CLIENT_SECRET
Eine eindeutige Kennung, mit der Ihr {ACCESS_TOKEN} generiert wird. Informationen zum Abrufen Ihrer {CLIENT_SECRET} finden Sie im Tutorial zum Authentifizieren und Zugreifen auf Experience Platform-APIs .
{CLIENT_SECRET}
API_KEY
Eine eindeutige Kennung, mit der Aufrufe an Experience Platform-APIs authentifiziert werden. Informationen zum Abrufen Ihrer {API_KEY} finden Sie im Tutorial zum Authentifizieren und Zugreifen auf Experience Platform-APIs .
c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN
Das Autorisierungstoken, das zum Abschließen von Aufrufen an Experience Platform-APIs erforderlich ist. Informationen zum Abrufen Ihrer {ACCESS_TOKEN} finden Sie im Tutorial zum Authentifizieren und Zugreifen auf Experience Platform-APIs .
Bearer {ACCESS_TOKEN}
META_SCOPE
In Bezug auf Marketo ist dieser Wert fest festgelegt und immer auf: ent_dataservices_sdk festgelegt.
ent_dataservices_sdk
CONTAINER_ID
Der 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
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. In Bezug auf Marketo ist dieser Wert festgelegt und immer auf: ims-na1.adobelogin.com festgelegt.
ims-na1.adobelogin.com
IMS_ORG
Eine Unternehmenseinheit, die Produkte und Dienste besitzen oder lizenzieren und Zugriff auf ihre Mitglieder gewähren kann. Anweisungen zum Abrufen Ihrer {ORG_ID} -Informationen finden Sie im Tutorial zum Einrichten der Entwicklerkonsole mit und Postman .
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 und immer auf 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.

Der Stammordner des Namespaces und Schemas-Generators in der Postman-Benutzeroberfläche. Ausführungenwird in der oberen Menüleiste hervorgehoben.

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.

Die Runner-Benutzeroberfläche der Postman-Benutzeroberfläche mit mehreren Anforderungen in der Sammlung Namespaces und Schemasist aktiviert und die Schaltfläche Namespaces und Schemas ausführenrechts hervorgehoben.

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.

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-Opportunity
b2b_opportunity
B2B_OPPORTUNITY
B2B Opportunity-Personenbeziehung
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-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 im Schema
Primäre Identität
Primärer Identity-Namespace
Sekundäre Identität
Sekundärer Identitäts-Namespace
Beziehung
Anmerkungen
B2B-Konto
XDM-Geschäftskonto
Details zum XDM Business-Konto
Aktiviert
accountKey.sourceKey in der Basisklasse
B2B-Konto
extSourceSystemAudit.externalKey.sourceKey in der Basisklasse
B2B-Konto
  • accountParentKey.sourceKey in der Feldergruppe "XDM-Geschäftskontodetails"
  • 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
  • Details zu Einverständnis und Voreinstellungen
Aktiviert
b2b.personKey.sourceKey in der Feldergruppe "XDM Business Person Details"
B2B Person
  1. extSourceSystemAudit.externalKey.sourceKey der Feldergruppe "XDM Business Person Details"
  2. workEmail.address der Feldergruppe "XDM Business Person Details"
  1. B2B Person
  2. E-Mail
  • 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
B2B-Opportunity
XDM-Geschäftschancen
XDM Business-Opportunity-Details
Aktiviert
opportunityKey.sourceKey in der Basisklasse
B2B-Opportunity
extSourceSystemAudit.externalKey.sourceKey in der Basisklasse
B2B-Opportunity
  • 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 Person Relation
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-Geschäftskampagne
XDM Business Campaign-Details
Aktiviert
campaignKey.sourceKey in der Basisklasse
B2B-Kampagne
extSourceSystemAudit.externalKey.sourceKey in der Basisklasse
B2B-Kampagne
B2B-Kampagnenmitglied
XDM-Geschäftskampagnenmitglieder
Abonnentendetails zur XDM Business-Kampagne
Aktiviert
ccampaignMemberKey.sourceKey in der Basisklasse
B2B-Kampagnenmitglied
extSourceSystemAudit.externalKey.sourceKey in der Basisklasse
B2B-Kampagnenmitglied

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-Marketing-Liste
XDM Business Marketing List
Keine
Aktiviert
marketingListKey.sourceKey in 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 in der Basisklasse
B2B-Marketing-Listenmitglied
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 mit Salesforce synchronisiert und hat daher keine sekundäre Identität.
B2B-Aktivität
XDM ExperienceEvent
  • 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
Aktiviert
personKey.sourceKey der Feldergruppe "Personen-ID"
B2B Person
Keine
Keine

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.
B2B-Konto-Personenbeziehung
XDM Business Account Person Relation
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

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

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