Ocean Engineオールインワンレポート
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
Ocean Engineオールインワンレポートは非推奨となり、AE管理画面では「オールインワンレポート（非推奨）」と表示されます。新しく統合プランを作成する場合は、Ocean Engine広告アップグレード版データレポートを使用してください。
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| オールインワンレポート | API | 集計データ | ✅ | ✅ | ✅ | ✅ |
オールインワンデータレポートは、各広告粒度、素材、キーワード階層の広告データに対応しており、分析ディメンションと指標が非常に豊富です。
統合の流れ
- Ocean Engineオープンプラットフォームにログインし、開発者アカウントとアプリを作成します
- アプリのAPP_ID、Secret、およびログインユーザーIDを取得します
- AE管理画面にログインし、サードパーティ統合モジュールでOcean Engineオールインワンレポートの統合プランを追加します
- 認証リンクを開き、データを取得する広告アカウントが属するOcean Engineアカウントにログインして、認証を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. 認証情報の取得
1.1 開発者アカウントとアプリの作成
Ocean Engineのデータを統合する前に、Ocean Engineの開発者アカウントを申請し、アプリを1つ作成する必要があります
- まず、Ocean Engineアカウントにログインまたは登録する必要があります。こちらのリンクからログイン・登録ページにアクセスしてください。Ocean Engineアカウントをお持ちの場合は、左下のログインを選択して該当するアカウントにログインします。アカウントをお持ちでない場合は、メールアドレスまたは携帯電話番号でOcean Engineアカウントを登録します
- ログインが完了すると、Ocean Engineオープンプラットフォームに移動します。ページ右上の「開発者管理画面」ボタンをクリックして、開発者管理画面に入ります
-
開発者アカウントを作成していない場合は、ここで開発者情報の入力と資格審査を完了する必要があります。1つの会社情報で登録・認証できる開発者アカウントは1つのみのため、必ず会社のメールアドレスで申請し、アカウントを大切に保管してください。具体的な申請手順については、公式ドキュメントを参照してください。
- 開発者タイプでは広告主または代理店を選択する必要があります。実際の状況に応じていずれかを選択してください。両者の違いは次のとおりです：
- 広告主：開発者アカウントと同じ会社主体の縦横組織アカウントの認証のみ申請できます
- 代理店：開発者アカウントと同じ会社主体の代理店アカウントの認証のみ申請できます
-
開発者アカウントの認証が完了したら、開発者公式サイトの「APPID管理」ページに移動し、「広告管理」タイプのアプリを作成します
- アプリ名、アプリアイコン、アプリの説明は実際の必要に応じて記入できます。アプリの用途には、Ocean Engineの広告配信データを自社のプラットフォームにコールバックするものと記述します
- ポストバックURLには「www.thinkingdata.cn」を入力してください。このURLは一時的なもので、プランの設定が完了したら変更する必要があります
- 申請する権限では、少なくとも「データレポート」権限を選択する必要があります
-
申請を提出すると、Ocean Engineが1営業日以内にアプリ作成（APPID）申請の審査を完了します
1.2 App ID、App Secretの取得
アプリの申請が完了したら、開発者管理画面に移動し、左側のサイドバーで「アプリ管理」-「基本アプリ」を開いて、作成したアプリを選択し、「編集」をクリックして「基本情報」ページに移動します。APP_IDとSecretを確認し、控えておきます。
1.3 ログインユーザーIDの取得
次に、ログインユーザーのIDを取得する必要があります。「Ocean Engineオープンプラットフォーム」に移動し、右上の「六角形のアイコン」をクリックしてから「Ocean Engine Zongheng」をクリックして管理画面に入ります。右上の「アカウント情報とセキュリティ」をクリックし、ログインユーザーIDを確認して控えておきます
1.4 まとめ
これで、必要な認証情報がすべて揃いました。この時点で、以下の情報を取得しているはずです：
- App ID
- App Secret
- ログインユーザーID
2. プランの設定
すべての認証情報を取得したら、AEシステムにログインし、「サードパーティ統合」モジュールで新しいプランの設定を完了できます。下図はOcean Engineオールインワンレポートの設定画面です。この章の内容に従ってプランを作成してください：
2.1 認証情報の設定
「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップに前の手順で取得した情報を入力します：
補足：
- APP ID：アプリのAPP ID
- APP Secret：アプリのAPP Secret
- Login ID：ログインユーザーID
- Account ID List：データを取得する広告アカウントIDです。入力しない場合は、認証したユーザー配下のすべての広告アカウントのデータを取得します
2.2 定期取得
「定期取得」モジュールで、AEシステムがOcean Engineオールインワンレポートを定期的に取得する方針を設定できます。毎日の特定の時刻に一定期間のデータを取得するよう選択できます。取得したデータもデータ量に計上されるため、定期取得で長すぎる期間のデータを取得しないことをお勧めします
2.3 格納設定
データをイベントとして書き込むかどうかを制御できます。オフにすると、データはイベントテーブルに書き込まれなくなるため、この設定はオフにしないでください。
2.4 統合構成
最後に、統合構成モジュールでデータ取得の詳細設定を制御できます。データの時間集計粒度、取得する指標フィールドとディメンション、格納後のイベント名などが含まれます。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_name | 格納後のイベント名。カスタマイズ可能な文字列型です。受信したデータはすべてこの名前をイベント名とします。 |
| source | metrics | データ内の指標。リスト型。カスタマイズ可能 |
| group_by | データ内のグループ化ディメンション。リスト型。カスタマイズ可能 |
必要に応じて統合構成を変更できます
2.4.1 分析ディメンション
以下の表は、オールインワンデータレポートが対応している分析ディメンションです。デフォルトのグループ条件は次のとおりです：
- STAT_GROUP_BY_TIME_HOUR
- STAT_GROUP_BY_CREATIVE_ID
オールインワンレポートのディメンションは以下の3種類に分かれており、各種類から最大1つずつ選択できます。調整が必要な場合は、選択したグループ条件をsource.group_byに記入してください
- 時間ディメンション
グループ条件の4つから1つを選択する必要があります。変更が必要な場合は、グループ条件をsource.group_byに記入してください
| グループ条件 | フィールド名 | 意味 | デフォルトかどうか |
|---|---|---|---|
| STAT_GROUP_BY_TIME_MONTH | stat_datetime | 時間 | |
| STAT_GROUP_BY_TIME_WEEK | |||
| STAT_GROUP_BY_TIME_DAY | |||
| STAT_GROUP_BY_TIME_HOUR | はい |
- IDディメンション
グループ条件の4つから1つを選択する必要があります。変更が必要な場合は、グループ条件をsource.group_byに記入してください
| グループ条件 | フィールド名 | 意味 | デフォルトかどうか |
|---|---|---|---|
| STAT_GROUP_BY_ADVERTISER_ID | advertiser_id | 広告主ID | |
| STAT_GROUP_BY_CAMPAIGN_ID | advertiser_id | 広告主ID | |
| campaign_name | 広告グループ名 | ||
| campaign_id | 広告グループID | ||
| STAT_GROUP_BY_AD_ID | advertiser_id | 広告主ID | |
| campaign_name | 広告グループ名 | ||
| campaign_id | 広告グループID | ||
| ad_name | 広告キャンペーン名 | ||
| ad_id | 広告キャンペーンID | ||
| STAT_GROUP_BY_CREATIVE_ID | advertiser_id | 広告主ID | はい |
| campaign_name | 広告グループ名 | ||
| campaign_id | 広告グループID | ||
| ad_name | 広告キャンペーン名 | ||
| ad_id | 広告キャンペーンID | ||
| creative_id | クリエイティブID |
- 細分-基本ディメンション
この中から最大1つを選択できます。変更が必要な場合は、グループ条件をsource.group_byに記入してください
| グループ条件 | フィールド名 | 意味 | デフォルトかどうか |
|---|---|---|---|
| STAT_GROUP_BY_PRICING | pricing | 入札方式 | |
| STAT_GROUP_BY_IMAGE_MODE | image_mode | 素材タイプ | |
| STAT_GROUP_BY_INVENTORY | inventory | 広告の優先配信面 | |
| STAT_GROUP_BY_CAMPAIGN_TYPE | campaign_type | 広告グループタイプ | |
| STAT_GROUP_BY_CREATIVE_MATERIAL_MODE | creative_material_mode | クリエイティブタイプ | |
| STAT_GROUP_BY_EXTERNAL_ACTION | external_action | コンバージョンタイプ | |
| STAT_GROUP_BY_LANDING_TYPE | landing_type | プロモーションタイプ | |
| STAT_GROUP_BY_PRICING_CATEGORY | pricing_category | 広告タイプ |
2.4.2 対象指標
以下の表は、オールインワンデータレポートが対応している常用指標の一部です。指標の総数が多いため、ここですべてを掲載することはできません。必要に応じて公式ドキュメントですべての指標の説明を確認してください。変更が必要な場合は、指標名をsource.metricsに記入してください
| 指標名 | 画面表示名 | デフォルトかどうか |
|---|---|---|
| active | アクティベーション数 | はい |
| active_cost | アクティベーションコスト | はい |
| active_pay_cost | 初回課金コスト | はい |
| active_pay_rate | 初回課金率 | はい |
| active_rate | アクティベーション率 | はい |
| active_register_cost | 登録コスト | はい |
| active_register_rate | 登録率 | はい |
| attribution_active_pay_7d_per_count | 7日間の1人あたり平均課金回数 | はい |
| attribution_convert | コンバージョン数（課金時間） | はい |
| attribution_convert_cost | コンバージョンコスト（課金時間） | はい |
| attribution_deep_convert | ディープコンバージョン数（課金時間） | はい |
| attribution_deep_convert_cost | ディープコンバージョンコスト（課金時間） | はい |
| attribution_game_pay_7d_cost | 7日間の課金コスト | |
| attribution_game_pay_7d_count | 7日間の課金回数 | |
| attribution_next_day_open_cnt | 翌日リテンション数 | |
| attribution_next_day_open_cost | 翌日リテンションコスト | |
| attribution_next_day_open_rate | 翌日リテンション率 | |
| avg_click_cost | 平均クリック単価 | はい |
| avg_show_cost | 1,000回表示あたりの平均費用 | はい |
| click | クリック数 | はい |
| click_install | クリックインストール数 | はい |
| convert | コンバージョン数 | はい |
| convert_cost | コンバージョンコスト | はい |
| convert_rate | コンバージョンデータ-コンバージョン率 | はい |
| cost | 総消費 | はい |
| ctr | クリック率 | はい |
| deep_convert | ディープコンバージョン数 | はい |
| deep_convert_cost | ディープコンバージョンコスト | はい |
| deep_convert_rate | ディープコンバージョン率 | はい |
| download | ダウンロード開始 | はい |
| game_addiction | キーアクション数 | はい |
| game_addiction_cost | キーアクションコスト | はい |
| game_addiction_rate | キーアクション率 | はい |
| game_pay_cost | 課金コスト | はい |
| game_pay_count | 課金回数 | はい |
| next_day_open | 翌日リテンションのコールバック数（未照合） | |
| next_day_open_cost | 翌日リテンションコスト（未照合） | |
| next_day_open_rate | 翌日リテンション率（未照合） | |
| pay_count | 初回課金回数 | はい |
| play_100_feed_break | 99%進捗の再生数 | |
| play_25_feed_break | 25%進捗の再生数 | |
| play_50_feed_break | 50%進捗の再生数 | |
| play_75_feed_break | 75%進捗の再生数 | |
| play_duration_sum | 再生時間（単位：ms） | |
| total_play | 再生数 | |
| valid_play | 有効再生数 | |
| valid_play_cost | 有効再生コスト | |
| valid_play_rate | 有効再生率 | |
| play_over_rate | 完全再生率 | |
| redirect | ページ遷移 | |
| register | 登録数 | |
| share | シェア数 | |
| show | 表示数 | はい |
| wifi_play | WiFi再生数 | |
| wifi_play_rate | WiFi再生の割合 |
2.4.3 イベントの格納ルール
- データ内のstat_datetimeフィールド、つまりデータの日付を、集約データの#event_timeとして設定します。現在、Ocean Engineから取得するデータは時間粒度のため、stat_datetimeも時間単位まで精確な時刻です
- データのイベント名は oceanengine_show_click_convert_data です
- その他のフィールドはすべて格納されます
2.5 認証の完了
設定が完了したら、右上の「保存して許可する」をクリックしてプランの設定を保存します。次に、最後の認証作業を完了する必要があります：
まず、表示される「認証情報」ページで、最初のステップのアドレスをコピーします
Ocean Engineの開発者管理画面に戻り、先ほど作成したアプリの基本情報ページに移動して、コピーしたURLをポストバックURL欄に入力します
AEの画面に戻り、「認証設定へ」をクリックすると、Ocean Engineの認証ページが開きます
認証画面が表示されたら、「現在のユーザーのすべてのアカウント」を選択し、「現在のログインユーザー」がデータを取得したい広告アカウントを所有していることを確認します。赤枠内のログインユーザーIDが、プランの設定で入力したログインユーザーIDであることを確認してください。確認が完了したら、「認証に同意」をクリックすると認証作業が完了します。
認証が完了したら、「認証情報」で左下の「以上の2つのステップを完了しました」をクリックし、右下の「認証完了」をクリックして設定を終了します。
2.6 標準化フィールド
Ocean Engineオールインワンデータレポートの一部のフィールドについて、AEシステムは標準化処理を行います：
| フィールド名 | 標準化フィールド | 意味 |
|---|---|---|
| advertiser_id | te_ads_object.ad_account_id | 広告主ID |
| campaign_name | te_ads_object.campaign_name | 広告グループ名 |
| campaign_id | te_ads_object.campaign_id | 広告グループID |
| ad_name | te_ads_object.ad_group_name | 広告キャンペーン名 |
| ad_id | te_ads_object.ad_group_id | 広告キャンペーンID |
| creative_name | te_ads_object.ad_name | クリエイティブ名 |
| creative_id | te_ads_object.ad_id | クリエイティブID |
| 【CNY】（固定値） | te_ads_object.currency | コストまたは収益の通貨 |
| show | te_ads_object.impressions | 表示数 |
| click | te_ads_object.clicks | クリック数 |
| click_install | te_ads_object.installs | クリックインストール数 |
| cost | te_ads_object.cost | 総消費 |