Ocean Engineデータ統合プラン
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
本記事では、Ocean EngineのデータをAgentic Engine（以下、AEシステム）にコールバックする方法を説明します。本プランは次に対応しています：
- オールインワンデータレポートの集約指標データを取得します。消費、クリック、表示などの基本レポート指標が含まれ、広告アカウント、広告グループ、広告キャンペーン、素材のディメンションでグループ化されます
- 広告クリエイティブデータの集約指標データを取得します。消費、クリック、表示などの基本レポート指標が含まれ、広告アカウント、広告グループ、広告キャンペーン、素材のディメンションでグループ化されます
- 広告アップグレード版データレポートの集約指標データ、つまり新バージョンのOcean Engine Adsのデータレポートを取得します。消費、クリック、表示などの基本レポート指標が含まれ、広告アカウント、広告グループ、広告キャンペーン、素材のディメンションでグループ化されます
本記事では主に、基盤となるAPIを通じてデータをAEシステムに統合する方法を説明します。製品の管理画面で設定する方法については、こちらの製品ドキュメントを参照してください。
Ocean Engineのデータの統合を始める前に、AEシステムのデータルールを読み、AEのデータ構造を理解しておいてください。また、データの取得に必要な情報を担当のカスタマーサクセスマネージャーにお渡しいただくことをお勧めします。形式はデータ統合設定情報テンプレートを参考にしてください。
流れ
Ocean Engineのデータの統合の流れは次のとおりです：
- Ocean Engineオープンプラットフォームにログインし、開発者アカウントとアプリを作成して、アプリのAPP_IDとSecret、ログインユーザーIDをThinkingAIの担当者に送信します
- アプリ管理ページの「ポストバックURL」に、ThinkingAIの担当者から提供されたURLを入力します
- 認証リンクを開き、データを取得する広告アカウントが属するOcean Engineアカウントにログインして、認証を完了します
- 取得するデータのディメンション、指標タイプ、取得頻度、取得する時間範囲を決めます
- ThinkingAIの担当者がデータ取得の開発作業を行います
- AE管理画面でダッシュボードやレポートを作成し、データ検証を完了します
2. 統合前の準備
2.1 開発者アカウントとアプリの作成
Ocean Engineのデータを統合する前に、Ocean Engineの開発者アカウントを申請し、アプリを1つ作成する必要があります
- まず、Ocean Engineアカウントにログインまたは登録する必要があります。こちらのリンクからログイン・登録ページにアクセスしてください。Ocean Engineアカウントをお持ちの場合は、左下のログインを選択して該当するアカウントにログインします。アカウントをお持ちでない場合は、メールアドレスまたは携帯電話番号でOcean Engineアカウントを登録します
- ログインが完了すると、Ocean Engineオープンプラットフォームに移動します。ページ右上の「開発者管理画面」ボタンをクリックして、開発者管理画面に入ります
-
開発者アカウントを作成していない場合は、ここで開発者情報の入力と資格審査を完了する必要があります。1つの会社情報で登録・認証できる開発者アカウントは1つのみのため、必ず会社のメールアドレスで申請し、アカウントを大切に保管してください。具体的な申請手順については、公式ドキュメントを参照してください。
- 開発者タイプでは広告主または代理店を選択する必要があります。実際の状況に応じていずれかを選択してください。両者の違いは次のとおりです：
- 広告主：開発者アカウントと同じ会社主体の縦横組織アカウントの認証のみ申請できます
- 代理店：開発者アカウントと同じ会社主体の代理店アカウントの認証のみ申請できます
- 開発者アカウントの認証が完了したら、開発者公式サイトの「APPID管理」ページに移動し、「広告管理」タイプのアプリを作成します
- 作成時の権限範囲で「データレポート」権限を選択する必要があることにご注意ください
- 申請を提出すると、Ocean Engineが1営業日以内にアプリ作成（APPID）申請の審査を完了します
2.2 App ID、App Secretの取得
アプリの申請が完了したら、開発者管理画面に移動し、左側のサイドバーで「アプリ管理」-「基本アプリ」を開いて、作成したアプリを選択し、「編集」をクリックして「基本情報」ページに移動します。APP_IDとSecretを確認し、ThinkingAIの担当者に送信します。
2.3 ログインユーザーIDの取得と認証の完了
次に、「Ocean Engineオープンプラットフォーム」に移動し、右上の「六角形のアイコン」をクリックしてから「Ocean Engine Zongheng」をクリックして管理画面に入ります。右上の「アカウント情報とセキュリティ」をクリックし、ログインユーザーIDを確認して、ThinkingAIの担当者に提供します。
ログインユーザーIDを提供すると、ThinkingAIの担当者からポストバックURLが提供されます。アプリの編集ページの「ポストバックURL」にそのURLを入力してください。
入力が完了すると、ページ下部に認証URLが表示されます。これをブラウザにコピーして開きます。
認証画面が表示されたら、「現在のユーザーのすべてのアカウント」を選択し、「現在のログインユーザー」がデータを取得したい広告アカウントを所有していることを確認します。赤枠内のログインユーザーIDが、以前ThinkingAIの担当者に提供したログインユーザーIDであることを確認してください。確認が完了したら、「認証に同意」をクリックすると認証作業が完了します。
3. データの取得
Ocean Engineは一連の広告データレポートを提供しています。AEは現在、オールインワンデータレポート、広告クリエイティブデータ、広告アップグレード版データレポートの取得に対応しています。
3.1 オールインワンデータレポート
インターフェースの基本情報
| インターフェース名 | APIタイプ | 製品化 | データ粒度 | アトリビューションデータ | コストデータ | 収益データ | インプレッション | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|---|
| オールインワンデータレポートインターフェース | プル型 | はい | 集計データ | はい | はい | はい | はい |
オールインワンデータレポートは、各広告粒度、素材、キーワード階層のデータを取得できるため、分析ディメンションが最も豊富ですが、対応している指標は通常のデータレポートに比べてやや少なめです。総じて、最もよく使われるデータレポートです。
3.1.1 分析ディメンション
以下の表は、オールインワンデータレポートが対応している分析ディメンションです。デフォルトのグループ条件は次のとおりです：
- STAT_GROUP_BY_TIME_HOUR
- STAT_GROUP_BY_CREATIVE_ID
調整が必要な場合は、まずグループ化の組み合わせルールを確認し、調整内容をデータ統合設定情報テンプレートに記録してください：
| フィールド名 | 意味 | グループ条件 | デフォルトかどうか |
|---|---|---|---|
| stat_datetime | 時間 | STAT_GROUP_BY_TIME_MONTH STAT_GROUP_BY_TIME_WEEK STAT_GROUP_BY_TIME_DAY STAT_GROUP_BY_TIME_HOUR | はい |
advertiser_id | 広告主ID | STAT_GROUP_BY_ADVERTISER_ID STAT_GROUP_BY_CAMPAIGN_ID STAT_GROUP_BY_AD_ID STAT_GROUP_BY_CREATIVE_ID | はい |
| campaign_name | 広告グループ名 | STAT_GROUP_BY_CAMPAIGN_ID STAT_GROUP_BY_AD_ID STAT_GROUP_BY_CREATIVE_ID | はい |
| campaign_id | 広告グループID | はい | |
| ad_name | 広告キャンペーン名 | STAT_GROUP_BY_AD_ID STAT_GROUP_BY_CREATIVE_ID | はい |
| ad_id | 広告キャンペーンID | はい | |
| creative_id | クリエイティブID | STAT_GROUP_BY_CREATIVE_ID | はい |
| bidword | キーワード名 | STAT_GROUP_BY_BIDWORD_ID | |
| bidword_id | キーワードID | ||
| query | 検索語句 | STAT_GROUP_BY_QUERY | |
| pricing | 入札方式 | STAT_GROUP_BY_PRICING | |
| image_mode | 素材タイプ | STAT_GROUP_BY_IMAGE_MODE | |
| inventory | 広告の優先配信面 | STAT_GROUP_BY_INVENTORY | |
| campaign_type | 広告グループタイプ | STAT_GROUP_BY_CAMPAIGN_TYPE | |
| creative_material_mode | クリエイティブタイプ | STAT_GROUP_BY_CREATIVE_MATERIAL_MODE | |
| external_action | コンバージョンタイプ | STAT_GROUP_BY_EXTERNAL_ACTION | |
| landing_type | プロモーションタイプ | STAT_GROUP_BY_LANDING_TYPE | |
| pricing_category | 広告タイプ | STAT_GROUP_BY_PRICING_CATEGORY | |
| province_name | 省 | STAT_GROUP_BY_PROVINCE_NAME | |
| city_name | 都市 | STAT_GROUP_BY_CITY_NAMEとSTAT_GROUP_BY_PROVINCE_NAMEの両方を含む | |
| gender | 性別 | STAT_GROUP_BY_GENDER | |
| age | 年齢 | STAT_GROUP_BY_AGE | |
| platform | プラットフォーム | STAT_GROUP_BY_PLATFORM | |
| ac | ネットワークタイプ | STAT_GROUP_BY_AC | |
| material_id | 素材ID | STAT_GROUP_BY_MATERIAL_ID | |
| playable_id | プレイアブル素材ID | STAT_GROUP_BY_PLAYABLE_ID | |
| playable_name | プレイアブル素材名 | ||
| playable_url | プレイアブル素材のリンク | ||
| playable_orientation | プレイアブル素材の表示方向 | ||
| playable_preview_url | プレイアブル素材のプレビューリンク |
3.1.2 対象指標
以下の表は、オールインワンデータレポートが対応している一部のよく使われる指標です。指標の総数が多すぎるため、ここではすべてを掲載できません。必要に応じて、公式ドキュメントですべての指標の説明を確認できます：
| 指標名 | 画面表示名 | デフォルトかどうか |
|---|---|---|
| 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再生の割合 |
3.1.3 インターフェースのパラメータ
-
広告アカウント：
- データを取得する広告アカウントを指定する必要があります
-
時間：
-
日単位のデータを取得します
- 検索語句レポートでは、直近30日間のデータのみ確認できます
- キーワードレポートでは、2019-05-19以降のデータのみ確認できます
- すべてのレポートで、期間は30日を超えてはいけません
-
データは日単位または時間単位で集計でき、デフォルトは時間単位です
-
3.1.4 データの格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
- オールインワンレポートが返すデータは集計データであるため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐づいていると考えることができます
- データ内のstat_datetimeフィールド、つまりデータの日付を、集計データの#event_timeとして設定します
- データのイベント名は oceanengine_show_click_convert_data です
- その他のフィールドはすべて格納されます
3.2 広告クリエイティブデータ
広告クリエイティブデータは、広告データの粒度が最も細かい通常のデータレポートです。オールインワンデータレポートと比べると、分析ディメンションは少ないものの、対応している指標は多めです。
インターフェースの基本情報
| インターフェース名 | APIタイプ | 製品化 | データ粒度 | アトリビューションデータ | コストデータ | 収益データ | インプレッション | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|---|
| 広告クリエイティブデータ | プル型 | いいえ | 集計データ | はい | はい | はい | はい |
3.2.1 分析ディメンション
以下の表は、広告クリエイティブデータレポートが対応している分析ディメンションです。デフォルトのグループ条件は次のとおりです：
- STAT_GROUP_BY_FIELD_STAT_TIME
- STAT_GROUP_BY_FIELD_ID
このほか、その他のグループ条件を最大1つ（下表のSTAT_GROUP_BY_INVENTORYなど）追加できます。追加しない場合は、デフォルトのグループ条件が適用されます
調整が必要な場合は、調整内容をデータ統合設定情報テンプレートに記録してください：
| フィールド名 | 意味 | グループ条件 | デフォルトかどうか |
|---|---|---|---|
| stat_datetime | データの開始時間。形式：
| STAT_GROUP_BY_FIELD_STAT_TIME | はい |
| advertiser_id | 広告主ID | STAT_GROUP_BY_FIELD_ID | はい |
| campaign_name | 広告グループ名 | はい | |
| campaign_id | 広告グループID | はい | |
| ad_name | 広告キャンペーン名 | はい | |
| ad_id | 広告キャンペーンID | はい | |
| creative_id | クリエイティブID | はい | |
| inventory | 配信広告枠 | STAT_GROUP_BY_INVENTORY | |
| creative_material_mode | クリエイティブタイプ。値：
| STAT_GROUP_BY_CREATIVE_MATERIAL_MODE | |
| landing_type | プロモーション目的のタイプ | STAT_GROUP_BY_LANDING_TYPE | |
| pricing | 入札タイプ | STAT_GROUP_BY_PRICING | |
| image_mode | 素材タイプ | STAT_GROUP_BY_IMAGE_MODE | |
| province_name | 省 | STAT_GROUP_BY_PROVINCE_NAME | |
| city_name | 都市 | STAT_GROUP_BY_CITY_NAME | |
| gender | 性別 | STAT_GROUP_BY_GENDER | |
| age | 年齢 | STAT_GROUP_BY_AGE | |
| platform | プラットフォーム | STAT_GROUP_BY_PLATFORM | |
| ac | タイプ | STAT_GROUP_BY_AC |
3.2.2 対象指標
以下の表は、広告クリエイティブデータレポートが対応している一部のよく使われる指標です。指標の総数が多すぎるため、ここではすべてを掲載できません。必要に応じて、公式サイトのドキュメントですべての指標の説明を確認できます：
| 指標名 | 画面表示名 | デフォルトかどうか |
|---|---|---|
| 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再生の割合 |
3.2.3 インターフェースのパラメータ
- 広告アカウント：
- データを取得する広告アカウントを指定する必要があります
- 時間：
- 日単位のデータを取得します
- 期間は30日を超えることはできません
- 日単位のデータを取得します
3.2.4 データの格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
- 広告クリエイティブレポートが返すデータは集計データであるため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐づいていると考えることができます
- データ内のstat_datetimeフィールド、つまりデータの日付を、集計データの#event_timeとして設定します
- データのイベント名は oceanengine_creative_data です
- その他のフィールドはすべて格納されます
3.3 広告アップグレード版データレポート
インターフェースの基本情報
| インターフェース名 | APIタイプ | 製品化 | データ粒度 | アトリビューションデータ | コストデータ | 収益データ | インプレッション | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|---|
| 広告アップグレード版データレポート | プル型 | いいえ | 集計データ | はい | はい | はい | はい |
広告アップグレード版データレポートは、Ocean Engineに新たに追加された広告データレポートで、Ocean Engine Adsアップグレード版の広告配信データを取得できます。
3.3.1 分析ディメンション
以下は、広告アップグレード版データレポートが対応しているディメンションです。「日単位」と「時間単位」のレポートを選択できます。時間単位のレポートは一部のディメンションと併用できないことにご注意ください
| 項目 | フィールド名 | 日単位のデフォルト | 時間単位のデフォルト | 標準化フィールド | 備考 |
|---|---|---|---|---|---|
| 広告アカウントID | - | はい | はい | ad_account_id | |
時間 | stat_time_day（日単位） stat_time_hour（時間単位） | はい | はい | 時間単位のレポートでは以下のディメンションを利用できません
| |
| プロジェクトID | cdp_project_id | はい | はい | ad_group_id | |
| プロジェクト名 | cdp_project_name | はい | はい | ad_group_name | |
| 広告ID | cdp_promotion_id | はい | はい | ad_id | |
| 広告名 | cdp_promotion_name | はい | はい | ad_name | |
| パッケージ名 | package_name | はい | はい | app_name | |
| プラットフォーム | platform | はい | platform | 以下のディメンションと併用不可
時間単位のレポートでは利用不可 | |
| 性別 | gender | ||||
| 年齢 | age | ||||
| ネットワーク | ac | ||||
| 省 | province_name | 以下のディメンションと併用不可
時間単位のレポートでは利用不可 | |||
| 都市 | city_name | ||||
| 素材タイプ | image_mode | ||||
| プロモーション目的 | landing_type | ||||
| コンバージョン目標 | external_action | ||||
| 課金タイプ | pricing | ||||
| ディープコンバージョン目標 | deep_external_action | ||||
| ダウンロード方式 | ad_platform_cdp_project_download_type | ||||
| ダウンロードリンク | ad_platform_cdp_project_download_url | ||||
| コンバージョン計測URL | ad_platform_cdp_project_action_track_url | ||||
| 配信モード | delivery_mode | ||||
| 広告入札額 | ad_platform_cdp_promotion_bid | ||||
| ディープコンバージョン入札額 | ad_platform_cdp_promotion_deep_cpa_bid | ||||
| ROI係数 | ad_platform_cdp_promotion_roi_goal | ||||
| 優先配信面 | app_code |
3.3.2 対象指標
以下の表は、広告アップグレード版データレポートが対応している一部のよく使われる指標です。指標の総数が多すぎるため、ここではすべてを掲載できません
| 指標 | 指標名 | 説明 | デフォルト | 標準化フィールド | 備考 |
|---|---|---|---|---|---|
| 消費 | stat_cost | 広告の配信期間中の推定費用額を表します。当日のデータは変動する可能性があり、翌日に確定します | はい | cost | |
| 表示数 | show_cnt | 広告がユーザーに表示された回数。計算方式：プラットフォームが有効と判定し、課金対象となった表示回数。 | はい | impressions | |
| 1,000回表示あたりの平均費用 | cpm_platform | 広告の表示1,000回あたりに支払った平均費用。計算式：総消費/表示数*1000。 | はい | ||
| クリック数 | click_cnt | ユーザーが広告素材をクリックするとクリックイベントがトリガーされ、このイベントが1回の有効な広告クリックとみなされます。 | はい | clicks | |
| クリック率 | ctr | 広告がクリックされた回数が表示回数に占める割合。計算方法：クリック数/表示数*100% | はい | ||
| 平均クリック単価 | cpc_platform | 広告主がクリック1回あたりに支払った費用。計算式：総消費/クリック数。 | はい | ||
| コンバージョン数 | convert_cnt | コンバージョンイベントの発生時間で集計したコンバージョン数。広告主がコストを評価する際は「コンバージョンデータ（課金時間）」を参照することをお勧めします。例えば、広告が朝8時に表示・クリックされ、ユーザーが夜19時にアクティベーションした場合、Ocean Engineはアクティベーション数を夜19時に計上します。 | はい | installs | |
| 平均コンバージョン単価 | conversion_cost | 広告主がコンバージョン1件あたりに支払った平均コスト。計算方式：総消費/コンバージョン数。当日のデータは変動する可能性があります。 | はい | ||
| コンバージョン率 | conversion_rate | 広告からユーザーがコンバージョンした回数がクリック回数に占める割合。計算方式：コンバージョン数/クリック数*100% | はい | ||
| ディープコンバージョン数 | deep_convert_cnt | ディープコンバージョン数を、コンバージョンイベントが発生した時間に記録します。広告主がディープコンバージョンコストを評価する際は「ディープコンバージョン数（課金時間）」を参照することをお勧めします。例えば、広告が朝8時に表示・クリックされ、ユーザーが夜19時にアクティベーションした場合、Ocean Engineはアクティベーション数を夜19時に計上します。 | |||
| ディープコンバージョンコスト | deep_convert_cost | 広告主がディープコンバージョン1件あたりに支払った平均コスト。計算方法：総消費/ディープコンバージョン数。当日のデータは変動する可能性があり、翌日朝8時以降に確定します。 | |||
| ディープコンバージョン率 | deep_convert_rate | 広告からユーザーがディープコンバージョンした回数がコンバージョン回数に占める割合。計算方式：ディープコンバージョン数/コンバージョン数*100% | |||
| アクティベーション数 | active | APIと連携している場合、アクティベーション数はお客様が認め、正常にコールバックされたアクティベーション数です。SDKと連携している場合、アクティベーション数はユーザーがAPPをダウンロードした後に起動した回数を指します。 | はい | ||
| アクティベーションコスト | active_cost | 計算方式：総費用/アクティベーション数。 | はい | ||
| アクティベーション率 | active_rate | 計算方式：アクティベーション数/クリック数*100% | はい | ||
| 登録数 | active_register | APIと連携している場合、登録数はお客様が認め、正常にコールバックされた登録数です。SDKと連携している場合、登録数はユーザーが登録を行った回数です。詳しくは「SDK連携ドキュメント」を参照してください | はい | ||
| 登録コスト | active_register_cost | 広告主が登録1件あたりに支払ったコスト。計算式：総費用/登録数。当日のデータは変動する可能性があり、翌日朝8時以降に確定します。 | はい | ||
| 登録率 | active_register_rate | 登録ユーザーがアクティベーションユーザーに占める割合 | はい | ||
| キーアクション数 | game_addiction | APP内でキーアクションを行ったユーザー数 | |||
| キーアクションコスト | game_addiction_cost | 広告主が、APP内でキーアクションを行ったユーザー1人あたりに支払ったコスト。計算式：総費用/キーアクション数。当日のデータは変動する可能性があり、翌日朝8時以降に確定します。 | |||
| キーアクション率 | game_addiction_rate | キーアクションユーザーがアクティベーションユーザーに占める割合 | |||
| 再生数 | total_play | 再生時間が0Sを超えた回数。一部のモバイルネットワーク環境では、手動でクリックしないと再生が始まらないため、再生数が表示数より少なくなる場合があります。 | はい | ||
| 有効再生数 | valid_play | 入札広告の再生時間が10秒以上の回数。動画の総再生時間が10秒未満の場合は、再生完了の回数を記録します。ブランド広告は、一部のAPP（Toutiao、Toutiao Lite、Douyin、Xigua Video、Douyin Huoshan、Pipixia）では再生時間が5秒以上の回数、その他のAPPでは3秒以上の回数です。動画の総再生時間が5秒/3秒未満の場合は、再生完了の回数を記録します。 | はい | ||
| 有効再生コスト | valid_play_cost | 計算式：総費用/有効再生数。当日のデータは変動する可能性があり、翌日朝8時以降に確定します。 | はい | ||
| 有効再生率 | valid_play_rate | 計算式：有効再生数/表示数。 | はい | ||
| 1,000回あたりの有効再生数 | valid_play_of_mille | 有効再生数/1000。有効再生数とは、入札広告の再生時間が10秒以上の回数を指します。動画の総再生時間が10秒未満の場合は、再生完了の回数を記録します。ブランド広告は、一部のAPP（Toutiao、Toutiao Lite、Douyin、Xigua Video、Douyin Huoshan、Pipixia）では再生時間が5s以上の回数、その他のAPPでは3s以上の回数です。動画の総再生時間が5s/3s未満の場合は、再生完了の回数を記録します。 | はい | ||
| 1,000回有効再生あたりのコスト | valid_play_cost_of_mille | 総費用/1,000回あたりの有効再生数。当日のデータは変動する可能性があり、翌日朝8時以降に確定します。 | はい | ||
| 25%進捗の再生数 | play_25_feed_break | ユーザーが動画の長さの25%以上まで再生した回数。スキップしてこの位置まで再生した回数も含みます | 互換性のないディメンション：
| ||
| 50%進捗の再生数 | play_50_feed_break | ユーザーが動画の長さの50%以上まで再生した回数。スキップしてこの位置まで再生した回数も含みます | |||
| 75%進捗の再生数 | play_75_feed_break | ユーザーが動画の長さの75%以上まで再生した回数。スキップしてこの位置まで再生した回数も含みます | |||
| 99%進捗の再生数 | play_99_feed_break | ユーザーが動画の長さの99%以上まで再生した回数。スキップしてこの位置まで再生した回数も含みます | |||
| 1回あたりの平均再生時間 | average_play_time_per_play | 計算方法：動画の実際の総再生時間／総再生回数（スキップした時間は含みません） | |||
| 完全再生率 | play_over_rate | 計算式：再生完了数/再生数。 | |||
| WiFi再生の割合 | wifi_play_rate | wifi環境での動画の再生数/動画の総再生数 | |||
| 3秒カード表示数 | card_show | 動画カード型広告で、動画が3秒まで再生された時点でカードが表示された回数。 | |||
| 3秒再生数 | play_duration_3s | 広告の再生時間が3秒以上の回数。動画の総再生時間が3秒未満の場合は、再生完了の回数を記録します。 |
3.3.3 インターフェースのパラメータ
- 広告アカウント：
- データを取得する広告アカウントを指定する必要があります
- 時間：
- 日単位のレポートまたは時間単位のレポートを選択できます
3.3.4 データの格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
- 広告アップグレード版データレポートが返すデータは集計データであるため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐づいていると考えることができます
- データ内のdimensions_stat_time_hourまたはdimensions_stat_time_dayフィールド、つまりデータの日付を、集約データの#event_timeとして設定します
- データのイベント名は oceanengine_custom_data です
- その他のフィールドはすべて格納されます
4. データ統合設定情報テンプレート
以上のドキュメントを読んだら、次の情報テンプレートに記入し、ThinkingAIの担当カスタマーサクセスマネージャーに送信することをお勧めします：
インターフェース：Ocean Engine広告データレポート
---------
会社名：XXX
AEプロジェクト環境：（SAAS/プライベートデプロイ）
AEプロジェクト名：XXX
AEプロジェクトAPP ID: XXX
データ受信URL push_url: XXX
---------
Ocean EngineアプリAPP_ID：XXX
Ocean EngineアプリSecret: XXX
広告主（広告アカウント）IDリスト：XXX，XXX
ログインユーザーID：XXXXXXXXX
---------
取得するデータタイプ：[オールインワン/広告クリエイティブ/アップグレード版データレポート]
分析ディメンション：XXX，XXX（空欄の場合はデフォルト）
取得するフィールド：XXX，XXX（空欄の場合はデフォルト）
履歴データの取得時間範囲：yyyy/mm/dd - yyyy/mm/dd
取得粒度：日単位（時間単位はアップグレード版データレポートのみ対応）
定期取得：毎日X時に過去N日分のデータを取得（1時間ごとにN日分のデータを取得）
5. 連携テスト
AEシステム管理画面の「データ管理」->「イベント管理」ページまたはSQL IDEページで、次のイベントを検索できます
- oceanengine_show_click_convert_data
または
- oceanengine_creative_data
または
- oceanengine_custom_data
検索後、該当するデータが格納されているかを確認してください
6. FAQ
同じゲームを1つのOcean Engine主体で配信していない場合でも、データを取得できますか？
可能です。1つのAEプロジェクトに複数のOcean Engine Tokenを対応させることができ、異なるOcean Engineユーザー配下の広告配信データを同じAEプロジェクトに集約できます。すべてのOcean Engine主体のデータを取得するには、Ocean Engineユーザーごとに認証操作を行い、AEプラットフォームのOcean Engineサードパーティ統合設定で複数の統合プランを追加する必要があります。
Ocean Engineの管理画面で新しいアプリを作成し、アプリ申請を記入する際、「ポストバックURL」には何を入力すればよいですか？
新しいアプリを作成する際、「ポストバックURL」にはまず自社のドメインを入力できます。APPを追加した後で、ポストバックURLをAEクラスターのOcean EngineポストバックURLに変更できます。
Ocean Engineの管理画面でログインユーザーIDが見つからない場合は？
Ocean Engineの管理画面では、2つの方法でログインユーザーIDを確認できます。
- 方法1：「Ocean Engineオープンプラットフォーム」- 右上の「六角形のアイコン」をクリックし、「Ocean Engine Zongheng」をクリック - 右上の「アカウント情報とセキュリティ」をクリックして、ログインユーザーIDを確認します。
- 方法2：「Ocean Engineオープンプラットフォーム」-「開発者管理画面」-「アプリ管理」-「アプリ編集」で、AEシステムのポストバックURLを入力 -「データレポート」権限範囲を選択した後 -「認証URL」をクリック -「現在のユーザーのすべてのアカウント」を選択すると、ログインユーザーIDを取得できます。
異なるログインユーザー配下の広告主ID/広告アカウントIDを取得するには？
「Ocean Engineオープンプラットフォーム」- 右上の「六角形のアイコン」をクリックし、「Ocean Engine Adsプラットフォーム」をクリックすると、該当するログインユーザー配下の広告アカウントIDが表示されます。（「アカウントID」がない場合は、「カスタムカラム」をクリックして「アカウントID」を追加できます）
advertiser_idを入力したのに、データが取得されないのはなぜですか？
入力したのは縦横組織の広告アカウントIDである可能性があります。縦横組織配下で配信している広告アカウントのIDを入力する必要があります。次の方法で取得できます：
curl --location --request GET 'https://ad.oceanengine.com/open_api/2/majordomo/advertiser/select/?advertiser_id={縦横組織の広告アカウントID}' \
--header 'Access-Token:{ACCESS_TOKEN}' \
--header 'Content-Type:application/x-www-form-urlencoded' \
--data-urlencode 'advertiser_id={縦横組織の広告アカウントID}'
同じ縦横組織配下で、異なるログインユーザーに対応する広告主IDリストを取得するには？
- Ocean Engine Zonghengページの右側で縦横組織IDを確認します。
- 「縦横組織配下のアセットアカウントリストの取得」インターフェースを使用すると、縦横組織配下で異なるログインユーザーに対応する広告主IDリストを取得できます