Erstellen von Zielen

Erstellen Sie Ziele mit diesen RESTful API -Methoden.

Unterstützte Zieltypen: Nur URL und Cookie

Mit den verfügbaren POST-Methoden können Sie URL und cookie destinations nur erstellen. Derzeit können Sie server-to-server destinations nicht mit diesen REST API -Methoden erstellen. Mit den zugehörigen Zielmethoden GET können Sie jedoch Informationen zu server-to-server destinations abrufen, die in der Benutzeroberfläche erstellt wurden.

Erstellen eines nicht seriellen URL-Ziels

Eine POST -Methode, mit der Sie ein Ziel erstellen können, das Segmente akzeptiert, die aus einzelnen Schlüssel-Wert-Paaren bestehen (z. B. gender=male oder gender=female).

Anfrage

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

Beispielanforderung

Diese Anfrage erstellt ein einzelnes Ziel. Sofern nicht anders angegeben, sind alle Anfragewerte erforderlich.

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

Antwort

Eine erfolgreiche Anfrage gibt 201 created und das Ziel zurück.

{
   "destinationType":"PUSH",
   "destinationId":4033,
   "dataSourceId":null,
   "pid":1099,
   "name":"Sample URL Destination (not serialized)",
   "description":"",
   "startDate":null,
   "endDate":null,
   "status":"ACTIVE",
   "destinationType":"PUSH",
   "createTime":1338937116000,
   "updateTime":1338937116000,
   "crUID":694,
   "upUID":694,
   "domainRestrictions":"all_domains",
   "tagType":0,
   "serializationEnabled":false,
   "urlFormatString":"https://www.adobe.com/send?%ALIAS%",
   "secureUrlFormatString":"https://www.adobe.com/send?%ALIAS%",
   "delimiter":null,
   "mappings":null
}

Erstellen eines serialisierten URL-Ziels

Eine POST -Methode, mit der Sie ein Ziel erstellen können, das mehrere Werte akzeptiert, die mit einem einzelnen Schlüssel verknüpft sind (z. B. color=blue, red, green).

Anfrage

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

Beispielanforderung

Geben Sie das sichere URL und Trennzeichen für das Schlüssel-Wert-Paar an, das an das Ziel übergeben wird. Sofern nicht anders angegeben, sind alle Anfragewerte erforderlich.

{
   "name":"Sample URL Destination (Serialized)",
   "description":"",
   "destinationType":"PUSH",
   "serializationEnabled":true,
   "urlFormatString":"https://www.adobe.com/send?data=%ALIAS%",
   "secureUrlFormatString":"https://www.adobe.com/%ALIAS%",
   "delimiter":","
}

Antwort

Bei erfolgreicher Aktualisierung werden der Antwort-Code 201 created und das Ziel zurückgegeben.

{
   "destinationType":"PUSH",
   "destinationId":4034,
   "dataSourceId":null,
   "pid":1099,
   "name":"Sample URL Destination (Serialized)",
   "description":"",
   "startDate":null,
   "endDate":null,
   "status":"active",
   "destinationType":"PUSH",
   "createTime":1338937420000,
   "updateTime":1338937420000,
   "crUID":694,
   "upUID":694,
   "domainRestrictions":"all_domains",
   "tagType":0,
   "serializationEnabled":true,
   "urlFormatString":"https://www.adobe.com/send?%ALIAS%",
   "secureUrlFormatString":"https://www.adobe.com/%ALIAS%",
   "delimiter":"-",
   "mappings":null
}

Erstellen eines Cookie-Ziels: Einzelschlüssel, nicht serialisiert

Eine POST -Methode, mit der Sie eine cookie destination-Methode erstellen können, die Segmente akzeptiert, die aus einzelnen Schlüssel-Wert-Paaren bestehen (z. B. gender=male oder gender=female).

Anfrage

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

Beispielanforderung

Sofern nicht anders angegeben, sind alle Anfragewerte erforderlich.

{
   "name":"Cookie Destination Single Key Not Serialized",
   "destinationType":"ADS",
   "adServerTypeID":1,
   "cookieName":"adobe",
   "cnameDomain":"adobe.com",
   "maxSize":"2048",
   "ttl":"0",
   "domainRestrictions":"inclusion",
   "siteIDs":[
      312
   ],
   "formatType":"single_key",
   "singleKey":"key",
   "keySeparator":"=",
   "valueSeparator":",",
   "serializationEnabled":false
}

Antwort

Bei erfolgreicher Aktualisierung werden der Antwort-Code 201 created und das Ziel zurückgegeben.

{
   "destinationType":"ADS",
   "destinationId":4035,
   "pid":1099,
   "name":"Cookie Destination Single Key Not Serialized",
   "status":"active",
   "destinationType":"ADS",
   "createTime":1338937984000,
   "updateTime":1338937984000,
   "crUID":694,
   "upUID":694,
   "domainRestrictions":"inclusion",
   "cnameDomain":"adobe.com",
   "cookieName":"adobe",
   "singleKey":"key",
   "keySeparator":"=",
   "valueSeparator":",",
   "formatType":"single_key",
   "transferMethod":0,
   "serializationEnabled":false,
   "maxSize":2048,
   "ttl":0,
   "siteIDs":[
      312
   ],
   "uparamEnabled":false
}

Erstellen eines Cookie-Ziels: Einzelschlüssel, serialisiert

Eine POST -Methode, mit der Sie ein Ziel erstellen können, das mehrere Werte akzeptiert, die mit einem einzelnen Schlüssel verknüpft sind (z. B. color=blue, red, green).

Anfrage

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

Beispielanforderung

Sofern nicht anders angegeben, sind alle Anfragewerte erforderlich.

{
   "name":"Cookie Destination Single Key Serialized",
   "destinationType":"ADS",
   "adServerTypeID":1,
   "cookieName":"adobe",
   "cnameDomain":"adobe.com",
   "maxSize":"2048",
   "ttl":"0",
   "domainRestrictions":"all_domains",
   "siteIDs":[

   ],
   "formatType":"single_key",
   "singleKey":"k",
   "keySeparator":"=",
   "valueSeparator":",",
   "serializationEnabled":true,
   "serializationSeparator":"#"
}

Antwort

Bei erfolgreicher Aktualisierung werden der Antwort-Code 201 created und das Ziel zurückgegeben.

{
   "destinationType":"ADS",
   "destinationId":4036,
   "pid":1099,
   "name":"Cookie Destination Single Key Serialized",
   "status":"active",
   "destinationType":"ADS",
   "createTime":1338938329000,
   "updateTime":1338938329000,
   "crUID":694,
   "upUID":694,
   "domainRestrictions":"all_domains",
   "cnameDomain":"adobe.com",
   "cookieName":"adobe",
   "singleKey":"k",
   "keySeparator":"=",
   "valueSeparator":",",
   "formatType":"single_key",
   "transferMethod":0,
   "serializationEnabled":true,
   "serializationSeparator":"#",
   "maxSize":2048,
   "ttl":0,
   "siteIDs":[

   ],
   "uparamEnabled":false
}

Erstellen eines Cookie-Ziels: Multi-Key, nicht serialisiert

Eine POST -Methode, mit der Sie ein Ziel erstellen können, das Segmente akzeptiert, die mehrere Schlüssel mit unterschiedlichen Werten enthalten (z. B. gender=male; gender=female; color=blue; color=red).

Anfrage

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

Beispielanforderung

Sofern nicht anders angegeben, sind alle Anfragewerte erforderlich.

{
   "name":"Ad Server Multi-Key Not Serialized",
   "destinationType":"ADS",
   "adServerTypeID":1,
   "cookieName":"adobe",
   "cnameDomain":"adobe.com",
   "maxSize":"2048",
   "ttl":"0",
   "domainRestrictions":"all_domains",
   "siteIDs":[

   ],
   "formatType":"key_value",
   "keySeparator":"=",
   "valueSeparator":",",
   "serializationEnabled":false
}

Antwort

Bei erfolgreicher Aktualisierung werden der Antwort-Code 201 created und das Ziel zurückgegeben.

{
   "destinationType":"ADS",
   "destinationId":4037,
   "pid":1099,
   "name":"Ad Server Multi-Key Not Serialized",
   "status":1,
   "destinationType":"ADS",
   "createTime":1338938666000,
   "updateTime":1338938666000,
   "crUID":694,
   "upUID":694,
   "domainRestrictions":"all_domains",
   "cnameDomain":"adobe.com",
   "cookieName":"adobe",
   "keySeparator":"=",
   "valueSeparator":",",
   "formatType":"key_value",
   "transferMethod":0,
   "serializationEnabled":false,
   "maxSize":2048,
   "ttl":0,
   "siteIDs":[

   ],
   "uparamEnabled":false
}

Erstellen eines Cookie-Ziels: Multi-Key, serialisiert

Eine POST -Methode, mit der Sie ein Ziel erstellen können, das Segmente akzeptiert, die mehrere Schlüssel und Werte enthalten (z. B. gender=male, female; color=blue, red, green).

Anfrage

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

Beispielanforderung

Sofern nicht anders angegeben, sind alle Anfragewerte erforderlich.

{
   "name":"Cookie Destination Multi-Key Serialized",
   "destinationType":"ADS",
   "adServerTypeID":1,
   "cookieName":"adobe",
   "cnameDomain":"adobe.com",
   "maxSize":"2048",
   "ttl":"0",
   "domainRestrictions":"all_domains",
   "siteIDs":[

   ],
   "formatType":"key_value",
   "keySeparator":"=",
   "valueSeparator":",",
   "serializationEnabled":true,
   "serializationSeparator":"#"
}

Antwort

Bei erfolgreicher Aktualisierung werden der Antwort-Code 201 created und das Ziel zurückgegeben.

{
   "destinationType":"ADS",
   "destinationId":4038,
   "pid":1099,
   "name":"Ad Server Multi-Key Serialized",
   "status":"active",
   "destinationType":"ADS",
   "createTime":1338938872000,
   "updateTime":1338938872000,
   "crUID":694,
   "upUID":694,
   "domainRestrictions":"all_domains",
   "cnameDomain":"adobe.com",
   "cookieName":"adobe",
   "keySeparator":"=",
   "valueSeparator":",",
   "formatType":"key_value",
   "transferMethod":0,
   "serializationEnabled":true,
   "serializationSeparator":"#",
   "maxSize":2048,
   "ttl":0,
   "siteIDs":[

   ],
   "uparamEnabled":false
}