Documentação Audience Manager Guia do usuário do Audience Manager

Retornar um destino por ID de destino

Última atualização: 20 de julho de 2024

Tópicos:
API

Um método GET que retorna o destino do destinationId especificado.

Solicitação

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

NOTE

Para preencher a passagem de campo mappings em includeMappings=true na URL.

Resposta

{
   "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
}

Retornar todos os destinos

Um método GET que retorna todos os destinos para o parceiro especificado.

Solicitação

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

NOTE

(Opcional) Transmita em containsSegment=<sid> para retornar uma matriz de todos os destinos mapeados para o segmento especificado. Por exemplo, sua consulta pode ser semelhante a esta: GET .../destinations/?containsSegment=4321.
Não retorna o objeto de destino completo. Obtenha o destino por ordem de dados se precisar de um objeto totalmente preenchido.

Parâmetros de consulta opcionais

Você pode usar esses parâmetros opcionais com métodos de API que retornam todas as propriedades de um objeto. Defina essas opções na cadeia de caracteres de solicitação ao passar essa consulta para o API. Consulte Parâmetros Opcionais.

Parâmetro

Descrição

page

Retorna resultados por número de página. A numeração começa em 0.

pageSize

Define o número de resultados de resposta retornados pela solicitação (10 é o padrão).

sortBy

Classifica e retorna resultados de acordo com a propriedade JSON especificada.

descending

Classifica e retorna resultados em ordem decrescente. Crescente é o padrão.

search

Retorna resultados com base na cadeia de caracteres especificada que você deseja usar como parâmetro de pesquisa. Por exemplo, digamos que você queira encontrar resultados para todos os modelos que têm a palavra "Teste" em qualquer um dos campos de valor para esse item. Seu exemplo de solicitação pode ser semelhante a:

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

Você pode pesquisar qualquer valor retornado por um método "get all".

Resposta

[
   {
      "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"
   }
]

Retornar um mapeamento de destino com a ID de mapeamento

Um método GET que retorna um mapeamento de destino individual com base no mappingId.

Solicitação

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

Resposta

{
"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
}

Mapeamentos de destino de retorno

Um método GET que retorna os mapeamentos para um destino.

NOTE

O mapeamento retornado é específico para o tipo e a configuração de destino.

Solicitação

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

NOTE

Suporta parâmetros de paginação.

Resposta

{
   "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
      }
   ]
{

Retornar todas as plataformas de destino disponíveis

Um método GET que retorna todas as plataformas de dispositivo disponíveis para destinos.

Solicitação

GET /destinations/configurations/available-platforms/

Resposta

[
BROWSER, ANDROID, iOS, ALL
]

Retornar Histórico de Trabalhos de Destino S2S e S2S em Massa

Um método GET que retorna informações de histórico de trabalho de destino Server-to-Server de saída ( S2S) e em massa S2S.

Solicitação

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

Parâmetros de consulta obrigatórios: startDate = <epochtime> e endDate = <epochtime>.

Resposta

[
{
      "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