Aanbevelingen en beperkingen limitations
Machtigingen en beveiliging permissions
Toewijzing van productprofielen
In Campaign Standard hebt u toegang gekregen tot API's met een verhoogde beheerdersrol, ongeacht het toegewezen productprofiel. Campagne v8 introduceert een andere set productprofielen, waarvoor u Campaign Standard moet toewijzen aan productprofielen voor Campaign v8.
Met de migratie worden twee productprofielen toegevoegd aan uw bestaande of vooraf gemaakte technische accounts: Beheerder en Berichtencentrum (voor toegang tot transactie-API's). Controleer de productprofieltoewijzing en wijs het vereiste productprofiel toe als u niet wilt dat het Admin-productprofiel aan uw technische account wordt toegewezen.
Tenant-id
Na migratie, voor om het even welke toekomstige integratie, wordt het geadviseerd om uw 24 huurdersidentiteitskaart van de Campagne v8 in REST URLs te gebruiken, die uw vorige Campaign Standard huurdersidentiteitskaart vervangen.
Sleutelgebruik
Het beheer van PKey-waarden verschilt tussen Campaign Standard en Campaign v8. Als u PKeys met Campaign Standard opslaat, zorg ervoor uw implementatie dynamisch verdere API vraag gebruikend PKeys of hrefs die uit vorige API vraag wordt verkregen vormt.
Beschikbare API's deprecated
Momenteel zijn de REST API's die hieronder worden vermeld, beschikbaar voor gebruik:
- Profielen
- de Diensten & abonnementen
- Aangepaste resources
- Workflows
- Transactionele berichten
- Marketinggeschiedenis
- Organisatorische eenheden
- Privacybeheer
Filteren
-
Als u uw filters wilt gebruiken in REST API-ladingen, moet u ze bewerken in Campagne v8 en een naam opgeven die u in uw ladingen kunt gebruiken. U doet dit door de aanvullende parameters van het filter vanaf het tabblad Parameters te openen en de gewenste naam op te geven in het veld Filter name in REST API .
-
Het voorvoegsel "by" dat vereist is om aangepaste filters te gebruiken, is niet langer nodig. De filternaam moet zo worden gebruikt in uw aanvragen.
Voorbeeld:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/<resourceName>/<customFilterName>?<customFilterparam>=<customFilterValue>
Gedropte databasevelden
Sommige velden uit de database worden tijdens de migratie verwijderd. Als u een weggelaten veld gebruikt, retourneert REST API's lege waarden. In de toekomst worden alle neergezette velden vervangen en verwijderd.
POST met gekoppelde bronnen
Wanneer het gebruiken van het volgende formaat van het verzoeklichaam, met "VehicleOwner"die de verbinding aan "nms :recipient"vertegenwoordigen:
{
"vehicleNumber": "20009",
"vehicleName": "Model E",
"vehicleOwner":{
"firstName":"tester 11",
"lastName":"Smith 11"
}
}
De koppelingsgegevens worden genegeerd. Bijgevolg wordt een nieuwe record gegenereerd onder "cusVehicle" die alleen waarden voor "vehicleNumber" en "vehicleName" bevat. Nochtans, blijft de verbinding ongeldig, resulterend in "vehicleOwner"die aan ongeldig wordt geplaatst.
Wanneer in Campaign v8 dezelfde structuur van de aanvraaginstantie wordt gebruikt en het "voertuig" aan een profiel is gekoppeld, treedt een fout op. Deze fout treedt op omdat de eigenschap "firstName" niet wordt herkend als geldig voor "cusVehicle". Een aanvraaginstantie die alleen de kenmerken zonder de koppeling omvat, functioneert echter zonder problemen.
PATCH-bewerkingen
- Campagne v8 biedt geen ondersteuning voor PATCH met een lege aanvraaginstantie: er wordt een 204-status Geen inhoud geretourneerd.
- Hoewel Campaign Standard PATCH op elementen/kenmerken in een schema ondersteunt, worden PATCH-bewerkingen op locatie niet ondersteund in Campagne v8. Als u een PATCH probeert te activeren op een locatie, wordt een 500 Interne serverfout gegenereerd met een foutbericht dat aangeeft dat de eigenschap 'zipCode' niet geldig is voor de bron 'profile'.
REST-reacties
In de onderstaande sectie worden kleine verschillen tussen Campaign Standard en v8 REST-antwoorden weergegeven.
- Voor enkele GET-records bevat de reactie de href in de reactie.
- Wanneer hierom wordt gevraagd met het kenmerk, biedt Campagne v8 Aantal en Paginering in de reactie.
- Na POST-bewerkingen worden waarden van gekoppelde bronnen geretourneerd in de reactie.
Foutcodes en berichten
In de onderstaande sectie ziet u de verschillen tussen foutcodes en berichten van Campaign Standard en Campagne v8.
Profiel - tijdzone
Met Campaign Standard, wordt timezone getoond als deel van de reactie JSON van profileAndServices/profile REST API vraag.
Met Campagne v8, wordt timezone slechts getoond aan gebruiker als deel van profileAndServicesExt/profile REST API vraag. Het maakt geen deel uit van profileAndServices/profile REST API vraag aangezien het in een uitgebreid schema wordt toegevoegd.
Workflows - externe signaalactivering
Campaign Standard Workflow GET API retourneert parameternamen zoals de werkstroominstantievariabelen en hun gegevenstypen (boolean, string, etc.). Dit wordt gebruikt om correct geformatteerde JSON- verzoeklichaam tot stand te brengen wanneer het teweegbrengen van het signaal via een POST API vraag.
Campaign v8 biedt geen ondersteuning voor instantievariabelen van advertentieworkflows, maar verwacht dat ontwikkelaars weten wat dat zijn. Daarom moet na de migratie parameterinformatie in de instantie van de POST-aanvraag worden samengesteld zonder de beschikbaarheid van parameterinformatie in de GET API-respons.