Partager via

Rapport Geo Analytics

Le rapport Geo Analytics vous permet de décomposer la livraison et les performances des campagnes par zone géographique. Voici quelques exemples de cas d’usage pour ce rapport :

  • Acheteurs qui souhaitent optimiser leurs campagnes
  • Les acheteurs qui doivent rendre compte à leurs clients annonceurs ou agences sur la livraison des campagnes

Ce rapport peut décomposer les performances des campagnes selon les limites géographiques suivantes :

Pour plus d’informations sur les champs de données disponibles et leurs définitions, consultez Dimensions et métriques ci-dessous.

Pour obtenir des instructions sur l’exécution de ce rapport, consultez les exemples.

Remarque

Sur la précision de la détermination de la zone géographique de l’utilisateur par adresse IP

La précision des données géographiques est limitée, en particulier sur les impressions achetées auprès de partenaires fournisseurs externes. Étant donné que certains partenaires fournisseurs externes (tels que Google Ad Manager) tronquent le dernier octet de l’adresse IP de l’utilisateur, nous avons une adresse IP moins précise à utiliser lors d’une recherche géographique IP. Par conséquent, nos données géographiques peuvent ne pas toujours être complètement précises à des niveaux granulaires (par exemple, région et DMA) pour les impressions achetées à partir de ces sources d’approvisionnement.

Période

Le report_interval champ de la demande peut être défini sur l’une des valeurs suivantes :

  • aujourd’hui
  • yesterday
  • last_7_days

Période de conservation des données

La période de conservation des données pour ce rapport est de 45 jours.

Remarque

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 Filtre? Description
month date Oui Année et mois au cours desquels la vente aux enchères a eu lieu.
day date Oui Année, mois et jour de la vente aux enchères.
hourly date Oui Heure à laquelle la vente aux enchères a eu lieu.
member_id int Oui ID du membre.
advertiser_currency string Oui Type de devise utilisée par l’annonceur.
insertion_order_id int Oui ID de l’ordre d’insertion.
campaign_id int Oui ID de campagne.
campaign_name string Non Nom de la campagne associée à la vente aux enchères.
campaign string Non Déconseillé.
advertiser_id int Oui ID de l’annonceur. Si la valeur est 0, soit l’impression a été achetée par un acheteur externe, soit une valeur par défaut ou une valeur PSA a été affichée.
line_item_id int Oui ID de l’élément de ligne.
advertiser_name string Non Nom de l’annonceur.
advertiser string Non Déconseillé.
split_id int Oui ID du fractionnement qui a acheté les impressions dans ce jeu de données. Les fractionnements s’appliquent uniquement aux éléments de ligne augmentée. Pour tous les rapports qui contiennent des campagnes, le (s’il split_id est inclus) est null.
split_name string Oui Nom du fractionnement qui a acheté les impressions dans ce jeu de données. Les fractionnements s’appliquent uniquement aux éléments de ligne augmentée. Pour tous les rapports qui contiennent des campagnes, le (s’il split_name est inclus) est null.
campaign_code string Non Code affecté par l’utilisateur utilisé pour identifier la campagne.
advertiser_code string Non Code affecté par l’utilisateur associé à l’annonceur.
geo_country_code string Oui Code de pays de l’emplacement de l’utilisateur tel que défini par le service de pays.
geo_country_id int Oui ID de pays de l’emplacement de l’utilisateur tel que défini par le service de pays. 250 s’affiche dans les cas où nous ne connaissons pas le pays ou si le pays ne correspond pas correctement à un emplacement dans notre base de données.
geo_region_code string Non Code de région de l’emplacement de l’utilisateur tel que défini par le service régional.
geo_region_id int Oui ID de région de l’emplacement de l’utilisateur tel que défini par le service régional. 4291 est indiqué dans les cas où nous ne connaissons pas la région ou si la région ne correspond pas correctement à un emplacement dans notre base de données.
geo_dma_id int Oui ID de l’emplacement de la zone de marché désignée de l’utilisateur, tel que défini par le service de zone de marché désignée.

Remarque : Pourquoi est-ce que je vois un ID DMA de 1?
Notre rapport dérive DMA de la ville enregistrée pour la vente aux enchères. Toutefois, notre fournisseur de services géographiques est parfois incapable de déterminer une ville à partir de l’adresse IP associée à l’impression, même lorsque DMA est déterminé. Par conséquent, il existe des cas où une campagne ciblant un DMA spécifique a des impressions dans les rapports montrant un DMA de 1.
geo_dma_name string Non Nom de la zone de marché désignée de l’utilisateur, tel que défini par le service de zone de marché désignée.
geo_postal_code string Oui Code postal de l’emplacement de l’utilisateur. Pour les codes postaux, consultez Postal Code Service.
geo_city_id int Oui ID de l’emplacement de la ville de l’utilisateur. Pour les ID de ville, consultez City Service.
geo_city_name string Oui Nom de la ville de l’utilisateur. Pour les noms de ville, consultez City Service.
insertion_order_name string Non Nom de l’ordre d’insertion.
insertion_order_code string Non Code défini par l’utilisateur associé à l’ordre d’insertion.
line_item_name string Non Nom de l’élément de ligne.
line_item_code string Non Code défini par l’utilisateur associé à l’élément de ligne.
geo_country_name string Non Nom du pays de l’utilisateur, tel que défini par le service de pays.
geo_region_name string Non Nom de la région de l’emplacement de l’utilisateur, tel que défini par le service régional.
insertion_order string Non Déconseillé.
line_item string Non Déconseillé.
geo_country string Non Déconseillé.
geo_region string Non Déconseillé.
geo_dma string Non Déconseillé.
pixel_id int Oui Numéro d’identification unique du pixel de conversion.

Remarque : cette dimension retourne un maximum de 10 pixels de conversion. En outre, vous pouvez filtrer par au plus 10 pixels de conversion. Bien que pixel_id soit groupable, nous vous déconseillons de regrouper par cette dimension, car cela entraîne l’affichage des événements de conversion dans des lignes distinctes des événements d’impression et de clic. Nous partons généralement du principe que vous souhaitez afficher tous ces événements dans une seule ligne afin de pouvoir récupérer des valeurs précises et agrégées pour les calculs du taux de conversion et du coût par conversion. Par conséquent, nous vous recommandons plutôt de filtrer par pixel_id afin de pouvoir récupérer les nombres de conversions et les métriques associées pour vos ID de pixel les plus pertinents.
buying_currency string Oui Devise de transaction utilisée par l’acheteur pour acheter cette impression.
uk_constituent_country string Non Pays constitutif de l’utilisateur. Cela s’applique au Royaume-Uni. Les valeurs admises sont les suivantes :
- England
- Scotland
- Wales
- Northern Ireland
congressional_district_id int Oui L’ID du district du congrès
congressional_district_name string Non Nom du district du congrès
state_house_district_id int Oui L’ID du district de la maison d’état
state_senate_district_id int Oui L’ID du district du sénat d’État
state_house_district_name string Non Nom du district de la maison d’état
state_senate_district_name string Non L’ID du district du sénat d’État

Mesures

Column Type Exemple Formule Description
imps int Lutins Nombre total d’impressions (servies et revendues).
clicks int Clics Nombre total de clics sur toutes les impressions.
cost Argent Coût Coût total de l’inventaire acheté.
booked_revenue Argent booked_revenue Chiffre d’affaires total réservé par l’intermédiaire d’annonceurs directs (élément de ligne).
cpm Argent Cpm Coût par mille impressions.
total_convs int total_convs Nombre total de conversions post-affichage et post-clic.
convs_rate double total_convs / imps Ratio des conversions en impressions.
post_view_convs int post_view_convs Nombre total de conversions post-affichage enregistrées.
post_click_convs int post_click_convs Nombre total de conversions post-clic enregistrées.
profit Argent booked_revenue - total_cost Chiffre d’affaires réservé moins le coût total.
click_thru_pct double (clics / imps) x 100 Taux de clics en impressions, exprimé sous forme de pourcentage.
external_imps int external_imps Nombre d’impressions externes (hors réseau).
external_clicks int external_clicks Nombre de clics externes (hors réseau).
booked_revenue_adv_curr Argent booked_revenue_adv_curr Chiffre d’affaires total enregistré par l’intermédiaire d’un annonceur direct, exprimé dans la devise de cet annonceur.
total_cost Argent 123.45 total_cost = media_cost + data_costs + partner_fees + commissions + serving_fees + publisher_revenue Montant total des coûts accumulés au cours de la période indiquée. Cela inclut généralement deux types de coûts, les coûts budgétés (coût des médias, coût des données, frais de partenaire, frais de service, commissions) et les revenus des éditeurs si vous suivez les paiements des éditeurs sur la plateforme.

Remarque : Nous avons ajouté une logique pour empêcher le double comptage des frais tiers pendant la période de changement cassant.
total_cost_ecpm Argent 123.45 (total_cost/imps) * 1 000 Coût total pour 1 000 imps.
total_cost_ecpc Argent 123.45 total_cost/clics Coût total par clic.
total_cost_ecpa Argent 123.45 total_cost/conversions Coût total par conversion.
profit_ecpm Argent 123.45 ((booked_revenue - total_cost)/imps) * 1 000 Profit par 1 000 imps.
profit_ecpc Argent 123.45 (booked_revenue - total_cost)/clics Profit par clic.
profit_ecpa Argent 123.45 (booked_revenue - total_cost)/conversions Profit par conversion.
profit_margin Argent 123.45 (booked_revenue - total_cost)/booked_revenue Marge bénéficiaire de l’acheteur.
video_skips int 10 Nombre total de fois où un utilisateur a ignoré la vidéo. Utilisez cette métrique pour créer des rapports lors de l’achat d’un inventaire non modifiable.
video_starts int 11 Nombre total de fois où le premier segment de la création vidéo a été téléchargé et démarré.
video_25_pcts int 10 Nombre total de fois où les créations vidéo ont terminé 25 % de la durée totale.
video_50_pcts int 10 Nombre total de fois où les créations vidéo se sont terminées 50 % de la durée totale.
video_75_pcts int 10 Nombre total de fois où les créations vidéo se sont terminées 75 % de la durée totale.
video_completions int 12 Nombre total de fois où les créations vidéo ont été lues pendant toute la durée.
video_served int 10 Nombre total de réponses vidéo envoyées au lecteur. Une réponse publicitaire se produit lorsque le document VAST (XML) est servi en réponse à une demande. Une réponse publicitaire n’indique pas nécessairement une impression réussie. Pour une impression, la première image de la vidéo doit être servie.
video_errors int 2 Nombre total de fois qu’une erreur vidéo s’est produite.
revenue_per_video_complete Argent 25.76 Chiffre d’affaires par saisie semi-automatique de la vidéo.
cost_per_video_complete Argent 22.76 Coût par saisie semi-automatique de la vidéo.
video_completion_rate double 1.12359550561797% (saisies vidéo/impressions totales) x 100 Rapport entre les saisies semi-vidéo et les impressions, exprimé sous forme de pourcentage.
video_start_rate double 1.12359550561797% Pourcentage de fois où le premier segment de la création vidéo a été téléchargé et démarré.
video_skip_rate double 1.12359550561797% Pourcentage de fois où l’utilisateur a choisi d’ignorer la vidéo.
booked_revenue_buying_currency Argent Chiffre d’affaires réservé par l’acheteur pour acheter cette impression.
cost_buying_currency Argent Montant du coût multimédia pour l’éditeur direct et l’inventaire acheté en temps réel dans la devise utilisée par l’acheteur pour acheter l’inventaire.

Remarque : Les taux de change ne sont pas encore disponibles dans les rapports.
cpm_buying_currency Argent Coût par 1 000 impressions dans la devise utilisée par l’acheteur pour acheter l’inventaire.

Remarque : Les taux de change ne sont pas encore disponibles dans les rapports.
cost_ecpa_buying_currency Argent Coût par acquisition/conversion dans la devise utilisée par l’acheteur pour acheter l’inventaire.
cost_ecpc_buying_currency Argent Coût par clic dans la devise utilisée par l’acheteur pour acheter l’inventaire.
revenue_ecpm_buying_currency Argent Chiffre d’affaires pour 1 000 impressions dans la devise d’achat.
revenue_ecpc_buying_currency Argent Chiffre d’affaires par clic dans la devise d’achat.
revenue_ecpa_buying_currency Argent Chiffre d’affaires par conversion dans la devise d’achat.
total_cost_buying_currency Argent Somme totale des coûts médias, des coûts de données et des frais de partenaire dans la devise d’achat (annonceur)

Exemples

Create une demande de rapport au format JSON

Le fichier doit contenir le report_type de "geo_analytics" , ainsi que les colonnes et les report_interval que vous souhaitez récupérer. Pour obtenir une explication complète des champs qui peuvent être inclus dans le fichier, consultez service de rapports.

Notez que plus vous regroupez de dimensions, plus le jeu de données retourné sera volumineux. Le traitement des jeux de données plus volumineux peut prendre beaucoup plus de temps. Veillez donc à regrouper uniquement les dimensions dont vous avez besoin.

$ cat geo_analytics

{
    "report":{
        "report_type":"geo_analytics",
        "timezone":"EST5EDT",
        "report_interval":"last_7_days",
        "groups":[
            "advertiser_id"
        ],
        "columns":[
            "advertiser_id",
            "imps",
            "clicks",
            "click_thru_pct",
            "total_convs",
            "convs_rate",
            "booked_revenue",
            "cost",
            "profit",
            "cpm"
        ],
        "orders":[
            "advertiser_id",
            "imps",
            "clicks",
            "click_thru_pct",
            "total_convs",
            "convs_rate",
            "booked_revenue",
            "cost",
            "profit",
            "cpm"
        ]
    }
}

POST la demande au service de rapport

$ curl -b cookies -X POST -d @geo_analytics 'https://api.appnexus.com/report'
{
  "response": {
    "status": "OK",
    "report_id": "58e7a1db8d0ccf222e21ffc7c3cd01fb"
  }
}

GETle 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 régulièrement 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 indiqué à l’étape suivante.

$ curl -b cookies "https://api.appnexus.com/report?id=58e7a1db8d0ccf222e21ffc7c3cd01fb"

{
    "response": {
        
        "execution_status": "ready",
        "report": {
            "url": "https://hb.nym1.sand-08.adnxs.net/report-download?id=58e7a1db8d0ccf222e21ffc7c3cd01fb",
            "query_time": "0",
            "finished_on": "2013-02-19 18:28:51",
            "started_on": "2013-02-19 18:28:48",
            "entity_id": "0",
            "user_id": "2027",
            "report_size": "93",
            "row_count": "0",
            "header_info": "Report ID:,58e7a1db8d0ccf222e21ffc7c3cd01fb
Run at:,2013-02-19 18:28:46
Start date:,2013-02-12 05:00:00
End date:,2013-02-19 05:00:00
Timezone:,EST5EDT
User:,Ursula Nimbus (2027)
",
            "json_request": "{"report":{"report_type":"geo_analytics","timezone":"EST5EDT","report_interval":"last_7_days","groups":["advertiser_id"],"columns":["advertiser_id","imps","clicks","click_thru_pct","total_convs","convs_rate","booked_revenue","cost","profit","cpm"],"pivot_report":false,"fixed_columns":[],"orders":["advertiser_id","imps","clicks","click_thru_pct","total_convs","convs_rate","booked_revenue","cost","profit","cpm"],"name":" Report - 02\/19\/2013","ui_columns":["advertiser_id","imps","clicks","click_thru_pct","total_convs","convs_rate","booked_revenue","cost","profit","cpm"]}}",
            "fact_cache_error": "did not find any cache table for 30,31,36,66,32,34",
            "fact_cache_hit": false,
            "cache_hit": false,
            "created_on": "2013-02-19 18:28:46",
            "name": " Report - 02/19/2013"
        },
        "status": "OK"
    }
}

GET les données de rapport du service de téléchargement de rapports

Utilisez le service de téléchargement de rapports pour télécharger vos données dans un fichier. Le nom du service et l’ID de rapport peuvent être extraits du url champ dans la réponse.

$ curl -b cookies "https://api.appnexus.com/report-download?id=58e7a1ddb80ccf222e21ffc7c3cd01fb" > /tmp/geo_analytics.csv

Remarque

Il existe une limite de 100 000 lignes par rapport lorsque vous les téléchargez en tant que fichier XLSX et Excel.

  • Last updated on