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

Kuaishouプログラマティッククリエイティブ2.0データ

最終更新 2026/10/03
ヒント

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

概要​

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

インターフェース名タイプ粒度アトリビューションコスト収益表示クリックコンバージョン
プログラマティッククリエイティブ2.0データAPI集約指標✅✅✅✅

プログラマティッククリエイティブ2.0データは、「クリエイティブ制作方式」が「プログラマティッククリエイティブ」の広告のデータを取得するのに適しています

統合の流れ​

  1. Kuaishouの開発者アカウントを登録し、アプリを作成します
  2. AE管理画面にログインし、サードパーティ統合モジュールでKuaishouプログラマティッククリエイティブ2.0データプランを追加して、関連する設定を完了します
  3. AE管理画面から認証用のポストバックURLを取得し、Kuaishouオープンプラットフォームにログインして、先ほど作成したアプリにそのポストバックURLを入力します
  4. AE管理画面で認証URLを開き、認証を完了します
  5. 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プログラマティッククリエイティブ2.0データの設定を完了します。下図はKuaishouプログラマティッククリエイティブ2.0データの設定画面です：

2.1 認証情報の設定​

「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップに認証作業で取得した情報を入力します

APP ID、Secret、User IDには、それぞれアプリ作成時に取得したAPP ID、Secret、および認証するアカウントのKuaishou IDを入力します

Advertiser ID Listには、取得したい広告アカウントIDのリストを入力します。複数ある場合は "," で区切ります。入力しない場合、AEシステムは認証したすべての広告アカウントのデータを取得します。入力した場合、AEシステムは入力した広告アカウントのデータのみを取得します

2.2 定期取得​

「定期取得」モジュールで、AEシステムがKuaishou広告のプログラマティッククリエイティブ2.0データを定期的に取得する方針を設定できます。毎日の特定の時刻、または1時間ごとに、一定期間のデータを取得するよう選択できます。取得したデータもデータ量に計上されるため、定期取得で長すぎる期間のデータを取得しないことをお勧めします

2.3 イベントデータの格納設定​

「イベントデータの格納設定」スイッチをオンにすると、コールバックされたデータはすべてイベントテーブルに書き込まれます。イベントデータの格納を有効にすることをお勧めします。

2.4 統合構成​

最後に、統合構成モジュールでデータ取得の詳細な設定を制御できます。データの時間集計粒度や、格納後のイベント名などが含まれます。

統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：

モジュール名前意味
sink_eventevent_name格納後のイベント名。カスタマイズ可能な文字列型です。受信したデータはすべてこの名前をイベント名とします。
source

time_granularity

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

選択可能な値: DAILY ／ HOURLY

transferdouble_columns指標フィールドです。変更しないでください

プログラマティッククリエイティブデータの指標には、さまざまな業態（オンラインショップ、ライブコマースなど）の指標データが含まれています。以下は一部の常用指標です。指標の完全なリストについては、【プログラマティッククリエイティブ2.0データ】ドキュメントを参照してください。デフォルトでは、すべてのデータを格納します：

  • 指標フィールド
指標説明
charge費用（元）
showカバー露出数
photo_clickカバークリック数
aclick素材露出数
bclickアクション数
photo_click_ratioカバークリック率
impression_1k_cost1,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_costAndroidダウンロード完了単価（元）
download_completed_ratioAndroidダウンロード完了率
download_conversion_ratioダウンロード完了後のアクティベーション率
download_started_costAndroidダウンロード開始単価（元）
download_started_ratioAndroidダウンロード開始率
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（横型/縦型）

2.5 イベントの格納ルール​

  • データ内のstat_dateとstat_hourフィールド、つまり日付と時間を連結した値を、データの#event_timeとして使用します
  • データのイベント名は kuaishou_ads_program_creative_report です
  • その他のフィールドはすべて格納されます

2.6 認証の完了​

設定が完了したら、右上の「保存して許可する」をクリックしてプランの設定を保存します。次に、最後の認証作業を完了する必要があります：

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

次に、Magnetic Engine オープンプラットフォームにログインし、先ほど作成したアプリに移動して、認証用のポストバックURLを下図のポストバックURL欄に入力します

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

認証画面が表示されたら、「ユーザーに基づく認証」を選択し、認証ページに表示されているKuaishou IDが、先ほどAEシステムで設定したプランのUser IDと一致していることを確認します。次に、「利用規約に同意する」にチェックを入れてから、「承認する」をクリックして認証を完了します

2.7 標準化フィールド​

Kuaishouプログラマティッククリエイティブ2.0データの一部のフィールドについて、AEシステムは標準化処理を行います：

フィールド名標準化フィールド意味
advertiser_idte_ads_object.ad_account_id広告主ID
campaign_namete_ads_object.campaign_name広告グループ名
campaign_idte_ads_object.campaign_id広告グループID
unit_namete_ads_object.ad_group_name広告キャンペーン名
unit_idte_ads_object.ad_group_id広告キャンペーンID
creative_namete_ads_object.ad_nameクリエイティブ名
creative_idte_ads_object.ad_idクリエイティブID
【CNY】（固定値）te_ads_object.currencyコストまたは収益の通貨
showte_ads_object.impressions表示数
photo_clickte_ads_object.clicksクリック数
conversion_numte_ads_object.installsクリックインストール数
chargete_ads_object.cost総消費
このページは役に立ちましたか？
このページの内容