どのようにお手伝いできますか?

PBAのローデータレポート

  • 更新

概要:PBAのローデータレポートは、Data Lockerで利用できます。

PBAのローデータレポート

PBAのローデータレポートを使用して、ユーザージャーニーやユーザーの行動を分析できます。

レポートの説明

PBAローデータレポートの種類

ローデータレポートの種類 説明
Webサイト訪問
  • Webサイトへの訪問を記録します。
  • Webサイトへの流入を促すキャンペーンに対する、ユーザーの接触やエンゲージメントを計測できます。

Webサイトイベント

  • サブスクリプションの登録や購入など、Webサイト訪問者の行動が含まれます。
  • イベントのアトリビューション先は、過去30日間のうち、直接流入を除く最後のWeb訪問です。
  • イベントに関連するアトリビューションパラメータには、メディアソース、メディアチャネル、キャンペーンなどがあります。 
  • これらのパラメータを活用して、マーケティング施策を最適化できます。
  • メディアソース別にユーザーの行動を分析できます。
  • これらのフィールドの値は、PBAのメディアソースアトリビューションルールに従い、アトリビューション先の訪問から決定されます。
  • イベントは、特定のページビューではなく、特定のWebサイト訪問に関連付けることを目的としています。
  • ユーザーを誘導した流入元やキャンペーンと、そのユーザーが行った操作を把握するために利用してください。

ローデータレポートのフィールド

Webサイト訪問とWebサイトイベント

サンプルレポート

  • Webサイトイベント:CSV
  • Webサイト訪問:CSV

ローデータのフィールドの一部には、モバイルアプリユーザーのアトリビューションリンクや、アプリのインストールイベントに由来するデータが入力されます。 

フィールド一覧をCSV形式でダウンロード

Webサイト訪問・Webサイトイベントレポートのフィールド一覧

フィールド名 説明 形式 例
advertising_id 広告ID(GAID) 文字列 7fzzz3fa-8bad-46c9-bb03-fffffffffffffffffffffffff
af_web_id Web SDKから送信されるCookie ID 文字列 68972980-58f9-4ca6-8743-c0d633364b6d
amazon_aid Amazon Fire TVの広告ID 文字列 df07c7dc-cea7-4a89-b328-810ff5acb15d
android_id AndroidのデバイスID 文字列 68999980-58f9-4ca6-8743-c0d633364b6d
app_id 直近にインストールされたアプリのID 文字列 id123456789
app_name 直近のアプリ名 文字列 My App
app_version 直近のアプリバージョン 文字列 6.32
appsflyer_id AppsFlyer(インストール)ID 文字列 1594825729709-5655157112349378588
attributed_touch_time Webサイト訪問の場合は訪問時のタイムスタンプ、Webサイトイベントの場合はアトリビューション先のWeb訪問のタイムスタンプ yyyy-mm-dd hh:mm:ss 9/17/2020 0:09:25
attributed_touch_type タッチポイントの種類です。現在は常にwebsite visitが設定されます。 文字列 web visit
bundle_id PBAバンドルID 文字列 048db9bf-97r7-4m2f-919b-607b7kk806d0
campaign Webサイト訪問のアトリビューション情報 文字列 Summer Campaign
campaign_id Webサイト訪問のアトリビューション情報 文字列 12343425
city IPアドレスから判定 文字列 Spring Valley
country_code IPアドレスから判定 文字列 US
customer_user_id カスタマーユーザーID(CUID) 文字列 5a8771ecbb986ABC
device_type デバイスの種類 文字列 Desktop
dma IPアドレスから判定 文字列 501
event_name Webサイト訪問レポート:常にwebsite visit。 Webサイトイベントレポート:Web SDKが送信したeventName。  文字列 purchase
event_revenue 購入通貨で表したイベント収益額 文字列 199.99
event_revenue_currency event_revenueの3桁の通貨コード 文字列 USD, ZAR, EUR
event_revenue_usd 米ドルに換算したevent_revenue 文字列 57.46
event_source Web SDKまたはサーバー間通信 文字列 web SDK, S2S
event_time Webサイト訪問の場合は訪問時刻、Webサイトイベントの場合はイベント発生時刻 yyyy-mm-dd hh:mm:ss 9/17/2020 0:09:25
event_type 標準イベント、コンバージョンイベント、Webサイト訪問のいずれか 文字列 conversion event
event_url イベントが発生したWebページのURL(Webサイト訪問ではOriginal URLと同じ値) 文字列 http://www.brandpit.com/checkout
event_value Webサイトイベント:JSON形式のイベント値の詳細。 Webサイト訪問:常にnull。 JSON {"sku": "ABC123", “color": "blue", "unit_price":3.99,"currency": "USD"}
idfa 広告識別子 文字列 A56B9887-FEBA-458C-BEFC-C891F9DF7681
idfv 広告識別子 文字列 EBC2F523-B1E5-4484-A4C8-ADC32DC7C23D
imei デバイス識別子 文字列 3532211234
install_time 直近のアプリインストール時刻 yyyy-mm-dd hh:mm:ss 9/17/2020 0:09:25
ip 訪問者のIPアドレス 文字列 24.7.104.115
language ユーザーエージェントから取得 文字列 English
media_channel Webサイト訪問のアトリビューション情報 文字列 Ad
media_source Webサイト訪問のアトリビューション情報 文字列 googleadwords_int
media_type Webサイト訪問のアトリビューション情報 文字列 Paid
oaid 広告識別子 文字列 df07c7dc-cea7-4a89-b328-810ff5acb15d
original_url アトリビューション先のWebサイト訪問で、ユーザーをWebサイトにリダイレクトしたURL 文字列 https://www.brandpitt.com/signin?utm_source=Googleg&utm_term=shoes&utm_campaign=cool&c=summer&af_siteid=publisher&af_sub1=helloworld
platform プラットフォーム 文字列 macOS
postal_code IPアドレスから判定 文字列 10977
query_params リダイレクト元URLのクエリパラメータ(?以降の部分)例:https://www.brandpitt.com/signin?utm_source=Google&utm_term=shoes&utm_campaign=cool&c=summer&af_siteid=publisher&af_sub1=helloworld&af_keyword=shoes URLにクエリパラメータがない場合、値はnullになります。 JSON {"c":"summer",af_siteid":"publisher",af_sub1":helloworld",af_keywords":"shoes","utm_source":"Google","utm_campaign":"cool","utm_term":"shoes"}
referrer アトリビューション先のWebサイト訪問のHTTPドキュメントリファラ 文字列 https://www.google.com/
region IPアドレスから判定 文字列 NA
state IPアドレスから判定 文字列 NY

フィールドのリリースノート

日付 レポート 変更内容
2020-11-18

Webサイトイベント

Webサイト訪問

レポート名と構造を以下のように変更:

  • Web touchpointsをWebサイト訪問に変更
  • Web eventsをWebサイトイベントに変更
2020-10-04 Web-to-App

追加されたフィールド:

  • mobile_campaign_id
  • web_campaign_id

操作手順

Data LockerでのPBAレポートの設定

  • 各日に発生したイベントのPBAレポートは、Data Lockerのh=23フォルダに日次で書き込まれます。
  • 過去のデータを遡って書き込むことはできません。

AppsFlyerAdmin_us-en.png PBAレポートを有効にするには、アカウント管理者がData Lockerを設定する必要があります。

  1. AppsFlyerのサイドメニューで、レポート > Data Lockerを選択します。
  2. People-Based Attributionセクションのすべてのレポートを選択します。
  3. [設定を保存]をクリックします。

レポートのダウンロード方法は、Data Lockerレポートへのアクセスを参照してください。

Data LockerのPBAローデータレポートは、h=23フォルダに格納されます。 

例:t=website_events/dt=2020-11-26/h=23

PBAデータとモバイルデータの結合

このデータには、モバイルアプリとWebサイトの両方を利用する可能性が最も高いユーザーが反映されます。

モバイルアプリとWebサイトのデータを結合します。

方法: 

  • カスタマーユーザーID(CUID)を使用してレポートを結合します。
    • モバイルとWebで同じCUIDを使用し、CUIDをキーとしてレポートを結合します。
    • そのうえで、CUIDフィールドを使ってレポートを結合してください。
  • PBAによるプラットフォーム横断のユーザー識別:
    • PBAは、Webとモバイルのユーザーが同一人物かどうかを判定できます。
    • 同一人物と判定した場合、PBAのWebレポートには、Android広告ID、iOS IDFA、OAID、Amazon広告IDなどのモバイル広告IDに加えて、appsflyer_idと app_nameが含まれます。
    • このモバイル広告IDを使って、モバイルとWebのレポートを結合します。

PBAデータとモバイルデータの活用例

モバイルとWebのデータを結合して、プラットフォームやデバイスを横断したユーザーの行動を確認できます。結合したデータで、以下を行えます。 

  • ブランドのWebサイトやアプリを横断したユーザージャーニーの追跡
  • 各プラットフォームでのユーザー行動の分析
  • ユーザーエンゲージメントが高いプラットフォームの検討
  • コンバージョンが多く発生するプラットフォームの確認
  • Webからモバイルへのユーザー誘導施策の効果の計測

活用手順|Data Lockerファイルのダウンロードと結合

PBAのローデータはData Lockerで利用できます。各レポートのデータは、レポートタイプごとのh=23フォルダに、複数の圧縮ファイルとして格納されています。 

以下の手順で、次の操作を行います。

  • Cyber-Duckなど、S3ファイルをコピーできるツールを使用して、Data Lockerからファイルをコピーします。
  • Qを使用して、ファイルを1つのCSVファイルに結合します。 

Data LockerからのPBAデータのコピー

 事前準備:

Cyber Duckでデータをコピーするには:

  1. Cyberduckを開きます。
    利用できるデータタイプの一覧が表示されます。

    Duck_us-en.jpg

  2. PBAのレポートタイプをダブルクリックし、web_events、web_to_app、web_touch_pointsのいずれかを選択します。
    利用できるレポートの日付一覧が表示されます。
  3. 対象の日付を右クリックします。
  4. Download to a specific locationを選択し、保存先を指定します。 
    ファイルがダウンロードされます。
  5. 他のレポートタイプのデータをコピーするには、上記の手順を繰り返します。レポートタイプと日付の組み合わせごとに、パソコン上の別々のディレクトリに保存してください。 

CSVファイルの結合: 

事前準備:

パソコンにQをインストールします。

Qを使用してデータを1つのCSVファイルに結合するには:

  1. コマンドラインまたはMacのターミナルで、データのあるディレクトリに移動します。
  2. 以下のコマンドを使用して、圧縮ファイルをpbadata.csvという名前の1つのファイルに結合します。
    注意:~は、パソコン上でQコマンドが配置されているパスまたはホームフォルダを示します。コマンドの実行時に、フルパスの指定が必要になる場合があります。 

    ~q "SELECT * from part*.gz" -d , -H -z -O >pbadata.csv
  3. Excelなどのツールでファイルを開きます。