サーバーポストバックがAPIを使用してアトリビューションデータを伝送する仕組み

opoinstall
2026-11-16
5 min read

APIとは何ですか?また、MMPとアドネットワークをどのように接続しますか? アプリケーションプログラミングインターフェイス(API)は、モバイル計測パートナー(MMP)が標準化されたHTTPサーバー間(S2S)リクエストを介して、計測されたコンバージョンポストバックをアドネットワークへセキュアに送信できるようにする定義済みのソフトウェアインターフェイスです。

アプリケーションプログラミングインターフェイス(API)は、ソフトウェアコンポーネント間でデータを交換したり機能の実行をリクエストしたりするための定義済みインターフェイスです。モバイルアトリビューションにおいて、HTTPベースのAPIにより、独立したモバイル計測パートナー(MMP)が自動化されたサーバー間(S2S)ポストバックを介して、検証済みのコンバージョンシグナルをアドネットワークのエンドポイントへ直接送信できるようになり、クローズドループのキャンペーン計測やアルゴリズムによる予算最適化をサポートします。

用語 定義 関連エンティティ 検索意図の役割
APIの定義 プログラムによる通信のためのインターフェイス契約およびデータモデルの正式な仕様。 RESTfulウェブサービス 情報提供 / 技術的
サーバーポストバック アトリビューションデータやコンバージョンデータを配信する、イベント駆動型のサーバー間HTTPリクエスト。 ウェブホックコールバック 技術的 / 情報提供
モバイル計測パートナー タッチポイントの重複排除を行い、コンバージョンクレジットを算出する独立したアトリビューションプロバイダー。 アトリビューションエンジン 商業的 / 情報提供

モバイルマーケティングにおけるAPIの基本定義の理解

用語の分解:ユニバーサルなソフトウェアコネクターとしてのアプリケーションプログラミングインターフェイス

アプリケーションプログラミングインターフェイス(API)は、独立したソフトウェアプラットフォーム間のアーキテクチャ上の契約として機能します。異なるシステム同士がそれぞれの内部データベース設計やメモリ構造を相互に理解する必要性を取り除く代わりに、APIはソフトウェアコンポーネント間で情報を交換するためのメソッド、データモデル、および相互作用のルールを定義します。

モバイル広告において、プラットフォームは異種混合の環境で動作します。広告プラットフォーム(プログラマティックなデマンドサイドプラットフォームやアドネットワークなど)は、主に自社のパブリッシャーインベントリ内で配信されたインプレッションやクリックを把握できます。モバイルアプリケーションは独立したオペレーティングシステムのサンドボックス(iOSおよびAndroid)内で実行され、モバイル計測パートナー(MMP)は中央集権的なデータ集約クラスターを運用しています。

APIは、これらすべてのレイヤーを結ぶ共通の通信基盤として機能します。クライアント開発では、APIはアプリケーションが直接呼び出すローカルメソッドシグネチャを公開します。クラウド環境全体では、HTTPセマンティクスを利用するウェブAPIなどのネットワークベースのAPIにより、独立したクラウドバックエンドがイベントレコードをプログラムによって送信できるようになります。

サーバー間ポストバックがクライアントサイドレポートへの依存を軽減する仕組み

従来、モバイルウェブ広告はクライアント側のトラッキングピクセルや複数ホップのHTTP 302リダイレクトチェーンに大きく依存していました。ユーザーが広告をタップすると、モバイルブラウザは宛先のストアに到達する前にトラッキングサーバーを介して連続的なリダイレクトを実行していました。

このレガシーアプローチには運用上の脆弱性がありました:

  • 累積的な遅延と離脱:連続するHTTPリダイレクトはネットワークの往復回数(DNS解決、TLSハンドシェイク、およびモバイル回線の遅延)を増加させ、アプリストアに到達する前にユーザーが離脱する割合を高めます。
  • クッキーの制限とサンドボックスの隔離:現代のモバイルブラウザは、厳格なサードパーティクッキーの制限やインテリジェント・トラッキング・プリベンション(ITP)ポリシーを施行し、リダイレクトナビゲーション中のステートフルな識別子クッキーを除去します。
  • 広告ブロックによる傍受:ウェブビューやモバイルブラウザ内で実行されるクライアント側のトラッキングピクセルは、ブラウザレベルのトラッキング保護やネットワークフィルタリングルールの影響を受けやすくなります。
  • 不安定なモバイル接続:基地局間のハンドオーバーや、クライアント側のリダイレクトチェーン中のわずかな接続の途切れにより、配信が完了する前にトラッキングリクエストが中断される可能性があります。

直接的なサーバー間(S2S)ポストバックは、レポートフェーズにおけるこれらの制限に対処します。キャンペーンパラメータをキャプチャしてユーザーをストアに誘導するための初期のクリックフェーズでは引き続きトラッキングリンクが利用されますが、コンバージョンイベントのレポートはクライアントデバイスからクラウドのバックエンドへ移行されます。専用のネットワーク接続を介してサーバークラスター間でアトリビューションデータを直接送信することにより、S2Sポストバックはコンバージョンレポートにおけるクライアント側のブラウザ実行への依存を軽減します。

技術的境界:アプリ内クライアントSDKとインジェスト/エグレスWeb APIの区別

アトリビューションデータのアーキテクチャは、クライアント側の計装とクラウドデータのルーティングを分離しています:

  • クライアントサイドモバイルSDK:アプリケーションバイナリに埋め込まれ、iOSやAndroidのSDKなどのライブラリがネイティブオペレーティングシステムのライフサイクルと連携します。ローカルのインストールシグナルのキャプチャ、コールドスタートイベントのリスニング、着信した起動インテントの解析、およびアトリビューションバックエンドへのセッションテレメトリの送信を行います。
  • インジェストWeb API:アトリビューションプロバイダーによってホストされ、これらのHTTPエンドポイントが生のインタラクションシグナルを受信します。ウェブブラウザからのトラッキングリンククリックの着信をログに記録し、モバイルクライアントSDKからHTTPS経由でディスパッチされたイベントキューを受け入れます。
  • エグレスS2S Web API(ポストバック):アトリビューションプラットフォームがHTTPクライアントとして機能し、検証済みのコンバージョンシグナルを参加アドネットワーク、デマンドサイドプラットフォーム(DSP)、およびカスタマーデータプラットフォーム(CDP)のインジェストAPIへプログラムによって配信する、クラウド間のインターフェイスです。

サーバー間ポストバックアーキテクチャの機能

ウェブホックコールバックの仕組み:クラウド境界を越えたイベント駆動型のHTTPリクエスト

サーバーポストバックは、アーキテクチャ上、イベント駆動型のウェブホックコールバックとして機能します。アドネットワーク側がインストールが発生したかどうかを繰り返しクエリで計測プラットフォームに継続的にポーリング要求するのではなく、アトリビューションエンジンがプロアクティブなイベント駆動型のHTTPディスパッチを実行します。

下流のコンバージョンイベントが確認され、特定のアドキャンペーンにアトリビューションされると、アトリビューションプラットフォームは構造化されたコンバージョンパラメータを含むアウトバウンドHTTPリクエスト(パートナーのAPI仕様に応じてPOSTまたはGETで送信)を構築します。このリクエストは、安全なTLS接続を介してパブリックインターネット経由で、アドネットワークによってホストされている事前設定済みの受信エンドポイントへ送信されます。

トポロジー:パブリッシャーとアドネットワーク間に位置するモバイル計測パートナー

モバイルマーケティングにおいて、計測パートナーは独立したデータの仲介役として機能します。個々のアドネットワークは自社のパブリッシャープロパティ内で配信されたインプレッションやクリックのみを把握でき、競合のトラフィックや下流のアプリ継続率を把握することはできません。

計測パートナーはすべてのメディアパートナーにわたるクリックシグナルを取り込み、決定的または確率的なロジックを使用してコンバージョンをアトリビューションし、勝者となったアドネットワークへアウトバウンドのS2Sポストバックを発信します。勝者とならなかったネットワークには、合意されたプライバシー制約やキャンペーン構成に応じて、セカンダリのポストバック(非アトリビューションのコンバージョン通知など)が送信される場合があります。

ペイロード配信プロトコル:セキュアなTLSチャネル上の標準HTTPメソッドの利用

ポストバックの送信は、確立されたインターネットプロトコル仕様(IETF RFC 9110 HTTPセマンティクス)に準拠しています。歴史的なシステムではURLエンコードされたクエリ文字列を持つHTTP GETリクエストが頻繁に使用されていましたが、現代の本番アーキテクチャでは、構造化されたJSONペイロードを送信するHTTP POSTリクエストがますます利用されています:

  • トランスポートセキュリティ:本番のポストバックエンドポイントは、通信する双方がサポートする近代的なTLS構成(TLS 1.2やTLS 1.3など)を使用してHTTPSを強制し、受信パートナーのトランスポートセキュリティ要件に準拠する必要があります。
  • HTTPリクエスト動詞:POSTリクエストはリクエストボディ内に構造化されたコンテキストペイロードを運ぶため、レガシーなGETクエリ文字列に関連するURLの長さ制限を回避できます。GETリクエストは、パラメータがクエリ文字列マクロとして付加されるレガシーなアドネットワークのエンドポイント全体で広くサポートされ続けています。
  • 標準化されたヘッダー属性:ポストバックリクエストには、Content-Type: application/jsonやapplication/x-www-form-urlencodedなどの標準メタデータヘッダーや、送信者検証のための承認トークンが含まれます。

アトリビューションプラットフォームによるプログラム的なS2Sポストバックワークフローのオーケストレーション

代表的なMMPアトリビューションアーキテクチャは、着信したコンバージョンイベントを対象となるエンゲージメントレコードと照合し、アトリビューションおよび重複排除ルールを適用し、許可されたイベントフィールドを構成済みのパートナー固有のペイロードにマッピングします。インストールまたはアプリ内購入が解決されると、ポストバックディスパッチャはアトリビューション結果を構成済みのパートナーのスキーマと照合し、外部のパートナーAPIにデータを配信します。

実際の配信遅延と内部キューアーキテクチャは、プロバイダー、プラットフォームの負荷、およびネットワークの状態によって異なります。

次のアーキテクチャ図は、最初の広告エンゲージメントから下流のS2Sポストバックのディスパッチまでのエンドツーエンドのデータパイプラインを示しています:

MMPインフラストラクチャはモバイルコンバージョンイベントを処理し、アドネットワークにサーバーポストバックを送信します。

[Ad Network / DSP] ──(1. Ad Click with Click ID)──> [Tracking URL] ──(Redirect)──> [App Store / Google Play]
                                                           │                                    │
                                              (Click Ingestion)                                 ▼
                                                           ▼                             [Installed App]
[Ad Network Endpoint] <──(4. S2S Postback)── [MMP Attribution Engine] <──(3. SDK Telemetry)───────┘
                                                   │
                                        (Deduplication & Matching)

アトリビューションAPIコールの時系列ライフサイクル

フェーズ1:動的トラッキングURLとクエリ文字列によるインジェストコンテキストのキャプチャ

ポストバックのライフサイクルは、エンドユーザーが外部アプリケーションまたはモバイルウェブサイト内に表示された広告をタップしたときに始まります。アドネットワークは、アトリビューションプラットフォームのインジェストクラスターを指す動的なトラッキングリンクを提供します。

このインタラクション中、アドネットワークの広告サーバーはキャンペーンパラメータをトラッキングURLのクエリ文字列に動的に挿入します:

  • click_id:アドネットワークによって生成された一意のトランザクション・トークン(例:click_id=9876543210_abc)。
  • campaign_id:マーケティングキャンペーン構造を示す内部識別子。
  • publisher_id / site_id:広告を表示した特定のアプリやウェブサイトのプレースメントを示す識別子。

アトリビューションサーバーはこのHTTPリクエストを取り込み、クエリパラメータをイベントストアに記録し、タイムスタンプを添付して、ユーザーのブラウザを指定の宛先(Apple App StoreやGoogle Playストアなど)にリダイレクトします。

フェーズ2:クライアントSDKイベントテレメトリとサーバーサイドのアトリビューション照合

インストール後、ユーザーはモバイルアプリケーションを開きます。組み込まれたモバイルクライアントSDKが初期化され、最初のセッションテレメトリをJSONイベントペイロードにパッケージ化し、HTTPS経由でアトリビューションプラットフォームのインジェストクラスターへ送信します。

アトリビューションエンジンは着信したモバイルアクティベーションパラメータを抽出し、データベースをクエリして、アクティブなアトリビューション・ルックバック・ウィンドウ内に記録された先行するタッチポイントを特定します。アトリビューションアルゴリズムはタッチポイントのタイムスタンプを評価し、クリックの整合性を検証し、条件を満たす広告タッチポイントにコンバージョンクレジットを割り当てます。

フェーズ3:下流のコンバージョンポストバックペイロードのフォーマットと組み立て

アトリビューションが解決されると、ポストバック生成ワーカーは、勝利したアドネットワークに必要な特定のデータスキーマに従ってペイロードをフォーマットします:

  • 下流の配信における重複排除を容易にするため、一意で安定したevent_idがポストバックレコードに割り当てられます。
  • 元のclick_idが最初のタッチポイントレコードから取得され、ペイロードにマッピングされて、アドネットワークがインストールとクリックを照合できるようになります。
  • タイムスタンプは標準化されたISO 8601文字列(例:2026-11-16T07:56:00Z)に正規化されます。
  • 通貨コードや購入金額などのアプリ内イベントのメタデータは、宛先のタイプに合わせてフォーマットされます。

フェーズ4:HTTPS送信の実行とサーバーレスポンスヘッダーの評価

アトリビューションエンジンは、宛先のアドネットワークのインジェストAPIエンドポイントへのアウトバウンドHTTPS接続を確立し、ペイロードを送信します。

ディスパッチ時に、ワーカーは宛先サーバーによって返されたHTTPレスポンスステータスコードを監視し、配信が成功したか、またはリトライのスケジュールが必要かを判断します:

HTTPステータス 一般的な意味 推奨されるアクション
200 OK リクエスト成功。 パートナー固有の確認およびレスポンスボディを評価する。
201 Created リソース作成完了。 パートナーのAPI契約の下で配信を確認する。
202 Accepted 処理のために受け付けられました。処理は未完了です。 受け付けを記録し、パートナーの完了ポリシーに従う。
204 No Content レスポンスコンテンツなしでリクエスト成功。 パートナーの契約に従って配信を確認する。
400 / 422 無効なリクエストまたは処理不能なコンテンツ。 リトライする前にペイロードとスキーマを確認する。自動的にループさせない。
401 / 403 認証または承認の問題。 資格情報または権限の問題を解決する。
429 レート制限を超過しました。 パートナーのリトライポリシーに従い、提供されている場合はRetry-Afterヘッダーを遵守する。
500 / 502 / 503 / 504 サーバーまたはゲートウェイのエラー。 配信契約の下で許可されており安全な場合にのみリトライする。

HTTPの200または202レスポンスは、宛先サーバーでのトランスポートの受信を確認するものであり、アドネットワークの下流機械学習システムがアトリビューションの照合やキャンペーンの最適化を完了したことを保証するものではありません。

コンバージョンポストバックペイロードにおけるデータスキーマと主要フィールド

本番アトリビューションポストバックリクエストの構造の内訳

本番のポストバックペイロードは、標準化されたJSON構造スキーマまたはURLパラメータマッピングに従います。すべてのペイロードは、最初の広告エンゲージメントコンテキストを下流のユーザーコンバージョンアクションに結び付けます。

開発者は、包括的なエンドポイント構成ガイドライン、パラメータ辞書、および生データのエクスポート仕様について、OpoInstallドキュメントセンターを参照できます。

スキーマ境界に関する注記:以下のJSONスキーマは、代表的なアプリケーション定義のコンバージョンポストバックペイロードを示しています。これは公式のOpoInstallまたはアドネットワークのAPI仕様ではありません。必須フィールド、データ型、および認証要件は受信パートナーによって異なります。

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "IllustrativeConversionPostback",
  "type": "object",
  "required": [
    "event_id",
    "event_name",
    "event_timestamp"
  ],
  "properties": {
    "event_id": {
      "type": "string",
      "minLength": 1,
      "description": "Idempotentな重複排除のために受信システムで使用される、一意のトランザクションイベント識別子。"
    },
    "click_id": {
      "type": ["string", "null"],
      "description": "アドネットワークに返される一意のトランザクションクリック識別子。オーガニックまたはビュースルーイベントの場合はnull可能です。"
    },
    "campaign_id": {
      "type": ["string", "null"],
      "description": "初期クリックインジェスト時に提供されたマーケティングキャンペーン識別子。"
    },
    "event_name": {
      "type": "string",
      "minLength": 1,
      "description": "アトリビューションされるコンバージョンイベントのカテゴリ(例:インストール、登録、購入)。"
    },
    "event_timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "イベントが発生した日時を示すISO 8601タイムスタンプ。厳密なUTC強制はスキーマバリデータの構成に依存することに注意してください。"
    },
    "conversion_value": {
      "type": "number",
      "description": "イベントに関連付けられた金銭的価値(例:チェックアウトの収益)。"
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "ISO 4217構文に準拠する3文字の通貨形式。"
    },
    "attribution_provider": {
      "type": "string",
      "description": "ポストバックを生成する計測パートナーの指定。"
    }
  },
  "dependentRequired": {
    "conversion_value": ["currency"]
  }
}

代表的なHTTPリクエストとレスポンスのワイヤーアーティファクト

次の例示的なHTTPリクエストとレスポンスの相互作用は、イベント駆動型ポストバックのワイヤーレベルでの送信を示しています。

プロトコルに関する注記:これらは簡略化されたHTTPリクエストおよびレスポンスの例です。メッセージフレーミングヘッダー(Content-Lengthなど)は可読性のために省略されており、通常はHTTPクライアントおよびサーバーのランタイムによって生成されます。

POST /v1/conversions HTTP/1.1
Host: partner-adnetwork.example.com
Content-Type: application/json
Authorization: Bearer <example_token>
User-Agent: Attribution-Postback-Dispatcher/2.0

{
  "event_id": "evt_9876543210_abc",
  "click_id": "click_123456789_xyz",
  "campaign_id": "cmp_spring_sale",
  "event_name": "purchase",
  "event_timestamp": "2026-11-16T07:56:00Z",
  "conversion_value": 29.99,
  "currency": "USD",
  "attribution_provider": "OpoInstall"
}
HTTP/1.1 202 Accepted
Content-Type: application/json
Date: Mon, 16 Nov 2026 07:56:01 GMT

{
  "event_id": "evt_9876543210_abc",
  "status": "accepted",
  "message": "Conversion event queued for downstream attribution"
}

主要なフィールドエンティティのマッピング:クリック識別子、イベント識別子、およびコンバージョン値

ポストバックペイロード内のすべてのフィールドは、それぞれの分析的役割を果たします:

  • event_id:アトリビューションシステムによって生成される、安定した一意のイベント識別子。単一のクリックに起因するすべてのコンバージョン間で同一であるclick_idとは異なり、event_idは各個別のインストール、登録、または購入イベントを明確に識別し、受信側のアドネットワークが配信の重複排除を実行できるようにします。
  • click_id:条件を満たす下流のコンバージョンと元の広告クリックレコードを結びつける主要なステートレスブリッジ。クリック課金型アトリビューションでは標準ですが、オーガニックコンバージョン、ビュースルーアトリビューション、またはプライバシー保護された集約ポストバックでは、click_idがnullであるか存在しない場合があります。
  • event_timestamp:正確な時間的順序を確立し、アドネットワークがコンバージョンのタイミングを計算してキャンペーンのアトリビューションモデルを最適化できるようにします。
  • conversion_valueとcurrency:アプリ内アクションによって生成された収益を伝え、高LTVユーザーセグメントのプログラム入札を調整するValue-Based Bidding(VBB)アルゴリズムにデータを供給します。

複数のメディアバイイングネットワークにまたがるデータスキーマの不一致の管理

コンバージョンポストバックフィールドは、内部のアトリビューションイベントをパートナー固有のAPIペイロードにマッピングします。

異なる広告ネットワークは、それぞれ異なるパラメータ命名規則を課しています。あるネットワークがキーclick_idの下でクリック識別子を期待する一方で、別のネットワークではclickid、sub_id、またはtx_idが要求される場合があります。

これらの不一致を解決するために、エンタープライズアトリビューションプラットフォームはモジュール式のマクロテンプレートシステムを維持しています。マーケティングチームは管理ダッシュボード内でポストバックテンプレートを構成し、カスタムバックエンドコードを書くことなく、内部計測トークン(例:{click_id})を各広告パートナーのAPIドキュメントで要求される正確なフィールド名にマッピングします。

リアルタイムAPI通信が広告入札アルゴリズムにとって重要な理由

機械学習フィードバックループへのデータ供給:レポート遅延がもたらす運用の影響

Google広告、Meta、TikTokなどのプラットフォームにおける現代の広告バイイングは、自動入札最適化アルゴリズム(目標コンバージョン単価や目標広告費用対効果など)に大きく依存しています。これらの入札エンジンは、オークションシグナルを動的に評価し、広告プレースメントのコンバージョン確率を計算します。

コンバージョンレポートの遅延は、自動入札システムで利用可能なフィードバックの鮮度を低下させる可能性があります:

  • 低遅延のフィードバック:コンバージョンポストバックがタイムリーに送信されると、入札エンジンはコンバージョンシグナルをより迅速に取り込み、コンバージョンにつながるパブリッシャーセグメントに対してより応答性の高い入札調整をサポートできます。
  • 遅延したフィードバック:バッチ処理キューでポストバックが停滞すると、入札モデルは古いデータに基づいて動作します。レポートの遅延により入札の更新にタイムラグが生じ、コンバージョンボリュームやモデルのケイデンスによっては、キャンペーンの最適化の応答性が低下する可能性があります。

プログラマティックキャンペーンにおけるコールドスタートのジレンマ

新しいモバイル広告キャンペーンを開始する際、プログラムによる最適化アルゴリズムは探索的な学習フェーズに入ります。この期間中、システムはコンバージョンする層を発見するために、幅広いパブリッシャーインベントリに広告費を分散させます。

コンバージョンレポートの遅延により、自動入札システムで利用可能なフィードバックの鮮度が低下する可能性があります。タイムリーな配信はより迅速な最適化をサポートしますが、学習期間やキャンペーンのパフォーマンスは、コンバージョンボリューム、ユーザーのコンバージョンサイクル、過去のデータ、アトリビューション設定、および広告プラットフォームの処理ケイデンスにも依存します。

アトリビューションパイプラインにおける遅延タイプの区別

配信タイミングを理解するには、ユーザージャーニー全体のさまざまな遅延の発生源を分解する必要があります:

遅延コンポーネント 運用の発生源 説明
コンバージョン遅延 ユーザーの行動 最初の広告クリックからユーザーがコンバージョンイベントを完了するまでに経過した時間。
アトリビューション処理遅延 MMPインフラストラクチャ SDKテレメトリを取り込み、重複排除を実行し、コンバージョンクレジットを割り当てるために必要な時間。
ポストバック配信レイテンシ ネットワークトランスポート HTTPS接続を確立し、パートナーのエンドポイントへHTTPリクエストをディスパッチするために必要な時間。
プライバシーによる遅延 OSのポリシー プライバシーフレームワークによって強制される、ランダム化された必須のレポート遅延。
パートナー処理遅延 アドネットワークインフラストラクチャ アドネットワークがポストバックを取り込み、検証し、入札モデルに組み込むために必要な時間。

タイムリーなコンバージョンポストバックはフィードバックの鮮度を向上させますが、プラットフォームのプライバシー遅延は独立したままです。

プライバシー保護型のアトリビューションフレームワークでは、ランダム化されたレポート遅延が課される場合があります。たとえば、Apple AdAttributionKitは、最初のインストールポストバックに24〜48時間のランダムな遅延を適用し、適用されるコンバージョンウィンドウが終了またはロックされた後の後続の対象ポストバックには24〜144時間の遅延を適用します。これらのプライバシーに起因する遅延はプラットフォームのOS仕様によって管理されており、サーバーサイドのネットワークインフラストラクチャを最適化しても削減することはできません。

ネットワークリトライと障害の処理:指数バックオフと冪等な重複排除

パブリッククラウドのネットワークリンクは、断続的なパケットロス、サーバーの再起動、およびルーティングのメンテナンスの影響を受けます。アトリビューションのバックエンドは、コンバージョンシグナルの損失を防ぐためにレジリエントなリトライアーキテクチャを維持しています:

  • ジッター付きのバインドされた指数バックオフ:アドネットワークのAPIエンドポイントがHTTP 503サービス利用不可、ネットワークタイムアウト、またはレート制限レスポンスを返した場合、ポストバックはバインドされたフルジッターモデルを使用してリトライのスケジュールが組まれます:

    d_n \sim U\left(0, \; \min(d_{\max}, \; d_0 \times 2^n)\right)

    ここで、d_0は初期のベース遅延を表し、d_{\max}はローカルのバックオフキャップを表し、ランダム化されたジッターは同期されたリトライウェーブが回復中のアドサーバーを圧倒するのを防ぎます。パートナーが指定したRetry-Afterレスポンスヘッダーは、ローカルのバックオフ計算よりも優先されます。

  • 配信リトライウィンドウ:リトライシステムは、プロバイダーのポリシーに従って定義されたリトライホライズンにわたって配信の試行を継続します。たとえば、Adjustは特定のエラー条件の下で24時間に最大6回のリトライを文書化しており、AppsFlyerはポストバックのリトライがアクティブなときに15分間隔で最大4回の追加リトライを文書化しています。すべてのリトライ試行が失敗した場合、イベントは診断確認のためにデッドレターキュー(DLQ)にルーティングされます。

  • 冪等性と重複排除レイヤー:アトリビューションの重複排除(MMPがコンバージョンを1回だけアトリビューションすることを保証する)と、配信の重複排除(アドネットワークがリトライされたHTTPリクエストを安全に処理することを保証する)の間で区別を維持する必要があります。リトライでは、同じ安定したイベント識別子(event_id)またはパートナーがサポートする冪等性キーを再利用する必要があります。受信APIが重複排除をサポートしている場合、繰り返し行われる配信の試行は同じ論理イベントとして認識されます。冪等ではないリクエストの自動リトライは、パートナーが文書化した配信契約に従う必要があります。

エンタープライズエグレスパイプ全体での高可用性とレート制限への準拠の確保

大容量のアトリビューションプラットフォームは、毎秒大量のアウトバウンドポストバックをディスパッチします。スロットリングメカニズムがなければ、このエグレスボリュームが受信側のアドネットワークのエンドポイントを圧倒し、HTTP 429 Too Many Requestsレスポンスを引き起こす可能性があります。

本番アトリビューションアーキテクチャには、エグレスゲートウェイにトークンバケットまたはリーキーバケットのレート制限アルゴリズムが組み込まれています。プラットフォームは、各アドネットワークAPIの公開されたレート制限に合わせてアウトバウンドリクエストの速度をキャップし、スロットリングされたときはパートナーが指定したRetry-Afterレスポンスヘッダーを遵守します。

信頼性の高いポストバック配信は、イベントキュー、レート制限、バインドされたリトライ、および重複排除を組み合わせたものです。

クライアントサイドSDKコールとサーバーポストバックの比較分析

運用上のトレードオフの評価:ネットワークオーバーヘッド、セキュリティ、プライバシー、およびデータの粒度

現代のモバイルマーケティングアーキテクチャを設計するには、各運用の目的に適した通信チャネルを選択する必要があります。クライアント側のトラッキングだけに依存すると肥大化したアプリケーションバイナリと脆弱なネットワーク依存関係が生じ、サーバーAPIだけに依存すると初期デバイス状態のキャプチャに複雑さが生じます。

以下の表は、クライアントサイドのSDK呼び出しとサーバー間(S2S)ポストバックAPIを、重要なアーキテクチャの側面で対比させています:

機能の側面 クライアントサイドSDKの呼び出し サーバー間(S2S)ポストバックAPI
実行環境 クライアントデバイスのOS(Android / iOS) 分散型クラウドサーバーインフラストラクチャ
通信プロトコル ローカルバイナリメソッド呼び出しと内部SDKキュー アウトバウンドHTTPSリクエスト(JSON POSTまたはURL GET)
ネットワーク遅延への影響 デバイスのセルラー/Wi-Fi接続に依存 高スループットのデータセンターネットワーク相互接続
改ざんに対する脆弱性 クライアント側の検査やリバースエンジニアリングの対象となる サーバーの承認トークンとネットワーク制御によって保護されている
主なアーキテクチャ上の役割 アプリ内ライフサイクルイベントとUIルーティングのキャプチャ アドネットワークやBIプラットフォームへのコンバージョンデータの送信

クライアント側のイベントトラッキングとバックエンドのポストバックパイプラインの統合を検討しているエンジニアリングチームは、ネイティブモバイルSDKライブラリと構成ドキュメントについてOpoInstall SDKダウンロードセンターにアクセスできます。

サーバー通信におけるプライバシーコンプライアンスとデータガバナンス

サーバー間配信はクラウドインフラストラクチャ間でデータを転送しますが、OSの同意フレームワーク(AppleのApp Tracking Transparencyなど)、地域のプライバシー規制、またはパートナーのデータ共有ポリシーをバイパスするわけではありません。ポストバックパイプラインを介して送信できるのは、適用されるユーザー同意状態の下で許可されたデータのみです。

アトリビューションシステムは、ポストバック生成前に適切なプライバシーフィルタリングを適用し、適用されるプラットフォームポリシー、法的要件、およびパートナーのデータ共有契約によって許可されたフィールドのみを送信する必要があります。

よくある質問(FAQ)

モバイルアトリビューションにおけるAPIとSDKの違いは何ですか?
SDK(ソフトウェア開発キット)は、デバイスのライフサイクルイベントを収集するためにモバイルアプリケーションに直接埋め込まれる、コンパイルされたコード、ライブラリ、およびドキュメントのインストール可能なパッケージです。API(アプリケーションプログラミングインターフェイス)は、クライアントSDKとアトリビューションバックエンドの間、またはアトリビューションバックエンドから外部のアドネットワークサーバーへのように、異なるプラットフォーム間でデータを送信するために使用されるインターフェイス契約およびエンドポイント定義のセットです。
アドネットワークは、着信するポストバックAPIリクエストの信頼性をどのように検証しますか?
受信するAPIに応じて、ポストバックリクエストは、事前共有されたベアラートークン、カスタム承認ヘッダー、相互TLS、または送信元IPのホワイトリスト登録によって認証される場合があります。一意のクリック識別子(<code>click_id</code>)は内部イベントの照合を支援しますが、送信者の身元を独自に認証するものではありません。
アドネットワークサーバーがアトリビューションポストバックの受信に失敗した場合はどうなりますか?
受信パートナーのAPI契約で許可されている場合、失敗したポストバックは、バインドされたバックオフポリシーと安定したイベント識別子を使用してリトライされる場合があります。構成されたリトライ制限を超えたイベントは、診断確認のためにデッドレターキューにルーティングされることがあります。

まとめと決定フレームワーク

サーバー間APIは、現代のモバイル広告の基礎的な通信バックボーンを形成し、生のクライアントサイドのインストールを広告ネットワーク向けの実用的なアトリビューションデータに変換します。クライアントブラウザやネイティブウェブビューからのレポート依存関係を排除することにより、プログラムによるS2Sポストバックは、コンバージョンシグナルが広告入札アルゴリズムに到達する一貫性を向上させます。

グローバルなプライバシー規制やOSのサンドボックスがクライアントサイドのトラッキング識別子の制限を続ける中、堅牢なサーバーサイドAPIの重要性は増していきます。標準化されたプライバシー準拠のサーバーポストバックパイプラインを構築するエンジニアリングおよびマーケティングチームは、信頼性の高い計測ループを確立し、回避可能なデータの不一致を削減し、獲得チャネル全体でのユーザー獲得キャンペーンの最適化をサポートできます。

自動化されたアトリビューションポストバックやキャンペーンのトラッキングリンクの構成を準備しているチームは、OpoInstall開発者コンソールでアカウントを作成するか、詳細なアーキテクチャガイドラインについてモバイルアトリビューション実装リファレンスを確認できます。

関連資料

Share this article