Ocean Engine広告アップグレード版データレポート
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| 広告アップグレード版データレポート | API | 集計データ | ✅ | ✅ | ✅ | ✅ |
広告アップグレード版データレポートは、Ocean Engineで新たに追加された広告データレポートで、Ocean Engine Adsのアップグレード版の広告配信データを取得できます。
統合の流れ
- 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オープンプラットフォーム」に移動し、右上の「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_event | event_name | 格納後のイベント名。カスタマイズ可能な文字列型です。受信したデータはすべてこの名前をイベント名とします。 |
| source | metrics | データ内の指標。リスト型。カスタマイズ可能 |
| group_by | データ内のグループ化ディメンション。リスト型。カスタマイズ可能 | |
time_granularity | データの時間集計粒度。つまり、取得したデータを日単位と時間単位のどちらで集計するか 選択可能な値: day、hour |
必要に応じて統合構成を変更できます
2.4.1 分析ディメンション
以下は広告アップグレード版データレポートが対応しているディメンションです。時間粒度は一部のディメンションと併用できないことに注意してください。その他の分析ディメンションを追加する場合は、フィールド名をsource.group_byに記述します
| フィールド名 | 画面表示名 | デフォルト | 備考 |
|---|---|---|---|
| advertiser_id（必須、入力不要） | 広告アカウントID | はい | |
| cdp_project_id | プロジェクトID | はい | |
| cdp_project_name | プロジェクト名 | はい | |
| cdp_promotion_id | 広告ID | はい | |
| cdp_promotion_name | 広告名 | はい | |
| package_name | パッケージ名 | ||
| 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 | ダウンロードリンク | ||
| 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_goal | ROI係数 | ||
| app_code | 優先配信面 |
2.4.2 対象指標
以下の表は、広告アップグレード版データレポートが対応している常用指標の一部です。指標の総数が多いため、ここですべてを掲載することはできません。その他の指標を追加する場合は、指標名をsource.metricsに記述します
| 指標名 | 画面表示名 | デフォルト | 備考 |
|---|---|---|---|
| stat_cost | 消費 | はい | |
| show_cnt | 表示数 | はい | |
| cpm_platform | 1,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_mille | 1,000回あたりの有効再生数 | はい | |
| valid_play_cost_of_mille | 1,000回有効再生あたりのコスト | はい | |
| play_25_feed_break | 25%進捗の再生数 | 以下の分析ディメンションとは互換性がありません：
| |
| play_50_feed_break | 50%進捗の再生数 | ||
| play_75_feed_break | 75%進捗の再生数 | ||
| play_99_feed_break | 99%進捗の再生数 | ||
| average_play_time_per_play | 1回あたりの平均再生時間 | ||
| play_over_rate | 完全再生率 | ||
| wifi_play_rate | WiFi再生の割合 | ||
| card_show | 3秒カード表示数 | ||
| play_duration_3s | 3秒再生数 |
2.4.3 データの格納ルール
- データ内のdimensions_stat_time_hourまたはdimensions_stat_time_dayフィールド、つまりデータの日付を、集約データの#event_timeとして設定します
- データのイベント名は oceanengine_custom_data です
- その他のフィールドはすべて格納されます
2.5 認証の完了
設定が完了したら、右上の「保存して許可する」をクリックしてプランの設定を保存します。次に、最後の認証作業を完了する必要があります：
まず、表示される「認証情報」ページで、最初のステップのアドレスをコピーします
Ocean Engineの開発者管理画面に戻り、先ほど作成したアプリの基本情報ページに移動して、コピーしたURLをポストバックURL欄に入力します
AEの画面に戻り、「認証設定へ」をクリックすると、Ocean Engineの認証ページが開きます
認証画面が表示されたら、「現在のユーザーのすべてのアカウント」を選択し、「現在のログインユーザー」がデータを取得したい広告アカウントを所有していることを確認します。赤枠内のログインユーザーIDが、プランの設定で入力したログインユーザーIDであることを確認してください。確認が完了したら、「認証に同意」をクリックすると認証作業が完了します。
認証が完了したら、「認証情報」で左下の「以上の2つのステップを完了しました」をクリックしてから、右下の「認証完了」をクリックして設定を終了します。これで、Ocean Engine広告アップグレード版データレポートの統合は完了です。
2.6 標準化フィールド
Ocean Engine広告アップグレード版データレポートの一部のフィールドについて、AEシステムは標準化処理を行います：
| フィールド名 | 標準化フィールド | 意味 |
|---|---|---|
| advertiser_id | te_ads_object.ad_account_id | 広告主ID |
| cdp_project_name | te_ads_object.ad_group_name | 広告キャンペーン名 |
| cdp_project_id | te_ads_object.ad_group_id | 広告キャンペーンID |
| cdp_promotion_name | te_ads_object.ad_name | クリエイティブ名 |
| cdp_promotion_id | te_ads_object.ad_id | クリエイティブID |
| package_name | te_ads_object.app_name | アプリ名 |
| platform | te_ads_object.platform | プラットフォーム（Android、iOSなど） |
| 【CNY】（固定値） | te_ads_object.currency | コストまたは収益の通貨 |
| show_cnt | te_ads_object.impressions | 表示数 |
| click_cnt | te_ads_object.clicks | クリック数 |
| convert_cnt | te_ads_object.installs | クリックインストール数 |
| stat_cost | te_ads_object.cost | 総消費 |