Vous trouverez ci-dessous quelques questions et réponses courantes concernant l'API d'événementset l'API Postback.

En quoi l'API d'événements est-il différent du site Rapport d'optimisation des médias?

L'API d'événements tire parti d'un système de bout en bout optimisé pour un traitement plus rapide des données afin de garantir que les notifications des transactions peuvent être effectuées en moins de dix minutes. Le rapport d'optimisation des médias utilise l'approche traditionnelle du flux de données avant que les données ne soient disponibles pour le rapport.

Quelles sont les transactions possibles sur l'API d'événements?

L'API d'événements comprend toutes les transactions déclarées à notre site réseau. Étant donné que nous offrons aux annonceurs la possibilité de déclarer des transactions à l'aide de services Web d'entreprise, de pixels et de méthodes de téléchargement par lots, le temps nécessaire au traitement des transactions téléchargées par lots aura une incidence sur le moment où les données seront disponibles dans l'API.

Quels champs de données sont disponibles via l'API d'événements ?

L'API fournit les champs de données de transaction suivants ; cliquez sur les + pour obtenir les descriptions et notes :

etransaction_id

Description : ce champ, également appelé TID, est un identifiant unique pour chaque transaction au sein d'une commande.

Remarques : Champ alphanumérique. Si un consommateur a effectué un achat contenant trois UGS différents, l'API renverra trois enregistrements, un pour chaque UGS. Les trois enregistrements partageront une valeur order_id, mais la valeur etransaction_id sera unique pour chaque enregistrement.

advertiser_id

Description : Ce champ, également appelé MID, est l'identifiant unique de l'annonceur.

Notes : Champ numérique

SID

Description : Ce champ contient l'identifiant unique Publisher.

Remarques : Champ numérique

order_id

Description : Ce champ fournit l'identifiant unique de l'annonceur pour la commande.

Remarques : Champ numérique

Identifiant de l'offre

Description : Ce champ, également appelé OID, fournit l'identifiant de l'offre sur laquelle la transaction a été effectuée.

Remarques : Champ numérique

sku_number

Description : ce champ indique l'UGS de l'article.

Remarques : champ alphanumérique Il n'est disponible que si l'annonceur le rapporte.

sale_amount

Description : Ce champ indique le montant que le consommateur a payé pour cet article dans la commande.

Remarques : Champ numérique

quantité

Description : Ce champ contient la quantité achetée pour l'article.

Remarques : Champ numérique

commissions

Description : Ce champ indique la commission de base totale pour cette transaction.

Remarques : Champ numérique

date_de_transaction

Description : Ce champ indique la date et l'heure auxquelles la commande a été passée sur le site de l'annonceur.

Remarques : Champ du format de l'heure.

date_du_processus

Description : Ce champ indique la date et l'heure auxquelles cette transaction a été traitée par Rakuten Advertising. Le fuseau horaire est le GMT.

Remarques : Champ de format d'heure

type de transaction

Description : Ce champ indique s'il s'agit d'une transaction en temps réel ou par lots.

Remarques : Champ alphanumérique.

Nom du produit

Description : Ce champ contient le nom du produit de l'article acheté ou retourné.

Remarques : Champ alphanumérique.

u1

Description : Il s'agit d'un champ que vous définissez et qui vous permet de faire référence à une campagne ou à une valeur de membre particulière. Il fait référence à votre paramètre & ; u1=.

Remarques : champ alphanumérique

devise

Description : La devise du montant de la vente pour la transaction.

Remarques : Champ alphanumérique.

is_event

Description : ce champ indique si la transaction en temps réel est un événement ou une transaction.

Remarques : champ Y ou N.

Événement : ces transactions sont destinées à servir d'indicateur de l'existence d'une transaction qui peut être éliminée après examen par l'annonceur et finalisée par le biais d'un téléchargement par lots. Vous ne devez pas utiliser ces transactions pour déterminer le montant final des commissions qui vous sont versées. Si cela est omis, vous pouvez obtenir des erreurs de rapport.

Transaction : ces transactions sont finalisées, vous pouvez donc les comptabiliser comme des transactions qui seront payées dans l'attente d'éventuelles annulations.

Quelle est la latence des données attendue ?

L'accord de niveau de service (SLA) pour les transactions disponibles sur l'API d'événements est de 10 minutes.

Que signifie l'indicateur "is_event" ?

Les annonceurs qui utilisent le processus par lots pour télécharger des transactions peuvent fournir aux publishers des informations directionnelles sur les transactions à l'aide du pixel d'optimisation des médias de Rakuten Affiliate. Les transactions signalées via le pixel d'optimisation des médias sont indiquées dans les résultats avec une valeur de Y. Vous ne devez pas utiliser ces transactions pour déterminer le montant total des commissions que vous recevrez. Il est important de noter que ces données ne sont prises en charge que par les annonceurs qui sont autorisés à utiliser le Rapport d'optimisation des médias.

Pour plus d'informations sur l'objectif du paramètre is_event=< is_event> et sur la manière d'interpréter vos données, consultez le guide API d'événements Transactions dans le site Portail pour développeur.

Combien de fois puis-je interroger le service ?

La fréquence des appels de service sera déterminée par le niveau que vous avez sélectionné sur le portail pour développeur API au cours de la procédure d'abonnement.

Puis-je recevoir des notifications push sur les transactions et les événements lorsqu'ils se produisent (postback) ?

Oui, vous pouvez enregistrer une URL via l'API Postback. Ces données et leur format seront les mêmes que ceux fournis dans l'API d'extraction.

Les postbacks peuvent prendre en charge des URL dynamiques, ce qui vous permet de personnaliser la sortie de votre postback. Pour en savoir plus sur les champs disponibles et la personnalisation de l'URL de postback, consultez le site Portail pour développeur.

Pourquoi certaines transactions ne sont-elles pas déclarées par le site API d'événements?

L'API d'événements signale à la fois les transactions et les événements qui sont signalés à Rakuten Affiliate à l'aide des services Web d'entreprise et des lots. Les transactions signalées à Rakuten Affiliate à l'aide d'une méthode de téléchargement par lots ne seront pas affichées dans le même délai que les transactions signalées par l'intermédiaire des services Web d'entreprise.

Pourquoi l'API d'événements fournit-elle des données différentes de celles des autres rapports ?

L'API d'événements signale à la fois les transactions et les événements qui sont signalés à Rakuten Affiliate à l'aide des services Web d'entreprise et des lots. Les transactions signalées à Rakuten Affiliate à l'aide d'une méthode de téléchargement par lots ne seront pas affichées dans le même délai que les transactions signalées via Enterprise Web Services. En outre, pour garantir la rapidité, nous limitons le volume des données de clics stockées à 30 jours. Par conséquent, pour les transactions résultant de clics datant de plus de 30 jours, l'API d'événements n'aura pas de valeur u1 associée à la transaction.

Comment les annulations fonctionnent-elles ? À quoi ressembleront-t-elles sur l'API d'événements ?

Les annulations sur l'API d'événements se présenteront de la même manière que dans les autres outils de reporting. Les dates de transaction et N° de commande correspondront à la transaction originale. La date de traitement sera la date de l'annulation. Certaines valeurs, telles que "commissions" et "sales_amount", seront négatives.