Steuern der Batch-Zielgruppenauswertung mit flexiblen Batch-Zeitplänen

Die Batch-Segmentierung ist eine Auswertungsmethode, mit der Sie Profildaten gleichzeitig verschieben können, um eine entsprechende Zielgruppe zu erstellen. Zuvor nutzten diese Batch-Zielgruppen einen einzelnen, festen Segmentierungsauftrag, der einmal täglich ausgeführt wurde.

Mit flexiblen Batch-Zeitplänen können Sie steuern, wann Ihre Zielgruppen ausgewertet werden. So haben Sie mehr Flexibilität bei der Priorisierung Ihrer Auswertungszeiten, sodass Sie sie besser auf größere Zielgruppen skalieren können.

Zeitplan erstellen create-schedule

Um flexible Batch-Zeitpläne zu verwenden, müssen Sie zunächst einen Zeitplan für die Zielgruppen erstellen. Sie können einen Zeitplan entweder über die Experience Platform-Benutzeroberfläche oder die API erstellen.

POST /schedules

curl -X POST https://platform.adobe.io/data/core/ups/config/schedules \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
{
    "name": "Weekly VIP refresh",
    "type": "batch_segmentation",
    "schedule": "0 0 10 * * ?",
    "properties": {
        "segments": [
            "sample-audience-1",
            "sample-audience-2"
        ]
    },
    "state": "active"
}'

{
  "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
  "name": "Weekly VIP Refresh",
  "type": "batch_segmentation",
  "schedule": "0 0 10 * * ?",
  "frequency": "weekly",
  "state": "active",
  "properties": {
    "segments": ["sample-audience-1", "sample-audience-2"]
  }
}

Zuweisen von Zielgruppen zu einem Zeitplan assign-audience

Nachdem Sie einen Zeitplan erstellt haben, können Sie dem zuvor erstellten Zeitplan zusätzliche Zielgruppen zuweisen. Zielgruppen können entweder über die Experience Platform-Benutzeroberfläche oder die API zugewiesen werden.

POST /schedules/add-audiences

curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/add-audiences \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
        "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
        "segments": [
            "sample-audience-3",
            "sample-audience-4"
        ]
      }'

{
    "added": ["sample-audience-3", "sample-audience-4"],
    "existing": [],
    "invalid": [],
    "segmentCount": {
        "previous": 2,
        "current": 4,
        "diff": 2
    }
}

Alternativ können Sie einer Zielgruppe während der Erstellung der Zielgruppe einen Zeitplan zuweisen. Gehen Sie in Audience Builder nach dem Speichern Ihrer Zielgruppe zum Abschnitt Zeitplan im Abschnitt mit den Zielgruppeneigenschaften und wählen Sie das aus.

Das Zielgruppen-Zeitpläne wird angezeigt. In diesem Pop-up können Sie festlegen, zu welchen Zeitplänen die Zielgruppe gehören soll.

Anzeigen des Zeitplans einer Zielgruppe view-audience-schedule

Sie können mithilfe der Experience Platform-Benutzeroberfläche oder -API sehen, zu welchen Zeitplänen eine Zielgruppe gehört.

POST /schedules/audience-map

curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/audience-map \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
        "segments": [
            "sample-audience-1",
            "sample-audience-2"
        ]
      }'

{
  "audienceMap": {
    "sample-audience-1": ["cd585edf-962d-420d-94ad-3be03e619ac2"],
    "sample-audience-2": []
  },
  "schedules": {
    "cd585edf-962d-420d-94ad-3be03e619ac2": {
      "name": "Weekly VIP Refresh",
      "schedule": "0 0 10 * * ?",
      "frequency": "weekly"
    }
  }
}

Entfernen von Zielgruppen aus einem Zeitplan remove-audience

Wenn Sie Zielgruppen aus einem bereits erstellten Zeitplan entfernen möchten, können Sie entweder die Experience Platform-Benutzeroberfläche oder die API verwenden.

POST /schedules/remove-audiences

curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/remove-audiences/
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
 {
    "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
    "segments": [
        "sample-audience-1"
    ]
 }
 '

{
    "removed": ["sample-audience-1"],
    "existing": [],
    "invalid": [],
    "segmentCount": {
        "previous"
    }
}

Zeitplan manuell ausführen run-manually

Anstatt auf die Ausführung des Zeitplans zu warten, können Sie manuell einen vorhandenen Zeitplan mithilfe der Experience Platform-Benutzeroberfläche oder -API zum Ausführen Trigger erstellen.

POST /schedules/trigger

curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/trigger \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
    "id": "cd585edf-962d-420d-94ad-3be03e619ac2"
    }'

Zeitplan aktivieren oder deaktivieren

Sie können einen Zeitplan entweder über die Experience Platform-Benutzeroberfläche oder die API aktivieren oder deaktivieren.

PATCH /schedules/{SCHEDULE_ID}

curl -X PATCH https://platform.adobe.io/data/core/ups/config/schedules/cd585edf-962d-420d-94ad-3be03e619ac2 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '[
        {
            "op": "replace",
            "path": "/state",
            "value": "inactive"
        }
      ]'

Nächste Schritte

Nach dem Lesen dieses Handbuchs wissen Sie jetzt, wie Sie flexible Batch-Zeitpläne entweder mit der Experience Platform-API oder über die Benutzeroberfläche verwenden können. Weitere Informationen zur flexiblen Benutzeroberfläche für Batch-Zeitpläne finden Sie unter Übersicht über die Benutzeroberfläche des Segmentierungs-Services. Weitere Informationen zur Zeitpläne-API finden Sie im Handbuch zu Zeitplänen-Endpunkten. Informationen zur Funktionsweise flexibler Batch-Zeitpläne mit Ihrer Kapazität und Ihren Guthaben finden Sie in der Übersicht über Lizenznutzung und Kapazitäten.

Video video

Das folgende Video zeigt, wie Sie flexible Batch-Zeitpläne verwenden und dabei beschreiben, wie Sie benutzerdefinierte Zeitpläne erstellen, Segmentierungsaufträge überwachen und Credits auf der Registerkarte Auswertung verwalten.

Anhang appendix

Im folgenden Anhang finden Sie Informationen zur Funktionsweise von Abhängigkeiten zwischen verschiedenen Zeitplänen sowie häufig gestellte Fragen zu flexiblen Batch-Zeitplänen.

Zeitübergreifende Abhängigkeiten cross-schedule-dependencies

Wenn eine Zielgruppe auf eine andere Zielgruppe als Abhängigkeit verweist, kann diese Abhängigkeit diese Zielgruppe in einen Zeitplan ziehen, zu dem sie nicht gehört.

Betrachten Sie die folgenden vier Zielgruppen und zwei Zeitpläne:

Zeitplan A: Zielgruppe 1, Zielgruppe 4
Zeitplan B: Zielgruppe 2, Zielgruppe 3

Zielgruppe 1 bezieht sich über eine Abhängigkeit auf Zielgruppe 2, sodass Zielgruppe 1 die Mitgliedschaft von Zielgruppe 2 benötigt, um ihre eigene zu berechnen.

Bei der Ausführung von Zeitplan A werden Zielgruppe 1 und Zielgruppe 4 wie erwartet ausgewertet. Allerdings wird Zielgruppe 2 auch ausgeführt, da es eine Abhängigkeit von Zielgruppe 1 ist.

Wenn Zeitplan B ausgeführt wird, werden Zielgruppe 2 und Zielgruppe 3 wie erwartet ausgewertet. In diesem Szenario wird Zielgruppe 1 nicht ausgewertet, da Zielgruppe 2 nicht von Zielgruppe 1 abhängig ist.

Dies bedeutet, dass Zielgruppen, die von anderen Zielgruppen abhängig sind (z. B. Zielgruppe 2 im obigen Szenario), mehr als einmal Tag ausgewertet werden können - einmal im Rahmen ihrer eigenen geplanten Auswertung und einmal im Rahmen des Zeitplans der Zielgruppe, der von der anderen Zielgruppe abhängig ist.

Häufig gestellte Fragen faq

Muss ich etwas tun, um die tägliche Auswertung, die ich derzeit habe, weiterhin zu verwenden?

Kann eine Zielgruppe mehreren benutzerdefinierten Zeitplänen zugewiesen werden?

Können Streaming- oder Edge-Zielgruppen benutzerdefinierte Zeitpläne verwenden?

Kann ich eine Audience-Komposition einem benutzerdefinierten Zeitplan zuweisen?

Wie viele Zeitpläne kann ich ausführen?

Benötige ich flexible Batch-Zeitpläne für mehr als 4.000 Batch-Zielgruppen?

Kostet die Erstellung eines benutzerdefinierten Zeitplans irgendetwas?

Wie kann ich sehen, ob mein Zeitplan abgelaufen ist?

Antwort

Sie können sehen, ob Ihr Zeitplan in der Ansicht zur Überwachung von Segmentierungsaufträgen ausgeführt wurde. Wählen Monitoring gefolgt von Dashboard, Audiences und Segmentierungsauftrag. Klicken Sie hier auf neben der Zeit, zu der der Zeitplan ausgeführt wurde, um die Liste der vom Zeitplan bewerteten Zielgruppen anzuzeigen.