DocumentaciónAudience ManagerGuía del usuario de Audience Manager

Devolver un destino por ID de destino return-a-destination-by-destination-id

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Un método GET que devuelve el destino del destinationId especificado.

Solicitud

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

NOTE
Para rellenar el campo mappings, pase includeMappings=true en la dirección URL.

Respuesta

{
   "destinationType":"PUSH",
   "destinationId":314,
   "dataSourceId":null,
   "pid":1099,
   "name":"sample destination",
   "description":"Turn",
   "startDate":null,
   "endDate":null,
   "status":"active",
   "destinationType":"PUSH",
   "createTime":1281997484000,
   "updateTime":1300752888000,
   "crUID":224,
   "upUID":308,
   "domainRestrictions":"ALL_DOMAINS",
   "tagType":0,
   "serializationEnabled":false,
   "urlFormatString":null,
   "secureUrlFormatString":null,
   "delimiter":null,
   "mappings":null
}

Devolver todos los destinos return-all-destinations

Un método GET que devuelve todos los destinos del socio especificado.

Solicitud

GET https://api.demdex.com/v1/destinations

NOTE

  • (Opcional) Pase containsSegment=<sid> para devolver una matriz de todos los destinos asignados al segmento especificado. Por ejemplo, su consulta podría tener un aspecto similar al siguiente: GET .../destinations/?containsSegment=4321.

  • No devuelve el objeto de destino completo. Obtenga el destino por orden de datos si necesita un objeto completamente rellenado.

Parámetros de consulta opcionales

Puede utilizar estos parámetros opcionales con métodos API que devuelven todas las propiedades de un objeto. Establezca estas opciones en la cadena de solicitud al pasar esa consulta al API. Consulte Parámetros opcionales.

Parámetro
Descripción
page
Devuelve los resultados por número de página. La numeración comienza en 0.
pageSize
Establece el número de resultados de respuesta que devuelve la solicitud (10 es el valor predeterminado).
sortBy
Ordena y devuelve los resultados según la propiedad JSON especificada.
descending
Ordena y devuelve los resultados en orden descendente. Ascendente es el valor predeterminado.
search

Devuelve los resultados en función de la cadena especificada que desee utilizar como parámetro de búsqueda. Por ejemplo, supongamos que desea buscar resultados para todos los modelos que tienen la palabra "Test" en cualquiera de los campos de valor de ese elemento. La solicitud de ejemplo podría tener este aspecto:

GET https://api.demdex.com/v1/models/?search=Test.

Puede buscar cualquier valor devuelto mediante el método "get all".

Respuesta

[
   {
      "destinationId":364,
      "pid":1099,
      "name":"Test",
      "description":"",
      "status":"active",
      "destinationType":"PUSH",
      "createTime":1291345192000,
      "updateTime":1291347561000,
      "crUID":262,
      "upUID":262,
      "domainRestrictions":"all_domains"
   },
   {
      "destinationId":369,
      "pid":1099,
      "name":"sample destination",
      "status":"active",
      "destinationType":"PUSH",
      "createTime":1292631706000,
      "updateTime":1292631706000,
      "crUID":262,
      "upUID":262,
      "domainRestrictions":"all_domains"
   }
]

Devolver una asignación de destino con el ID de asignación return-dest-mapping-id

Un método GET que devuelve una asignación de destino individual basada en mappingId.

Solicitud

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

Respuesta

{
"mappingId": 14593,
"traitType": "SEGMENT",
"traitValue": 0,
"destinationId": 314,
"elementName": "sample",
"elementDescription": "Migration Pixel",
"elementStatus": "active",
"createTime": 1281997484000,
"updateTime": 1300752888000,
"crUID": 224,
"upUID": 308,
"sid": 80920,
"startDate": "2010-11-15",
"endDate": null,
"priority": null,
"url": "https://www.adobe.com/send?%ALIAS%",
"secureUrl": "https://www.adobe.com/send?%ALIAS%",
"tagCode": null,
"secureTagCode": null,
"traitAlias": null
}

Devolver asignaciones de destino return-dest-mappings

Un método GET que devuelve las asignaciones para un destino.

NOTE
La asignación devuelta es específica para el tipo de destino y la configuración.

Solicitud

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

NOTE
Admite parámetros de paginación.

Respuesta

{
   "total":354,
   "page":0,
   "pageSize":2,
   "list":[
      {
         "destinationMappingId":14395,
         "traitType":"SEGMENT",
         "traitValue":0,
         "destinationId":314,
         "elementName":"sample pixel",
         "elementDescription":"Migration Pixel",
         "elementStatus":"active",
         "createTime":1281997484000,
         "updateTime":1300752888000,
         "crUID":224,
         "upUID":308,
         "sid":80920,
         "startDate":"2010-11-15",
         "endDate":null,
         "priority":null,
         "url":"https://www.adobe.com/send?%ALIAS%",
         "secureUrl":"https://www.adobe.com/send?%ALIAS%",
         "tagCode":null,
         "secureTagCode":null,
         "traitAlias":null
      }
      {
         "destinationMappingId":15934,
         "traitType":"SEGMENT",
         "traitValue":0,
         "destinationId":314,
         "elementName":"sample pixel",
         "elementDescription":"Migration Pixel",
         "elementStatus":"active",
         "createTime":1281997484000,
         "updateTime":1300752888000,
         "crUID":242,
         "upUID":803,
         "sid":90820,
         "startDate":"2010-11-15",
         "endDate":null,
         "priority":null,
         "url":"https://www.adobe.com/send?%ALIAS%",
         "secureUrl":"https://www.adobe.com/send?%ALIAS%",
         "tagCode":null,
         "secureTagCode":null,
         "traitAlias":null
      }
   ]
{

Devolver todas las plataformas de destino disponibles return-dest-platforms

Un método GET que devuelve todas las plataformas de dispositivo disponibles para los destinos.

Solicitud

GET /destinations/configurations/available-platforms/

Respuesta

[
BROWSER, ANDROID, iOS, ALL
]

Devolver historial de trabajos de destino de S2S y Bulk S2S return-job-history

Un método GET que devuelve información de historial de trabajo de destino saliente Server-to-Server ( S2S) y masiva S2S.

Solicitud

GET https://api.demdex.com/v1/destinations/655/history/outbound?startDate=1000000000&endDate=1403034473000

Parámetros de consulta requeridos: startDate = <epochtime> y endDate = <epochtime>.

Respuesta

[
{
      "pushID":34090,
      "orderID":655,
      "dataProviderID":269,
      "syncType":1,
      "fullPublish":false,
      "receivedRecords":1,
      "attemptedRecords":1,
      "successRecords":1,
      "startTime":1337292466000,
      "endTime":1337292466000,
      "dataFileName":"ftp_655_269_iter_1337229891903.sync",
      "success":true
   },
   {
      "pushID":34104,
      "orderID":655,
      "dataProviderID":269,
      "syncType":1,
      "fullPublish":false,
      "receivedRecords":1,
      "attemptedRecords":1,
      "successRecords":1,
      "startTime":1337346397000,
      "endTime":1337346397000,
      "dataFileName":"ftp_655_269_iter_1337285714581.sync",
      "success":true
   },
   {
      "pushID":34124,
      "orderID":655,
      "dataProviderID":269,
      "syncType":1,
      "fullPublish":false,
      "receivedRecords":1,
      "attemptedRecords":1,
      "successRecords":1,
      "startTime":1337396811000,
      "endTime":1337396812000,
      "dataFileName":"ftp_655_269_iter_1337338243600.sync",
      "success":true
   }
]
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695