Rapport d’utilisation des données pour les fournisseurs de données

Ce rapport fournit des détails relatifs à votre utilisation des données fournies par des tiers (par exemple, des fournisseurs de segments d’utilisateurs), les coûts de cette utilisation des données et les campagnes dans lesquelles ces données ont été utilisées pour cibler les utilisateurs.

Le time_granularity des données est hourly.

Avertissement

Pour les impressions antérieures à 100 jours, le jour est retourné plutôt que l’heure. Pour obtenir des instructions sur la récupération d’un rapport, consultez l’exemple ci-dessous.

Période

Le report_interval champ dans la requête JSON doit être défini sur l’une des valeurs suivantes :

today
yesterday
last_7_days
last_30_days
month_to_date
quarter_to_date
last_month
lifetime

Conseil

Pour exécuter un rapport pour une période personnalisée, définissez les start_date champs et end_date dans votre demande de rapport. Pour plus d’informations sur ces champs, consultez Service de rapports.

Dimensions

Column	Type	Groupe?	Filtre?	Exemple	Description
month	date	Non	Oui	`"2010-02"`	Mois auquel la vente aux enchères associée à l’impression s’est produite
Jour	date	oui	oui	`"2010-02-01"`	Le jour où la vente aux enchères associée à l’impression s’est produite
Heure	date	oui	oui	`"2010-02-01 05:00:00"`	Heure à laquelle la vente aux enchères associée à l’impression s’est produite.
buyer_member_id	int	oui	oui	`643`	ID du membre qui a utilisé les données tierces.
buyer_member_name	chaîne	Oui	oui	`"Buyer A"`	Nom du membre qui a utilisé les données tierces.
advertiser_name	chaîne	Oui	oui	`"Advertiser"`	Nom de l’annonceur qui a utilisé les données tierces.
geo_country	chaîne	Oui	oui	`"US"`	Code du pays géographique associé à l’impression.
geo_country_name	string	Non	Non	`"United States"`	Nom du pays géographique associé à l’impression.
geo_country_code	chaîne	Oui	oui	`"CA"`	Chaîne à deux caractères indiquant le pays associé à l’impression. Pour obtenir la liste complète des valeurs autorisées, consultez Codes de pays ISO 3166-1.
campaign_id	int	oui	oui	`31`	ID de la campagne associée aux impressions qui ont utilisé le ciblage de données tierces.
campaign_name	string	Non	Non	`"Prospect Campaign"`	Nom de la campagne associée aux impressions qui utilisent le ciblage de données tierces.
data_provider_id	int	oui	oui	`517`	ID du tiers qui a fourni les données de ciblage.
targeted_segment_ids	string	Non	Non	`"935035, 935146"`	Liste d’ID séparés par des virgules pour chacun des segments utilisés lors du ciblage.
data_provider_name	string	Non	Non	`"Peer 39 (Data Provider)"`	Nom et ID du tiers qui a fourni les données de ciblage.
cpm_usd	int	Oui	Non	`"0.75"`	Valeur CPM du segment de données utilisé

Mesures

Column	Type	Exemple	Formule	Description
Lutins	int	`34534`	Lutins	Nombre total d’impressions qui ont utilisé des données tierces pour diffuser la publicité.
data_costs	Argent	`3.50`	imps * CPM/1000	Valeur monétaire des segments de données achetés auprès de fournisseurs de données tiers.
data_clearing_fee_usd	Argent	`0.50`	data_costs * Xandr revshare	Valeur monétaire de la reshare gagnée par Xandr.
data_provider_payout_usd	Argent	`3.00`	data_costs - data_clearing_fee_usd	Valeur monétaire du revenu qui a été payé ou qui sera versé au fournisseur de données.

Exemple

Étape 1 : Create la demande de rapport JSON.

Le fichier JSON doit inclure le report_type de "data_usage_analytics_for_data_providers", ainsi que le columns (dimensions et métriques) et report_interval que vous souhaitez récupérer. Vous pouvez également filtrer des dimensions spécifiques, définir la granularité (mois, jour, heure) et spécifier le format dans lequel les données doivent être retournées (csv, excel ou html).

$ cat data_usage_analytics
        {"report":
                {
                        "format": "csv",
                        "report_interval": "yesterday",
                        "row_per": ["geo_country"],
                        "columns": ["imps","campaign_id","geo_country"],
                        "report_type": "data_usage_analytics_for_data_providers"
                }
         }

Pour obtenir une explication complète des champs qui peuvent être inclus dans le fichier JSON, consultez service de rapports.

Étape 2 :POST la demande adressée au service de rapports.

POST demande JSON pour récupérer un ID de rapport.

$ curl -b cookies -c cookies -X POST -d @data_usage_analytics "https://api.adnxs.com/report?member_id=MEMBER_ID"
         {
            "response":{
               "status":"OK",
               "report_id":"c445bca183a3d338dc1c5b85a3d484f5"
            }
         }

Étape 3 :GET le rapport status à partir du service de rapports.

Effectuez un GET appel avec l’ID de rapport pour récupérer les status du rapport. Continuez à effectuer cet GET appel jusqu’à ce que soit execution_status"ready". Utilisez ensuite le service de téléchargement de rapports pour enregistrer les données du rapport dans un fichier, comme décrit à l’étape suivante.

$ curl -b cookies -c cookies 'https://api.adnxs.com/report?id=c445bca183a3d338dc1c5b85a3d484f5'
         {
            "response": {
                "status": "OK",
                "report": {
                    "name": null,
                    "created_on": "2014-11-19 22:33:31",
                    "json_request": "{\"report\":{\"format\":\"csv\",\"report_interval\":\"yesterday\",\"row_per\":[\"geo_country\"],\"columns\":[\"imps\",\"campaign_id\",\"geo_country\"],\"report_type\":\"buyer_data_usage_analytics\",\"filters\":[{\"buyer_member_id\":\"958\"}]}}",
                    "url": "report-download?id=c445bca183a3d338dc1c5b85a3d484f5"
                },
                "execution_status": "ready"
            }
         }

Étape 4 :GET les données de rapport du service de téléchargement de rapports.

Pour télécharger les données du rapport dans un fichier, effectuez un autre GET appel avec l’ID de rapport, mais cette fois au service de téléchargement de rapports . Vous trouverez l’ID de service et de rapport dans le url champ de la réponse à votre appel précédent GET . Lorsque vous identifiez le fichier dans lequel vous souhaitez enregistrer, veillez à utiliser l’extension de fichier du format de fichier que vous avez spécifié dans votre fichier initial POST.

Conseil

Si une erreur se produit pendant le téléchargement, l’en-tête de réponse inclut un code d’erreur HTTP et un message. Utilisez -i ou -v dans votre appel pour exposer l’en-tête de réponse.

$ curl -b cookies -c cookies 'https://api.adnxs.com/report-download?id=c445bca183a3d338dc1c5b85a3d484f5' > /tmp/data_usage_analytics.csv

Dernière mise à jour : 2025-04-01

Rapport d’utilisation des données pour les fournisseurs de données

Période

Dimensions

Mesures

Exemple

Ressources supplémentaires