Empfehlungen und Einschränkungen limitations
Berechtigungen und Sicherheit permissions
Zuordnung von Produktprofilen
In Campaign Standard wurde Ihnen erhöhte Administratorrolle Zugriff auf APIs gewährt, unabhängig von Ihrem zugewiesenen Produktprofil. Campaign v8 führt einen anderen Satz von Produktprofilen ein, für die eine Zuordnung von Campaign Standard zu Campaign v8-Produktprofilen erforderlich ist.
Bei der Migration werden zwei Produktprofile zu Ihren vorhandenen oder vorab erstellten technischen Konten hinzugefügt: Administrator und Message Center (für den Zugriff auf Transaktions-APIs). Überprüfen Sie die Produktprofilzuordnung und weisen Sie das erforderliche Produktprofil zu, wenn Sie nicht möchten, dass das Admin-Produktprofil Ihrem technischen Konto zugeordnet wird.
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 Campaign Standard-Mandanten-ID zu ersetzen.
Verwendung von Schlüsseln
Die Verwaltung der PKey-Werte 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 dynamisch durch PKeys oder aus vorherigen API-Aufrufen erstellt.
Verfügbare APIs deprecated
Vorerst sind die unten aufgeführten REST-APIs zur Verwendung verfügbar:
- Profile
- Services und Abonnements
- Benutzerdefinierte Ressourcen
- Workflows
- Transaktionsnachrichten
- Marketing-Verlauf
- Organisationseinheiten
- Datenschutzverwaltung
Filterung
-
Um Ihre Filter in den 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 an.
-
Das Präfix „by“, das für die Verwendung benutzerdefinierter Filter erforderlich ist, wird nicht mehr benötigt. Der Filtername sollte in Ihren Anfragen unverändert verwendet werden.
Beispiel:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/<resourceName>/<customFilterName>?<customFilterparam>=<customFilterValue>
Abgelegte 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 veraltet sein und entfernt.
POST mit verknüpften Ressourcen
Bei Verwendung des folgenden Anfragetext-Formats, wobei „vehierOwner“ den Link zu „nms“
{
"vehicleNumber": "20009",
"vehicleName": "Model E",
"vehicleOwner":{
"firstName":"tester 11",
"lastName":"Smith 11"
}
}
Die Link-Informationen werden ignoriert. Daher wird unter „cusVehicle“ ein neuer Datensatz generiert, der nur die Werte „vehicleNumber“ und „vehicleName“ enthält. Der Link bleibt jedoch null, was dazu führt, dass für „VehicleOwner“ „null“ festgelegt wird.
Wenn in Campaign v8 dieselbe Anfragekörperstruktur 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 die Relation enthält, funktioniert jedoch problemlos.
PATCH-Vorgänge
- Campaign v8 unterstützt PATCH nicht mit einem leeren Anfrageinhalt: Der Status „Kein Inhalt“ wird 204 zurückgegeben.
- Campaign Standard unterstützt PATCH zwar für Elemente/Attribute innerhalb eines Schemas, doch beachten Sie, dass PATCH-Vorgänge vor Ort in Campaign v8 nicht unterstützt werden. Der Versuch, einen PATCH-Speicherort zu konfigurieren, führt zu einem internen 500-Server-Fehler mit einer Fehlermeldung, die angibt, dass die Eigenschaft „zipCode“ für die Ressource „profile“ nicht gültig ist.
REST-Antworten
Im folgenden Abschnitt sind geringfügige Unterschiede zwischen Campaign Standard- und v8-REST-Antworten aufgeführt.
- Bei einzelnen GET-Einträgen enthält die Antwort die href in der Antwort.
- Bei der Abfrage mit dem -Attribut liefert Campaign v8 Anzahl und Paginierung in der Antwort.
- Nach POST-Vorgängen werden Werte aus verknüpften Ressourcen in der Antwort zurückgegeben.
Fehlercodes und Meldungen
Im folgenden Abschnitt werden die Unterschiede zwischen Fehler-Codes und Fehlermeldungen von Campaign Standard und Campaign v8 aufgeführt.
Profil - Zeitzone
Bei Campaign Standard wird die Zeitzone als Teil der JSON-Antwort von profileAndServices/profile REST-API-Aufrufen angezeigt.
In Campaign v8 wird die Zeitzone Benutzenden nur als Teil der REST-API Aufrufe von „profileAndServicesExt/profile angezeigt. Sie ist nicht Teil der profileAndServices/profile REST-API-Aufrufe, da sie in einem erweiterten Schema hinzugefügt wird.
Workflows - Auslösen externer Signale
Die Campaign Standard Workflow GET-API gibt Parameternamen wie die Workflow-Instanzvariablen und deren Datentypen (boolesch, Zeichenfolge usw.) zurück. Dies wird verwendet, um beim Auslösen des Signals über einen POST-API-Aufruf einen entsprechend formatierten JSON-Anfragetext zu erstellen.
Campaign v8 unterstützt keine Advertising Workflow-Instanzvariablen, erwartet jedoch, dass die Entwickler wissen, was diese sind. Daher müssen Parameterinformationen im POST-Anfrageinhalt nach der Migration erstellt werden, ohne dass Parameterinformationen in der GET-API-Antwort verfügbar sind.