Data Science Toolkit - ログ レベルの増分フィード

  • [アーティクル]

Log-Level 増分フィードは、テスト グループ (広告に公開されているグループ) とコントロール グループ (広告に公開されていないグループ) の間でランダムに分割された対象ユーザーに表示されるインプレッションに関するデータを提供します。 このテストでは、各グループのユーザーが主導する収益を広告主が分析して、広告に公開されているユーザーからの増分リフトを決定できるように、各グループに対して同じターゲティングと入札のアプローチを使用します。 フィードには、インプレッションごとに 1 行が含まれています。

コンソール UI の増分 (必須)

  1. Xandr の UI で、[ 行項目の>基本セットアップ>の増分] に移動し、[ コントロール グループを使用する] を選択します。
  2. コントロール グループに割り当てるキーとトラフィックの割合を割り当てます。

Sequence

以下の 列 は、ログ レベルのフィード ファイルに表示される順序と同じ順序で一覧表示されます (ここでは上から下、ファイルでは左から右)。

データの可視性と "NULL" 値

すべての列は常に含まれますが、アクセス許可を持つデータのみを表示できます。 表示されない列は として "NULL"表示されます。

"NULL" は、次の場合に返される可能性があります。

  • インプレッションの販売者には、そのフィールドの値を購入者から非表示にする可視性設定があります (このトランザクションで購入者であると仮定します)。
  • データは使用できません。

次の Columns テーブルの Type 列の一部の値には、推奨される有効桁数またはかっこ内の長さが含まれています。 たとえば string(100) 、"この文字列はおそらく 100 文字以下である可能性があります (ただし、保証されません) であることを意味します。

整数の場合、サイズについては、「 整数キー 」セクションで説明します。

(浮動小数点) データ型の場合 numeric は、(18,6) の有効桁数を受け入れることをお勧めします。つまり、小数点の左側に 12 桁、右側に 6 桁の最大合計 18 桁が存在することを想定しています。

データ型の場合 string 、フィールドの推奨される長さはフィールドによって異なります。 次の表を参照してください。

注:

これらは推奨事項であり、保証ではありません。

データ型は、文書化されているとおりに正確であることを意図しています。 ただし、特定のデータ型に推奨される有効桁数または長さは、保証として読み取られるべきではありません。 たとえば、文字列または数値列の値が、このページに記載されている推奨される長さまたは有効桁数を超える場合があります。

推奨事項は、このデータを取り込むためのシステムの構築に役立ちます。 特定の統合で機能させるには、Standard フィードの出力に対して追加の処理を行う必要がある場合があります。

整数キー

  • tinyint = 1 バイト (8 ビット)
  • smallint = 2 バイト (16 ビット)
  • int = 4 バイト (32 ビット)
  • bigint = 8 バイト (64 ビット)

段組み

列インデックス 列名 型 説明
01 date_time UNIX エポック時間 インプレッションの日時 (たとえば、 15260575612018 年 5 月 11 日金曜日 4:52:41 PM (UTC) に翻訳する必要があります)。
02 auction_id_64 Bigint Xandr 一意のオークション識別子。
03 price numeric (18,6) ネットワークがインプレッションに対して支払っているドル金額 * 1000。
04 buyer_member_id int 購入者のメンバー ID。
05 advertiser_id int 広告主の ID。
06 campaign_group_id int 行項目の ID。
07 campaign_id int キャンペーンの ID。
08 creative_id int 配信されたクリエイティブの ID。
09 creative_freq int クリエイティブ レベルの頻度 (ユーザーがこのクリエイティブを見た時間)。
10 creative_rec int クリエイティブ レベルのリジェンシー (ユーザーがこのクリエイティブ広告を見てから経過した時間)。
11 advertiser_freq int 広告主レベルの頻度 (この広告主がクリエイティブを見た回数)。
12 advertiser_rec int クリエイティブレベルのリジェンシー (ユーザーがこの広告主のクリエイティブ広告を見てからどれくらいの時間が経過したか)。
13 is_remarketing Tinyint 新しいセグメント ピクセルがリマーケティング用であることを示します。
14 user_group_id int 広告主が A/B テストのためにユーザーをグループに分離する場合のグループ ID。
15 media_buy_cost numeric (18,6) ネットワークがインプレッションに対して支払っているドル金額 * 1000。
16 is_default int 既定のクリエイティブが配信されたことを示します。
17 pub_rule_id int で設定され、発行元の支払い方法を定義する発行元ルールの ID。
18 media_buy_rev_share_pct numeric(18,6) 発行元の収益シェア、または販売者がパブリッシャーと共有する予約収益の割合。 これは、0 から 1 の間の分数です。 100 を乗算すると、パーセンテージ値が取得されます。
19 pricing_type string(3) 広告申込情報の価格の種類、または購入者ネットワークが広告主によって支払われる方法 (例: cpm、cpc)。
20 can_convert Tinyint 関連付けられている変換ピクセルがインプレッションに関連付けられていることを示します。
22 control_pct numeric(18,6) 制御グループに送信されるトラフィックの割合。
23 control_creative_id int コントロール グループに提供されるクリエイティブの ID。
24 cadence_modifier numeric(18,6) インプレッションのケイデンス修飾子。これは、入札が乗算された数値です。
25 advertiser_currency string 広告主が使用する通貨。
26 advertiser_exchange_rate numeric(18,6) イベント当日の為替レート。 料金は毎日午後 4 時 GMT に更新されます。
27 insertion_order_id int 挿入順序の ID (使用されている場合)。
28 predict_type Tinyint 入札の最適化フェーズ。 使用可能な値:
-2 = 予測フェーズなし
-1 = 基本予測フェーズ
0 = 学習の放棄
1 = Learn
2 = 調整済み
3 = 最適化
4 = バイアス
5 = 最適化 1
8 = 最適化されたギブアップ
9 = ギブアップ以下の基本入札
29 predict_type_goal int 指定した予測型の目標量。
30 revenue_value_dollars numeric(18,6) ネットワークがインプレッションで獲得したドルの金額。
31 revenue_value_adv_curr string インプレッションで獲得したドル額(広告主の通貨で表示)。
32 commission_cpm numeric(18,6) 使用する場合は、cpm で手数料を指定します。
33 commission_revshare numeric(18,6) 使用する場合は、収益シェアの手数料を指定します。
34 serving_fees_cpm numeric(18,6) 広告を配信する際のメディア コストに加えて、配信料金。
35 serving_fees_revshare numeric(18,6) 広告配信時の収益分配に加えて、配信料金。
36 publisher_currency string(3) 発行元が支払われる通貨。
37 publisher_exchange_rate numeric(18,6) 取引日の為替レート (発行元の通貨: USD)。
38 payment_type Tinyint 買い手が印象のために支払っている方法。 使用可能な値:
-1 = 支払いなし
0 = CPM
1 = CPC
2 = CPA
3 = 所有者 CPM
4 = 所有者 revshare
39 payment_value numeric(18,6) 指定した支払いタイプを使用してインプレッションに対して支払われた金額。
40 creative_group_freq int クリエイティブ グループ レベルの頻度 (ユーザーがこのクリエイティブ グループを見た回数)。
41 creative_group_rec int クリエイティブ グループ レベルのリジェンシー (ユーザーがこのクリエイティブ グループを見てからどれくらいの時間が経過したか)。
42 revenue_type Tinyint 購入者ネットワークが広告主によって支払われる方法、または売り手ネットワークが買い手ネットワークによって支払われた方法。 使用可能な値:

-1 = 支払いなし
0 = フラット CPM
1 = Cost Plus CPM
2 = コストプラスマージン
3 = CPC
4 = CPA
5 = Revshare
6 = 定額料金
7 = 変数 CPM (vcpm)
8 = 推定 CPM (est_cpm)
43 apply_cost_on_default int 既定のクリエイティブにコストを適用するかどうかを示します。
44 instance_id int このインプレッションのモバイル アプリ インスタンスの ID を指定します。 モバイル アプリ インスタンス サービスを使用して、ID に関連付けられているモバイル アプリ インスタンスを検索します。
45 vp_expose_gender bool 性別が公開されているかどうかを示します。
46 targeted_segments 配列 ターゲット セグメント ピクセルの ID。
47 ttl int セグメント ピクセルの有効期間 (TTL)。
48 auction_timestamp UNIX エポック時間 インプレッションの日時 (たとえば、 15260575612018 年 5 月 11 日金曜日 4:52:41 PM (UTC) に翻訳する必要があります)。
49 data_costs numeric(18,6) 合計データコストは、購入者が特定のインプレッションに対して支払ったコストです。
50 targeted_segment_list 配列 ターゲット セグメント ピクセルの ID。
51 campaign_group_freq int 広告申込情報レベルの頻度 (ユーザーがこの広告申込情報から広告を見た頻度)。
52 campaign_group_rec int 広告申込情報レベルのリジェンシー (ユーザーがこの広告申込情報から広告を見てから経過した時間)。
53 insertion_order_freq int 挿入順序レベルの頻度 (ユーザーがこの挿入順から広告を見た頻度)。
54 insertion_order_rec int 挿入順序レベルの再表示 (ユーザーがこの挿入順から広告を見てから経過した時間)。
55 buyer_gender string(1) ユーザーの性別 (既知の場合)。 可能な値は、"u"、"m"、"f" です。
56 buyer_age int ユーザーの年齢 (既知の場合)。
57 custom_model_id int オークションで使用されるカスタム モデルの ID。 カスタム モデルを使用しない場合、既定値は になります 0。
58 custom_model_last_modified int オークションで使用されたカスタム モデルが最後に変更されてからの日付と時刻 (Unix エポック時間)。 モデルが使用されなかった場合、既定値は になります 0。
59 custom_model_output_code string(7) デバッグとパフォーマンス分析に役立つログとレポートに渡される省略可能な文字列値。 custom_model_output_code は最大 7 文字の ASCII (7 ビット) 文字であり、一意である必要はありません。
60 bid_priority int 管理インプレッションのみに対するキャンペーンまたは広告申込情報の優先度を指定します。 その他のすべてのインプレッションの場合、既定値は です 0。
61 is_control Tinyint 配信されたクリエイティブがコントロール クリエイティブであるかどうかを示します。
0 = テストインプレッション
1 = コントロールインプレッション
2 = Cookie ユーザーなし。 (Xandr には、テストグループと制御グループのサイズをスキューしないように Cookie ユーザーは含まれません)。
62 site_domain string(100) 購入者が利用できるサイトの最も詳細な識別子 (これは、供給パートナーのドメインである場合があります(たとえば、 doubleclick.com、在庫の再販を所有するネットワーク、または単に "再販売在庫" と言う場合があります)。 購入者への露出は、販売者の可視性プロファイルによって異なります。
63 eap numeric(18,6) 別の広告主通貨が指定されていない限り、プレースメント タグの推定平均価格 (ドル)。
64 ecp numeric(18,6) 別の広告主の通貨が指定されていない限り、プレースメント タグの見積もりクリア価格をドル単位で指定します。
65 user_id_64 Bigint Xandr Cookie ストアに格納されている Xandr 64 ビットユーザー ID。 このフィールドは、 0 Xandr がこのユーザーと一致しない場合、またはユーザーのブラウザーが Cookie を受け入れない場合です。 これは、オプトアウト ユーザー向けになります -1 。
66 predicted_engagement_rate int インプレッションが表示可能になる可能性を予測するために計算される割合。
67 seller_member_id int 販売者のメンバー ID。
68 bidder_auction_rank int インプレッション バスに送り返される他の入札と比較して、入札者によって計算された現在の入札の架空の順序付け順位。 上位の入札は、オークション ランク 0 (0 インデックス付き) です。
69 hashed_user_id_64 バイト 64 ビット ハッシュ値として表されるユーザー ID。
70 partition_time_millis UNIX エポック時間 UNIX エポック タイムスタンプ値 (ミリ秒単位) として表される、レコード行がに分類される時間単位パーティション。 データベースまたはデータ ウェアハウスへの読み込み時に、時間単位のパーティションを定義する場合に便利です。 Avro 形式の場合、このフィールドにはネイティブ タイムスタンプ検出用の timestamp-millis 論理型が指定されます。 たとえば、 15680772000002019 年 9 月 10 日午前 1 時 (UTC) の火曜日にも表すことができます。
71 device_unique_id string 注: このフィールドは、契約補遺に署名したクライアントに対してのみ設定されます。 詳細については、Xandr アカウント マネージャーにお問い合わせください。

モバイル デバイスを表す一意の識別子。 数値プレフィックスは、一意のデバイス識別子の種類を示します。
0 = IDFA (広告用 Apple ID)
1 = SHA1
2 = MD5
3 = ODIN
4 = OPENUDID
5 = AAID (Android 広告 ID)
6 = WINDOWSADID (Microsoft Advertising ID)
7 = RIDA (広告用のRoky id)
8.9 = AFAI (Amazon Fire OS)
8.10 = TIFA (Tizen Identifier for Advertising (Samsung Ad ID))
8.11 = VIDA (Vizio Advertising ID)
8.12 = LGUDID (LG 固有のデバイス ID)
72 ip_address string 注: このフィールドは、契約補遺に署名したクライアントに対してのみ設定されます。 詳細については、Xandr アカウント マネージャーにお問い合わせください。

ユーザーの IP アドレス。

増分