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オープンプラットフォーム」に移動し、右上の「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 グループ化ディメンション
以下の表は、広告クリエイティブデータレポートが対応しているグループ化ディメンションです。デフォルトのグループ化条件は次のとおりです：
- STAT_GROUP_BY_FIELD_STAT_TIME
- STAT_GROUP_BY_FIELD_ID
このほか、最大1つの他のグループ化条件（下表のSTAT_GROUP_BY_INVENTORYなど）を追加できます。追加せずにデフォルトのグループ化条件を使用することもできます。調整が必要な場合は、追加するグループ化条件名をsource.group_byに追加してください
| グループ化条件名 | 格納フィールド名 | 意味 | デフォルトかどうか |
|---|---|---|---|
| STAT_GROUP_BY_FIELD_STAT_TIME | stat_datetime | データの開始時間。形式：
| はい |
STAT_GROUP_BY_FIELD_ID | advertiser_id | 広告主ID | はい |
| campaign_name | 広告グループ名 | はい | |
| campaign_id | 広告グループID | はい | |
| ad_name | 広告キャンペーン名 | はい | |
| ad_id | 広告キャンペーンID | はい | |
| creative_id | クリエイティブID | はい | |
| STAT_GROUP_BY_INVENTORY | inventory | 配信広告枠 | |
| STAT_GROUP_BY_CREATIVE_MATERIAL_MODE | creative_material_mode | クリエイティブタイプ。値：
| |
| STAT_GROUP_BY_LANDING_TYPE | landing_type | プロモーション目的のタイプ | |
| STAT_GROUP_BY_PRICING | pricing | 入札タイプ | |
| STAT_GROUP_BY_IMAGE_MODE | image_mode | 素材タイプ | |
| STAT_GROUP_BY_PROVINCE_NAME | province_name | 省 | |
| STAT_GROUP_BY_CITY_NAME | city_name | 都市 | |
| STAT_GROUP_BY_GENDER | gender | 性別 | |
| STAT_GROUP_BY_AGE | age | 年齢 | |
| STAT_GROUP_BY_PLATFORM | platform | プラットフォーム | |
| STAT_GROUP_BY_AC | ac | タイプ |
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として設定します
- データのイベント名は oceanengine_creative_data です
- その他のフィールドはすべて格納されます
2.5 認証の完了
設定が完了したら、右上の「保存して許可する」をクリックしてプランの設定を保存します。次に、最後の認証作業を完了する必要があります：
まず、表示される「認証情報」ページで、最初のステップのアドレスをコピーします
Ocean Engineの開発者管理画面に戻り、先ほど作成したアプリの基本情報ページに移動して、コピーしたURLをポストバックURL欄に入力します
AEの画面に戻り、「認証設定へ」をクリックすると、Ocean Engineの認証ページが開きます
認証画面が表示されたら、「現在のユーザーのすべてのアカウント」を選択し、「現在のログインユーザー」がデータを取得したい広告アカウントを所有していることを確認します。赤枠内のログインユーザーIDが、プランの設定で入力したログインユーザーIDであることを確認してください。確認が完了したら、「認証に同意」をクリックすると認証作業が完了します。
認証が完了したら、「認証情報」で左下の「以上の2つのステップを完了しました」をクリックしてから、右下の「認証完了」をクリックして設定を終了します。これで、Ocean Engine広告クリエイティブデータの統合は完了です。
2.6 標準化フィールド
データに次のイベントプロパティが存在する場合は、自動的に標準化処理を行います：
| 元フィールド | 標準化フィールド | 意味 |
|---|---|---|
| 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 | 広告グループ名、マネタイズ広告のUnit名 |
| ad_id | te_ads_object.ad_group_id | 広告グループID、マネタイズ広告のUnit ID |
| creative_name | te_ads_object.ad_name | 広告名 |
| creative_id | te_ads_object.ad_id | 広告ID |
| platform（デフォルトでは取得しない） | te_ads_object.platform | プラットフォーム（Android、iOSなど） |
| 【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 | ユーザー獲得コスト |