Recommendations & begränsningar limitations
Behörigheter och säkerhet permissions
Mappning av produktprofiler
I Campaign Standard fick du förhöjd administratörsrollåtkomst till API:er oavsett din tilldelade produktprofil. I Campaign v8 introduceras en annan uppsättning produktprofiler, vilket kräver mappning från produktprofiler för Campaign Standard till Campaign v8.
Med migreringen läggs två produktprofiler till i dina befintliga eller redan skapade tekniska konton: Administratör och Meddelandecenter (för åtkomst till transaktionsprogrammeringsgränssnitt). Granska mappningen av produktprofiler och tilldela den produktprofil som behövs om du inte vill att Admin-produktprofilen ska mappas till ditt tekniska konto.
Klient-ID
Efter migreringen, för framtida integreringar, rekommenderas att du använder ditt Campaign v8-klientorganisations-ID i REST-URL:er och ersätter ditt tidigare Campaign Standard-klientorganisations-ID.
Nyckelanvändning
Hanteringen av PKey-värden skiljer sig mellan Campaign Standard och Campaign v8. Om du lagrade PKeys med Campaign Standard bör du se till att implementeringen dynamiskt skapar efterföljande API-anrop med PKeys eller hrefs från tidigare API-anrop.
Tillgängliga API:er deprecated
För närvarande är REST API:erna som listas nedan tillgängliga:
- Profiler
- Tjänster och prenumerationer
- Anpassade resurser
- Arbetsflöden
- Marknadsföringshistorik
- Organisationsenheter
- Integritetshantering
Filtrering
-
Om du vill använda dina filter i REST API-nyttolaster måste du redigera dem i Campaign v8 och ange ett namn att använda i dina nyttolaster. Om du vill göra det kommer du åt filtrets ytterligare parametrar på fliken Parameters och anger önskat namn i fältet Filter name in REST API.
-
Det by-prefix som krävs för att använda anpassade filter behövs inte längre. Filternamnet ska användas som det är i dina förfrågningar.
Exempel:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/<resourceName>/<customFilterName>?<customFilterparam>=<customFilterValue>
Ignorerade databasfält
Vissa fält från databasen tas bort under migreringen. När du använder ett släppt fält returnerar REST-API:er tomma värden. I framtiden kommer alla borttagna fält att bli inaktuella och tas bort.
POST med länkade resurser
När du använder följande body-format för begäran, där "vehikelägare" representerar länken till "nms:mottagare":
{
"vehicleNumber": "20009",
"vehicleName": "Model E",
"vehicleOwner":{
"firstName":"tester 11",
"lastName":"Smith 11"
}
}
Länkinformationen ignoreras. Följaktligen genereras en ny post under"cusVehicle" som endast innehåller värdena"VehicleNumber" och"VehicleName". Länken är emellertid fortfarande null, vilket resulterar i att"vehikelägare" ställs in på null.
I Campaign v8 inträffar ett fel när samma frågetexakthjälpstruktur används och"vehikeln" är kopplad till en profil. Det här felet inträffar eftersom egenskapen "firstName" inte känns igen som giltig för "cusVehicle". En begärandetext som bara innehåller attributen utan länkfunktionerna utan några problem.
PATCH operationer
- Campaign v8 stöder inte PATCH med en tom begärandetext: den returnerar statusen 204 Inget innehåll.
- Campaign Standard har stöd för PATCH på element/attribut i ett schema, men observera att PATCH-åtgärder på plats inte stöds i Campaign v8. Om du försöker utföra ett PATCH på-plats uppstår ett internt 500-serverfel med ett felmeddelande som anger att zipCode-egenskapen inte är giltig för profile-resursen.
REST-svar
I avsnittet nedan visas mindre skillnader mellan Campaign Standard- och v8 REST-svar.
- För enskilda GETTER innehåller svaret href i svaret.
- När Campaign v8 efterfrågas med attributet tillhandahåller den Count och Pagination i svaret.
- Efter POST returneras värden från länkade resurser i svaret.
Felkoder och meddelanden
I avsnittet nedan listas skillnaderna mellan felkoder och meddelanden för Campaign Standard och Campaign v8.
Profil - tidszon
Med Campaign Standard visas tidszonen som en del av JSON-svaret för REST-API-anrop för profileAndServices/profile.
Med Campaign v8 visas tidszonen endast för användaren som en del av profileAndServicesExt/profile REST API-anrop. Det ingår inte i profileAndServices/profile REST API-anrop eftersom det läggs till i ett utökat schema.
Arbetsflöden - Extern signalutlösare
Campaign Standard Workflow GET API returnerar parameternamn som arbetsflödesinstansvariabler och deras datatyper (boolesk, sträng osv.). Detta används för att skapa korrekt formaterad JSON-begärandetext när signalen aktiveras via ett POSTS-API-anrop.
Campaign v8 stöder inte variabler för annonsarbetsflödesinstanser, men förväntar sig att utvecklare ska veta vad de är. Efter migreringen måste parameterinformationen i POSTENS begärandetext konstrueras utan att parameterinformationen i GET API-svaret är tillgänglig.