Controllare la valutazione del pubblico in batch con gli Schedules batch flessibili

La segmentazione batch è un metodo di valutazione che consente di spostare i dati di profilo in una sola volta per creare un pubblico corrispondente. In precedenza, questi tipi di pubblico in batch si basavano su un singolo processo di segmentazione fisso che veniva eseguito una volta al giorno.

Con gli Schedules Batch Flessibili, puoi controllare quando i tipi di pubblico vengono valutati, dando maggiore flessibilità nell’assegnare priorità ai tempi di valutazione, in modo da adattarli meglio a volumi di pubblico più grandi.

Creare una pianificazione create-schedule

Per utilizzare i programmi batch flessibili, devi innanzitutto creare una pianificazione per il pubblico. Puoi creare una pianificazione utilizzando l’interfaccia utente o l’API di Experience Platform.

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"]
  }
}

Assegnare un pubblico a una pianificazione assign-audience

Dopo aver creato una pianificazione, puoi assegnare un pubblico aggiuntivo alla pianificazione precedente. Puoi assegnare i tipi di pubblico utilizzando l’interfaccia utente o l’API di Experience Platform.

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
    }
}

In alternativa, puoi assegnare una pianificazione a un pubblico durante la sua creazione. In Audience Builder, dopo aver salvato il pubblico, passa alla sezione Pianificazione nella sezione delle proprietà del pubblico e seleziona l’icona .

Viene visualizzato il popover Pianificazioni pubblico. In questo popover, puoi assegnare a quali pianificazioni deve appartenere il pubblico.

Visualizzare la pianificazione di un pubblico view-audience-schedule

Puoi vedere a quali pianificazioni appartiene un pubblico utilizzando l’interfaccia o l’API di Experience Platform.

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"
    }
  }
}

Rimuovere un pubblico da una pianificazione remove-audience

Se desideri rimuovere i tipi di pubblico da una pianificazione già creata, puoi utilizzare l’interfaccia utente o l’API di Experience Platform.

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"
    }
}

Eseguire manualmente una pianificazione run-manually

Invece di attendere l’esecuzione della pianificazione, puoi attivare manualmente una pianificazione esistente da eseguire utilizzando l’interfaccia utente o l’API di Experience Platform.

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"
    }'

Abilitare o disabilitare una pianificazione

Puoi abilitare o disabilitare una pianificazione utilizzando l’interfaccia utente o l’API di Experience Platform.

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"
        }
      ]'

Passaggi successivi

Dopo aver letto questa guida, ora sai come utilizzare gli Schedules Batch flessibili utilizzando l’API o l’interfaccia utente di Experience Platform. Per ulteriori informazioni sull’interfaccia utente di Flexible Batch Schedules, leggere la panoramica dell’interfaccia utente del servizio di segmentazione. Per ulteriori informazioni sull’API delle pianificazioni, leggere la guida dell’endpoint delle pianificazioni. Per informazioni sul funzionamento di Flexible Batch Schedules con capacità e crediti, leggere la panoramica sull’utilizzo delle licenze e sulle capacità.

Video video

Nel video seguente viene illustrato come utilizzare pianificazioni batch flessibili, in cui viene illustrato come creare pianificazioni personalizzate, monitorare i processi di segmentazione e gestire i crediti nella scheda Valutazione.

Appendice appendix

Nell’appendice seguente viene illustrato il funzionamento delle dipendenze tra programmi e le domande frequenti sui programmi batch flessibili.

Dipendenze tra programmi cross-schedule-dependencies

Se un pubblico fa riferimento a un altro pubblico come a una dipendenza, tale dipendenza può richiamare tale pubblico in una pianificazione a cui non appartiene.

Considera i seguenti quattro tipi di pubblico e due pianificazioni:

Pianificazione A: pubblico 1, pubblico 4
Pianificazione B: pubblico 2, pubblico 3

Il Pubblico 1 si riferisce al Pubblico 2 attraverso una dipendenza, quindi il Pubblico 1 ha bisogno dell’appartenenza valutata dal Pubblico 2 per calcolare la propria.

Quando viene eseguita la Pianificazione A, il Pubblico 1 e il Pubblico 4 valutano, come previsto. Tuttavia, viene eseguito il pubblico 2 also, poiché è una dipendenza del pubblico 1.

Quando viene eseguita la pianificazione B, il pubblico 2 e il pubblico 3 valutano, come previsto. In questo scenario, il pubblico 1 non viene valutato, poiché il pubblico 2 non dipende dal pubblico 1.

Di conseguenza, ciò significa che i tipi di pubblico dipendenti da altri tipi di pubblico (come il Pubblico 2 nello scenario precedente) maggio valutano più di una volta al giorno - una volta come parte della propria valutazione pianificata e una volta come parte della pianificazione del pubblico che dipende dall’altro pubblico.

Domande frequenti faq

È necessario continuare a utilizzare la valutazione giornaliera di cui si dispone attualmente?

È possibile assegnare un pubblico a più di una pianificazione personalizzata?

I tipi di pubblico in streaming o perimetrale possono utilizzare pianificazioni personalizzate?

Posso assegnare una composizione di pubblico a una pianificazione personalizzata?

Quante pianificazioni è possibile eseguire?

Sono necessari programmi batch flessibili per avere più di 4.000 tipi di pubblico batch?

La creazione di un programma personalizzato costa qualcosa?

Come posso vedere se la mia pianificazione è stata eseguita?

Risposta

Puoi verificare se la pianificazione è stata eseguita nella vista di monitoraggio del processo di segmentazione. Seleziona Monitoraggio seguito da Dashboard, Tipi di pubblico e Processo di segmentazione. Da qui, seleziona l’ accanto all’ora di esecuzione della pianificazione per visualizzare l’elenco dei tipi di pubblico valutati dalla pianificazione.