Recommendations und Einschränkungen limitations
Berechtigungen und Sicherheit permissions
Produktprofilzuordnung
Im Campaign Standard wurde Ihnen ungeachtet Ihres zugewiesenen Produktprofils ein erhöhter Administratorrollenzugriff auf APIs gewährt. Campaign v8 führt einen anderen Satz von Produktprofilen ein, was eine Zuordnung von Campaign Standard zu Campaign v8-Produktprofilen erfordert.
Mit der Migration werden Ihren vorhandenen oder vorab erstellten technischen Konten zwei Produktprofile hinzugefügt: Administrator und Message Center (für den Zugriff auf Transaktions-APIs). Überprüfen Sie das Produktprofil-Mapping und weisen Sie das benötigte Produktprofil zu, wenn das Admin-Produktprofil nicht Ihrem technischen Konto zugeordnet werden soll.
Mandanten-ID
Nach der Migration wird für alle zukünftigen Integrationen empfohlen, Ihre Campaign v8-Mandanten-ID in REST-URLs zu verwenden und Ihre vorherige Mandanten-ID des Campaign Standards zu ersetzen.
Schlüsselverwendung
Die Verwaltung von PKey-Werten unterscheidet sich zwischen Campaign Standard und Campaign v8. Wenn Sie PKeys mit Campaign Standard gespeichert haben, stellen Sie sicher, dass Ihre Implementierung nachfolgende API-Aufrufe mit PKeys dynamisch formt oder href aus vorherigen API-Aufrufen erhält.
Verfügbare APIs deprecated
Derzeit sind die unten aufgeführten REST-APIs zur Verwendung verfügbar:
- Profile
- Dienste und Abonnements
- Benutzerdefinierte Ressourcen
- Workflows
- Marketing-Verlauf
- Organisationseinheiten
- Datenschutzverwaltung
Filter
-
Um Ihre Filter in REST-API-Payloads zu verwenden, müssen Sie sie in Campaign v8 bearbeiten und einen Namen angeben, der in Ihren Payloads verwendet werden soll. Greifen Sie dazu über die Registerkarte Parameter auf die zusätzlichen Parameter des Filters zu und geben Sie den gewünschten Namen im Feld Filtername in REST API ein.
-
Das für die Verwendung benutzerdefinierter Filter erforderliche Präfix "by"ist nicht mehr erforderlich. Der Filtername sollte unverändert in Ihren Anforderungen verwendet werden.
Beispiel:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/<resourceName>/<customFilterName>?<customFilterparam>=<customFilterValue>
Dropped Datenbankfelder
Einige Felder aus der Datenbank werden während der Migration gelöscht. Bei Verwendung eines abgelegten Felds geben REST-APIs leere Werte zurück. In Zukunft werden alle abgelegten Felder nicht mehr unterstützt und entfernt.
POST mit verknüpften Ressourcen
Bei Verwendung des folgenden Anfrageinhaltsformats, bei dem die Relation zu "nms:recipient"durch "FahrzeugOwner"repräsentiert wird:
{
"vehicleNumber": "20009",
"vehicleName": "Model E",
"vehicleOwner":{
"firstName":"tester 11",
"lastName":"Smith 11"
}
}
Die Linkinformationen werden ignoriert. Folglich wird ein neuer Datensatz unter "cusVehicle" erstellt, der nur die Werte "FahrzeugNumber" und "FahrzeugName" enthält. Der Link bleibt jedoch null, was dazu führt, dass "carOwner"auf null gesetzt wird.
Wenn in Campaign v8 dieselbe Struktur des Anfragetexts verwendet wird und das "Fahrzeug" mit einem Profil verknüpft ist, tritt ein Fehler auf. Dieser Fehler tritt auf, weil die Eigenschaft "firstName"für "cusVehicle"nicht als gültig erkannt wird. Ein Anfragetext, der nur die Attribute ohne Link enthält, funktioniert jedoch ohne Probleme.
PATCH-Vorgänge
- Campaign v8 unterstützt kein PATCH mit einem leeren Anfrageinhalt: Es wird der Status "204 Kein Inhalt"zurückgegeben.
- Campaign Standard unterstützt zwar das PATCH von Elementen/Attributen innerhalb eines Schemas, beachten Sie jedoch, dass PATCH-Vorgänge am Standort in Campaign v8 nicht unterstützt werden. Beim Versuch, eine PATCH an einem Ort durchzuführen, wird ein 500-Fehler mit einer Fehlermeldung angezeigt, die angibt, dass die Eigenschaft "zipCode"für die Ressource "profile"nicht gültig ist.
REST-Antworten
Im folgenden Abschnitt werden geringfügige Unterschiede zwischen Campaign Standard- und v8-REST-Antworten aufgeführt.
- Bei einzelnen GET enthält die Antwort das href in der Antwort.
- Wenn mit dem -Attribut abgefragt wird, bietet Campaign v8 in der Antwort "Count"(Zählung) und "Paginierung"(Paginierung).
- Nach der POST werden in der Antwort Werte aus verknüpften Ressourcen zurückgegeben.
Fehlercodes und -nachrichten
Im folgenden Abschnitt finden Sie die Unterschiede zwischen den Fehlercodes und -nachrichten von Campaign Standard und Campaign v8.
Profil - Zeitzone
Mit Campaign Standard wird die Zeitzone als Teil der JSON-Antwort von profileAndServices/profile REST-API-Aufrufen angezeigt.
Bei Campaign v8 wird die Zeitzone dem Benutzer nur im Rahmen von profileAndServicesExt/profile REST-API-Aufrufen angezeigt. Sie ist nicht Teil der REST-API-Aufrufe profileAndServices/profile , da sie in einem erweiterten Schema hinzugefügt werden.
Workflows - Auslösung von Externem Signal
Die Campaign Standard Workflow-GET-API gibt Parameternamen wie die Workflow-Instanzvariablen und ihre Datentypen (boolesch, Zeichenfolge usw.) zurück. Damit wird beim Auslösen des Signals über einen POST-API-Aufruf ein entsprechend formatierter JSON-Anfrageinhalt erstellt.
Campaign v8 unterstützt keine Instanzvariablen im Werbe-Workflow, erwartet jedoch, dass Entwickler wissen, was diese sind. Daher müssen nach der Migration Parameterinformationen im Anfragetext der POST erstellt werden, ohne dass in der Antwort der GET API Parameterinformationen verfügbar sind.