情報フロー広告 API (メディアチャネル「広告変換」データ返送 API、ドッキング要件をどのように記述しますか?)

メディアチャネルの「広告コンバージョン」データフィードバック API の接続要件をどのように記述すればよいですか?

強力な収益化機能を備えた製品（金融、ゲーム、電子商取引など）は、必然的にさまざまなメディアチャネル（Kuaishou、Toutiao、Douyin など）に広告を掲載します。ユーザーが広告をクリックしてからダウンロード、登録、ログイン、支払いなどを行うまでの一連の主要な行動のコンバージョンに関するデータ統計は、一方では広告料に関連し、他方では広告の効果を分析し、タイムリーに戦略を調整してコストを削減し、コンバージョン率を高めるためにも使用できます。

しかし、メディアが持っているのは広告をクリックしたユーザーに関するデータのみであり、広告主が持っているのは自社製品に関連するコンバージョンデータのみです。ファネル全体の統計分析を実行するには、両側からのデータを統合する必要があります。その結果、多くの広告プラットフォームが登場しました（Fengchao、Guangdiantong、Duocai Interactiveなど）。広告主の商業製品マネージャーのエントリーレベルの需要計画タスクは、広告プラットフォームの標準インターフェースに接続し、コンバージョンデータを正確に報告することです。

メディアと広告主は単一のアカウントシステムを共有していないため、ユーザーが生成したデータを両端でどのように一致させるかが非常に重要であることに留意することが重要です。

まず、携帯電話番号は最も正確な一致フィールドです。メディアアカウントと広告主アカウントが同じ携帯電話番号にバインドされている場合、同じユーザーであると判断でき、統一された方法でデータを収集できます。
ただし、すべてのメディアチャネルでユーザーの登録とログインが必要なわけではありません。訪問者の中には、コンバージョンを生み出すために広告をクリックする人もいます。このとき、Android の IMEI デバイス番号と Apple の IDFA デバイス番号が役立ちます。アカウントを登録していない場合でも、携帯電話のデバイス番号は変更されません。メディアと広告主が収集した行動データに対応するデバイス番号が一致していれば、双方のデータを一致させることもできます。
しかし、これでは問題が100%解決されるわけではありません。一部のユーザーはクライアントにデバイス番号の取得を許可していないため、IMEI と IDFA をまったく取得できません。ただし、携帯電話の MAC ネットワークカードアドレス、Android の Android ID、IP アドレスなど、ユーザー ID の照合に使用できるフィールドもあります。一般的に、IMEI と IDFA の収集率が最も高く、他の照合方法を代替または補足として使用できます。 (実際、メディアは IMEI と IDFA 以外のフィールドを収集しない可能性があり、広告プラットフォームインターフェースはそれらを提供しない可能性があります。)

（Kuaishouの広告プラットフォームに接続する金融商品を例に挙げます）

**** と *** は、Kuaishou 情報フローにおける変換データの統計分析が不足しており、変換量とコストの最適化の余地があります。

以下の表に示すように、履歴データから、コンバージョンデータフィードバック API に接続すると明らかな利点があることがわかります。

また、要件を満たすための前提条件として、基準を満たすデバイス数取得率が必要となります。調査の結果、要件は満たされました:

KuaishouのIMEIとIDFAの取得率は約95%です。
APPクライアントの最適化は5月7日に開始され、V*.*.*バージョン（****）のIMEI取得率は91.53％、V*.*.*バージョン（***）のIMEI取得率は91.21％となり、予想要件を満たしました。
**** と *** の IDFA キャプチャ率は 98% を超えています。

下表の通り、コンバージョンデータフィードバックAPIに接続することで、快手における****と***の情報フロー配信の規模が拡大し、コストが削減されました。

Kuaishou ユーザーは、Kuaishou クライアントによって表示される広告をクリックします。
Kuaishou クライアントは、広告プラットフォーム (広告主自身が開発するか、サードパーティの監視プラットフォームによってホストされる) に設定された監視リンクを要求し、マクロ置換を通じてクリックデータの詳細を広告主またはサードパーティの監視プラットフォームにリアルタイムで同期します (詳細については、インターフェイス 1 を参照)。
広告主またはサードパーティのモニタリングプラットフォームは、Kuaishouインターフェースから報告されたクリックリクエストを受信すると、リクエストパラメータにユーザー情報（ユーザーのIDFA-MD5、IMEI-MD5など）とコールバック情報を記録し、関連するコンバージョンを生成したユーザーからKuaishouプロモーションチャネルによってもたらされたユーザーとそのコンバージョンデータを照合します。
広告主またはサードパーティの監視プラットフォームは、対応するコールバックを要求することにより、一致したコンバージョンデータを Kuaishou 効果統計サーバーに通知します (詳細については、インターフェイス 2 を参照)。
Kuaishouのパフォーマンス統計サーバーは、受信したコンバージョン情報を広告クリックデータと照合し、配信プラットフォームレポートで対応する広告プラン-広告グループ-広告クリエイティブのコンバージョンデータを公開します。

1.4.1 広告主

今回、****と***の2つの製品は、同じプロセスと要件でKuaishou APIに接続されており、Kuaishouメディアチャネルに情報フロー広告を掲載する「広告主」と総称されます。

1.4.2 新規登録

このユーザーの携帯電話番号の登録は最初の登録となります。同じ携帯電話番号でも、**** と *** は独立して区切られており、つまり、同じ携帯電話番号をそれぞれ **** と *** に 1 回ずつ登録できます。

1.4.3 広告クリック

Kuaishou ユーザーが広告のインタラクティブ領域をクリックすると、クリックイベントがトリガーされ、有効な広告クリックとみなされます。指定のランディングページに入った後、内部の関連リンクをクリックしてもクリック数としてカウントされません。

1.4.4 変換番号

Kuaishou バックエンドレポートに表示されるコンバージョンデータは、Kuaishou サーバーがコールバック要求を受信した時間に基づいており、その大きさは顧客から報告された実際の要求数に基づいています。

広告主である****と***は、Kuaishou APIに接続する際に、クリックしたユーザーのデバイス番号関連情報の記録、新規登録ユーザーの判別、登録ユーザーのデバイス番号関連情報の取得、デバイス番号の照合、登録ユーザーのデバイス番号関連情報の送信という5つの手順を実行します。

クリックしたユーザーのデバイス番号情報の記録は、他の 4 つのリンクに対して非同期かつプリエンプティブに行われることに注意してください。

2.2.1 クリッカーのデバイス番号を記録する

1. Kuaishou クライアントはクリック監視 URL（Kuaishou 広告プラットフォームで広告主が事前に設定）を要求し、インターフェイス 1 を介してユーザーのクリックデータの詳細を広告主のサーバーにリアルタイムで同期します。

2. 広告主のサーバーは、Kuaishou インターフェースから報告されたクリックリクエストを受信すると、ユーザーの IDFA-MD5 または IMEI-MD5、ユーザーがクリックした広告の AID、CID、DID、DNAME、ユーザーが広告をクリックした時間 TS、コールバック情報などのユーザー情報をリクエストパラメータに記録します。（パラメータの説明は次の表に示されています）

ユーザーのすべてのクリック動作が報告され、パラメータ情報が完全に記録される必要があることに注意してください。

で：

www.example.comは、広告主がクリックレポートデータを受信するアドレスであり、サーバーから提供される必要があります。
channel=kuaishou は、広告主がチャネルを区別するためにカスタマイズしたパラメータ情報です。 Kuaishou が報告した場合は、変更せずにそのまま返されます。
パラメータ名 channel/aid/cid/did/dname/ts/idfaMD5/imeiMD5/callback は参照用です。最終的なパラメータ名はサーバーによって設定できます。
__CALLBACK__ は必須パラメータです。報告時に、Kuaishou クライアントはそれを http 形式のアドレス (1 回エンコード) に置き換えます。報告されたデータを受け取った後、広告主はアドレスを保存する必要があります。ユーザーがアプリ内で登録を完了すると、変換データを報告するためのアドレスを要求します（対応するパラメータを結合する必要があります）。

4. 応答要件: 応答方法は JSON データ形式、HTTP 標準ステータスコードであり、応答内容に要件はありません。

2.2.2 新規登録ユーザーの判断

ユーザーが初めて APP にログインすると、広告主のサーバーはユーザーが新規登録ユーザーかどうかを判断します。ユーザーが新規登録ユーザーでない場合、プロセスは終了します。
ユーザーが新規登録された場合、広告主サーバーはユーザーのインストール元の登録チャネル番号を取得します。取得した登録チャネル番号がKuaishouチャネル番号でない場合（****と***のKuaishouチャネル番号の詳細については、添付ファイル「Kuaishouと**チャネル番号」を参照してください）、プロセスは終了します。
取得した登録チャンネル番号がKuaishouチャンネル番号である場合、プロセスは次のステップ2.2.3に進みます。

2.2.3 登録ユーザーのデバイス番号に関する情報の取得

広告主のサーバーによる判断後、Kuaishou情報フローチャネルを通じてAPPをダウンロードし、新規登録したユーザーは審査に合格します。

これらのユーザーについては、MD5 で暗号化されたデバイス ID とユーザー登録時刻情報を取得します。取得に失敗した場合、プロセスは終了します。取得が成功した場合、プロセスは次のステップ 2.2.4 に進みます。

で：

Android IMEIデュアルSIM電話には2つのIMEIがある場合があり、デフォルトのものを使用します
iOSのidfa計算MD5は、32桁の16進数+4つのコネクタ「-」の元のテキスト（例：32ED3EE5-9968-4F25-A015-DE3CFF569568）を使用し、MD5を計算して大文字に変換します。
ユーザー登録時間は13桁のミリ秒のタイムスタンプである必要があります

2.2.4 デバイス番号のマッチング

取得した登録ユーザーの MD5 暗号化デバイス番号を、2.2.1 で記録したクリックユーザーの MD5 暗号化デバイス番号と照合します。具体的な一致ルールは、登録ユーザーの MD5 暗号化デバイス番号がクリックしたユーザーの MD5 暗号化デバイス番号のリストに存在し、最新のクリックが登録前の 7 日以内 (日数は設定可能) に発生した場合、一致は成功したと見なされ、それ以外の場合は不成功と見なされます。

一致が失敗した場合、プロセスは終了します。一致が成功した場合は、次のステップ 2.2.5 に進みます。

2.2.5 登録ユーザーのデバイス番号に関する情報の送信

1. 送信アドレス: __CALLBACK__ の後の http アドレスは、登録前の 7 日以内に広告主がインターフェイス 1 を通じて受信した最後のクリック動作に置き換えられます (対応するパラメータを結合する必要があります)。

2. 結合する必要があるパラメータ:

event_type、イベントタイプ、パラメータ値2が返される、これはコンバージョンイベントが登録イベントであることを意味する
event_time、イベント時間、13 桁のミリ秒のタイムスタンプ (リクエストに event_type パラメータが含まれている場合は、event_time パラメータも含まれている必要があります。含まれていない場合はエラーが報告されます)
callback、インターフェース 1 で受信した __CALLBACK__ を置き換えた後の http アドレス内のコールバックパラメータ (以下の例の赤い部分を参照)

3. コールバック要求 URL (インターフェース 1 の __CALLBACK__ に対応する値、リンクアドレスがデコードされ、関連するパラメータと連結されます) (「callback=」の後のフィールドの文字は毎回異なります)

4. 応答内容: コールバック後、応答内の result=1 は、コールバック要求が正常に報告されたことを示します。

インターフェース 2 の応答が異常な場合、広告主は同じアプリ内コンバージョンデータを最大 3 回までレポートできます。それでも送信に失敗した場合は、送信は中止され、異常ログが記録されます。

広告主は即時戦略を使用して、アプリ内コンバージョンデータを Kuaishou 広告プラットフォームに報告します。同じアプリ内コンバージョンデータが 3 回連続して送信されなかった場合、関係者に SMS または電子メールのアラームが送信されます。アラームは1日に最大1回送信できます。具体的な送信リストは次のとおりです。

登録された変換ユーザデバイス番号の関連情報の送信および応答データを記録する必要があります。具体的な必須フィールドは次のとおりです。

Ø チャネル: チャネル

Ø aid: 広告グループ ID Ø cid: 広告クリエイティブ ID

Ø 実行: 広告プランID

Ø dname: 広告プラン名

Ø dt: 広告クリックイベントのUTCタイムスタンプ

Ø idfaMD5: iOS での idfa 計算 MD5

Ø imeiMD5: 15桁のIMEIに対してMD5を実行する

Ø event_type: コンバージョンイベントの種類

Ø event_time: コンバージョンイベントの時間

Ø sendNumber: メッセージが送信された回数（1〜3）

Ø sendTime: 送信時間