Pular para o conteúdo principal

Using Additional Sub IDs

Conforme explicado na documentação [Using Sub Ids] (subids.md), os subidentificadores são usados pelos editores para segmentar o tráfego. Por exemplo, eles podem fazer isso por fonte de tráfego. Esta informação será então apresentada no separador Estatísticas, no sub- separador Sub IDs.

Para além deste, existem mais dois parâmetros que são essencialmente iguais a "sub": "sub2" e "sub3".

Exemplos​

Zonas de anúncios assíncronos: Banners, Sticky Banners, mensagens instantâneas, anúncios Outstream e formatos múltiplos​

Adicionados data-sub = XXXXXX, data-sub2 = XXXXXX e data-sub3 = XXXXXX

<script async type="application/javascript" src="https://ads.examplesite.com/ad-provider.js"></script>
<ins class="adsbynetwork" data-zoneid="1234567" data-sub="XXXXXX" data-sub2="XXXXXX" data-sub3="XXXXXX"></ins>
<script>(AdProvider = window.AdProvider || []).push({"serve": {}});</script>

iFrames​

Adicionado &sub= XXXXXX, &sub2= XXXXXX e &sub3= XXXXXX

<iframe src="//a.examplesite.com/iframe.php?idzone=1234567&size=300x250&sub=XXXXXX&sub2=XXXXXX&sub3=XXXXXX" width="300" height="250" scrolling="no" marginwidth="0" marginheight="0" frameborder="0"></iframe>

Nativo​

Adicionado como data-ad_sub= "XXXXXX"; data-ad_sub2 = "XXXXXX"; data-ad_sub3 = "XXXXXX";

data-ad_sub= "XXXXXX";
data-ad_sub2 = "XXXXXX";
data-ad_sub3 = "XXXXXX";

<script type="text/javascript" data-idzone="123" data-ad_sub="123456" data-ad_sub="789101" data-ad_sub="1213141" src="https://a.examplesite.com/nativeads.js"></script>

RTB​

Adicionado no objeto ext como &sub=XXXXXX, &sub2=XXXXXX, &sub3=XXXXXX




{
   "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
   "imp": [
       {
           "id": "974090632",
           "banner": {
               "w": 300,
               "h": 250
           }
       }
   ],
   "site": {
       "id": "12345",
       "domain": "sitedomain.com",
       "cat": ["IAB25-3"],
       "page": "https://sitedomain.com/page"
   },
   "device": {
       "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36",
       "ip": "131.34.123.159",
       "geo": {
           "country": "IRL"
       },
       "language": "en",
       "os": "Linux & UNIX",
       "js": 0,
       "ext": {
           "remote_addr": "131.34.123.159",
           "x_forwarded_for": "",
           "accept_language": "en-GB;q=0.8,pt-PT;q=0.6,en;q=0.4,en-US;q=0.2,de;q=0.2,es;q=0.2,fr;q=0.2"
       }
   },
   "user": {
       "id": "57592f333f8983.043587162282415065"
   },
   "ext": {
       "sub": 1221,
       "sub2": 2222,
       "sub3": 3333
   }
}

Estes parâmetros podem ser utilizados para segmentar ainda mais o tráfego. No entanto, ao contrário do sub, este não será apresentado no sub- separador Sub IDs do separador Estatísticas. No entanto, registamo-los internamente. A única maneira de obter os dados para essas métricas é por meio da [API Global Routes for Publishers] (https://api.exoclick.com/v2/docs/#!/47statistics/post_statistics_publisher_global).

Eis dois exemplos de como deve ser o pedido para obter dados de sub2 e sub3, respetivamente:

Agrupamento por sub2 e sub3​


{
  "count": 0,
  "detailed": 0,
  "timezone": "Europe/Dublin",
  "totals": 1,
  "filter": {
    "date_from": "2019-11-07",
    "date_to": "2019-11-07",
     "zone_id": [
      1234567
    ]
  },
  "group_by": [
    "sub2",
    "sub3"
  ],
  "order_by": [
    {
      "field": "impressions",
      "order": "desc"
    }
  ],
  "projection": [
    "base"
  ],
  "limit": 25,
  "offset": 0
}

Filtragem e agrupamento por sub2 e sub 3​



{
  "count": 0,
  "detailed": 0,
  "timezone": "Europe/Dublin",
  "totals": 1,
  "filter": {
    "date_from": "2019-11-07",
    "date_to": "2019-11-07",
    "sub": [
      10001
    ],
    "sub2":[
      10002
    ],
    "sub3":[
      10003
    ],
    "zone_id": [
      1234567
    ]
  },
  "group_by": [
    "sub2",
    "sub3"
  ],
  "order_by": [
    {
      "field": "impressions",
      "order": "desc"
    }
  ],
  "projection": [
    "base"
  ],
  "limit": 25,
  "offset": 0
}

Nota: Só é possível agrupar em duas dimensões. Se pretender agrupar por "sub", terá de remover "sub2" ou "sub3". Caso contrário, a resposta gerará um erro.


{
  "message": "Request `group_by` data is invalid."
}