Documentation Audience Manager Guide d’utilisation d’Audience Manager

Renvoi d’une destination par un ID de destination return-a-destination-by-destination-id

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

Rubriques :
API

Une méthode GET qui renvoie la destination pour le destinationId spécifié.

Requête

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

NOTE

Pour renseigner le champ mappings transmis dans includeMappings=true dans l’URL.

Réponse

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

Renvoie toutes les destinations return-all-destinations

Une méthode GET qui renvoie toutes les destinations pour le partenaire spécifié.

Requête

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

NOTE

(Facultatif) Transmettez containsSegment=<sid> pour renvoyer un tableau de toutes les destinations mappées au segment spécifié. Par exemple, votre requête peut ressembler à ceci : GET .../destinations/?containsSegment=4321.
Ne renvoie pas l’objet de destination complet. Obtenez la destination selon l’ordre des données si vous avez besoin d’un objet entièrement renseigné.

Paramètres de requête facultatifs

Vous pouvez utiliser ces paramètres facultatifs avec des méthodes API qui renvoient les propriétés all pour un objet. Définissez ces options dans la chaîne de requête lors de la transmission de cette requête à API. Voir Paramètres facultatifs.

Paramètre

Description

page

Renvoie les résultats par numéro de page. La numérotation commence à 0.

pageSize

Définit le nombre de résultats de réponse renvoyés par la requête (10 est la valeur par défaut).

sortBy

Trie et renvoie les résultats en fonction de la propriété JSON spécifiée.

descending

Trie et renvoie les résultats dans l’ordre décroissant. La valeur ascendante est la valeur par défaut.

search

Renvoie des résultats en fonction de la chaîne spécifiée que vous souhaitez utiliser comme paramètre de recherche. Par exemple, supposons que vous souhaitiez trouver des résultats pour tous les modèles ayant le mot "Test" dans l’un des champs de valeur de cet élément. Votre exemple de requête peut ressembler à ceci :

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

Vous pouvez effectuer une recherche sur n’importe quelle valeur renvoyée par une méthode "get all".

Réponse

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

Renvoi d’un mappage de destination avec l’ID de mappage return-dest-mapping-id

Une méthode GET qui renvoie un mappage de destination individuel basé sur mappingId.

Requête

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

Réponse

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

Mappages de destination des retours return-dest-mappings

Une méthode GET qui renvoie les mappages pour une destination.

NOTE

Le mappage renvoyé est spécifique au type et à la configuration de destination.

Requête

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

NOTE

Prend en charge les paramètres de pagination.

Réponse

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

Renvoie toutes les plateformes de destination disponibles return-dest-platforms

Une méthode GET qui renvoie toutes les plateformes d’appareils disponibles pour les destinations.

Requête

GET /destinations/configurations/available-platforms/

Réponse

[
BROWSER, ANDROID, iOS, ALL
]

Renvoi de l’historique des tâches de destination S2S et S2S en bloc return-job-history

Une méthode GET qui renvoie les informations d’historique des tâches de destination Server-to-Server sortantes ( S2S) et S2S en masse.

Requête

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

Paramètres de requête requis : startDate = <epochtime> et endDate = <epochtime>.

Réponse

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