Endpunkt der Marketing-Aktionen

Eine Marketing-Aktion bezeichnet im Kontext der Adobe Experience Platform Data Governance eine Aktion, die ein Datennutzer von Experience Platform ergreift und bei der geprüft werden muss, ob gegen Datennutzungsrichtlinien verstoßen wurde.

Sie können Marketing-Aktionen für Ihr Unternehmen mithilfe des /marketingActions-Endpunkts in der Richtlinien-Service-API verwalten.

Erste Schritte

Die in diesem Handbuch verwendeten API-Endpunkte sind Teil der Policy Service -API. Bevor Sie fortfahren, lesen Sie im Handbuch Erste Schritte die Links zu entsprechenden Dokumentationen, den Leitfaden zum Lesen der Beispiel-API-Aufrufe in diesem Dokument und wichtige Informationen zu Kopfzeilen, die für das erfolgreiche Aufrufen einer Experience Platform-API erforderlich sind.

Abrufen einer Liste von Marketing-Aktionen list

Sie können eine Liste von Kern- oder benutzerspezifischen Marketing-Aktionen abrufen, indem Sie eine GET-Anfrage an /marketingActions/core oder /marketingActions/custom senden.

API-Format

GET /marketingActions/core
GET /marketingActions/custom

Anfrage

Die folgende Anfrage ruft eine Liste von benutzerspezifischen Marketing-Aktionen ab, die von Ihrem Unternehmen verwaltet werden.

curl -X GET \
  https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Antwort

Eine erfolgreiche Antwort gibt die Details für jede abgerufene Marketing-Aktion zurück, einschließlich name und href. Der Wert href wird beim Erstellen einer Datennutzungsrichtlinie zur Identifizierung der Marketing-Aktion verwendet.

{
    "_page": {
        "count": 2
    },
    "_links": {
        "page": {
            "href": "https://platform.adobe.io/marketingActions/custom?{?limit,start,property}",
            "templated": true
        }
    },
    "children": [
        {
            "name": "sampleMarketingAction",
            "description": "Marketing Action description.",
            "imsOrg": "{ORG_ID}",
            "created": 1550714012088,
            "createdClient": "string",
            "createdUser": "string",
            "updated": 1550714012088,
            "updatedClient": "string",
            "updatedUser": "string",
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/sampleMarketingAction"
                }
            }
        },
        {
            "name": "newMarketingAction",
            "description": "Another marketing action.",
            "imsOrg": "{ORG_ID}",
            "created": 1550793833224,
            "createdClient": "string",
            "createdUser": "string",
            "updated": 1550793833224,
            "updatedClient": "string",
            "updatedUser": "string",
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/newMarketingAction"
                }
            }
        }
    ]
}

Suchen Sie nach einer bestimmten Marketing-Aktion lookup

Sie können die Details einer bestimmten Marketing-Aktion nachschlagen, indem Sie die name-Eigenschaft der Marketing-Aktion in den Pfad einer GET-Anfrage aufnehmen.

API-Format

GET /marketingActions/core/{MARKETING_ACTION_NAME}
GET /marketingActions/custom/{MARKETING_ACTION_NAME}

Anfrage

Die folgende Anfrage ruft eine benutzerdefinierte Marketing-Aktion mit dem Namen combineData ab.

curl -X GET \
  https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/combineData \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Antwort

Das Antwortobjekt enthält die Details zur Marketing-Aktion, einschließlich des Pfads (_links.self.href), der beim Definieren einer Datenverwendungsrichtlinie zum Verweisen auf die Marketing-Aktion benötigt wird (marketingActionsRefs).

{
    "name": "combineData",
    "description": "Combine multiple data sources together.",
    "imsOrg": "{ORG_ID}",
    "created": 1550793805590,
    "createdClient": "string",
    "createdUser": "string",
    "updated": 1550793805590,
    "updatedClient": "string",
    "updatedUser": "string",
    "_links": {
        "self": {
            "href": "https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/combineData"
        }
    }
}

Erstellen oder aktualisieren einer benutzerspezifischen Marketing-Aktion create-update

Sie können eine neue benutzerspezifische Marketing-Aktion erstellen oder eine vorhandene aktualisieren, indem Sie den vorhandenen oder beabsichtigten Namen der Marketing-Aktion in den Pfad einer PUT-Anfrage aufnehmen.

API-Format

PUT /marketingActions/custom/{MARKETING_ACTION_NAME}

Anfrage

Die folgende Anfrage erstellt eine neue Marketing-Aktion mit dem Namen crossSiteTargeting, sofern im System noch keine Marketing-Aktion mit demselben Namen vorhanden ist. Wenn eine crossSiteTargeting-Marketing-Aktion vorhanden ist, wird diese stattdessen auf der Grundlage der in der Payload bereitgestellten Eigenschaften aktualisiert.

curl -X PUT \
  https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/crossSiteTargeting \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "name": "crossSiteTargeting",
        "description": "Perform targeting on information obtained across multiple web sites."
      }'

Antwort

Eine erfolgreiche Antwort gibt die Details der Marketing-Aktion zurück. Wenn eine vorhandene Marketing-Aktion aktualisiert wurde, gibt die Antwort den HTTP-Status 200 (OK) zurück. Wenn eine neue Marketing-Aktion erstellt wurde, gibt die Antwort den HTTP-Status 201 (Created) zurück.

{
    "name": "crossSiteTargeting",
    "description": "Perform targeting on information obtained across multiple web sites.",
    "imsOrg": "{ORG_ID}",
    "created": 1550713341915,
    "createdClient": "string",
    "createdUser": "string",
    "updated": 1550713856390,
    "updatedClient": "string",
    "updatedUser": "string",
    "_links": {
        "self": {
            "href": "https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/crossSiteTargeting"
        }
    }
}

Löschen einer benutzerspezifischen Marketing-Aktion delete

Sie können eine benutzerspezifische Marketing-Aktion löschen, indem Sie deren Namen in den Pfad einer DELETE-Anfrage aufnehmen.

API-Format

DELETE /marketingActions/custom/{MARKETING_ACTION_NAME}

Anfrage

curl -X DELETE \
  https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/crossSiteTargeting \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Antwort

Eine erfolgreiche Antwort gibt HTTP-Status 200 (OK) mit einem leeren Antworttext zurück.

Sie können überprüfen, ob der Löschvorgang erfolgreich war, indem Sie versuchen, nach der die Marketing-Aktion zu suchen. Dies sollte zu einem HTTP-404-Fehler (Not Found) führen, wenn die Marketing-Aktion aus dem System entfernt wurde.