Kwai統合プラン
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| Marketing API | API | 集約指標 | ✅ | ✅ | ✅ | ✅ |
現在、AEはKuaishouの海外向けビジネスプラットフォームKwaiの広告クリエイティブデータの統合に対応しており、広告クリエイティブ階層のコスト、クリック、表示などの集約指標データを取得できます
統合の流れ
- AE管理画面にログインし、サードパーティ統合モジュールでKwai統合プランを追加して関連する設定を完了し、認証用のポストバックURLをコピーします
- Kwai管理画面で新しいアカウントを作成し、管理者アカウントを使用してそのアカウントに開発者ロールを追加します。開発者の申請を完了し、アプリを作成します
- AE管理画面に戻り、先ほどのKwai統合プランを編集して、アプリのClient IDとsecretを設定し、認証リンクを開いて認証を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. プランの設定
Kwaiプラットフォームのデータを統合する前に、まずAE管理画面で対応する統合プランを作成し、認証用のポストバックURLを取得する必要があります。本ドキュメントに従って統合プランを作成してください
1.1 仮の認証情報の入力
まず、認証情報欄の「認証情報設定」ボタンをクリックし、表示された認証情報のポップアップで認証情報の3つの項目に任意の値を入力して、仮の認証情報とします。その後、Kwaiプラットフォームでアプリを作成したら、改めて修正する必要があります。
1.2 定期取得
「定期取得」モジュールで、AEシステムがKwai Marketing APIのデータを定期的に取得する方針を設定できます。毎日の特定の時刻に、一定期間のデータを取得するよう選択できます。取得したデータもデータ量に計上されるため、定期取得で長すぎる期間のデータを取得しないことをお勧めします
1.3 取得タイムゾーン
取得するデータのタイムゾーンも設定できます。デフォルトはUTC+8です
1.4 格納設定
データをイベントとして書き込むかどうかを制御できます。オフにすると、データはイベントテーブルに書き込まれなくなるため、この設定はオフにしないでください。
1.5 統合構成
最後に、統合構成モジュールでデータ取得の詳細設定を制御できます。データの時間集計粒度、取得する指標フィールドとディメンション、格納後のイベント名などが含まれます。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_name | 格納後のイベント名。カスタマイズ可能 |
| source | time_granularity | データの時間集計粒度。つまり、取得したデータを日単位と時間単位のどちらで集計するか 選択可能な値: day、hour |
| transfer | double_columns | 指標フィールドです。変更しないでください |
1.6 認証用のポストバックURLの取得
上記の設定が完了したら、右上の「保存して許可する」をクリックし、認証情報を取得してください。最初のステップにある認証用のポストバックURLをコピーし、大切に保管してください。その後、「認証保留中」をクリックしてポップアップを閉じます：
「保存して許可する」をクリックした時点でプランは保存されるため、別途保存する必要はありません。これでAE管理画面での設定作業はいったん完了です。次に、Kwai管理画面で関連する設定を行ってください。
2. Kwaiプラットフォームでの開発者アカウントとアプリの作成
2.1 開発者ロールのアカウントの作成
Kwaiプラットフォームでは現在、開発者以外のロール（広告運用担当者ロールなど）のアカウントを開発者ロールに切り替えることも、開発者ロールのアカウントを開発者以外のロールに切り替えることもできません。そのため、新しいアカウントを作成して開発者ロールに設定する必要があります。具体的な手順は次のとおりです：
- まずKwai管理画面のページにアクセスし、登録をクリックして新しいアカウントを作成します（会社のメールアドレスで登録し、アカウントとパスワードは大切に保管することをお勧めします）。
- 管理者アカウントでBusiness Centerにログインし、「Permission Management」ページに移動して、「Add Member」をクリックします
- 「Add Member」ページでメンバーの氏名を入力し、「Bind Email」には最初の手順で新しいアカウントを登録したときのメールアドレスを入力します。「Select Team」では管理者が所属するチームと同じ選択肢を選び、「Select Role」ではDeveloperを選択します。設定が完了すると、先ほど作成した新しいアカウントに開発者ロールが付与されます。
2.2 開発者権限の申請
開発者ロールのアカウントでBusiness Centerにログインし、開発者の申請を行ってアプリを作成します
- APP Name：アプリ名です。自由に設定できます
- Callback URL：認証用のポストバックURL、つまり1.6節で取得したURLです。ここに入力してください
2.3 認証の完了
開発者審査に合格すると、APP Listで先ほど作成したアプリを確認できます
アプリをクリックするとアプリの基本情報を確認できます。CLIENT IDとSecretをコピーしてください
3. AE管理画面に戻り、認証作業を完了
Kwai管理画面での設定が完了したら、AE管理画面に戻り、先ほど作成したKwai統合プランに移動して、「認証情報」の下にある「認証情報設定」ボタンをクリックします：
次に、Kwai管理画面で取得したCLIENT IDとSecretを該当する欄に入力し、Account ID Listにはデータを取得したいKwai広告プラットフォームのアカウントIDを入力します。複数のIDは "," で区切ります。編集が完了したら、保存ボタンをクリックします：
続いて右上の「保存して許可する」をクリックすると、再度認証情報のポップアップが表示されます。ここで「認証設定へ」をクリックするとKwaiプラットフォームの認証ページが開くので、Kwaiプラットフォームの広告アカウントにログインして認証を完了してください。プランを保存したものの認証が完了していない場合は、プランページの上部に「現在のプランはまだ承認されておらず、データにアクセスできません。認証に進んでください。」というヒントバーが表示されます。その中の「認証解除」をクリックしても、認証情報のポップアップを開くことができます
認証が完了したら、「認証情報」で左下の「以上の2つのステップを完了しました」をクリックしてから、右下の「認証完了」をクリックして設定を終了します。これで、Kwaiプラットフォームのデータ統合は完了です。
4. データの格納
4.1 格納ルール
- クリエイティブレポートは集計データであるため、ユーザー識別子として固定値を使用します。すべてのデータが1人の仮想ユーザーに紐づいていると考えてください
- データ内のtimeフィールド（データ時間）を、イベントの#event_timeとして使用します
- デフォルトのイベント名：kwai_ads_creative_report
- その他のフィールドはすべて格納されます
4.2 対象フィールド
広告クリエイティブデータでは、以下のフィールドを取得できます：
| フィールド名 | 名称と備考 |
|---|---|
| time | タイムスタンプ（時間型に変換） |
| #zone_offset | タイムゾーン（timeZoneIanaから抽出） |
| accountid | 広告アカウントID |
| accountname | 広告アカウント名 |
| campaignid | 広告キャンペーンID |
| campaignname | 広告キャンペーン名 |
| unitid | 広告グループID |
| unitname | 広告グループ名 |
| creativeid | 広告クリエイティブID |
| creativename | 広告クリエイティブ名 |
| id | 広告クリエイティブID |
| cost | 消費額。該当アカウントの配信プラットフォームの通貨と一致します。 数値は6桁精度で、実際の金額はcostを1000000で割った値です 例：配信通貨が米ドルの場合、実際の消費額 = cost / 1000000（米ドル） 注：AEシステムはcostフィールドを処理しませんが、標準化フィールドte_ads_object.costは1000000で割った値になります |
| exposure | 表示数 |
| click | クリック数 |
| action | コンバージョン数 |
| cpm | 1,000回露出あたりの消費額。該当アカウントの配信プラットフォームの通貨と一致します。 |
| cpc | 1回のクリックあたりのコスト。該当アカウントの配信プラットフォームの通貨と一致します。 |
| ctr | クリック率 |
| cvr | コンバージョン率 |
| cpa | 平均コンバージョンコスト。該当アカウントの配信プラットフォームの通貨と一致します。 |
| play3s | 3秒再生数 |
| play5s | 5秒再生数 |
| playfinished | 完全視聴数 |
| registration | 広告主がコールバックした登録数。該当アカウントの配信プラットフォームと一致します。 |
| costperregistration | 広告主がコールバックした登録のコンバージョンコスト。該当アカウントの配信プラットフォームと一致します。 |
| registrationrate | 広告主がコールバックした登録のコンバージョン率。該当アカウントの配信プラットフォームと一致します。 |
| addtocart | 広告主がコールバックしたカート追加数。該当アカウントの配信プラットフォームと一致します。 |
| costperaddtocart | 広告主がコールバックしたカート追加のコンバージョンコスト。該当アカウントの配信プラットフォームと一致します。 |
| addtocartrate | 広告主がコールバックしたカート追加のコンバージョン率。該当アカウントの配信プラットフォームと一致します。 |
| applaunch | 広告主がコールバックしたアプリ起動数。該当アカウントの配信プラットフォームと一致します。 |
| costperapplaunch | 広告主がコールバックしたアプリ起動のコンバージョンコスト。該当アカウントの配信プラットフォームと一致します。 |
| applaunchrate | 広告主がコールバックしたアプリ起動のコンバージョン率。該当アカウントの配信プラットフォームと一致します。 |
| activation | 広告主がコールバックしたアクティベーション数。該当アカウントの配信プラットフォームと一致します。 |
| costperactivation | 広告主がコールバックしたアクティベーションのコンバージョンコスト。該当アカウントの配信プラットフォームと一致します。 |
| activationrate | 広告主がコールバックしたアクティベーションのコンバージョン率。該当アカウントの配信プラットフォームと一致します。 |
| pageview | 広告主がコールバックしたページビュー数。該当アカウントの配信プラットフォームと一致します。 |
| costperpageview | 広告主がコールバックしたページビューのコンバージョンコスト。該当アカウントの配信プラットフォームと一致します。 |
| pageviewrate | 広告主がコールバックしたページビューのコンバージョン率。該当アカウントの配信プラットフォームと一致します。 |
4.3 標準化フィールド
AEシステムは以下のフィールドを標準化処理します：
| 元フィールド | 標準化フィールド | 意味 |
|---|---|---|
| accountid | te_ads_object.ad_account_id | 広告アカウントID |
| campaignid | te_ads_object.campaign_id | 広告キャンペーンID |
| campaignname | te_ads_object.campaign_name | 広告キャンペーン名 |
| unitid | te_ads_object.ad_group_id | 広告グループID |
| unitname | te_ads_object.ad_group_name | 広告グループ名 |
| creativeid | te_ads_object.ad_id | 広告クリエイティブID |
| creativename | te_ads_object.ad_name | 広告クリエイティブ名 |
| exposure | te_ads_object.impressions | 露出数 |
| click | te_ads_object.clicks | クリック数 |
| action | te_ads_object.installs | コンバージョン数 |
| cost | te_ads_object.cost | ユーザー獲得コスト |