Partager via

Rapport de chevauchement de segments

Remarque

  • Ce service est actuellement disponible pour un ensemble limité de clients et d’employés Microsoft uniquement.

  • Il remplace le rapport unique quotidien de segment d’inventaire existant, qui a été déprécié le 15/11/12.

Le rapport de chevauchement de segments permet aux acheteurs d’afficher des données sur l’intersection de l’inventaire disponible avec un segment particulier, filtrées par zone géographique, vendeur ou status d’audit. Il offre des réponses à des questions telles que :

  • Combien d’impressions uniques examinées par la plateforme vais-je pouvoir acheter pour mon segment auprès de l’ID de vendeur 123 ?
  • Combien de volume d’impression au Canada est disponible pour mon segment à partir de l’ID de vendeur 456 ?

L’objectif de ce rapport est de vous montrer l’inventaire que vous pouvez réellement cibler pour l’achat. Pour cette raison, il prend en compte les paramètres côté éditeur du service de profil publicitaire et du service membre de la plateforme.

Remarque

Disponibilité des segments et échantillonnage statistique

En raison du volume élevé d’impressions sur notre plateforme, ce rapport est basé sur un échantillonnage statistique. Cela signifie que toutes les combinaisons de vendeurs et de segments comprenant moins de 1 000 utilisateurs uniques ne seront pas incluses dans ce rapport, car nos analystes ont déterminé qu’elles ne sont pas significatives sur le plan statistique.

Administration utilisateurs et logique de visibilité

Remarque

Cette section est visible uniquement par les employés AppNexus. Il répertorie les champs que les clients ne peuvent ni voir ni modifier.

Les appels à ce rapport sans le member_id paramètre de chaîne de requête retournent des informations sur tout l’inventaire disponible sans aucune logique de visibilité appliquée. Par conséquent, les utilisateurs administrateurs doivent passer un member_id via la chaîne de requête pour que la logique de visibilité de ce membre soit appliquée. Consultez les exemples ci-dessous.

Période

Le délai couvert par ce rapport est les sept jours précédents, avec des mises à jour quotidiennes. En raison de la disponibilité de la période fixe, aucun champ n’est "report_interval" requis dans la requête JSON. Pour plus d’informations, consultez Exemples ci-dessous.

Dimensions

Remarque

19 décembre 2012

"inv_src" et les états d’audit autres que ceux qui "appnexus_reviewed" ont été désactivés au niveau des données et sont sur le point d’être supprimés de ce rapport.

Column Type Exemple Description
segment_id int 123 ID du segment dont vous recherchez le comportement de navigation.

Filtrer par : Oui
seller_member_id int 456 ID de membre du vendeur dont vous recherchez l’inventaire.

Filtrer par : Oui
seller_member_name string "PubMatic" Nom du membre vendeur dont l’inventaire est basé sur ce rapport. Si le membre a choisi de garder son exposition de plateforme privée, une valeur telle que "Seller 453" s’affiche. Pour plus d’informations sur les différents types d’exposition de plateforme que les membres peuvent choisir, consultez Platform Member Service.

Par défaut : NA
Filtrer par : Oui
inventory_type enum "seller" Vous pouvez filtrer le rapport par vendeur. Valeur autorisée : "seller"

Par défaut : "seller"
Filtrer par : Oui
geo_country enum "CA" Chaîne à deux caractères indiquant le pays dans lequel l’impression a été vue.

Valeur par défaut : "--" (Cela signifie « aucun indicatif de pays » ou « ciblage dans le monde entier »).
Filtrer par : Oui
audit_type enum "appnexus_reviewed" Audit status du domaine sur lequel l’impression sera affichée. Valeurs autorisées :
- "any_audit_status": inclut les quatre états d’audit possibles : unaudited, AppNexus-reviewed, seller-reviewedet AppNexus-and-seller-reviewed inventaire.
- "appnexus_reviewed": inclut un status d’audit : uniquement l’inventaireAppNexus-reviewed.
- "appnexus_seller_reviewed": inclut trois status d’audit : seller-reviewed, AppNexus-reviewedet seller- and-AppNexus-reviewed.

Par défaut : "any_status"
Filtrer par : Oui
inventory_id int 999 ID du vendeur.

Filtrer par : Oui

Mesures

Column Type Exemple Description
avg_total_imps int 1024 Nombre moyen quotidien d’impressions disponibles de ce vendeur associé au segment que vous avez choisi. Ce nombre inclut toutes les impressions dans le monde entier (par exemple, un geo_country de "--").
avg_imps int 57180 Nombre moyen quotidien d’impressions disponibles, en fonction des filtres supplémentaires que vous avez spécifiés au-delà seller_member_id de et segment_id. Comparez cette valeur avg_total_imps à pour déterminer les effets du ciblage de votre campagne sur la disponibilité des stocks.
avg_uniques int 12455 Nombre moyen quotidien d’impressions disponibles associées à des utilisateurs uniques en fonction de votre choix de seller_member_id et geo_country.

Remarque : Disponibilité des uniques
Il n’existe que deux cas dans lesquels la "avg_uniques" métrique sera affichée par ce rapport :
- Lorsque vous avez choisi de filtrer par "segment_id" et un "inventory_type" de "seller" (valeur par défaut).
- Lorsque vous avez choisi de filtrer par "segment_id", un "inventory_type" de "seller" et "geo_country".
Dans tous les autres cas, seule la "avg_imps" métrique est disponible et la "avg_uniques" colonne contient la valeur "N/A".

Exemples

Répertorier les sources d’inventaire qui chevauchent votre segment

$ cat report-request
{
    "sync-report": {
        "report_type":"segment_overlap",
        "filters": [
            {
                "segment_id":106,
                "inventory_type":"inv_src"
            }
        ]
    }
}

$ curl -b cookies -X POST -d @report-request "https://api.appnexus.com/sync-report"
{
      "response": {
          "status": "OK",
          "report": {
              "data": [
                  {
                      "inventory_type": "inv_src",
                      "id": "43307767",
                      "segment_id": 106,
                      "seller_member_id": 273,
                      "inventory_id": 0,
                      "geo_country": "--",
                      "audit_type": 2,
                      "avg_imps": 1202560,
                      "avg_uniques": 168940,
                      "inventory_name": null,
                      "seller_member_name": "Yahoo RTB member"
                  },
                  {
                      "inventory_type": "inv_src",
                      "id": "40720823",
                      "segment_id": 106,
                      "seller_member_id": 630,
                      "inventory_id": 0,
                      "geo_country": "--",
                      "audit_type": 3,
                      "avg_imps": 7180,
                      "avg_uniques": 3400,
                      "inventory_name": null,
                      "seller_member_name": "Marimedia Ltd."
                  },
                  ...
              ],
              "total_count": 332,
              "offset": 0,
              "count": 0,
              ],
          },
  ...
  }

Répertorier les sources d’inventaire qui chevauchent votre segment, au format CSV

$ cat report-request
{
    "sync-report": {
        "report_type":"segment_overlap",
        "filters": [
            {
                "segment_id":106,
                "inventory_type":"inv_src"
            }
        ]
    }
}

$ curl -b cookies -X POST -d @report-request "https://api.appnexus.com/sync-reportdownload"
segment_id,geo_country,seller_member_id,seller_member_name,audit_type,inventory_type,inventory_id,inventory_name,avg_imps,avg_uniques
106,--,273,Yahoo RTB member,2,inv_src,0,--,1202560,168940
106,--,630,Marimedia Ltd.,3,inv_src,0,--,7180,3400
106,--,86,Photobucket,2,inv_src,212,Photobucket Brandsafe,327500,14000
106,--,86,Photobucket,2,inv_src,15,Photobucket,574680,56300
106,--,514,AudienceScience,2,inv_src,0,--,1489240,271200
106,--,852,AdMeld,2,inv_src,1308,The Weather Channel,782700,210820
106,--,459,Rubicon,2,inv_src,924,Rubicon - Mom & Baby,2650020,35420
106,--,357,OpenX,2,inv_src,1186,Unanimis Auto2,22933,5167
106,--,74,PubMatic,2,inv_src,483,Detroit Free Press,31920,9360
106,--,74,PubMatic,2,inv_src,686,Netzero,739740,33120
106,--,181,Google AdExchange,2,inv_src,75,AdSense Long Tail - Entertainment,15078140,843800
106,--,468,"Kontera Technologies, Inc.",3,inv_src,0,--,5540,3960
106,--,852,AdMeld,2,inv_src,845,Lijit,7108180,474960
106,--,818,Media Shakers,2,inv_src,0,--,13560,2200
106,--,1264,WRAL,2,inv_src,0,--,464960,16160
106,--,181,Google AdExchange,2,inv_src,49,Slickdeals,1041720,46600
...

Répertorier tous les stocks disponibles dans le monde où votre segment se trouve

$ cat report-request.json
{
  "sync-report": {
    "filters": [
      {
        "segment_id": 94425
      }
    ],
    "report_type": "segment_overlap"
  }
}

$ curl -b cookies -X POST -d @report-request "https://api.appnexus.com/sync-report"
{
  "response": {
    "dbg_info": {
      "version": "1.12.39",
      "start_microtime": 1345224526.0922,
      "time": 1078.34815979,
      "warnings": [
      ],
      "db": "master",
      "s1ave_hit": false,
      "instance": "19.bm-hbapi.prod.nym1"
    },
    "sync-report": {
      "query": {
        "orders": [
          {
            "direction": "DESC",
            "order_by": "avg_imps0"
          }
        ],
        "string": "geo_country:\\-\\- AND segment_id:94425 AND inventory_type:2",
        "ast": {
          "inventory_type": 2,
          "segment_id": 94425,
          "geo_country": "\\-\\-"
        }
      },
      "count": 20,
      "offset": 0,
      "total_count": 243,
      "data": [
        {
          "audit_type": "any_status",
          "avg_total_imps": 296095900,
          "avg_imps": 296095900,
          "inventory_name": "YouTube",
          "seller_member_name": "Google AdExchange",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 39,
          "seller_member_id": 181,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1790532
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 221322600,
          "avg_imps": 221322600,
          "inventory_name": "OpenX - Default",
          "seller_member_name": "OpenX",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 1243,
          "seller_member_id": 357,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1831949
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 184479000,
          "avg_imps": 184479000,
          "inventory_name": "AdX - Unverticalized",
          "seller_member_name": "Google AdExchange",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 114,
          "seller_member_id": 181,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1796558
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 181159900,
          "avg_imps": 181159900,
          "inventory_name": "AdSense Long Tail - Entertainment",
          "seller_member_name": "Google AdExchange",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 75,
          "seller_member_id": 181,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1791449
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 144808000,
          "avg_imps": 144808000,
          "inventory_name": "Rubicon - Entertainment",
          "seller_member_name": "Rubicon",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 899,
          "seller_member_id": 459,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1839085
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 87032600,
          "avg_imps": 87032600,
          "inventory_name": "AdMeld - Default",
          "seller_member_name": "AdMeld",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 1241,
          "seller_member_id": 852,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1868874
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 77004000,
          "avg_imps": 77004000,
          "inventory_name": "Rubicon - News & Reference",
          "seller_member_name": "Rubicon",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 905,
          "seller_member_id": 459,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1839702
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 70802000,
          "avg_imps": 70802000,
          "inventory_name": "OpenX Longtail - Entertainment Vertical",
          "seller_member_name": "OpenX",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 513,
          "seller_member_id": 357,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1830368
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 33801500,
          "avg_imps": 33801500,
          "inventory_name": "Lijit",
          "seller_member_name": "AdMeld",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 845,
          "seller_member_id": 852,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1868690
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 31285500,
          "avg_imps": 31285500,
          "inventory_name": "Rubicon - Social Networking",
          "seller_member_name": "Rubicon",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 908,
          "seller_member_id": 459,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1840023
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 25680100,
          "avg_imps": 25680100,
          "inventory_name": "PubMatic - Default",
          "seller_member_name": "PubMatic",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 183,
          "seller_member_id": 74,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1785499
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 21725000,
          "avg_imps": 21725000,
          "inventory_name": "OpenX Longtail - Internet and Computing Vertical",
          "seller_member_name": "OpenX",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 528,
          "seller_member_id": 357,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1831072
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 21153300,
          "avg_imps": 21153300,
          "inventory_name": "Rubicon - Music",
          "seller_member_name": "Rubicon",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 904,
          "seller_member_id": 459,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1839527
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 20240500,
          "avg_imps": 20240500,
          "inventory_name": "AdSense Long Tail - Internet",
          "seller_member_name": "Google AdExchange",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 82,
          "seller_member_id": 181,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1792661
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 20214900,
          "avg_imps": 20214900,
          "inventory_name": "Rubicon - Mom & Baby",
          "seller_member_name": "Rubicon",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 924,
          "seller_member_id": 459,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1841696
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 19615600,
          "avg_imps": 19615600,
          "inventory_name": "AdSense Long Tail - Online Communities",
          "seller_member_name": "Google AdExchange",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 99,
          "seller_member_id": 181,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1795468
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 18702300,
          "avg_imps": 18702300,
          "inventory_name": "Rubicon - Anime",
          "seller_member_name": "Rubicon",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 918,
          "seller_member_id": 459,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1841234
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 17818000,
          "avg_imps": 17818000,
          "inventory_name": "Grooveshark",
          "seller_member_name": "Google AdExchange",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 972,
          "seller_member_id": 181,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1798102
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 17691200,
          "avg_imps": 17691200,
          "inventory_name": "Playlist",
          "seller_member_name": "Google AdExchange",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 104,
          "seller_member_id": 181,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1796215
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 16504800,
          "avg_imps": 16504800,
          "inventory_name": "AdSense Long Tail - Games",
          "seller_member_name": "Google AdExchange",
          "geo_country_name": "Worldwide",
          "geo_country": "--",
          "inventory_id": 79,
          "seller_member_id": 181,
          "segment_id": 94425,
          "inventory_type": "inv_src",
          "id": 1792146
        }
      ]
    },
    "status": "OK"
  }
}

Répertoriez les stocks, classés par avg_imps, parmi les 3 premiers vendeurs sur lesquels votre segment a été vu

$ cat report-request.json
{
  "sync-report": {
    "filters": [
      {
        "segment_id": 94425,
        "geo_country": "US"
      }
    ],
    "orders": [
      {
        "direction": "DESC",
        "order_by": "avg_imps"
      }
    ],
    "count": 3,
    "report_type": "segment_overlap"
  }
}

$ curl -b cookies -X POST -d @report-request "https://api.appnexus.com/sync-report"
{
  "response": {
    "dbg_info": {
      "version": "1.12.39",
      "start_microtime": 1345231627.9961,
      "time": 126.81794166565,
      "warnings": [
      ],
      "db": "master",
      "s1ave_hit": false,
      "instance": "17.bm-hbapi.prod.nym1"
    },
    "sync-report": {
      "query": {
        "orders": [
          {
            "order_by": "avg_imps",
            "direction": "DESC"
          }
        ],
        "string": "geo_country:US AND segment_id:94425 AND inventory_type:0",
        "ast": {
          "inventory_type": 0,
          "segment_id": 94425,
          "geo_country": "US"
        }
      },
      "count": 3,
      "offset": 0,
      "total_count": 104,
      "data": [
        {
          "audit_type": "any_status",
          "avg_total_imps": 893806800.0,
          "avg_imps": 338874800,
          "inventory_name": "Google AdExchange",
          "seller_member_name": "Google AdExchange",
          "avg_uniques": 25875000,
          "geo_country_name": "United States",
          "geo_country": "US",
          "inventory_id": 181,
          "seller_member_id": 181,
          "segment_id": 94425,
          "inventory_type": "seller",
          "id": 1790516
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 349341500,
          "avg_imps": 310694500,
          "inventory_name": "OpenX",
          "seller_member_name": "OpenX",
          "avg_uniques": 9203400,
          "geo_country_name": "United States",
          "geo_country": "US",
          "inventory_id": 357,
          "seller_member_id": 357,
          "segment_id": 94425,
          "inventory_type": "seller",
          "id": 1830356
        },
        {
          "audit_type": "any_status",
          "avg_total_imps": 424966400,
          "avg_imps": 284220200,
          "inventory_name": "Rubicon",
          "seller_member_name": "Rubicon",
          "avg_uniques": 11085600,
          "geo_country_name": "United States",
          "geo_country": "US",
          "inventory_id": 459,
          "seller_member_id": 459,
          "segment_id": 94425,
          "inventory_type": "seller",
          "id": 1838429
        }
      ]
    },
    "status": "OK"
  }
}
  • Last updated on