Kuaishou広告クリエイティブ（カスタム）データ
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| 広告クリエイティブデータ（カスタム） | API | 集約指標 | ✅ | ✅ | ✅ | ✅ |
広告クリエイティブデータ（カスタム）レポートは、「クリエイティブ制作方式」が「カスタム」の広告のデータを取得するのに適しています
統合の流れ
- Kuaishouの開発者アカウントを登録し、アプリを作成します
- AE管理画面にログインし、サードパーティ統合モジュールでKuaishou広告クリエイティブデータ（カスタム）プランを追加して、関連する設定を完了します
- AE管理画面から認証用のポストバックURLを取得し、Kuaishouオープンプラットフォームにログインして、先ほど作成したアプリにそのポストバックURLを入力します
- AE管理画面で認証URLを開き、認証を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. 認証に必要な情報の取得
1.1 Kuaishou開発者アカウントの登録
Kuaishou Marketing APIを呼び出す前に、Kuaishouの開発者アカウントを用意する必要があります。まず、Magnetic Engine オープンプラットフォームにログインします
次に、「開発者として登録」をクリックします：
担当者の氏名などを入力し、担当者情報を登録します：
続いて、開発者の資格情報を登録する必要があります。会社の法人または代理人が登録を申請できますが、いずれの場合も申請者の実名認証が必要です
開発者ロールで「広告主」を選択する必要があります
1.2 アプリの作成
Kuaishou開発者アカウントの登録が完了したら、次に「アプリ管理」で新しいアプリを作成する必要があります
アプリの作成には以下の情報が必要です：
- アプリ名、アプリアイコン、アプリの説明：自由に設定できます
- ポストバックURL：ひとまずwww.thinkingdata.cnを使用します。アプリの作成とAEプラットフォームでのプランの作成が完了したら、再度変更する必要があります
次に、下図の緑枠と緑矢印で示したAPP IDとSecretを取得する必要があります
1.3 認証するアカウントのKuaishou IDの取得
最後に、広告データを取得するKuaishouアカウントのKuaishou IDを取得する必要があります。通常、Kuaishou管理画面の右上で確認できます：
2. プランの設定
アプリを作成したら、次にAEシステムの管理画面にログインし、「サードパーティ統合」モジュールでKuaishou広告クリエイティブデータ（カスタム）プランの設定を完了します。下図はKuaishou広告クリエイティブデータ（カスタム）の設定画面です：
2.1 認証情報の設定
「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップに認証作業で取得した情報を入力します
APP ID、Secret、User IDには、それぞれアプリ作成時に取得したAPP ID、Secret、および認証するアカウントのKuaishou IDを入力します
Advertiser ID Listには、取得したい広告アカウントIDのリストを入力します。複数ある場合は "," で区切ります。入力しない場合、AEシステムは認証したすべての広告アカウントのデータを取得します。入力した場合、AEシステムは入力した広告アカウントのデータのみを取得します
2.2 定期取得
「定期取得」モジュールで、AEシステムがKuaishou広告クリエイティブデータ（カスタム）を定期的に取得する方針を設定できます。毎日の特定の時刻、または1時間ごとに、一定期間のデータを取得するよう選択できます。取得したデータもデータ量に計上されるため、定期取得で長すぎる期間のデータを取得しないことをお勧めします
2.3 イベントデータの格納設定
「イベントデータの格納設定」スイッチをオンにすると、コールバックされたデータはすべてイベントテーブルに書き込まれます。イベントデータの格納を有効にすることをお勧めします。
2.4 統合構成
最後に、統合構成モジュールでデータ取得の詳細な設定を制御できます。データの時間集計粒度や、格納後のイベント名などが含まれます。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_name | 格納後のイベント名。カスタマイズ可能な文字列型です。受信したデータはすべてこの名前をイベント名とします。 |
| source | time_granularity | データの時間集計粒度。取得したデータを日単位と時間単位のどちらで集計するかを指定します 選択可能な値: DAILY ／ HOURLY |
| transfer | double_columns | 指標フィールドです。変更しないでください |
広告クリエイティブデータ（カスタム）の指標には、さまざまな業態（オンラインショップ、ライブコマースなど）の指標データが含まれています。以下は一部の常用指標です。指標の完全なリストについては、【広告クリエイティブデータ（カスタム）】ドキュメントを参照してください。デフォルトでは、すべてのデータを格納します
- 指標フィールド
| 指標 | 説明 |
|---|---|
| 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 - 削除済み |
2.5 イベントの格納ルール
- データ内のstat_dateとstat_hourフィールド、つまり日付と時間を連結した値を、データの#event_timeとして使用します
- データのイベント名は kuaishou_ads_creative_report です
- その他のフィールドはすべて格納されます
2.6 認証の完了
設定が完了したら、右上の「保存して許可する」をクリックしてプランの設定を保存します。次に、最後の認証作業を完了する必要があります：
まず、表示される「認証情報」ページで、最初のステップのアドレスをコピーします
次に、Magnetic Engine オープンプラットフォームにログインし、先ほど作成したアプリに移動して、認証用のポストバックURLを下図のポストバックURL欄に入力します
AEの画面に戻り、「認証設定へ」をクリックすると、Magnetic Engineの認証ページが開きます
認証画面が表示されたら、「ユーザーに基づく認証」を選択し、認証ページに表示されているKuaishou IDが、先ほどAEシステムで設定したプランのUser IDと一致していることを確認します。次に、「利用規約に同意する」にチェックを入れてから、「承認する」をクリックして認証を完了します
2.7 標準化フィールド
Kuaishou広告クリエイティブ（カスタム）データの一部のフィールドについて、AEシステムは標準化処理を行います：
| フィールド名 | 標準化フィールド | 意味 |
|---|---|---|
| advertiser_id | te_ads_object.ad_account_id | 広告主ID |
| campaign_name | te_ads_object.campaign_name | 広告グループ名 |
| campaign_id | te_ads_object.campaign_id | 広告グループID |
| unit_name | te_ads_object.ad_group_name | 広告キャンペーン名 |
| unit_id | te_ads_object.ad_group_id | 広告キャンペーンID |
| creative_name | te_ads_object.ad_name | クリエイティブ名 |
| creative_id | te_ads_object.ad_id | クリエイティブID |
| 【CNY】（固定値） | te_ads_object.currency | コストまたは収益の通貨 |
| show | te_ads_object.impressions | 表示数 |
| photo_click | te_ads_object.clicks | クリック数 |
| conversion_num | te_ads_object.installs | クリックインストール数 |
| charge | te_ads_object.cost | 総消費 |