Point de terminaison des tâches de segmentation
Une tâche de segmentation est un processus asynchrone qui crée un segment d’audience à la demande. Il fait référence à une définition de segment, ainsi qu’à toute stratégie de fusion contrôlant la manière dont Real-Time Customer Profile fusionne les attributs qui se chevauchent dans vos fragments de profil. Lorsqu’une tâche de segmentation se termine avec succès, vous pouvez collecter diverses informations sur le segment, telles que les erreurs qui se sont produites au cours du traitement et la taille finale de votre audience.
Ce guide fournit des informations pour vous aider à mieux comprendre les tâches de segmentation et inclut des exemples d’appels API pour exécuter des actions de base à l’aide de l’API.
Prise en main
Les points de terminaison utilisés dans ce guide font partie de l’API Adobe Experience Platform Segmentation Service. Avant de poursuivre, consultez le guide de prise en main pour obtenir des informations importantes à connaître afin d’effectuer avec succès des appels vers l’API, y compris les en-têtes requis et comment lire des exemples d’appels API.
Obtention d’une liste de tâches de segmentation retrieve-list
Vous pouvez récupérer une liste de toutes les tâches de segmentation pour votre organisation en envoyant une requête de GET au point de terminaison /segment/jobs
.
Format d’API
Le point d’entrée /segment/jobs
prend en charge plusieurs paramètres de requête pour vous aider à filtrer vos résultats. Bien que ces paramètres soient facultatifs, leur utilisation est vivement recommandée pour réduire les frais généraux élevés. Un appel à ce point de terminaison sans paramètres permet de récupérer toutes les tâches d’exportation disponibles pour votre organisation. Plusieurs paramètres peuvent être inclus et séparés par des esperluettes (&
).
GET /segment/jobs
GET /segment/jobs?{QUERY_PARAMETERS}
Paramètres de requête
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
---|---|---|
Paramètre | Description | Exemple |
start |
Spécifie le décalage de départ pour les tâches de segmentation renvoyées. | start=1 |
limit |
Spécifie le nombre de tâches de segmentation renvoyées par page. | limit=20 |
status |
Filtre les résultats selon l’état. Les valeurs prises en charge sont : NEW (nouveau), QUEUED (file d’attente), PROCESSING (traitement en cours), SUCCEEDED (réussite), FAILED (échec), CANCELLING (annulation en cours), CANCELLED (annulé). | status=NEW |
sort |
Commande les tâches de segmentation renvoyées. Codé au format `[attributeName]:[desc | asc]`. |
property |
Filtre les tâches de segmentation et obtient des correspondances exactes pour le filtre donné. Peut être codé dans l’un des formats suivants :
|
property=segments~segmentId==workInUS |
Requête
code language-shell |
---|
|
Réponse
Une réponse réussie renvoie un état HTTP 200 avec une liste de tâches de segmentation pour l’organisation spécifiée sous JSON. Cependant, la réponse sera différente, selon le nombre de définitions de segment dans la tâche de segmentation.
Si moins de 1 500 définitions de segment sont exécutées dans votre tâche de segmentation, une liste complète de toutes les définitions de segment s’affiche dans l’attribut children.segments
.
note note |
---|
NOTE |
La réponse suivante a été tronquée pour l’espace et affiche uniquement la première tâche renvoyée. |
accordion | ||
---|---|---|
Exemple de réponse lors de la récupération d’une liste de tâches de segmentation. | ||
|
Si plus de 1 500 définitions de segment sont exécutées dans votre tâche de segmentation, l’attribut children.segments
affichera *
, indiquant que toutes les définitions de segment sont évaluées.
note note |
---|
NOTE |
La réponse suivante a été tronquée pour l’espace et affiche uniquement la première tâche renvoyée. |
accordion | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Exemple de réponse lors de l’affichage d’une liste de tâches de segmentation. | ||||||||||||||||||||||||||||||
|
Création d’une tâche de segmentation create
Vous pouvez créer une tâche de segmentation en effectuant une requête de POST sur le point de terminaison /segment/jobs
et en incluant dans le corps l’identifiant de la définition de segment à partir de laquelle vous souhaitez créer une audience.
Format d’API
POST /segment/jobs
Lors de la création d’une tâche de segmentation, la requête et la réponse diffèrent en fonction du nombre de définitions de segment dans la tâche de segmentation.
Requête
accordion | ||||||||
---|---|---|---|---|---|---|---|---|
Exemple de requête pour créer une tâche de segmentation | ||||||||
|
Réponse
Une réponse réussie renvoie un état HTTP 200 avec des informations sur la tâche de segmentation que vous venez de créer.
accordion | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Exemple de réponse lors de la création d’une tâche de segmentation. | ||||||||||||||||
|
Requête
note note |
---|
NOTE |
Bien que vous puissiez créer une tâche de segmentation avec plus de 1 500 définitions de segment, il s’agit de hautement déconseillé. |
accordion | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Exemple de requête pour créer une tâche de segmentation. | ||||||||||
|
Réponse
Une réponse réussie renvoie un état HTTP 200 avec les détails de la tâche de segmentation que vous venez de créer.
accordion | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Exemple de réponse lors de la création d’une tâche de segmentation. | ||||||||||||||
|
Récupération d’une tâche de segmentation spécifique get
Vous pouvez récupérer des informations détaillées sur une tâche de segmentation spécifique en envoyant une requête de GET au point de terminaison /segment/jobs
et en fournissant l’identifiant de la tâche de segmentation que vous souhaitez récupérer dans le chemin d’accès de la requête.
Format d’API
GET /segment/jobs/{SEGMENT_JOB_ID}
{SEGMENT_JOB_ID}
id
de la tâche de segmentation que vous souhaitez récupérer.Requête
code language-shell |
---|
|
Réponse
Une réponse réussie renvoie un état HTTP 200 avec des informations détaillées sur la tâche de segmentation spécifiée. Cependant, la réponse varie en fonction du nombre de définitions de segment dans la tâche de segmentation.
Si moins de 1 500 définitions de segment sont exécutées dans votre tâche de segmentation, une liste complète de toutes les définitions de segment s’affiche dans l’attribut children.segments
.
accordion | ||
---|---|---|
Exemple de réponse pour récupérer une tâche de segmentation. | ||
|
Si plus de 1 500 définitions de segment sont exécutées dans votre tâche de segmentation, l’attribut children.segments
affichera *
, indiquant que toutes les définitions de segment sont évaluées.
accordion | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Exemple de réponse pour récupérer une tâche de segmentation. | ||||||||||||||||||
|
Récupération en masse de tâches de segmentation bulk-get
Vous pouvez récupérer des informations détaillées sur plusieurs tâches de segmentation en envoyant une requête de POST au point de terminaison /segment/jobs/bulk-get
et en fournissant les valeurs id
des tâches de segmentation dans le corps de la requête.
Format d’API
POST /segment/jobs/bulk-get
Requête
code language-shell |
---|
|
Réponse
Une réponse réussie renvoie un état HTTP 207 avec les tâches de segmentation demandées. Cependant, la valeur de l’attribut children.segments
varie selon que la tâche de segmentation est exécutée pour plus de 1 500 définitions de segment.
code language-json |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
---|---|
Propriété | Description |
id |
Identifiant en lecture seule généré par le système pour la tâche de segmentation. |
status |
État actuel de la tâche de segmentation. Les valeurs potentielles de l’état sont "NEW" (Nouvelle), "PROCESSING" (En cours de traitement), "CANCELLING" (ANNULÉ), "FAILED" (ÉCHEC) et "SUCCEEDED" (SUCCEEDED). |
segments |
Objet contenant des informations sur les définitions de segment renvoyées dans la tâche de segmentation. |
segments.segment.id |
L’identifiant de la définition de segment. |
segments.segment.expression |
Objet contenant des informations sur l’expression de la définition de segment, écrites dans PQL. |
Annulation ou suppression d’une tâche de segmentation spécifique delete
Vous pouvez supprimer une tâche de segmentation spécifique en effectuant une requête de DELETE sur le point de terminaison /segment/jobs
et en fournissant l’identifiant de la tâche de segmentation que vous souhaitez supprimer dans le chemin d’accès de la requête.
Format d’API
DELETE /segment/jobs/{SEGMENT_JOB_ID}
{SEGMENT_JOB_ID}
id
de la tâche de segmentation que vous souhaitez supprimer.Requête
code language-shell |
---|
|
Réponse
Une réponse réussie renvoie un état HTTP 204 avec un corps de réponse vide.
Étapes suivantes
Après avoir lu ce guide, vous comprenez mieux le fonctionnement des tâches de segmentation.