Contrôle de l’évaluation des audiences par lots avec des planifications par lots flexibles

La segmentation par lots est une méthode d’évaluation qui vous permet de déplacer les données de profil en même temps pour créer une audience correspondante. Auparavant, ces audiences par lot s’appuyaient sur une tâche de segmentation unique et fixe qui s’exécutait une fois par jour.

Grâce aux planifications de lots flexibles, vous pouvez contrôler le moment où vos audiences sont évaluées, ce qui vous donne plus de flexibilité pour prioriser les délais d’évaluation afin de mieux adapter l’évaluation à des volumes d’audience plus importants.

Création d’un planning create-schedule

Pour utiliser des planifications par lots flexibles, vous devez d’abord créer une planification pour les audiences. Vous pouvez créer un planning à l’aide de l’interface utilisateur ou de l’API d’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"]
  }
}

Attribution d’audiences à un planning assign-audience

Après avoir créé un planning, vous pouvez affecter des audiences supplémentaires au planning précédent. Vous pouvez affecter des audiences à l’aide de l’interface utilisateur ou de l’API 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
    }
}

Vous pouvez également affecter un planning à une audience lors de la création de l’audience. Dans le Créateur d’audience, après avoir enregistré votre audience, accédez à la section Planning dans la section des propriétés de l’audience et sélectionnez l’icône .

La fenêtre contextuelle Plannings d’audience s’affiche. Dans cette fenêtre contextuelle, vous pouvez affecter les plannings auxquels l’audience doit appartenir.

Afficher le planning d’une audience view-audience-schedule

Vous pouvez voir à quels plannings une audience appartient à l’aide de l’interface utilisateur ou de l’API d’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"
    }
  }
}

Supprimer des audiences d’un planning remove-audience

Si vous souhaitez supprimer des audiences d’un planning déjà créé, vous pouvez utiliser l’interface utilisateur ou l’API d’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"
    }
}

Exécution manuelle d’un planning run-manually

Au lieu d’attendre que le planning s’exécute, vous pouvez déclencher manuellement un planning existant à exécuter à l’aide de l’interface utilisateur ou de l’API d’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"
    }'

Activation ou désactivation d’un planning

Vous pouvez activer ou désactiver un planning à l’aide de l’interface utilisateur ou de l’API d’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"
        }
      ]'

Étapes suivantes

Vous êtes arrivé au bout de ce guide. À présent, vous savez comment utiliser des planifications par lots flexibles à l’aide de l’API ou de l’interface utilisateur d’Experience Platform. Pour plus d’informations sur l’interface utilisateur des plannings de lot flexibles, consultez la ​ présentation de l’interface utilisateur de segmentation Service. Pour plus d’informations sur l’API des plannings, consultez le guide des points d’entrée des plannings. Pour découvrir comment les plannings de lot flexibles fonctionnent avec votre capacité et vos crédits, lisez la ​ présentation de l’utilisation des licences et des capacités ​.

Vidéo video

La vidéo suivante montre comment utiliser des plannings de lot flexibles, en décrivant comment créer des plannings personnalisés, surveiller les tâches de segmentation et gérer les crédits dans l’onglet Évaluation.

Annexe appendix

L’annexe suivante répertorie le fonctionnement des dépendances entre programmes et les questions fréquentes sur les programmes de commandes flexibles.

Dépendances sur plusieurs planifications cross-schedule-dependencies

Si une audience fait référence à une autre audience comme à une dépendance, cette dépendance peut attirer cette audience dans un planning auquel elle n’appartient pas.

Tenez compte des quatre audiences et des deux plannings suivants :

Annexe A : audience 1, audience 4
Annexe B : audience 2, audience 3

L’audience 1 fait référence à l’audience 2 par le biais d’une dépendance. L’audience 1 a donc besoin de l’abonnement évalué à l’audience 2 pour calculer son propre abonnement.

Lorsque le planning A s’exécute, l’audience 1 et l’audience 4 sont évaluées comme prévu. Cependant, l’Audience 2 s’exécute également car il s’agit d’une dépendance de l’Audience 1.

Lorsque l’annexe B s’exécute, l’audience 2 et l’audience 3 sont évaluées comme prévu. Dans ce scénario, l’audience 1 n’est pas évaluée, car l’audience 2 ne dépend pas de l’audience 1.

Par conséquent, cela signifie que les audiences qui sont dépendantes d’autres audiences (comme l’audience 2 dans le scénario ci-dessus) peuvent évaluer plus d’une fois par jour, une fois dans le cadre de leur propre évaluation planifiée et une fois dans le cadre du planning de l’audience qui dépend de l’autre audience.

Questions fréquentes faq

Dois-je faire quelque chose pour continuer à utiliser l’évaluation quotidienne que j’ai actuellement ?

Une audience peut-elle être affectée à plusieurs planifications personnalisées ?

Les audiences en flux continu ou Edge peuvent-elles utiliser des plannings personnalisés ?

Puis-je affecter une composition d’audience à un planning personnalisé ?

Combien de plannings puis-je exécuter ?

Ai-je besoin de plannings de traitement par lots flexibles pour avoir plus de 4 000 audiences par lots ?

La création d’un planning personnalisé coûte-t-elle quelque chose ?

Comment puis-je voir si mon planning s’est exécuté ?

Réponse

Vous pouvez voir si votre planning s’est exécuté dans la vue de surveillance des tâches de segmentation. Sélectionnez Surveillance suivi de Tableau de bord, Audiences et Tâche de segmentation. À partir de là, sélectionnez l’icône en regard de l’heure d’exécution du planning pour afficher la liste des audiences évaluées par le planning.