SKAdNetwork 用 Reporting API

Vungle Agent

2022年10月16日 21:55

この新しい API メソッドを使用すると、広告主は Vungle API を呼び出して、Vungle がキャンペーンで受け取ったすべての Apple SKAdNetwork コンバージョンポストバックのレコードを取得できます。API は顧客へのレポート用であり、プラットフォーム内で集約されたレポートを作成するために MMP パートナーと共有することもできます。

キーポイント:

データの可用性: SKAdNetwork ポストバックデータは、Vungle サーバーが Apple から送信されたデータを受信するとすぐに利用可能になります。
SKAdNetwork キャンペーンマッピング: これらのリクエスト内のキャンペーン ID は SKAdNetwork キャンペーン ID です。Vungle キャンペーン ID にマップし、Vungle ダッシュボードと MMP ダッシュボードのレポートおよびパフォーマンスメトリックと連携させる必要があります。
ポストバックのパラメータ: 以下に詳しく説明する API 応答には、Apple によって定義および送信されたパラメータを含む SKAdNetwork ポストバックが含まれています。Vungle API は、これらのパラメータを受け取ったときに変更を行わずに渡します。

SKAdNetwork 用レポートメソッド

エンドポイント

https://postbacks.api.vungle.com/v1/sk-ad-network/installs

リクエスト例

すべてのリクエストパラメータが必要です。

curl --compressed -H 'Accept-Encoding: deflate, gzip' -H 'Accept: application/json' -H 'Authorization: Bearer a_valid_api_token' 'https://postbacks.api.vungle.com/v1/sk-ad-network/installs?start=2020-08-23&end=2020-08-23&app_id=525463029'

応答形式の例

[
  {
    "version": "2",
    "transaction-id": "4e4b0c3f-9479-455d-9bec-4bcdd10002ba",
    "app-id": 525463029,
    "campaign-id": 44,
    "ad-network-id": "com.example",
    "source-app-id": 1234567891,
    "redownload": true,
    "conversion-value": 20,
    "attribution-signature": "MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",
    "vungle_app_id": "5727cbb4630ae51d400000cf",
    "vungle_campaign_id": "5c6e163797dc95000149cffb",
    "vungle_creative_id": "5c6e1637f2f3de0001a8212f"
  },
  // ...
]

応答パラメータの定義

パラメータ名	形式	定義
`version`	整数	ポストバックを生成する SKAdNetwork バージョンを示します。「2」になります。
`transaction-id`	文字列	検証の一意の値。インストール検証メッセージの重複排除に使用します。
`app-id`	文字列	インストールされたアプリのアプリストア ID。
`campaign-id`	文字列	Vungle キャンペーン ID にマップする SKAdNetwork キャンペーン ID (0-100)。
`ad-network-id`	文字列	Vungle の SKAdNetwork 広告ネットワーク ID。
`source-app-id`	文字列	インストールを促す広告が表示されたアプリのアプリストア ID。Apple のプライバシー基準に従います。
`redownload`	ブール値	ブール値インジケーターは、ダウンロードがユーザーの Apple ID を使用して以前ダウンロードされたアプリであるかどうかを示します。true または false。true = 再ダウンロード。
`conversion-value`	文字列	文字列は、Apple に送信される、広告主が設定したインストール後のコンバージョンイベント値を表します。
`attribution-signature`	文字列	検証用の Apple のアトリビューション署名です。

フィルタ

応答データは、次のパラメータでフィルタ処理できます。

app_id
start (必須)
end (必須)

構文については、上記のリクエスト例を参照してください。

以下も参照してください。

広告主用 Reporting API に関するドキュメント
SKAdNetwork ポストバック用の Apple 開発者に関するドキュメント

SKAdNetwork 用レポート メソッド