Dokumentation Audience Manager Benutzerhandbuch für Audience Manager

API-Methoden für die Domain-Verwaltung

Letzte Aktualisierung: 20. Dezember 2024

Themen:
API

Methoden der Domain-Verwaltung, mit denen Sie die Domains erstellen und verwalten können, an die Sie Daten senden möchten (nur für Cookie-Ziele).

Erstellen einer neuen Domain

Eine POST Methode zum Erstellen einer neuen Domain (nur für Cookie-Ziele).

Anfrage

POST https://api.demdex.com/v1/partner-sites/

Beispielanforderung

{
   "url":"example1.com"
}

Antwort

Bei einer erfolgreichen Antwort werden 201 created und die Partner-Site zurückgegeben, einschließlich ihrer eindeutigen ID.

{
    "pid": 1111,
    "siteId": 111,
    "url": "example1.com"
}

Löschen einer Domain

Eine DELETE Methode zum Entfernen einer Domain (nur für Cookie-Ziele).

Anfrage

DELETE https://api.demdex.com/v1/partner-sites/<site-Id>

Antwort

Eine erfolgreiche Antwort gibt 204 no content zurück. Gibt 404 not found zurück, wenn die Partnerseite nicht gefunden werden kann.

Zurückgeben von Eigenschaften für eine Domain

Eine GET Methode, die Details zur angegebenen Domain zurückgibt (nur für Cookie-Ziele).

Anfrage

GET https://api.demdex.com/v1/partner-sites/<siteId>

Antwort

Eine erfolgreiche Antwort gibt 200 OK und Daten zurück, wie im folgenden Beispiel gezeigt. Gibt 404 Not found zurück, wenn die Site-ID oder der Partner nicht gefunden wurde.

{
    "pid": 1111,
    "siteId": 111,
    "url": "example1.com"
}

Eigenschaften für alle Domains zurückgeben

Eine GET Methode, die Informationen zu all Ihren Domains zurückgibt (nur für Cookie-Ziele).

Anfrage

GET https://api.demdex.com/v1/partner-sites/

Optionale Abfrageparameter

Sie können diese optionalen Parameter mit API Methoden verwenden, die alle-Eigenschaften für ein Objekt zurückgeben. Legen Sie diese Optionen in der Anforderungszeichenfolge fest, wenn Sie diese Abfrage an den API übergeben. Siehe Optionale Parameter.

Parameter

Beschreibung

page

Gibt Ergebnisse nach Seitenzahl zurück. Nummerierung beginnt bei 0.

pageSize

Legt die Anzahl der von der Anfrage zurückgegebenen Antwortergebnisse fest (10 ist der Standardwert).

sortBy

Sortiert Ergebnisse entsprechend der angegebenen JSON-Eigenschaft und gibt sie zurück.

descending

Sortiert die Ergebnisse in absteigender Reihenfolge und gibt sie zurück. Aufsteigend ist Standard.

search

Gibt Ergebnisse basierend auf der angegebenen Zeichenfolge zurück, die Sie als Suchparameter verwenden möchten. Angenommen, Sie möchten Ergebnisse für alle Modelle finden, die das Wort „Test“ in einem der Wertefelder für dieses Element enthalten. Ihre Beispielanfrage könnte wie folgt aussehen:

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

Sie können nach jedem Wert suchen, der von einer „get all“-Methode zurückgegeben wird.

Antwort

Eine erfolgreiche Antwort gibt 200 OK und Daten in einem Array zurück, wie im folgenden Beispiel gezeigt. Gibt 404 Not found zurück, wenn die Site-ID oder der Partner nicht gefunden wurde.

[
    {
        "pid": 1111,
        "siteId": 111,
        "url": "example1.com"
    },
    {
        "pid": 2222,
        "siteId": 222,
        "url": "example2.com"
    },
    {
        "pid": 3333,
        "siteId": 333,
        "url": "example3.com"
    }
]

recommendation-more-help