追加のSub IDの使用

で説明したとおり Sub Idsのドキュメントを使用する、Sub Idsは出版社がトラフィックをセグメント化するために使用します。たとえば、トラフィックソース別にこれを行うことがあります。この情報は次に、 統計 タブの サブID サブタブに表示されます。

これに加えて、本質的に sub とまったく同じ、さらに2つのパラメータがあります: sub2 と sub3.

例

非同期広告ゾーン: バナー、スティッキーバナー、インスタントメッセージ、アウトストリーム広告、マルチフォーマット

追加された data-sub = XXXXXX, data-sub2 = XXXXXX および 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>

iFrame

追加された &sub= XXXXXX, &sub2= XXXXXX および &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>

ネイティブ

として追加 data-ad_sub= "XXXXXX"; data-ad_sub2 = "XXXXXX"; data-ad_sub3 = "XXXXXX";

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

RTB

で追加 ext オブジェクトとして &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
   }
}

これらのパラメータを使用すると、トラフィックをさらに細かくセグメント化できます。ただし、subとは異なり、これは サブID のサブタブには表示されません 統計 タブ。ただし、これらは内部では記録しています。これらの指標のデータを取得する唯一の方法は、 パブリッシャー向けAPI Global Routes.

sub2とsub3からそれぞれデータを取得するためのリクエストの例を2つ示します:

sub2と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
}

sub2とsub3でのフィルタリングとグループ化

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

注: 2次元でのみグループ化できます。もし subでグループ化したい場合は、どちらか一方を削除する必要があります sub2 または sub3。そうしないと、レスポンスでエラーが生成されます。

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