内部BIポストバック:FAQとトラブルシューティング

Singularは、アプリのインストール、リエンゲージメント、アプリ内イベント、その他のイベントに関する通知をBIプラットフォームにリアルタイムで送信できます。これらの通知は内部 BI ポストバック(またはコールバック)と呼ばれ、パートナー構成ページで設定できます。

トラブルシューティング

内部 BI ポストバックを設定しました。正常に送信されているかどうかを確認するにはどうすればよいですか?

Singularによって送信されたポストバックのログを表示するには:

  1. Singularで、[属性]>[ログのエクスポート ]に進み、該当する日付範囲と[ポストバック]ログタイプを選択します。
  2. ログに含まれるフィールドのリストで、Response HTTP CodeResponse HTTP Body を選択してください。
  3. ダウンロードしたファイルで、ポストバックが正常に送信されたかどうかを確認し、正常に送信されなかった場合は、その原因を特定できるかどうかを確認します:
    • Response HTTP Codeフィールドは、ポストバックが正常に送信されたかどうかを示します。送信にエラーがあった場合、Singularは1分、5分、15分、30分、60分の間隔で5回ポストバックを再試行します。
    • Response HTTP Bodyフィールドにはエラーの詳細が表示されます。

問題がある場合は、設定を確認し、Singularサポートに連絡してください。

注:Singularはお客様のプラットフォームでデータがどのように処理されるかをコントロールしません。ログに表示されるデータは、Singularがお客様のBIにポストバックとして送信したデータと同じです。

よくある質問

内部BIのポストバックを設定する前に何を考慮する必要がありますか?

システムがポストバック(コールバックとも呼ばれる)を受信し、データを適切に取り込む必要があります。技術チームのメンバーが計画に関与していることを確認してください。

注: Singularからユーザーレベルのアトリビューションデータを取得する方法は他にもあります:

内部BIポストバックの設定方法を教えてください。
  1. Singularアカウントにログインし、Attribution > Partner Configurationに進み、Internal BIパートナーを選択します。
  2. 設定ウィンドウで、必ずポストバックURL(例:https://my_company_name.com/bi/event_endpoint?app=12)を指定してくださいこれはSingularがPOSTリクエストでポストバックを送信する場所です。
  3. その他のポストバック設定は、パートナーのポストバックと同じように設定します(「アトリビューションパートナーの設定方法」を参照)。

ネットワークによっては、 データの共有に特別な 制限がある場合があります。

ポストバックはどのように送信されますか?問題があった場合、Singularはどのくらいの頻度で送信を再試行しますか?
  • SingularはJSON形式のデータペイロードでHTTP POSTリクエストを行います(下記の構造を参照)。
  • Singularが500から599の間のHTTPSレスポンスコードを受け取った場合、ポストバックの送信を再試行します(最大5回まで再試行可能)。
  • 再試行は最初の送信から1分、5分、15分、30分、60分後に行われます。
  • ポストバックが送信されるIPアドレスの最新リストについては、ポストバックサーバーのIPアドレスを参照してください。
Singularポストバックの構造は?

Singular はポストバックを以下のフィールドを持つ JSON オブジェクトとして送信します:

キー  
app_name Display Name of application string
longname Long name (bundle ID) of application string
platform iOS or Android string
event_name Name of the event. Some events sent in postbacks are auto-tracked or generated events. These events include installs, sessions, uninstalls, reinstalls, and revenue events. See Auto-Tracked Events. string
idfa Unhashed iOS advertising identifier of device string
idfv Unhashed iOS identifier for vendor string
aifa Unhashed Android advertising identifier of device string
android_id Unhashed Android ID. Available only if aifa (android advertising ID) is not available string
singular_id Deprecated - Used when LAT is enabled for iOS devices. Use IDFV. Singular internal ID string
event_utc_timestamp Event UNIX Timestamp number
click_utc_timestamp Click UNIX Timestamp number
install_utc_timestamp Install UNIX Timestamp number
is_organic 1 if event is Organic, 0 if attributed number
is_viewthrough 1 if attributed event is a view-through conversion, 0 otherwise number
network Name of network to which install is attributed, when available string
network_tiktok_restricted For view-through campaigns, subject to restrictions based on TikTok Ads' terms of service string
campaign Campaign name as specified in Attribution Tracking Tags string
campaign_group Campaign Group Name (available for certain Self-Attributing Partners) string
campaign_tiktok_restricted For view-through campaigns, subject to restrictions based on TikTok Ads' terms of service string
tracker_campaign_name Campaign Name as passed by the network. Available if passed in click in the pcn string
tracker_campaign_id Campaign ID as passed by the network. Available if passed in click in the pcid string
tracker_sub_ campaign_name Sub-campaign name as passed by the network. Available if passed in click in the pscn string
tracker_sub_ campaign_id Sub-campaign ID as passed by the network. Available if passed in click in the pscid string
tracker_creative_name Campaign creative name as passed by the network. Available if passed in click in the pcrn string
tracker_creative_id Campaign creative ID as passed by the network. Available if passed in click in the pcrid string
tracker_publisher_id Publisher ID as passed by the network. Available if passed in the click in ps string
tracker_publisher_ sub_id Publisher SUB ID as passed by the network. Available if passed in the click in pssn string
tracker_publisher_ site_name Publisher name as passed by the network. Available if passed in click in the psn string
tracker_publisher_ site_id Publisher ID as passed by the network. Available if passed in click in the psid string
tracker_publisher_ sub_site_name Sub-publisher name as passed by the network. Available if passed in click in the pssn string
tracker_publisher_ sub_site_id Sub-publisher ID as passed by the network. Available if passed in click in the pssid string
tracker_name Campaign name as specified in Attribution Tracking Tags string
partner_campaign Deprecated - Use tracker_campaign_name or tracker_campaign_id Campaign ID or Name as passed by the network. Available if passed in click string
partner_sub_campaign Deprecated - Use tracker_sub_campaign_name or tracker_sub_campaign_id Sub Campaign Name or ID as passed by the network. Available if passed in click string
partner_site Deprecated - Use tracker_publisher_site_name or tracker_publisher_site_id Source site or application for click. Available if passed in click string
partner_sub_site Deprecated - Use tracker_publisher_sub_site_name or tracker_publisher_sub_site_id Source sub site or application for click. Available if passed in click string
creative Creative Name or ID. Available only if provided in click string
site Source site & Sub Site for click. Available if passed in click string
user_id Custom user ID. Available if passed by the SDK string
singular_click_id Singular assigned click ID string
is_reengagement Will return '1' if attributed to a re-engagement campaign, '0' if not number
click_ip IP of the device at the time of the clicked ad string
os_version OS version of the device at the time of the clicked ad string
app_version App version of the device at the time of the install/event number
country Country from which user installed string
city City from which user installed string
limit_ad_tracking Do not track flag is set active will return '1', all other conditions will return '0' number
device_model Device model string
device_brand Device Brand string
match_type Whether the attribution is deterministic (device ID matching), probabilistic (Android only), or none (null value indicates an organic install). string
amount Revenue event postbacks only - The transaction amount in dollars and cents number
currency Revenue event postbacks only - The three-letter ISO 4217 currency code for the transaction string
is_first_event Returns '1' for first occurrence of an event (revenue or custom), '0' for every subsequent event from the same device ID number
fb_campaign_id Numeric Facebook Campaign ID. Subject to restrictions based on Facebook's terms of service number
fb_campaign_name Facebook Campaign name. Subject to restrictions based on Facebook's terms of service string
fb_adset_id Numeric Facebook Ad Set ID. Subject to restrictions based on Facebook's terms of service number
fb_adset_name Facebook Ad Set name. Subject to restrictions based on Facebook's terms of service string
fb_ad_id Numeric Facebook Ad ID. Subject to restrictions based on Facebook's terms of service number
fb_ad_name Facebook Ad name. Subject to restrictions based on Facebook's terms of service string
twitter_campaign_name Twitter Campaign Name. Subject to restrictions based on Twitter's terms of service string
twitter_campaign_id Twitter alphanumeric Campaign ID. Subject to restrictions based on Twitter's terms of service string
twitter_line_id Twitter alphanumeric Line Item ID. Subject to restrictions based on Twitter's terms of service string
fraud_status Fraud decision for installation. Available only when fraud postbacks are enabled. Possible values are "valid"/"suspicious"/"rejected" string
fraud_reason Name of rule that decided the fraud status (for example, the name of the rule that rejected the install). Available only when fraud postbacks are enabled. string
異なる収益イベント(__IAP __、__REVENUE __、__ADMON_ USER_LEVEL_REVENUE__)とは何ですか?どれに対してポストバックを設定すべきですか?

アプリ内(SDK)イベントのドロップダウンには、いくつかの異なる収益関連イベントが表示されます。

同じアプリ内イベントに対して重複してポストバックが送信されるのを防ぐには、以下の手順に従ってください。

収益イベント名
説明

__IAP__

An event triggered by any in-app purchases that have not been given a custom name in the SDK/S2S implementation.

(Custom revenue events)

In-app purchase events that have been given custom names in the SDK/S2S implementation also appear in the list.
__ADMON_ USER_LEVEL_REVENUE__ An event triggered by revenue gained from ad monetization (if you have set up ad revenue attribution using the method of sending SDK events).
__REVENUE__

An event triggered by any revenue coming into the app (including __IAP__, purchase events with custom names, and ad revenue events). See warning below.

アプリ内課金のみの収益がある場合の対処方法:

  • IAP__とカスタム購入イベントのマッピングを設定します。
  • または、すべてのアプリ内課金イベントを含む__REVENUE__を使用してください。

アプリ内課金と広告収入の両方がある場合はどうすればよいですか?

  • IAP__、カスタム購入イベント、__ADMON_USER_LEVEL_REVENUE__のマッピングを設定します。
  • この場合、一般的なイベント__REVENUE__を使用することはお勧めしません。なぜなら、このイベントには購入と広告収益の両方のイベントが含まれており、ネットワーク側で両方の収益を同じ収益イベントにマッピングすると問題が発生する可能性があるからです。
  • 代わりに、アプリ内課金イベントをネットワークの購入イベントにマッピングし、__ADMON_USER_LEVEL_REVENUE__イベントをネットワークのアドモンまたは広告収入イベントにマッピングします。
  • ネットワーク側で使用するイベントがわからない場合は、ネットワークにお問い合わせください。

警告パートナーに対する既存の設定が__REVENUE__ポストバックを送信しており、アプリ内課金イベントに加えて広告収入イベントを開始する場合、パートナーネットワークが広告収入イベントを受信するように設定されていないか、別のイベントにマッピングする必要がある場合に問題が発生する可能性があります。広告収入のポストバックを送信すべきかどうか、またどのように送信すべきかについては、ネットワークに確認してください。