Recommendations en beperkingen limitations
Machtigingen en beveiliging permissions
Toewijzing van productprofielen
In Campaign Standard, werd u verhoogde admin roltoegang tot APIs ongeacht uw toegewezen productprofiel verleend. Campagne v8 introduceert een andere set productprofielen, waardoor het nodig is deze toe te wijzen van Campaign Standard naar productprofielen van 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 20} huurdersidentiteitskaart van de Campagne v8 in REST URLs te gebruiken, die uw vorige huurdersidentiteitskaart van het Campaign Standard 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
- 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
Bij gebruik van de volgende indeling van de aanvraaginstantie, met "VehicleOwner" die de koppeling naar "nms:receiner" vertegenwoordigt:
{
"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 ondersteunt geen PATCH met een lege aanvraaginstantie: er wordt een 204-status Geen inhoud geretourneerd.
- Hoewel het Campaign Standard PATCH op elementen/attributen binnen een schema steunt, merk op dat de verrichtingen van de PATCH op plaats niet in Campagne v8 worden gesteund. Het proberen van een PATCH op plaats zal in een 500 Interne Fout van de Server met een foutenmelding resulteren erop wijzend dat het "zipCode"bezit niet geldig voor het "profiel"middel is.
REST-reacties
In de onderstaande sectie worden kleine verschillen tussen Campaign Standard- en v8 REST-reacties weergegeven.
- Voor afzonderlijke 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 de verrichtingen van de POST, zijn de waarden van verbonden middelen teruggekeerd in de reactie.
Foutcodes en berichten
In de onderstaande sectie ziet u de verschillen tussen foutcodes en berichten voor 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
De GET API van het Werkschema van het Campaign Standard keert parameternamen zoals de variabelen van de werkschemainstantie en hun gegevenstypes (boolean, koord, enz.) terug. Dit wordt gebruikt om geschikt 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. Als zodanig, post-migratie, zal parameterinformatie in de POST aanvraaginstantie moeten worden samengesteld zonder de beschikbaarheid van parameterinformatie in de reactie van de GET API.