manuallatest製品マニュアル / Kuaishou広告データ統合ソリューション
Kuaishou広告データ統合ソリューション
最終更新日：2022-07-27
1. 統合プランの紹介
ヒント
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
本記事では、KuaishouのMagnetic Engine広告データをAgentic Engine（以下、AEシステム）にコールバックする方法を説明します。本プランは次に対応しています：
- Kuaishou Marketing APIで、露出、クリック、インストール、コスト、コンバージョンの指標を含む集約指標データをコールバック
Kuaishouの広告データの統合を始める前に、AEシステムのデータルールを読み、AEのデータ構造を理解しておいてください。また、データの取得に必要な情報を担当のカスタマーサクセスマネージャーにお渡しいただくことをお勧めします。形式はデータ統合設定情報テンプレートを参考にしてください。
流れ
-
Kuaishouの開発者アカウントを登録し、アプリを作成します
-
KuaishouアプリのAPP_IDと、統合するAEプロジェクトのAPP IDをThinkingAIの担当者に提供します。ThinkingAIの担当者からコールバックリンクが提供されますので、そのリンクをKuaishouアプリのコールバックリンクとして設定してください
-
ThinkingAIの担当者から提供された認証URLを開き、認証を完了します
-
データの取得方法を決めます：
- 広告主データ
- 広告クリエイティブデータ（カスタム）
- プログラマティッククリエイティブ2.0データ
- トラフィックブースト注文データ
-
取得するデータのディメンション、指標タイプ、取得頻度、取得する時間範囲を決めます
-
ThinkingAIの担当者がデータ取得の開発作業を行います
-
AE管理画面でダッシュボードやレポートを作成し、データ検証を完了します
2. 統合前の準備
2.1 Kuaishou開発者アカウントの登録
Kuaishou Marketing APIを呼び出す前に、Kuaishouの開発者アカウントを用意する必要があります。Kuaishou公式ドキュメントの手順に従って、開発者アカウントの登録を完了することをお勧めします。
2.2 コールバックアドレスの設定と認証の完了
- Kuaishou開発者アカウントの登録が完了したら、次に「アプリ管理」でアプリ情報を入力し、対応するアプリを作成する必要があります
- アプリ情報には認証用のコールバックリンクが含まれます。アプリの申請後にKuaishouから返されるアプリのapp_idと、統合するAEプロジェクトのAPP IDをThinkingAIの担当者に提供してください。ThinkingAIの担当者からコールバックリンクが提供されますので、そのアドレスをKuaishouの「アプリ管理」の該当する箇所に入力してください。
- 設定が完了すると、ThinkingAIの担当者から認証リンクが提供されます。認証リンクをクリックすると、次のページが表示されます。ここに表示される「Kuaishou ID」を控えて、ThinkingAIの担当者に提供してください。次に、「ユーザーに基づく認証」をクリックし、「利用規約に同意する」にチェックを入れてから、「承認する」をクリックして認証を完了します
3. データの取得
Kuaishou Marketing APIはさまざまなデータタイプを提供しています。現在、AEシステムが対応しているデータタイプは次のとおりです：
- 広告主データ
- 広告クリエイティブデータ（カスタム）
- プログラマティッククリエイティブ2.0データ
- トラフィックブースト注文データ
3.1 広告主データ
インターフェースの基本情報
| インターフェース名 | APIタイプ | 製品化 | データ粒度 | アトリビューションデータ | コストデータ | 収益データ | インプレッション | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|---|
| 広告主データ | プル型 | いいえ | 集計データ | はい | はい | はい | はい |
3.1.1 インターフェースのパラメータ
-
広告主アカウント：
- データを取得する広告主アカウントIDを指定する必要があります
-
時間：
- 1日単位または1時間単位のデータ
- 指標の時間粒度は、日粒度または時間粒度から選択できます
3.1.2 対象フィールド
広告主データの指標には、さまざまな業態（オンラインショップ、ライブコマースなど）の指標データが含まれています。本節では一部のよく使われる指標のみを示します。指標の完全なリストについては、【広告主データ】ドキュメントを参照してください：
- 指標フィールド
| 指標 | 説明 |
|---|---|
| charge | 費用（元） |
| show | カバー露出数 |
| photo_click | カバークリック数 |
| aclick | 素材露出数 |
| bclick | アクション数 |
| photo_click_ratio | カバークリック率 |
| impression_1k_cost | 1,000回露出あたりの平均費用（元） |
| photo_click_cost | 平均クリック単価（元） |
| action_cost | 平均アクション単価（元） |
| share | シェア数 |
| comment | コメント数 |
| like | いいね数 |
| follow | 新規フォロー数 |
| cancel_follow | フォロー解除数 |
| report | 通報数 |
| block | ブロック数 |
| negative | 「この種の作品を減らす」数 |
| download_started | アプリダウンロードデータ-Androidダウンロード開始数 |
| download_completed | アプリダウンロードデータ-Androidダウンロード完了数 |
| activation | アプリダウンロードデータ-アクティベーション数 |
| event_pay_first_day | アプリダウンロードデータ-初日課金回数 |
| event_pay_purchase_amount_first_day | アプリダウンロードデータ-初日課金額 |
| event_pay_first_day_roi | アプリダウンロードデータ-初日ROI |
| event_pay | アプリダウンロードデータ-課金回数 |
| event_pay_purchase_amount | アプリダウンロードデータ-課金額 |
| event_pay_roi | アプリダウンロードデータ-ROI |
| event_register | アプリダウンロードデータ-登録数 |
| event_register_cost | アプリダウンロードデータ-登録コスト |
| event_register_ratio | アプリダウンロードデータ-登録率 |
| event_order_paid | アプリダウンロードデータ-支払い成功数 |
| event_order_paid_purchase_amount | アプリダウンロードデータ-支払い成功金額 |
| event_order_paid_cost | アプリダウンロードデータ-1回あたりの支払いコスト |
| played_end | 再生完了 |
| played_three_seconds | 有効再生数 |
| click_1k_cost | 素材1,000回露出あたりの平均費用(元) |
| event_button_click | ボタンクリック数 |
| event_button_click_cost | ボタンクリックコスト：当日消費 / ボタンクリック数 |
| event_button_click_ratio | ボタンクリック率：ボタンクリック数 / アクション数 |
| play_end_ratio | 完全視聴率：ボタンクリック数 / アクション数 |
| event_watch_app_ad | 広告視聴 |
| event_ad_watch_times | 広告視聴回数 |
| event_ad_watch_times_ratio | 広告視聴回数のコンバージョン率 |
| event_ad_watch_times_cost | 広告視聴回数のコスト |
| ad_show | 広告露出 |
| click_conversion_ratio | クリックアクティベーション率 |
| conversion_cost | アクティベーション単価 |
| download_completed_cost | Androidダウンロード完了単価（元） |
| download_completed_ratio | Androidダウンロード完了率 |
| download_conversion_ratio | ダウンロード完了後のアクティベーション率 |
| download_started_cost | Androidダウンロード開始単価（元） |
| download_started_ratio | Androidダウンロード開始率 |
| conversion_num | コンバージョン数（ポストバック時刻でアトリビューション） |
| conversion_num_cost | コンバージョンコスト（ポストバック時刻でアトリビューション） |
| conversion_ratio | コンバージョン率（ポストバック時刻でアトリビューション） |
- ディメンションフィールド
| ディメンション | 説明 |
|---|---|
| advertiser_id | 広告アカウントID |
| campaign_id | 広告キャンペーンID |
| campaign_name | 広告キャンペーン名 |
| unit_id | 広告グループID |
| unit_name | 広告グループ名 |
| creative_id | 広告クリエイティブID |
| creative_name | 広告クリエイティブ名 |
| status | 1 - 配信中、2 - 一時停止中、3 - 削除済み |
3.1.3 格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
- 広告主データは集計データのため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐付けられていると考えてください
- データ内のstat_dateとstat_hourフィールド、つまり日付と時間を連結した値を、データの#event_timeとして使用します
- データのイベント名は kuaishou_ads_account_report です
- その他のフィールドはすべて格納されます
3.2 広告クリエイティブデータ（カスタム）
インターフェースの基本情報
| インターフェース名 | APIタイプ | 製品化 | データ粒度 | アトリビューションデータ | コストデータ | 収益データ | インプレッション | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|---|
| 広告クリエイティブデータ（カスタム） | プル型 | いいえ | 集計データ | はい | はい | はい | はい |
Magnetic Engine管理画面で「クリエイティブ制作方式」が「カスタム」の広告を設定している場合は、このインターフェースでデータを取得できます：
3.2.1 インターフェースのパラメータ
-
広告主アカウント：
- データを取得する広告主アカウントIDを指定する必要があります
-
時間：
- 1日単位または1時間単位のデータ
- 指標の時間粒度は、日粒度または時間粒度から選択できます
3.2.2 対象フィールド
広告クリエイティブデータの指標には、さまざまな業態（オンラインショップ、ライブコマースなど）の指標データが含まれています。本節では一部のよく使われる指標のみを示します。指標の完全なリストについては、【広告クリエイティブデータ-カスタム】ドキュメントを参照してください：
- 指標フィールド
| 指標 | 説明 |
|---|---|
| charge | 費用（元） |
| show | カバー露出数 |
| photo_click | カバークリック数 |
| aclick | 素材露出数 |
| bclick | アクション数 |
| photo_click_ratio | カバークリック率 |
| impression_1k_cost | 1,000回露出あたりの平均費用（元） |
| photo_click_cost | 平均クリック単価（元） |
| action_cost | 平均アクション単価（元） |
| share | シェア数 |
| comment | コメント数 |
| like | いいね数 |
| follow | 新規フォロー数 |
| cancel_follow | フォロー解除数 |
| report | 通報数 |
| block | ブロック数 |
| negative | 「この種の作品を減らす」数 |
| download_started | アプリダウンロードデータ-Androidダウンロード開始数 |
| download_completed | アプリダウンロードデータ-Androidダウンロード完了数 |
| activation | アプリダウンロードデータ-アクティベーション数 |
| event_pay_first_day | アプリダウンロードデータ-初日課金回数 |
| event_pay_purchase_amount_first_day | アプリダウンロードデータ-初日課金額 |
| event_pay_first_day_roi | アプリダウンロードデータ-初日ROI |
| event_pay | アプリダウンロードデータ-課金回数 |
| event_pay_purchase_amount | アプリダウンロードデータ-課金額 |
| event_pay_roi | アプリダウンロードデータ-ROI |
| event_register | アプリダウンロードデータ-登録数 |
| event_register_cost | アプリダウンロードデータ-登録コスト |
| event_register_ratio | アプリダウンロードデータ-登録率 |
| event_order_paid | アプリダウンロードデータ-支払い成功数 |
| event_order_paid_purchase_amount | アプリダウンロードデータ-支払い成功金額 |
| event_order_paid_cost | アプリダウンロードデータ-1回あたりの支払いコスト |
| click_1k_cost | 素材1,000回露出あたりの平均費用(元) |
| event_button_click | ボタンクリック数 |
| event_button_click_cost | ボタンクリックコスト：当日消費 / ボタンクリック数 |
| event_button_click_ratio | ボタンクリック率：ボタンクリック数 / アクション数 |
| play_end_ratio | 完全視聴率：ボタンクリック数 / アクション数 |
| event_watch_app_ad | 広告視聴 |
| event_ad_watch_times | 広告視聴回数 |
| event_ad_watch_times_ratio | 広告視聴回数のコンバージョン率 |
| event_ad_watch_times_cost | 広告視聴回数のコスト |
| ad_show | 広告露出 |
| click_conversion_ratio | クリックアクティベーション率 |
| conversion_cost | アクティベーション単価 |
| download_completed_cost | Androidダウンロード完了単価（元） |
| download_completed_ratio | Androidダウンロード完了率 |
| download_conversion_ratio | ダウンロード完了後のアクティベーション率 |
| download_started_cost | Androidダウンロード開始単価（元） |
| download_started_ratio | Androidダウンロード開始率 |
| conversion_num | コンバージョン数（ポストバック時刻でアトリビューション） |
| conversion_num_cost | コンバージョンコスト（ポストバック時刻でアトリビューション） |
| conversion_ratio | コンバージョン率（ポストバック時刻でアトリビューション） |
- ディメンションフィールド
| ディメンション | 説明 |
|---|---|
| advertiser_id | 広告アカウントID |
| campaign_id | 広告キャンペーンID |
| campaign_name | 広告キャンペーン名 |
| unit_id | 広告グループID |
| unit_name | 広告グループ名 |
| creative_id | 広告クリエイティブID |
| creative_name | 広告クリエイティブ名 |
| status | 1 - 配信中、2 - 一時停止中、3 - 削除済み |
3.2.3 格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
- 広告クリエイティブデータは集計データのため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐付けられていると考えてください
- データ内のstat_dateとstat_hourフィールド、つまり日付と時間を連結した値を、データの#event_timeとして使用します
- データのイベント名は kuaishou_ads_creative_report です
- その他のフィールドはすべて格納されます
3.3 プログラマティッククリエイティブ2.0データ
インターフェースの基本情報
| インターフェース名 | APIタイプ | 製品化 | データ粒度 | アトリビューションデータ | コストデータ | 収益データ | インプレッション | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|---|
| プログラマティッククリエイティブ2.0データ | プル型 | いいえ | 集計データ | はい | はい | はい | はい |
Magnetic Engine管理画面で「クリエイティブ制作方式」が「プログラマティッククリエイティブ」の広告を設定している場合は、このインターフェースでデータを取得できます：
3.3.1 インターフェースのパラメータ
-
広告主アカウント：
- データを取得する広告主アカウントIDを指定する必要があります
-
時間：
- 時間単位まで指定した時間範囲のデータ
- 指標の時間粒度は、日粒度または時間粒度から選択できます
3.3.2 対象フィールド
プログラマティッククリエイティブデータの指標には、さまざまな業態（オンラインショップ、ライブコマースなど）の指標データが含まれています。本節では一部のよく使われる指標のみを示します。指標の完全なリストについては、【プログラマティッククリエイティブ2.0データ】ドキュメントを参照してください：
- 指標フィールド
| 指標 | 説明 |
|---|---|
| charge | 費用（元） |
| show | カバー露出数 |
| photo_click | カバークリック数 |
| aclick | 素材露出数 |
| bclick | アクション数 |
| photo_click_ratio | カバークリック率 |
| impression_1k_cost | 1,000回露出あたりの平均費用（元） |
| photo_click_cost | 平均クリック単価（元） |
| action_cost | 平均アクション単価（元） |
| share | シェア数 |
| comment | コメント数 |
| like | いいね数 |
| follow | 新規フォロー数 |
| cancel_follow | フォロー解除数 |
| report | 通報数 |
| block | ブロック数 |
| negative | 「この種の作品を減らす」数 |
| download_started | アプリダウンロードデータ-Androidダウンロード開始数 |
| download_completed | アプリダウンロードデータ-Androidダウンロード完了数 |
| activation | アプリダウンロードデータ-アクティベーション数 |
| event_pay_first_day | アプリダウンロードデータ-初日課金回数 |
| event_pay_purchase_amount_first_day | アプリダウンロードデータ-初日課金額 |
| event_pay_first_day_roi | アプリダウンロードデータ-初日ROI |
| event_pay | アプリダウンロードデータ-課金回数 |
| event_pay_purchase_amount | アプリダウンロードデータ-課金額 |
| event_pay_roi | アプリダウンロードデータ-ROI |
| event_register | アプリダウンロードデータ-登録数 |
| event_register_cost | アプリダウンロードデータ-登録コスト |
| event_register_ratio | アプリダウンロードデータ-登録率 |
| event_order_paid | アプリダウンロードデータ-支払い成功数 |
| event_order_paid_purchase_amount | アプリダウンロードデータ-支払い成功金額 |
| event_order_paid_cost | アプリダウンロードデータ-1回あたりの支払いコスト |
| played_end | 再生完了 |
| played_three_seconds | 有効再生数 |
| click_1k_cost | 素材1,000回露出あたりの平均費用(元) |
| event_button_click | ボタンクリック数 |
| event_button_click_cost | ボタンクリックコスト：当日消費 / ボタンクリック数 |
| event_button_click_ratio | ボタンクリック率：ボタンクリック数 / アクション数 |
| play_end_ratio | 完全視聴率：ボタンクリック数 / アクション数 |
| event_watch_app_ad | 広告視聴 |
| event_ad_watch_times | 広告視聴回数 |
| event_ad_watch_times_ratio | 広告視聴回数のコンバージョン率 |
| event_ad_watch_times_cost | 広告視聴回数のコスト |
| ad_show | 広告露出 |
| click_conversion_ratio | クリックアクティベーション率 |
| conversion_cost | アクティベーション単価 |
| download_completed_cost | Androidダウンロード完了単価（元） |
| download_completed_ratio | Androidダウンロード完了率 |
| download_conversion_ratio | ダウンロード完了後のアクティベーション率 |
| download_started_cost | Androidダウンロード開始単価（元） |
| download_started_ratio | Androidダウンロード開始率 |
| conversion_num | コンバージョン数（ポストバック時刻でアトリビューション） |
| conversion_num_cost | コンバージョンコスト（ポストバック時刻でアトリビューション） |
| conversion_ratio | コンバージョン率（ポストバック時刻でアトリビューション） |
- ディメンションフィールド
| ディメンション | 説明 |
|---|---|
| campaign_id | キャンペーンID |
| campaign_name | キャンペーン名 |
| unit_id | グループID |
| unit_name | グループ名 |
| creative_id | クリエイティブID |
| photo_url | 動画リンク |
| photo_id | 動画ID |
| image_token | カバーID |
| cover_url | カバーリンク |
| description | 作品の広告文 |
| pic_id | 画像ライブラリの画像ID |
| pic_list | ユニオン画像（横型/縦型） |
| pic_url_list | ユニオン画像URL（横型/縦型） |
3.3.3 格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
- プログラマティッククリエイティブ2.0データは集計データのため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐付けられていると考えてください
- データ内のstat_dateとstat_hourフィールド、つまり日付と時間を連結した値を、データの#event_timeとして使用します
- データのイベント名は kuaishou_ads_program_creative_report です
- その他のフィールドはすべて格納されます
3.4 トラフィックブースト注文データ
インターフェースの基本情報
| インターフェース名 | APIタイプ | 製品化 | データ粒度 | アトリビューションデータ | コストデータ | 収益データ | インプレッション | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|---|
| トラフィックブースト注文データ | プル型 | いいえ | 集計データ | はい | はい | はい | はい |
トラフィックブーストデータでは、過去30日間に作成されたトラフィックブースト注文の、昨日の消費状況を取得します
3.4.1 インターフェースのパラメータ
- 広告主アカウント：
- データを取得する広告主アカウントIDを指定する必要があります
3.4.2 対象フィールド
トラフィックブーストデータの指標と分析ディメンションは固定です。すべてのフィールドは次のとおりです：
- 指標フィールド
| 指標 | 説明 |
|---|---|
| amount | 金額 |
| consume_amount | 消費金額 |
| view | カバー露出数 |
| play | 再生数 |
| action | アクション数 |
| conversion | アクティベーション数 |
| play_percent | カバークリック率 |
| action_percent | アクション率 |
| cpm | cpm |
| cpc_of_action | 平均アクション単価 |
| cpa | アクティベーション単価 |
- ディメンションフィールド
| ディメンション | 説明 |
|---|---|
| supplement_order_id | ブースト注文ID |
| task_id | タスクID |
| order_id | Juxing注文ID |
| star_user_id | クリエイターID |
| account_id | account_id |
| unit_ids | unit_id |
| star_name | クリエイター名 |
| status | ステータス |
| promotion_begin_time | プロモーション開始時間 |
| promotion_end_time | プロモーション終了時間 |
| target_type | 配信オーディエンスタイプ |
| unit_type | 最適化目標/配信目標 |
| unit_price | 入札額/目標コスト |
| supplement_order_sense_id | 広告枠 |
| android_app_name | Androidアプリ名 |
| package_name | Androidアプリのパッケージ名 |
3.4.3 格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
- トラフィックブースト注文の配信後データは集計データのため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐付けられていると考えてください
- 昨日の日付（つまり'YYYY-MM-DD 00:00:00'）をデータの#event_timeとして使用します
- データのイベント名は kuaishou_ads_supplement_report です
- その他のフィールドはすべて格納されます
4. データ統合設定情報テンプレート
以上のドキュメントを読んだら、次の情報テンプレートに記入し、ThinkingAIの担当カスタマーサクセスマネージャーに送信することをお勧めします：
データインターフェース：Kuaishou Magnetic Engine Marketing API
---------
会社名：XXX
AEプロジェクト環境：（SAAS/プライベートデプロイ）
AEプロジェクト名：XXX
AEプロジェクトAPP ID: XXX
---------
Magnetic Engineアプリ管理ページのAPP_IDとsecret：XXX
ブーストインターフェースで絞り込むアプリのパッケージ名：xxx
---------
取得するデータタイプ：（広告主/カスタム広告クリエイティブ/プログラマティッククリエイティブ2.0/トラフィックブースト注文の配信後データ）
データを取得する広告主（広告アカウント）IDリスト：XXX，XXX
取得するフィールド：XXX，XXX
履歴データの取得時間範囲：yyyy/mm/dd - yyyy/mm/dd
定期取得：毎日X時に前日のデータを取得
5. データ検証と利用
「イベント分析」で、以下のイベント（データセット）を分析できます：
- kuaishou_ads_account_report
- kuaishou_ads_creative_report
- kuaishou_ads_program_creative_report
- kuaishou_ads_supplement_report
このページは役に立ちましたか？