メインコンテンツまでスキップ

Ocean Engine広告アップグレード版データレポート

最終更新 2026/11/17
ヒント

サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください

概要​

インターフェースの概要​

インターフェース名タイプ粒度アトリビューションコスト収益表示クリックコンバージョン
広告アップグレード版データレポートAPI集計データ✅✅✅✅

広告アップグレード版データレポートは、Ocean Engineで新たに追加された広告データレポートで、Ocean Engine Adsのアップグレード版の広告配信データを取得できます。

統合の流れ​

  1. Ocean Engineオープンプラットフォームにログインし、開発者アカウントとアプリを作成します
  2. アプリのAPP_ID、Secret、およびログインユーザーIDを取得します
  3. AE管理画面にログインし、サードパーティ統合モジュールでOcean Engine広告アップグレード版データレポートの統合プランを追加します
  4. 認証リンクを開き、データを取得する広告アカウントが属するOcean Engineアカウントにログインして、認証を完了します
  5. AEシステムがデータを正常に受信しているかを確認し、レポートを作成します

1. 認証情報の取得​

1.1 開発者アカウントとアプリの作成​

Ocean Engineのデータを統合する前に、Ocean Engineの開発者アカウントを申請し、アプリを1つ作成する必要があります

  1. まず、Ocean Engineアカウントにログインまたは登録する必要があります。こちらのリンクからログイン・登録ページにアクセスしてください。Ocean Engineアカウントをお持ちの場合は、左下のログインを選択して該当するアカウントにログインします。アカウントをお持ちでない場合は、メールアドレスまたは携帯電話番号でOcean Engineアカウントを登録します
  2. ログインが完了すると、Ocean Engineオープンプラットフォームに移動します。ページ右上の「開発者管理画面」ボタンをクリックして、開発者管理画面に入ります
  1. 開発者アカウントを作成していない場合は、ここで開発者情報の入力と資格審査を完了する必要があります。1つの会社情報で登録・認証できる開発者アカウントは1つのみのため、必ず会社のメールアドレスで申請し、アカウントを大切に保管してください。具体的な申請手順については、公式ドキュメントを参照してください。

    1. 開発者タイプでは広告主または代理店を選択する必要があります。実際の状況に応じていずれかを選択してください。両者の違いは次のとおりです:
    • 広告主:開発者アカウントと同じ会社主体の縦横組織アカウントの認証のみ申請できます
    • 代理店:開発者アカウントと同じ会社主体の代理店アカウントの認証のみ申請できます
  1. 開発者アカウントの認証が完了したら、開発者公式サイトの「APPID管理」ページに移動し、「広告管理」タイプのアプリを作成します

    1. アプリ名、アプリアイコン、アプリの説明は実際の必要に応じて記入できます。アプリの用途には、Ocean Engineの広告配信データを自社のプラットフォームにコールバックするものと記述します
    2. ポストバックURLには「www.thinkingdata.cn」を入力してください。このURLは一時的なもので、プランの設定が完了したら変更する必要があります
    3. 申請する権限では、少なくとも「データレポート」権限を選択する必要があります
  2. 申請を提出すると、Ocean Engineが1営業日以内にアプリ作成(APPID)申請の審査を完了します

1.2 App ID、App Secretの取得​

アプリの申請が完了したら、開発者管理画面に移動し、左側のサイドバーで「アプリ管理」-「基本アプリ」を開いて、作成したアプリを選択し、「編集」をクリックして「基本情報」ページに移動します。APP_IDとSecretを確認し、控えておきます。

1.3 ログインユーザーIDの取得​

次に、ログインユーザーのIDを取得する必要があります。「Ocean Engineオープンプラットフォーム」に移動し、右上の「9つの点のアイコン」をクリックし、「Ocean Engine Ads」をクリックして管理画面に入り、アカウント概要ページでログインユーザー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_eventevent_name格納後のイベント名。カスタマイズ可能な文字列型です。受信したデータはすべてこの名前をイベント名とします。
sourcemetricsデータ内の指標。リスト型。カスタマイズ可能
group_byデータ内のグループ化ディメンション。リスト型。カスタマイズ可能

time_granularity

データの時間集計粒度。つまり、取得したデータを日単位と時間単位のどちらで集計するか

選択可能な値: day、hour

必要に応じて統合構成を変更できます

2.4.1 智擎版(スマート配信)の設定​

智擎版と広告アップグレード版は同じ連携を使用しますが、データトピックが異なります。広告アップグレード版のデフォルトは BASIC_DATA です。

智擎版の配信データを取得するには、「統合構成」で以下の2点を変更します。

  1. extra_params.data_topic を STD_BASIC_DATA に設定します。
  2. source.group_by から cdp_promotion_name(プロモーション名)を削除し、cdp_project_id、cdp_project_name、cdp_promotion_id を残します。

プロモーション名を削除すると、取り込まれるイベントには ad_name(広告名)が含まれなくなります。

設定例の全体は以下のとおりです。

{
"extra_params": {
"data_topic": "STD_BASIC_DATA"
},
"sink_event": {
"event_name": "oceanengine_custom_data"
},
"sink_user": [],
"source": {
"time_granularity": "day",
"group_by": [
"cdp_project_id",
"cdp_project_name",
"cdp_promotion_id"
],
"metrics": [
"stat_cost",
"show_cnt",
"cpm_platform",
"click_cnt",
"ctr",
"cpc_platform",
"convert_cnt",
"conversion_cost",
"conversion_rate",
"active",
"active_cost",
"active_rate",
"active_register",
"active_register_cost",
"active_register_rate",
"total_play",
"valid_play",
"valid_play_cost",
"valid_play_rate",
"valid_play_of_mille",
"valid_play_cost_of_mille"
]
}
}

2.4.2 分析ディメンション​

以下は広告アップグレード版データレポートが対応しているディメンションです。時間粒度は一部のディメンションと併用できないことに注意してください。その他の分析ディメンションを追加する場合は、フィールド名をsource.group_byに記述します

フィールド名画面表示名デフォルト備考
advertiser_id(必須、入力不要)広告アカウントIDはい
cdp_project_idプロジェクトIDはい
cdp_project_nameプロジェクト名はい
cdp_promotion_id広告IDはい
cdp_promotion_name広告名はい
package_nameパッケージ名
platformプラットフォーム

以下のディメンションと併用不可

  • city_name
  • province_name

時間単位の粒度では利用不可

gender性別
age年齢
acネットワーク
province_name省

以下のディメンションと併用不可

  • ac
  • gender
  • age
  • platform

時間単位の粒度では利用不可

city_name都市
image_mode素材タイプ
landing_typeプロモーション目的
external_actionコンバージョン目標
pricing課金タイプ
deep_external_actionディープコンバージョン目標
ad_platform_cdp_project_download_typeダウンロード方式
ad_platform_cdp_project_download_urlダウンロードリンク
ad_platform_cdp_project_action_track_urlコンバージョン計測URL
delivery_mode配信モード
ad_platform_cdp_promotion_bid広告入札額
ad_platform_cdp_promotion_deep_cpa_bidディープコンバージョン入札額
ad_platform_cdp_promotion_roi_goalROI係数
app_code優先配信面

2.4.3 対象指標​

以下の表は、広告アップグレード版データレポートが対応している常用指標の一部です。指標の総数が多いため、ここですべてを掲載することはできません。その他の指標を追加する場合は、指標名をsource.metricsに記述します

指標名画面表示名デフォルト備考
stat_cost消費はい
show_cnt表示数はい
cpm_platform1,000回表示あたりの平均費用はい
click_cntクリック数はい
ctrクリック率はい
cpc_platform平均クリック単価はい
convert_cntコンバージョン数はい
conversion_cost平均コンバージョン単価はい
conversion_rateコンバージョン率はい
deep_convert_cntディープコンバージョン数
deep_convert_costディープコンバージョンコスト
deep_convert_rateディープコンバージョン率
activeアクティベーション数はい
active_costアクティベーションコストはい
active_rateアクティベーション率はい
active_register登録数はい
active_register_cost登録コストはい
active_register_rate登録率はい
game_addictionキーアクション数
game_addiction_costキーアクションコスト
game_addiction_rateキーアクション率
total_play再生数はい
valid_play有効再生数はい
valid_play_cost有効再生コストはい
valid_play_rate有効再生率はい
valid_play_of_mille1,000回あたりの有効再生数はい
valid_play_cost_of_mille1,000回有効再生あたりのコストはい
play_25_feed_break25%進捗の再生数

以下の分析ディメンションとは互換性がありません:

  • ac
  • gender
  • age
  • platform
  • city_name
  • province_name
play_50_feed_break50%進捗の再生数
play_75_feed_break75%進捗の再生数
play_99_feed_break99%進捗の再生数
average_play_time_per_play1回あたりの平均再生時間
play_over_rate完全再生率
wifi_play_rateWiFi再生の割合
card_show3秒カード表示数
play_duration_3s3秒再生数

2.4.4 データの格納ルール​

  • データ内のdimensions_stat_time_hourまたはdimensions_stat_time_dayフィールド、つまりデータの日付を、集約データの#event_timeとして設定します
  • データのイベント名は oceanengine_custom_data です
  • その他のフィールドはすべて格納されます

2.5 認証の完了​

2.5.1 ワークベンチのサブアカウントの認証(必須)​

AE は、認証済みの Ocean Engine ワークベンチのサブアカウントをデフォルトで取得します。Ocean Engine オープンプラットフォームのアプリの「権限申請」で、「アカウントサービス → Ocean Engine ワークベンチの組織管理」に進み、「Ocean Engine ワークベンチの広告配信アカウント一覧を取得(120)」を選択してください。お客様が認証する際は、ワークベンチ配下のアカウントへのアクセス権限が付与され、対象の広告サブアカウントが認証範囲に含まれていることを確認します。この権限を付与せずに認証済みの場合は、アプリの権限を追加して再度認証してください。

2.5.2 連携プランの認証​

連携プランの設定が完了したら、右上の「保存して許可する」をクリックして設定を保存し、以下の手順で認証を完了します。

まず、表示される「認証情報」ページで、最初のステップのアドレスをコピーします

Ocean Engineの開発者管理画面に戻り、先ほど作成したアプリの基本情報ページに移動して、コピーしたURLをポストバックURL欄に入力します

AEの画面に戻り、「認証設定へ」をクリックすると、Ocean Engineの認証ページが開きます

認証画面が表示されたら、「現在のユーザーのすべてのアカウント」を選択し、「現在のログインユーザー」がデータを取得したい広告アカウントを所有していることを確認します。赤枠内のログインユーザーIDが、プランの設定で入力したログインユーザーIDであることを確認してください。確認が完了したら、「認証に同意」をクリックすると認証作業が完了します。

認証が完了したら、「認証情報」で左下の「以上の2つのステップを完了しました」をクリックしてから、右下の「認証完了」をクリックして設定を終了します。これで、Ocean Engine広告アップグレード版データレポートの統合は完了です。

2.6 標準化フィールド​

Ocean Engine広告アップグレード版データレポートの一部のフィールドについて、AEシステムは標準化処理を行います:

フィールド名標準化フィールド意味
advertiser_idte_ads_object.ad_account_id広告主ID
cdp_project_namete_ads_object.ad_group_name広告キャンペーン名
cdp_project_idte_ads_object.ad_group_id広告キャンペーンID
cdp_promotion_namete_ads_object.ad_nameクリエイティブ名
cdp_promotion_idte_ads_object.ad_idクリエイティブID
package_namete_ads_object.app_nameアプリ名
platformte_ads_object.platformプラットフォーム(Android、iOSなど)
【CNY】(固定値)te_ads_object.currencyコストまたは収益の通貨
show_cntte_ads_object.impressions表示数
click_cntte_ads_object.clicksクリック数
convert_cntte_ads_object.installsクリックインストール数
stat_costte_ads_object.cost総消費
このページは役に立ちましたか?