Erstellen von Zielen
- Themen:
- API
Erstellen Sie Ziele mit diesen RESTful API.
Unterstützte Zieltypen: nur URL und Cookie
Mit den verfügbaren POST können Sie nur URL und cookie destinations erstellen. Derzeit können Sie mit diesen REST API Methoden keine server-to-server destinations erstellen. Mit den zugehörigen Ziel-GET-Methoden 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. Alle Anfragewerte sind erforderlich, sofern nicht anders angegeben.
{
"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 mit einem einzelnen Schlüssel verknüpfte Werte akzeptiert (z. B. color=blue, red, green).
Anfrage
POST https://api.demdex.com/v1/destinations/
Beispielanforderung
Geben Sie den sicheren URL und das Trennzeichen für das Schlüssel-Wert-Paar an, das an das Ziel übergeben wird. Alle Anfragewerte sind erforderlich, sofern nicht anders angegeben.
{
"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 einer erfolgreichen 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 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
Alle Anfragewerte sind erforderlich, sofern nicht anders angegeben.
{
"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 einer erfolgreichen 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 mit einem einzelnen Schlüssel verknüpfte Werte akzeptiert (z. B. color=blue, red, green).
Anfrage
POST https://api.demdex.com/v1/destinations/
Beispielanforderung
Alle Anfragewerte sind erforderlich, sofern nicht anders angegeben.
{
"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 einer erfolgreichen 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: Mehrschlüssel, 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
Alle Anfragewerte sind erforderlich, sofern nicht anders angegeben.
{
"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 einer erfolgreichen 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: Mehrschlüssel, 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
Alle Anfragewerte sind erforderlich, sofern nicht anders angegeben.
{
"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 einer erfolgreichen 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
}