Informe de superposición de segmentos

Nota:

  • Actualmente, este servicio solo está disponible para un conjunto limitado de clientes y empleados de Microsoft.

  • Reemplaza el informe de únicos diarios del segmento de inventario existente, que quedó en desuso el 15/11/12.

El informe de superposición de segmentos permite a los compradores ver datos sobre la intersección del inventario disponible con un segmento en particular, filtrados por área geográfica, vendedor o estado de auditoría. Ofrece respuestas a preguntas como:

  • ¿Cuántas impresiones únicas revisadas por la plataforma podré comprar para mi segmento del ID de vendedor 123?
  • ¿Cuánto volumen de impresiones está disponible en Canadá para mi segmento del ID de vendedor 456?

El objetivo de este informe es mostrarle el inventario que realmente puede seleccionar para la compra. Por ese motivo, tiene en cuenta la configuración del lado del editor del Servicio de perfiles de anuncios y el Servicio de miembros de la plataforma.

Nota:

Disponibilidad de segmento y muestreo estadístico

Debido al alto volumen de impresiones en nuestra plataforma, este informe se basa en un muestreo estadístico. Esto significa que cualquier combinación de vendedor y segmento que comprenda menos de 1,000 usuarios únicos no se incluirá en este informe, ya que nuestros analistas han determinado que carecen de significación estadística.

Usuarios Administración y lógica de visibilidad

Nota:

Esta sección solo es visible para los empleados de AppNexus. Muestra los campos que los clientes no pueden ver ni editar.

Las llamadas a este informe sin el parámetro de cadena de consulta devolverán información sobre todo el inventario disponible sin ninguna lógica de member_id visibilidad aplicada. Por lo tanto, los usuarios administradores tendrán que pasar una member_id a través de la cadena de consulta para que se aplique la lógica de visibilidad de ese miembro. Vea los ejemplos siguientes.

Período de tiempo

El marco de tiempo cubierto por este informe son los siete días anteriores, con actualizaciones diarias. Debido a la disponibilidad de un período de tiempo fijo, no se requiere ningún "report_interval" campo en la solicitud JSON. Para obtener más información, consulte los siguientes ejemplos .

Dimensions

Nota:

Mié, 19 dic 2012

"inv_src" y los estados de auditoría que no "appnexus_reviewed" se hayan deshabilitado en el nivel de datos y estén a punto de quitarse de este informe.

Column Tipo Ejemplo Descripción
segment_id Entero 123 El identificador del segmento cuyo comportamiento de exploración está investigando.

Filtrar por: Sí
seller_member_id Entero 456 El id. de miembro del vendedor cuyo inventario está investigando.

Filtrar por: Sí
seller_member_name string "PubMatic" El nombre del miembro vendedor en cuyo inventario se basa este informe. Si el miembro ha optado por mantener la exposición privada de su plataforma, se mostrará un valor como "Seller 453" . Para obtener más información sobre los diferentes tipos de exposición a la plataforma entre los que pueden elegir los miembros, consulte el Servicio para miembros de la plataforma.

Valor predeterminado: NA
Filtrar por: Sí
inventory_type enumeración "seller" Puede filtrar el informe por vendedor. Valor permitido: "seller"

Valor predeterminado: "seller"
Filtrar por: Sí
geo_country enumeración "CA" Una cadena de dos caracteres que indica el país o región en el que se ha visto la impresión.

Valor predeterminado: "--" (Esto significa "sin código de país" o "segmentación mundial").
Filtrar por: Sí
audit_type enumeración "appnexus_reviewed" El estado de auditoría del dominio en el que se mostrará la impresión. Valores permitidos:
- "any_audit_status": incluye los cuatro estados de auditoría posibles: unaudited, , seller-reviewedAppNexus-reviewede AppNexus-and-seller-reviewed inventario.
- "appnexus_reviewed": incluye un estado de auditoría: solo AppNexus-reviewed inventario.
- "appnexus_seller_reviewed": incluye tres estados de auditoría: seller-reviewed, AppNexus-reviewed, y seller- and-AppNexus-reviewed.

Valor predeterminado: "any_status"
Filtrar por: Sí
inventory_id Entero 999 El identificador del vendedor.

Filtrar por: Sí

Métricas

Column Tipo Ejemplo Descripción
avg_total_imps Entero 1024 El número medio diario de impresiones disponibles de ese vendedor asociado al segmento elegido. Este número incluye todas las impresiones en todo el mundo (por ejemplo, una geo_country de "--").
avg_imps Entero 57180 El número medio diario de impresiones disponibles, dados los filtros adicionales que hayas especificado más allá seller_member_id de y segment_id. Compáralo para avg_total_imps determinar los efectos de la segmentación de tu campaña en la disponibilidad del inventario.
avg_uniques Entero 12455 El número medio diario de impresiones disponibles asociadas a usuarios únicos, dada tu elección de seller_member_id y .geo_country

Nota: Disponibilidad de los únicos
Solo hay dos casos en los que este informe mostrará la "avg_uniques" métrica:
- Cuando hayas elegido filtrar por "segment_id" y un "inventory_type" de "seller" (el valor predeterminado).
- Cuando hayas elegido filtrar por "segment_id", un "inventory_type" de "seller" y "geo_country".
En todos los demás casos, solo la "avg_imps" métrica estará disponible y la "avg_uniques" columna contendrá el valor de "N/A".

Ejemplos

Enumere los orígenes de inventario que se superponen con su segmento

$ 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,
              ],
          },
  ...
  }

Enumere los orígenes de inventario que se superponen con el segmento, en formato 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
...

Enumere todo el inventario disponible en todo el mundo donde se puede encontrar su segmento

$ 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"
  }
}

Enumera el inventario, ordenado por avg_imps, de los 3 principales vendedores en cuyo inventario se ha visto tu segmento

$ 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