AppLovin Support

Conversion API

Conversion APIを使用して、ウェブサイトのコンバージョンイベントを送信します。 AppLovinは、広告主様がAppLovin Pixelと併せてConversion APIを使用することを推奨しています。 これにより、最適なキャンペーンパフォーマンスを達成できます。

リクエスト形式

Conversion APIに1つ以上のイベントを送信するには、https://b.applovin.com/v1/eventにHTTP POSTリクエストを送信します。

認証

ヘッダー名値
Authorizationお客様のConversion APIキー

Conversion APIの連携にはConversion APIキーが必要です。これはAds ManagerのKeysページで確認できます。該当ページに表示されない場合は、AppLovinの担当者にお問い合わせいただくか、サポートチケットをご起票ください。

クエリパラメータ

名前タイプ必須説明
pixel_idstringtrueAppLovinイベントキー

レスポンスコード

コード説明
200すべてのイベントが正常に処理されました。
400リクエストにエラーがあります。このイベントバッチは破棄されました。
401認証に失敗しました。

POSTペイロード

HTTPリクエストのPOSTペイロードは、送信する1つ以上のイベントを表します:

名前タイプ必須説明
eventsサーバーイベント[]true送信するイベントのリスト。すべてのイベントが有効である必要があります。無効なイベントが1つでもあると、バッチ全体が失敗します。最大バッチサイズは100です。

サーバーイベント

名前タイプ必須説明
dataイベントデータtrueこのイベントのデータ。イベントとオブジェクトページを参照して、各イベントで送信するデータを確認してください。
event_source_urlstringtrueイベントが発生した完全なURL(例:https://example.com/product?product_name=widget)
event_timenumbertrueミリ秒単位の現在のUnixエポック時間
namestringtrueこのイベントの名前。利用可能なイベントについては、イベントとオブジェクトのリファレンスを参照してください。
user_dataUser datatrue以下のUser dataの表を参照し、aleid、client_id、axwrt、alartなどのデータフィールドを指定してください。
measurement_partner_data計測データfalseイベントに対してAppLovinに付与される貢献度(クレジット)を示すための計測データ
dedupe_idstringfalseこのイベントの一意の識別子。AppLovinはこれを重複排除(デデュプリケーション)に使用します。同一 of pixelイベントとサーバー間(S2S)イベントは、同じdedupe_idを持つ必要があります。
注意:これは以下のaleidとは異なります。

イベントデータ

イベントとオブジェクトを参照して、各イベントのdataフィールドに入力する方法を確認してください。 このリンクに記載されているイベントに加えて、サポートされている追加のイベントを以下に示します。

任意のイベント

app_open イベント(モバイルアプリ連携のみ)

ユーザーがアプリを起動したときにこのイベントをトリガーします。 このイベントに渡すデータオブジェクトはありません。

User data

名前タイプ必須説明
alartstringtrue*ランディングページのURLまたは_axartクッキーからのalart値。
*詳細は以下のaleidとalart of 送信を参照してください。
aleidstringtrue*詳細は以下のaleidとalartの送信を参照してください。
*URLに存在する場合は必須(広告クリック後にAppLovinから送信されます)
axwrtstringtrue*AppLovin Pixelに設定されたaxwrt。
*詳細は以下のユーザー識別子の送信を参照してください。
client_idstringtrue*固定のファーストパーティユーザー識別子。
*詳細は以下のユーザー識別子の送信を参照してください。
client_ip_addressstringtrueイベントに対応するブラウザのIPアドレス(スペースなし)。IPv4またはIPv6アドレスのいずれかを使用できます。両方利用可能な場合は、IPv4を送信してください。IPアドレスは、アクションをトリガーしたユーザーの実際のパブリックIPアドレスである必要があります。AppLovinは、非パブリックIPまたはlocalhostに由来するイベントを取り込みません。
client_user_agentstringtrueデバイス/ブラウザのUser Agent
emailstringtrue*ユーザーのメールアドレス。AppLovinはプライバシー保護のため、この値をSHA-256を使用して自動的にハッシュ化します。また、AppLovinのハッシュ化ガイドラインに従って識別子を前処理する場合は、独自のSHA-256ハッシュを提供することもできます。
*詳細は以下のユーザー識別子の送信を参照してください。
esistringtrueイベントソースインジケーター。モバイルアプリイベントの場合は"app"、ウェブサイトイベントの場合は"web"を使用します。
phonestringtrue*ユーザーの電話番号。AppLovinはプライバシー保護のため、この値をSHA-256を使用して自動的にハッシュ化します。また、AppLovinのハッシュ化ガイドラインに従って識別子を前処理する場合は、独自のSHA-256ハッシュを提供することもできます。
*詳細は以下のユーザー識別子の送信を参照してください。
phone_last10_hashedstringfalsephoneがすでにSHA-256ハッシュである場合に強く推奨されます。AppLovinのハッシュ化ガイドラインに記載されている小文字の16進ダイジェスト(hex digest)を送信してください。phoneのハッシュを再利用しないでください。phoneがプレーンテキストの番号である場合は、このフィールドを省略してください。
user_idstringtrue*顧客の一意の識別子。
*詳細は以下のユーザー識別子の送信を参照してください。
country_codestringfalseユーザーの請求先国コード。ISO 3166規格に従ってください。
ifastringfalseユーザーの広告識別子:idfaまたはgaid
idfvstringfalseユーザーのベンダー識別子
osstringfalseユーザーのオペレーティングシステム:ios、android、macos、windows、linux、chrome_os、ipad_os、またはfire_os。大文字と小文字は区別されません。省略された場合、または認識されない場合、AppLovinはclient_user_agentからオペレーティングシステムを推測します。
sidstringfalseセッションID
zipstringfalseユーザーの請求先郵便番号。米国の郵便番号の場合は、最初の5桁のみを使用してください。

計測データ

名前タイプ必須説明
accounting_modestringtrueCASHまたはACCRUALのいずれか
attribution_lookback_window_hoursnumberfalseコンバージョンの貢献度(クレジット)を獲得するために、タッチポイントがどのくらい遡って発生できるかの期間(時間単位)。このフィールドを省略するか、nullを渡すと、無制限に遡ります。
attribution_modelstringtrueLAST_CLICK、FIRST_CLICK、LINEAR、TIME_DECAY、CUSTOM_MULTI_TOUCH、LAST_NON_DIRECT_TOUCH、CLICKS_AND_VIEWS_ENHANCED、またはANY_CLICKのいずれか
attribution_sharenumbertrue指定されたアトリビューションモデルとルックバックに基づいて、イベントに対してAppLovinが獲得する貢献度(クレジット)を表す0から1の間の数値
is_claimablebooleantrueAppLovinがイベントを促進したかどうかを示すフラグ
campaign_idstringfalseAppLovinのキャンペーンID
creative_set_idstringfalseAppLovinのクリエイティブセットID(adset IDとも呼ばれます)
first_purchase_tsnumberfalse顧客が広告主で最初に購入を行った時のミリ秒単位のエポックタイムスタンプ
first_visit_tsnumberfalse顧客が最初に広告主を訪問した時のミリ秒単位のエポックタイムスタンプ
is_new_customerbooleanfalse顧客が以前に広告主で購入したことがあるかどうか
is_new_visitorbooleanfalse顧客が以前に広告主を訪問したことがあるかどうか
last_purchase_tsnumberfalse顧客が最後に広告主で購入を行った時のミリ秒単位のエポックタイムスタンプ
last_visit_tsnumberfalse顧客が最後に広告主を訪問した時のミリ秒単位のエポックタイムスタンプ

aleidとalartの送信

aleidとalartは、ユーザーがAppLovin広告をクリックした後に、AppLovinがウェブサイトのURLに追加するクエリパラメータです。これらのパラメータの存在を利用して、どのクリックがAppLovinからのものであるかを識別します。

aleidとalartを送信するには、次のいずれかを行います。

  • サイトにAppLovin Pixelがインストールされている場合、AppLovin Pixelはaleidクエリパラメータを検出すると、自動的にクッキー_axeidを設定します。 そのようなクッキーが確認された場合は常に、その値を読み取り、user_data.aleidの値としてJSONリクエストボディに含めて送信してください。AppLovin Pixelはalartに対しても同様に動作し、alartクエリパラメータを検出するとクッキー_axartを設定します。そのクッキーを読み取り、その値をuser_data.alartとしてJSONリクエストボディに含めて送信してください。
  • aleid URLクエリパラメータが存在する場合は、その値を取得します。 サーバーがaleidクエリパラメータを検出した場合は、サーバー側でパラメータを読み取ります。 AppLovinは、これをサイト上の名前が_axeidのHTTPクッキーとして設定することを推奨しています。 このクッキーの有効期限は1年間に設定してください。 前の方法と同様に、そのようなクッキーが確認された場合は常に、その値を読み取り、user_data.aleidの値としてJSONリクエストボディに含めて送信してください。alartも同様に処理します。alartクエリパラメータを取得し、サーバー側で有効期限1年の_axartという名前のHTTPクッキーとして保存し、その値をuser_data.alartとしてJSONリクエストボディに含めて送信します。

ユーザー識別子の送信

AppLovinでは、次のフィールドのうち少なくとも1つを渡す必要があります:client_id、axwrt、alart、user_id、email、またはphone。

client_id
サイトにAppLovin Pixelがインストールされていない場合は、訪問者を識別するために保存している別の固定のファーストパーティクッキーを渡します。 これはグローバルに一意であり、ユーザーのブラウジングセッション間で一貫している必要があります。
axwrt
サイトにAppLovin Pixelがインストールされている場合、AppLovin Pixelは自動的にクッキー_axwrtを設定します。
user_id
システムにおける顧客の一意の識別子。 これは、ユーザーセッション間で一貫している固定の識別子である必要があります。
email
ユーザーのメールアドレス。 AppLovinはプライバシー保護のため、この値をSHA-256を使用して自動的にハッシュ化します。 AppLovinのガイドラインに従って識別子を前処理する場合は、独自のSHA-256ハッシュを提供することもできます。
phone
ユーザーの電話番号。 AppLovinはプライバシー保護のため、この値をSHA-256を使用して自動的にハッシュ化します。 AppLovinのガイドラインに従って識別子を前処理する場合は、独自のSHA-256ハッシュを提供することもできます。
phone_last10_hashed
phoneがすでにSHA-256ハッシュである場合に強く推奨されます。 この値はphoneとは異なります。phoneのハッシュをこのフィールドにコピーしないでください。 AppLovinのハッシュ化ガイドラインにあるphone_last10_hashedのルールに従ってください。 プレーンテキストの電話番号を送信する場合は、このフィールドを省略してください。 省略してもイベントが拒否されることはありません。

ペイロードの例

{
  "events": [
    {
      "event_time": 1741784485001,
      "event_source_url": "https://applovin.com",
      "name": "purchase",
      "user_data": {
        "client_ip_address": "172.59.8.172",
        "client_user_agent": "chrome/123.456 android mobile",
        "aleid": "_aleid-query-param",
        "axwrt": "_axwrt-cookie-value",
        "email": "user@example.com",
        "phone": "+11234567890",
        "user_id": "customer_12345",
        "client_id": "_first_party_identifier",
        "sid": "sid",
        "ifa": "idfa",
        "idfv": "idfv",
        "os": "macos",
        "esi": "web",
        "zip": "12345",
        "country_code": "US"
      },
      "measurement_partner_data": {
        "is_claimable": true,
        "attribution_model": "LAST_CLICK",
        "attribution_lookback_window_hours": 24,
        "attribution_share": 0.5,
        "accounting_mode": "ACCRUAL",
        "campaign_id": "456",
        "creative_set_id": "789",
        "is_new_customer": false,
        "last_purchase_ts": null,
        "is_new_visitor": true,
        "last_visit_ts": 1
      },
      "data": {
        "user_id": "customer_12345",
        "currency": "USD",
        "discount_applications": [
          {
            "code": "SAVE10",
            "title": "Member discount"
          },
          {
            "title": "Holiday sale"
          }
        ],
        "value": 30,
        "transaction_id": "txn_abc123_20250120",
        "shipping": 5.99,
        "tax": 6,
        "items": [
          {
            "item_variant_id": "SKU-123-M",
            "item_id": "PROD-456",
            "item_name": "T-Shirt",
            "affiliation": "affiliation",
            "item_brand": "item_brand",
            "item_category": "item_category",
            "item_category_id": 604,
            "item_category2": "item_category2",
            "image_url": "image_url",
            "price": 15,
            "discount": 10,
            "quantity": 2
          }
        ]
      }
    }
  ]
}

search