Mappare segmenti su una destinazione

Mappa i segmenti sulle destinazioni con questi metodi RESTful API.

Tipi di destinazione supportati: Solo URL e cookie

I metodi POST disponibili consentono di mappare i segmenti solo su URL e cookie destinations. Al momento non è possibile mappare i segmenti su server-to-server destinations con questi metodi REST API. Utilizza invece l’interfaccia utente . Tuttavia, i metodi GET di destinazione correlati consentono di recuperare informazioni su server-to-server destinations create nell'interfaccia utente.

Mappare un segmento su una destinazione URL non serializzata

Un metodo POST che consente di mappare un segmento su una destinazione non seriale URL.

Richiesta

POST https://api.demdex.com/v1/destinations/<destinationId>/mappings/

Richiesta di esempio

Tutti i valori della richiesta sono obbligatori, salvo diversa indicazione.

{
   "sid":87723,
   "traitType":"SEGMENT",
   "url":"https://adobe.com",
   "startDate":"2012-07-04"
}

Risposta

{
   "mappingId":65334,
   "traitType":"SEGMENT",
   "traitValue":0,
   "destinationId":4033,
   "elementName":"Sample games",
   "elementDescription":"Sample games pixel",
   "elementStatus":"active",
   "createTime":1338940094000,
   "updateTime":1338940094000,
   "crUID":694,
   "upUID":694,
   "sid":87723,
   "startDate":"2012-07-03",
   "endDate":null,
   "priority":null,
   "url":"https://adobe.com",
   "secureUrl":null,
   "tagCode":null,
   "secureTagCode":null,
   "traitAlias":null
}

Mappare un segmento su una destinazione URL serializzata

Un metodo POST che consente di mappare un segmento su una destinazione URL serializzata.

Richiesta

POST https://api.demdex.com/v1/destinations/<dataOrderId>/traits/

Richiesta di esempio

Nella richiesta, il traitAlias corrisponde alla chiave in una coppia chiave-valore. Tutti i valori della richiesta sono obbligatori, salvo diversa indicazione.

{
   "sid":87723,
   "traitType":"SEGMENT",
   "startDate":"2012-07-04",
   "traitAlias":"123"
}

Risposta

{
   "mappingId":65335,
   "traitType":"SEGMENT",
   "traitValue":0,
   "destinationId":4034,
   "elementName":"Sample Games",
   "elementDescription":"Migration of Sample Games Pixel",
   "elementStatus":"active",
   "createTime":1338940401000,
   "updateTime":1338940401000,
   "crUID":694,
   "upUID":694,
   "sid":87723,
   "startDate":"2012-07-03",
   "endDate":null,
   "priority":null,
   "url":"123",
   "secureUrl":"123",
   "tagCode":null,
   "secureTagCode":null,
   "traitAlias":"123"
}

Mappare un segmento su una destinazione cookie: Chiave singola, non serializzata

Un metodo POST che consente di mappare un segmento a una destinazione a chiave singola e non serializzata cookie.

Richiesta

POST https://api.demdex.com/v1/destinations/<destinationId>/mappings/

Richiesta di esempio

Nella richiesta, il valueAlias corrisponde al valore in una coppia chiave-valore. Tutti i valori della richiesta sono obbligatori, salvo diversa indicazione.

{
   "sid":87723,
   "traitType":"SEGMENT",
   "startDate":"2012-07-04",
   "valueAlias":"123"
}

Risposta

{
   "destinationMappingId":65336,
   "traitType":"SEGMENT",
   "traitValue":0,
   "destinationId":4035,
   "elementName":"Sample Games",
   "elementDescription":"Migration of Sample Games Pixel",
   "elementStatus":"active",
   "createTime":1338940704000,
   "updateTime":1338940704000,
   "crUID":694,
   "upUID":694,
   "sid":87723,
   "startDate":"2012-07-03",
   "endDate":null,
   "priority":1,
   "traitAlias":null,
   "valueAlias":"123"
}

Mappare un segmento su una destinazione cookie: Multi-chiave, non serializzata

Un metodo POST che consente di mappare un segmento a una destinazione con più chiavi e non serializzate cookie.

Richiesta

POST https://api.demdex.com/v1/destinations/<destinationId>/mappings/

Richiesta di esempio

Nella richiesta, i valori traitAlias e valueAlias impostano rispettivamente la chiave e il valore in una coppia chiave-valore. Tutti i valori della richiesta sono obbligatori, salvo diversa indicazione.

{
   "sid":87723,
   "traitType":"SEGMENT",
   "startDate":"2012-07-04",
   "traitAlias":"type",
   "valueAlias":"123"
}

Risposta

{
   "mappingId":65338,
   "traitType":"SEGMENT",
   "traitValue":0,
   "destinationId":4037,
   "elementName":"Sample Games",
   "elementDescription":"Migration of Sample Games Pixel",
   "elementStatus":"active",
   "createTime":1338941092000,
   "updateTime":1338941092000,
   "crUID":694,
   "upUID":694,
   "sid":87723,
   "startDate":"2012-07-03",
   "endDate":null,
   "priority":1,
   "traitAlias":"type",
   "valueAlias":"123"
}

Mappare un segmento su una destinazione cookie: Multi-chiave, serializzata

Un metodo POST che consente di mappare un segmento su un cookie destination con più chiavi e serializzazione.

Richiesta

POST https://api.demdex.com/v1/destinations/<destinationId>/mappings/

Richiesta di esempio

Nella richiesta, i valori traitAlias e valueAlias impostano la chiave e il valore in una coppia chiave-valore. Tutti i valori della richiesta sono obbligatori, salvo diversa indicazione.

{
   "sid":87723,
   "traitType":"SEGMENT",
   "startDate":"2012-07-04",
   "traitAlias":"type",
   "valueAlias":"123"
}

Risposta

{
   "destinationMappingId":65340,
   "traitType":"SEGMENT",
   "traitValue":0,
   "destinationId":4038,
   "elementName":"Sample Games",
   "elementDescription":"Migration of Sample Games Pixel",
   "elementStatus":"active",
   "createTime":1338941273000,
   "updateTime":1338941273000,
   "crUID":694,
   "upUID":694,
   "sid":87723,
   "startDate":"2012-07-03",
   "endDate":null,
   "priority":2,
   "traitAlias":"type",
   "valueAlias":"123"
}

Mappare un segmento su una destinazione server-to-server

Un metodo POST che consente di mappare un segmento su una destinazione server-to-server esistente. Nota, tuttavia, che non è possibile creare destinazioni server-to-server con questi metodi attualmente disponibili API.

Richiesta

POST https://api.demdex.com/v1/destinations/<destinationId>/mappings/

Richiesta di esempio

Nella richiesta, il traitAlias corrisponde alla chiave in una coppia chiave-valore. Tutti i valori della richiesta sono obbligatori, salvo diversa indicazione.

{
   "sid":87723,
   "traitType":"SEGMENT",
   "startDate":"2012-07-04",
   "traitAlias":"123"
}

Risposta

{
   "destinationMappingId":65341,
   "traitType":"SEGMENT",
   "traitValue":0,
   "destinationId":566,
   "elementName":"Sample",
   "elementDescription":"",
   "elementStatus":"active",
   "createTime":1338942118000,
   "updateTime":1338942118000,
   "crUID":308,
   "upUID":308,
   "sid":84326,
   "startDate":"2012-07-03",
   "endDate":null,
   "priority":null,
   "traitAlias":"123"
}

Creazione in blocco di mappature di destinazione

Un metodo POST che consente di passare una matrice di mappature di destinazione cookie o URL.

Richiesta

POST https://api.demdex.com/v1/destinations/<destinationId>/bulk-create

Richiesta di esempio

Tutti i valori della richiesta sono obbligatori, salvo diversa indicazione.

[
{
   "sid": 105123,
   "traitType":"SEGMENT",
   "url":"https://adobe.com",
   "startDate":"2012-11-20"
},
{
   "sid": 121070,
   "traitType":"SEGMENT",
   "url":"https://my.adobeconnect.com",
   "startDate":"2012-11-21"
}
]

Risposta

Una risposta corretta restituisce l’array delle mappature create.

[
    {
        "mappingId": 103454,
        "traitType": "SEGMENT",
        "traitValue": 0,
        "destinationId": 780,
        "elementName": "Case of the Mondays",
        "elementDescription": "test",
        "elementStatus": "active",
        "createTime": 1353373234000,
        "updateTime": 1353373234000,
        "crUID": 1065,
        "upUID": 1065,
        "sid": 105123,
        "startDate": "2012-11-19",
        "endDate": null,
        "priority": null,
        "url": "https://adobe.com",
        "secureUrl": null,
        "tagCode": null,
        "secureTagCode": null,
        "traitAlias": null
    },
    {
        "mappingId": 103455,
        "traitType": "SEGMENT",
        "traitValue": 0,
        "orderId": 780,
        "elementName": "Test Trait",
        "elementDescription": "This trait",
        "elementStatus": 1,
        "createTime": 1353373234000,
        "updateTime": 1353373234000,
        "crUID": 1065,
        "upUID": 1065,
        "sid": 121070,
        "startDate": "2012-11-20",
        "endDate": null,
        "priority": null,
        "url": "https://my.adobeconnect.com",
        "secureUrl": null,
        "tagCode": null,
        "secureTagCode": null,
        "traitAlias": null
    }
]

Aggiungere più segmenti a una destinazione

Un metodo POST che consente di mappare più segmenti su una destinazione.

Richiesta

POST https://api.demdex.com/v1/destinations/<destinationId>bulk-create

Richiesta di esempio

Crea più mappature di destinazione in un array. Tutti i valori della richiesta sono obbligatori, salvo diversa indicazione.

[
{
   "sid": 105123,
   "traitType":"SEGMENT",
   "url":"https://adobe.com",
   "startDate":"2012-11-20"
},
{
   "sid": 121070,
   "traitType":"SEGMENT",
   "url":"https://my.adobeconnect.com",
   "startDate":"2012-11-21"
}
]

Risposta

Restituisce una matrice di mappature create.

[
    {
        "destinationMappingId": 103454,
        "traitType": "SEGMENT",
        "traitValue": 0,
        "destinationId": 780,
        "elementName": "Case of the Mondays",
        "elementDescription": "test",
        "elementStatus": "active",
        "createTime": 1353373234000,
        "updateTime": 1353373234000,
        "crUID": 1065,
        "upUID": 1065,
        "sid": 105123,
        "startDate": "2012-11-19",
        "endDate": null,
        "priority": null,
        "url": "https://adobe.com",
        "secureUrl": null,
        "tagCode": null,
        "secureTagCode": null,
        "traitAlias": null
    },
    {
        "traitToDataOrderId": 103455,
        "traitType": "SEGMENT",
        "traitValue": 0,
        "destinationId": 780,
        "elementName": "Test Trait",
        "elementDescription": "This trait",
        "elementStatus": 1,
        "createTime": 1353373234000,
        "updateTime": 1353373234000,
        "crUID": 1065,
        "upUID": 1065,
        "sid": 121070,
        "startDate": "2012-11-20",
        "endDate": null,
        "priority": null,
        "url": "https://my.adobeconnect.com",
        "secureUrl": null,
        "tagCode": null,
        "secureTagCode": null,
        "traitAlias": null
    }
]

Aggiornare una destinazione per ID destinazione

Un metodo PUT che consente di aggiornare una destinazione esistente per destinationId.

Richiesta

PUT https://api.demdex.com/v1/destinations/<destinationId>

Richiesta di esempio

Tutti i valori della richiesta sono obbligatori, salvo diversa indicazione.

{
   "name":"Updated URL Destination (not serialized)",
   "description":"new description",
   "destinationType":"PUSH",
   "serializationEnabled":false
}

Risposta

{
    "destinationType": "PUSH",
    "destinationId": 780,
    "dataSourceId": null,
    "pid": 1099,
    "name": "Updated URL Destination (not serialized)",
    "description": "new description",
    "startDate": null,
    "endDate": null,
    "status": 1,
    "createTime": 1348851790000,
    "updateTime": 1353372029000,
    "crUID": 884,
    "upUID": 1065,
    "domainRestrictions":"all_domains",
    "tagType": 0,
    "serializationEnabled": false,
    "urlFormatString": null,
    "secureUrlFormatString": null,
    "delimiter": null,
    "mappings": null
}

Aggiornare una mappatura a una destinazione mappando l’ID

Un metodo PUT che consente di aggiornare una mappatura a una destinazione in base al mappingId specificato.

Richiesta

PUT https://api.demdex.com/v1/destinations/mappings/<mappingId>

Richiesta di esempio

Tutti i valori della richiesta sono obbligatori, salvo diversa indicazione.

{
   "sid": 105123,
   "traitType":"SEGMENT",
   "url":"https://adobe.com",
   "startDate":"2012-11-20"
}

Risposta

{
    "mappingId": 103453,
    "traitType": "SEGMENT",
    "traitValue": 0,
    "destinationId": 780,
    "elementName": "sample",
    "elementDescription": "test",
    "elementStatus": "active",
    "createTime": 1353373005000,
    "updateTime": 1353373005000,
    "crUID": 1065,
    "upUID": 1065,
    "sid": 105123,
    "startDate": "2012-11-19",
    "endDate": null,
    "priority": null,
    "url": "https://www.adobe.com/send?%ALIAS%",
    "secureUrl": null,
    "tagCode": null,
    "secureTagCode": null,
    "traitAlias": null
}