Recommendations e limitazioni limitations
Autorizzazioni e sicurezza permissions
Mappatura dei profili di prodotto
In Campaign Standard, ti era stato concesso l’accesso alle API con un ruolo di amministratore elevato, indipendentemente dal profilo di prodotto assegnato. Campaign v8 introduce un diverso set di profili di prodotto, che richiede la mappatura dai profili di prodotto di Campaign Standard a Campaign v8.
Con la migrazione, due profili di prodotto vengono aggiunti agli account tecnici esistenti o precreati: Amministratore e Centro messaggi (per accedere alle API transazionali). Rivedi la mappatura del profilo di prodotto e assegna il profilo di prodotto necessario se non desideri che il profilo di prodotto Amministratore sia mappato con il tuo account tecnico.
ID tenant
Dopo la migrazione, per eventuali integrazioni future, si consiglia di utilizzare l'ID tenant Campaign v8 negli URL REST, sostituendo l'ID tenant Campaign Standard precedente.
Utilizzo chiave
La gestione dei valori PKey varia tra Campaign Standard e Campaign v8. Se memorizzi le PKeys con Campaign Standard, assicurati che l’implementazione formi dinamicamente le successive chiamate API utilizzando le PKeys o gli href ottenuti da precedenti chiamate API.
API disponibili deprecated
Per il momento, è possibile utilizzare le API REST elencate di seguito:
- Profili
- Servizi e abbonamenti
- Risorse personalizzate
- Flussi di lavoro
- Storico dei dati marketing
- Unità organizzative
- Gestione della privacy
Filtro
-
Per utilizzare i filtri nei payload API REST, è necessario modificarli in Campaign v8 e fornire un nome da utilizzare nei payload. A tale scopo, accedere ai parametri aggiuntivi del filtro dalla scheda Parametri e specificare il nome desiderato nel campo Nome filtro nell'API REST.
-
Il prefisso "by" necessario per utilizzare i filtri personalizzati non è più necessario. Il nome del filtro deve essere utilizzato così com’è nelle richieste.
Esempio:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/<resourceName>/<customFilterName>?<customFilterparam>=<customFilterValue>
Campi di database rilasciati
Alcuni campi del database vengono eliminati durante la migrazione. Quando si utilizza un campo rilasciato, le API REST restituiscono valori vuoti. In futuro, tutti i campi rilasciati diventeranno obsoleti e verranno rimossi.
POST con risorse collegate
Quando si utilizza il seguente formato del corpo della richiesta, con "vehicleOwner" che rappresenta il collegamento a "nms:recipient":
{
"vehicleNumber": "20009",
"vehicleName": "Model E",
"vehicleOwner":{
"firstName":"tester 11",
"lastName":"Smith 11"
}
}
Le informazioni sul collegamento vengono ignorate. Di conseguenza, viene generato un nuovo record in "cusVehicle" contenente solo i valori "vehicleNumber" e "vehicleName". Tuttavia, il collegamento rimane nullo, con conseguente impostazione di "vehicleOwner" su null.
In Campaign v8, quando si utilizza la stessa struttura del corpo della richiesta e il "veicolo" è collegato a un profilo, si verifica un errore. Questo errore si verifica perché la proprietà "firstName" non è riconosciuta come valida per "cusVehicle". Tuttavia, un corpo della richiesta che include solo gli attributi senza il collegamento funziona senza alcun problema.
Operazioni PATCH
- Campaign v8 non supporta PATCH con un corpo di richiesta vuoto: restituisce lo stato 204 Nessun contenuto.
- Campaign Standard supporta PATCH su elementi/attributi all’interno di uno schema, ma non in Campaign v8 è supportata alcuna operazione PATCH sulla posizione. Se si tenta di individuare un PATCH nel percorso, si verifica un errore interno del server 500 con un messaggio di errore che indica che la proprietà 'zipCode' non è valida per la risorsa 'profile'.
Risposte REST
La sezione seguente elenca differenze minori tra le risposte REST di Campaign Standard e v8.
- Per i record a GET singolo, la risposta include il href nella risposta.
- Quando viene eseguita una query con l’attributo, Campaign v8 fornisce i valori Count e Pagination nella risposta.
- Dopo le operazioni POST, i valori delle risorse collegate vengono restituiti nella risposta.
Codici di errore e messaggi
La sezione seguente elenca le differenze tra i codici di errore e i messaggi di Campaign Standard e Campaign v8.
Profilo - Fuso orario
Con Campaign Standard, il fuso orario viene visualizzato come parte della risposta JSON di profileAndServices/profile chiamate REST API.
Con Campaign v8, il fuso orario viene visualizzato all’utente solo come parte delle chiamate REST API profileAndServicesExt/profile. Non fa parte delle chiamate REST API di profileAndServices/profile poiché è in fase di aggiunta in uno schema esteso.
Flussi di lavoro - Attivazione segnale esterno
L’API del flusso di lavoro di Campaign Standard GET restituisce i nomi dei parametri, come le variabili dell’istanza del flusso di lavoro e i relativi tipi di dati (booleano, stringa, ecc.). Viene utilizzato per creare un corpo di richiesta JSON formattato in modo appropriato quando si attiva il segnale tramite una chiamata API POST.
Campaign v8 non supporta le variabili dell’istanza del flusso di lavoro per la pubblicità, ma si aspetta che gli sviluppatori sappiano di cosa si tratta. Di conseguenza, dopo la migrazione, le informazioni sui parametri nel corpo della richiesta POST dovranno essere costruite senza la disponibilità di informazioni sui parametri nella risposta API GET.