Plaatsingen weergeven list-placements

Last update: Thu Dec 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Van toepassing op:
Journey Orchestration

Onderwerpen:
Besluitbeheer
API

Gemaakt voor:

Ervaren
Ontwikkelaar

TIP

Het besluit, de nieuwe beslissingsmogelijkheden van Adobe Journey Optimizer, is nu beschikbaar via de op code gebaseerde ervaring en e-mailkanalen! Meer informatie

Plaatsingen zijn containers die worden gebruikt om uw voorstellen te tonen. Een plaatsing helpt ervoor te zorgen dat de juiste aanbiedingsinhoud op de juiste plaats binnen uw bericht verschijnt. Wanneer u inhoud aan een aanbieding toevoegt, wordt u gevraagd een plaatsing te selecteren waarin die inhoud kan worden weergegeven.

U kunt een lijst van alle plaatsen bekijken door één enkel GET verzoek aan Offer Library API uit te voeren.

API formaat

GET /{ENDPOINT_PATH}/placements?{QUERY_PARAMS}

Parameter

Beschrijving

Voorbeeld

{ENDPOINT_PATH}

Het eindpuntpad voor gegevensopslagruimte-API's.

https://platform.adobe.io/data/core/dps

Query-parameters gebruiken using-query-parameters

U kunt queryparameters gebruiken om de resultaten te filteren en te pagineren wanneer u bronnen weergeeft.

Paginering paging

De gemeenschappelijkste vraagparameters voor het pagineren omvatten:

Parameter

Beschrijving

Voorbeeld

property

Een optioneel eigenschapsfilter:

De eigenschappen worden gegroepeerd door EN-bewerking.
De parameters kunnen als zo worden herhaald: property= {PROPERTY_EXPR}[&property= {PROPERTY_EXPR2}… ] of property= {PROPERTY_EXPR1}[, {PROPERTY_EXPR2}… ]
Eigenschapexpressies hebben de notatie [ !]field[op]value en ondersteunen op in [==,!=,<=,>=,<,>,~] reguliere expressies.

property=name!=abc&property=id~.*1234.*&property=description equivalent with property=name!=abc,id~.*1234.*,description.

orderBy

Resultaten sorteren op een bepaalde eigenschap. Als u de naam a - before toevoegt (orderby=-name), worden de items op naam gesorteerd in aflopende volgorde (Z-A). Padexpressies hebben de vorm van door punten gescheiden paden. Deze parameter kan als volgt worden herhaald: orderby=field1[,-fields2,field3,...]

orderby=id, -name

Verzoek

curl -X GET 'https://platform.adobe.io/data/core/dps/placements?limit=2' \
-H 'Accept: *,application/json' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'

Reactie

Een succesvolle reactie keert een lijst van plaatsen terug die aanwezig zijn en die u toegang tot hebt.

{
    "results": [
        {
            "created": "2023-05-15T11:22:50.031+00:00",
            "modified": "2023-05-15T11:22:50.031+00:00",
            "etag": 1,
            "schemas": [
                "https://ns.adobe.com/experience/offer-management/offer-placement;version=0.5"
            ],
            "createdBy": "{CREATED_BY}",
            "lastModifiedBy": "{MODIFIED_BY}",
            "id": "offerPlacement5678",
            "name": "Placement one",
            "description": "Placement description",
            "componentType": "html",
            "channel": "https://ns.adobe.com/xdm/channel-types/web",
            "itemCount": 1,
            "allowDuplicatePlacements": false,
            "returnContent": false,
            "returnMetaData": {
                "decisionName": true,
                "offerName": true,
                "offerAttributes": true,
                "offerPriority": true,
                "placementName": true,
                "channelType": true,
                "contentType": true
            }
        },
        {
            "created": "2023-05-19T08:29:15.875+00:00",
            "modified": "2023-05-19T08:29:15.875+00:00",
            "etag": 1,
            "schemas": [
                "https://ns.adobe.com/experience/offer-management/offer-placement;version=0.5"
            ],
            "createdBy": "{CREATED_BY}",
            "lastModifiedBy": "{MODIFIED_BY}",
            "id": "offerPlacement1234",
            "name": "Placement two",
            "description": "Placement description",
            "componentType": "html",
            "channel": "https://ns.adobe.com/xdm/channel-types/email",
            "itemCount": 1,
            "allowDuplicatePlacements": false,
            "returnContent": false,
            "returnMetaData": {
                "decisionName": true,
                "offerName": true,
                "offerAttributes": true,
                "offerPriority": true,
                "placementName": true,
                "channelType": true,
                "contentType": true
            }
        }
    ],
    "count": 2,
    "total": 4,
    "_links": {
        "self": {
            "href": "/placements?href={SELF_HREF}&limit=2",
            "type": "application/json"
        },
        "next": {
            "href": "/placements?href={NEXT_HREF}&limit=2",
            "type": "application/json"
        }
    }
}

recommendation-more-help

b22c9c5d-9208-48f4-b874-1cefb8df4d76