Partager via

API de plateforme numérique - Format de fichier BSS hérité

Le service de segment batch permet de charger des fichiers de données de segment dans différents formats. Pour plus d’informations, consultez les exemples ci-dessous.

Remarque

Le format Avro décrit dans BSS Avro File Format fournit une prise en charge d’une plus grande variété d’identificateurs d’utilisateur. La méthode décrite dans cette rubrique a été le format standard dans le passé, mais elle devrait être déconseillée à l’avenir, car l’identification de l’utilisateur s’appuie de plus en plus sur les ID étendus (EID) et les identificateurs internes de l’éditeur plutôt que sur les cookies.

Conseil

Contactez votre représentant de compte pour obtenir de l’aide sur la configuration de notre système afin d’accepter votre format de fichier particulier.

Vue d’ensemble du format

Chaque ligne du fichier spécifie un minimum d’un UID (ID utilisateur) et un ou plusieurs SEG blocs. Les séparateurs sont configurables.

Le tableau suivant décrit l’ordre des blocs et des séparateurs qui composent chaque ligne.

| UID | | SEG | SEPARATOR1 | SEG | SEPARATOR2 | SEG | SEPARATOR4 | SEG | SEPARATOR2 | SEPARATOR5DOMAINE |

UID

Nom Type Description Exemple
UID int ID utilisateur Xandr en cours d’ajout ou de suppression d’un segment. 5727816213491965430

SEG Bloc

Le SEG bloc décrit le ou les segments auxquels l’utilisateur est ajouté ou supprimé et contient des données telles que l’ID de segment ou un code de segment défini par l’utilisateur.

Construisez un SEG bloc comme suit :

| SEG_FIELD | SEPARATOR3 | SEG_FIELD |

SEG_FIELD Bloc

Le tableau suivant répertorie les valeurs possibles qui peuvent être incluses dans le SEG_FIELD bloc. Lorsqu’il existe des valeurs par défaut, elles sont appliquées sauf indication contraire.

Remarque

Chaque SEG bloc doit être normal, ce qui signifie qu’il doit contenir tous les champs que vous avez choisi d’inclure. Par exemple, si vous avez inclus le VALUE champ mais que vous n’avez pas de valeur pour un utilisateur particulier, vous devez utiliser 0 comme valeur.

Nom Type Description Exemple
SEG_ID int ID de segment Xandr.
Par défaut: Cela est généré par le système lors de la création du segment.		 1234567890
SEG_CODE string Nom défini par l’utilisateur pour le segment. Vous pouvez inclure SEG_CODE ou mais SEG_ID pas les deux. "18-35_autobuy"
EXPIRATION int Durée de vie du segment, à partir de la valeur de TIMESTAMP. Spécifié en minutes. Une valeur de 0 signifie que l’utilisateur expirera dans le segment après le délai maximal autorisé de 180 jours ; -1 cela signifie que l’utilisateur sera supprimé de ce segment.

Par défaut: La valeur par défaut est spécifiée au niveau du segment lors de la création du segment. S’il n’y en a pas, votre paramètre de configuration de l’API Segment batch est utilisé. L’utilisation de ce champ remplace la valeur par défaut.		 1440
TIMESTAMP int Heure à laquelle vous souhaitez que votre segment entre en vigueur. Horodatage UNIX, jusqu’à la seconde. Si un horodatage est soumis à une plus grande spécificité (jusqu’à la milliseconde, par exemple), l’utilisateur n’est pas correctement écrit dans le segment lors du chargement.
Par défaut: Heure actuelle.		 1278250469
VALUE int Valeur numérique que vous souhaitez affecter à un segment. 310

Remarque :
La valeur maximale acceptée est 2147483647. (Si une valeur supérieure à celle-ci est incluse, il peut y avoir un comportement imprévisible tel que le tir de pixel ne traite pas. Par conséquent, l’utilisateur n’est pas ajouté au segment. D’autres fois, il est traité, mais la valeur définie sera beaucoup plus petite que ce qui a été passé.)
MEMBER_ID int Ce champ n’est requis que si vous utilisez un SEG_CODE et que vous chargez les données d’autres membres en plus des vôtres.
Par défaut: .member_id		 958

DOMAIN

Nom Type Description
DOMAIN string Vous pouvez éventuellement spécifier un domaine à associer à cet ID utilisateur.

Séparateurs

Poursuivez la lecture pour connaître les définitions de chaque type de séparateur. Chaque séparateur doit être différent, à l’exception de SEPARATOR1 et SEPARATOR3, qui peuvent être identiques (SEPARATOR2 et SEPARATOR4, ne peuvent pas être identiques). Chaque séparateur ne doit avoir que 1 caractère.

Attention

Caractères non autorisés

Les caractères suivants ne sont pas autorisés comme séparateurs : [ ] ( ) { } $ \ / | ? * + -

SEPARATOR1

Sépare l’ID utilisateur de la liste de segments (ou SEG bloc). Il ne peut y en avoir qu’un par ligne. Obligatoire.

SEPARATOR2

Sépare les segments dans la liste de segments. Il peut y en avoir plusieurs par ligne, car plusieurs segments peuvent être associés à un seul UID. Obligatoire s’il existe plusieurs segments.

SEPARATOR3

Sépare les champs dans chaque SEG bloc. Si cette valeur est définie, elle doit rester la même pour chaque ligne du fichier (sauf après SEPARATOR4). Obligatoire s’il existe plusieurs champs dans le SEG.

SEPARATOR4

L’utilisateur sera supprimé de tous les segments apparaissant après ce séparateur. Optional.

SEPARATOR5

L’utilisateur sera ajouté à ou DOMAIN recherché dans l’ensemble désigné directement après ce séparateur. Optional.

Remarque

Champs de données d’ID d’appareil mobile

Pour transmettre les ID d’appareil à partir d’appareils mobiles, passez SEPARATOR5 à la fin d’une ligne suivie de l’un des numéros indiqués dans le tableau ci-dessous. Chaque nombre correspond à un schéma d’identification d’appareil mobile différent. Cette table suppose que ^ est utilisé comme SEPARATOR5:

Séparateur et nombre Valeur
^3 Idfa
^4 sha1udid
^5 md5udid
^7 openudid
^8 aaid
^9 windowsadid
^10 Rida

^6 sha1mac a été déconseillé depuis le 7 mai 2019. Ne pas utiliser.

Exemples

Les exemples suivants illustrent des scénarios dérivés de cas d’usage réels.

Remarque

Les exemples ci-dessous montrent des valeurs de séparateur qui peuvent différer de celles qui ont été configurées dans votre configuration de segment de lot initiale. Si vous souhaitez mettre à jour vos paramètres de configuration, contactez notre équipe de services.

Exemple 1

Un client ajoute un utilisateur 12345678900987654321 aux segments 10000 et 10001 avec un délai d’expiration de 1440 (un jour). Le client supprime également l’utilisateur 12345678900987654321 des segments 10002 et 10003.

Champ Valeur
UID ID utilisateur Xandr
SEPARATOR1 ","
SEPARATOR2 ";"
SEPARATOR3 ":"
SEG_FIELD [SEG_ID, EXPIRATION] 
12345678900987654321,10000:1440;10001:1440;10002:-1;10003:-1

Exemple 2

Un client ajoute un utilisateur 12345678900987654321 à des segments avec des codes "auto_intender" et "nike_shopper" avec le délai d’expiration par défaut. Le client supprime également (à l’aide SEPARATOR4de ) l’utilisateur 12345678900987654321 des segments avec des codes "bicycle_intender" et "newbalance_shopper".

Champ Valeur
UID ID utilisateur Xandr
SEPARATOR1 ","
SEPARATOR2 ";"
SEPARATOR4 "\t"
SEG_FIELD [SEG_CODE]

Remarque

\t fait référence au caractère de tabulation horizontal. Il déplace le curseur d’une largeur de tabulation. L’exemple ci-dessous utilise \t pour afficher l’emplacement de l’espace.

12345678900987654321,auto_intender;nike_shopper\tbicycle_intender;newbalance_shopper

Exemple 3

Dans l’exemple ci-dessous, le client ajoute l’utilisateur 12345678900987654321 aux segments 10000 et 10001 sans expiration (ce qui signifie que l’utilisateur expirera dans le segment après le délai maximal autorisé de 180 jours), et il supprime l’utilisateur du segment 10002.

Champ Valeur
UID ID utilisateur Xandr
SEPARATOR1 "\t"
SEPARATOR3 "\t"
SEG_FIELD [TIMESTAMP, SEG_ID, VALUE, EXPIRATION]

Avertissement

\t fait référence au caractère de tabulation horizontal. Il déplace le curseur d’une largeur de tabulation. L’exemple ci-dessous utilise \t pour afficher l’emplacement de l’espace.

12345678900987654321\t1320689131\t10000\t0\t0
12345678900987654321\t1320689131\t10001\t0\t0
12345678900987654321\t1320689131\t10002\t0\t-1

Exemple 4

Un client ajoute un utilisateur "abcdefg" aux segments 10000 et 10001 avec un délai d’expiration de 1440 (un jour). Le client ajoute également l’utilisateur "abcdefg" aux segments croisés 10002 et 10003.

Conseil

Ce client est défini en tant que XSEG membre.

Champ Valeur
UID ID utilisateur Xandr
SEPARATOR1 ","
SEPARATOR2 ";"
SEPARATOR3 ":"
SEG_FIELD [SEG_ID, EXPIRATION]
uses_external_uids true 
abcdefg,10000:1440;10001:1440
abcdefg,10002:1440;10003:1440

Exemple 5

Un client ajoute un utilisateur 12345678900987654321 à des segments avec du code "car_like" et "bike_like" avec le délai d’expiration par défaut.

Conseil

Ce client utilise SEG_CODE et charge sous différents noms de membres.

Champ Valeur
UID ID utilisateur Xandr
SEPARATOR1 ","
SEPARATOR2 ";"
SEPARATOR3 ":"
SEPARATOR4 "\t"
SEG_FIELD [MEMBER_ID, SEG_CODE]

Remarque

\t fait référence au caractère de tabulation horizontal. Il déplace le curseur d’une largeur de tabulation.

12345678900987654321,400:car_like;500:bike_like

Exemple 6

Un client ajoute l’IDFA (ID pour les annonceurs) AEBE52E7-03EE-455A-B3C4-E57283966239 utilisateur mobile aux segments 10000, 10001, 10002, 10003 pour des durées variables, via le service batch segment. Cette méthode a souvent des taux de correspondance faibles sur notre plateforme, car même si les ID sont correctement envoyés à notre service, cela ne signifie pas que l’ID de l’appareil a réellement été vu sur notre plateforme. Notez que le séparateur5 ajouté qui désigne l’utilisation d’identificateurs mobiles. La valeur désigne la valeur "3"IDFA d’Apple. Vous trouverez d’autres valeurs ci-dessus dans la table Champs de données d’ID d’appareil mobile .

Champ Valeur
IDFA ID Apple pour les annonceurs.
SEPARATOR1 ","
SEPARATOR2 ";"
SEPARATOR3 ":"
SEPARATOR4 "\t"
SEPARATOR5 "^"
SEG_FIELD [SEG_ID,EXPIRATION]

Remarque

\t fait référence au caractère de tabulation horizontal. Il déplace le curseur d’une largeur de tabulation.

AEBE52E7-03EE-455A-B3C4-E57283966239,10000:1440;10001:1440;10002:-1;10003:-1^3
  • Last updated on