Uw Recommendations-catalogus beheren met behulp van API's

Laatst bijgewerkt: 14 november 2023

Gemaakt voor:

  • Ontwikkelaar

Terwijl u ervoor zorgt dat u voldoet aan de vereisten voor het gebruik van de Recommendations API, hebt u geleerd hoe te een toegangstoken genereren de JWT-verificatiestroom gebruiken om de Adobe Target Admin API's op de Adobe Developer Console.

U kunt nu de opdracht Recommendations API's om items toe te voegen, bij te werken of te verwijderen uit uw catalogus met aanbevelingen. Net als bij de andere Adobe Target Admin API's is verificatie vereist voor de Recommendations API's.

NOTE
Verzend de IMS: JWT Generate + Auth via User Token verzoek wanneer u uw toegangstoken voor authentificatie moet verfrissen, aangezien het na 24 uren verloopt. Zie API-verificatie voor Adobe configureren voor instructies.

JWT3ff

Haal voordat u verdergaat de Recommendations Postman-collectie.

Items maken en bijwerken met de API Entiteiten opslaan

Als u de Recommendations-productdatabase wilt vullen met behulp van de API in plaats van een CSV-productfeed of Target-aanvraag die wordt gestart op productpagina's, gebruikt u de optie Entiteiten-API opslaan. Met deze aanvraag wordt een item toegevoegd of bijgewerkt in één doelomgeving. De syntaxis is:

POST https://mc.adobe.io/{{TENANT_ID}}/target/recs/entities

Bijvoorbeeld, sparen Entiteiten kunnen worden gebruikt om punten bij te werken wanneer bepaalde drempels worden voldaan-zoals drempels voor inventaris of prijs-om die punten te markeren en hen te verhinderen worden geadviseerd.

  1. Navigeren naar Target > Setup > Hosts > CONTROL Environments om identiteitskaart van het Milieu van het Doel te verkrijgen waarin u een punt wilt toevoegen of bijwerken.

    SaveEntities1

  2. Verifiëren TENANT_ID en API_KEY verwijzen naar de eerder vastgestelde Postman-omgevingsvariabelen. Gebruik de onderstaande afbeelding om deze te vergelijken. Wijzig zo nodig de koppen en het pad in de API-aanvraag, zodat deze overeenkomen met de waarden in de onderstaande afbeelding.

    SaveEntities3

  3. Voer uw JSON in als ruw code in de Lichaam. Vergeet niet uw milieu-id op te geven met de environment variabele. (In het onderstaande voorbeeld is de milieu-id 6781.)

    SaveEntities4.png

    Hieronder ziet u een voorbeeld van JSON waarmee entiteit.id kit2001 wordt toegevoegd aan de bijbehorende entiteitswaarden voor een product van Toaster Oven, in omgeving 6781.

        {
    "entities": [{
            "name": "Toaster Oven",
            "id": "kit2001",
            "environment": 6781,
            "categories": [
                "housewares:appliances"
            ],
            "attributes": {
                "inventory": 77,
                "margin": 23,
                "message": "crashing helicopter",
                "pageUrl": "www.foobar.foo.com/helicopter.html",
                "thumbnailUrl": "www.foobar.foo.com/helicopter.jpg",
               "value": 19.2
            }
        }]
    }

  4. Klik op Send. U dient het volgende antwoord te ontvangen.

    SaveEntities5.png

    Het JSON-object kan worden geschaald om meerdere producten te verzenden. In deze JSON worden bijvoorbeeld twee entiteiten opgegeven.

        {
        "entities": [{
                "name": "Toaster Oven",
                "id": "kit2001",
                "environment": 6781,
                "categories": [
                    "housewares:appliances"
                ],
                "attributes": {
                    "inventory": 89,
                    "margin": 11,
                    "message": "Toaster Oven",
                    "pageUrl": "www.foobar.foo.com/helicopter.html",
                    "thumbnailUrl": "www.foobar.foo.com/helicopter.jpg",
                    "value": 102.5
                }
            },
            {
                "name": "Blender",
                "id": "kit2002",
                "environment": 6781,
                "categories": [
                    "housewares:appliances"
                ],
                "attributes": {
                    "inventory": 36,
                    "margin": 5,
                    "message": "Blender",
                    "pageUrl": "www.foobar.foo.com/helicopter.html",
                    "thumbnailUrl": "www.foobar.foo.com/helicopter.jpg",
                    "value": 54.5
                }
            }
        ]
    }

  5. Nu is het jouw beurt! Gebruik de Save Entities API om de volgende items aan uw catalogus toe te voegen. Gebruik het JSON-voorbeeld hierboven als beginpunt. (U moet de JSON uitbreiden tot extra entiteiten.)

    SaveEntities6.png

Deze laatste twee items horen niet bij elkaar. Laten we ze controleren met de Get Entity API, en indien nodig, schrapt hen gebruikend Delete Entities API.