Singularは、アプリのインストール、リエンゲージメント、アプリ内イベント、その他のイベントに関する通知をBIプラットフォームにリアルタイムで送信できます。これらの通知は内部 BI ポストバック(またはコールバック)と呼ばれ、パートナー構成ページで設定できます。
- パートナー ネットワークへのポストバックの設定については、「アトリビューション パートナーを設定する方法」を参照してください。
- Facebook、Google、Apple、Snapchat、Twitter、および Yahoo キャンペーンでポストバックがどのように表示されるかを理解するには、「自己アトリビューションネットワークからの内部 BI ポストバック」を参照してください:フィールド マッピングと例」を参照してください。
トラブルシューティング
Singularによって送信されたポストバックのログを表示するには:
- Singularで、[属性]>[ログのエクスポート ]に進み、該当する日付範囲と[ポストバック]ログタイプを選択します。
- ログに含まれるフィールドのリストで、Response HTTP CodeとResponse HTTP Body を選択してください。
- ダウンロードしたファイルで、ポストバックが正常に送信されたかどうかを確認し、正常に送信されなかった場合は、その原因を特定できるかどうかを確認します:
- Response HTTP Codeフィールドは、ポストバックが正常に送信されたかどうかを示します。送信にエラーがあった場合、Singularは1分、5分、15分、30分、60分の間隔で5回ポストバックを再試行します。
- Response HTTP Bodyフィールドにはエラーの詳細が表示されます。
問題がある場合は、設定を確認し、Singularサポートに連絡してください。
注:Singularはお客様のプラットフォームでデータがどのように処理されるかをコントロールしません。ログに表示されるデータは、Singularがお客様のBIにポストバックとして送信したデータと同じです。
よくある質問
システムがポストバック(コールバックとも呼ばれる)を受信し、データを適切に取り込む必要があります。技術チームのメンバーが計画に関与していることを確認してください。
注: Singularからユーザーレベルのアトリビューションデータを取得する方法は他にもあります:
- ログのダウンロード(ログのエクスポートとユーザーレベルデータのFAQをご覧ください。
- データ送信先を設定して、Singularからお客様のシステムに定期的にユーザーレベルデータをエクスポートする(Singularデータ送信先(ETL)FAQをご覧ください。
- Singularアカウントにログインし、Attribution > Partner Configurationに進み、Internal BIパートナーを選択します。
- 設定ウィンドウで、必ずポストバックURL(例:https://my_company_name.com/bi/event_endpoint?app=12)を指定してください。これはSingularがPOSTリクエストでポストバックを送信する場所です。
- その他のポストバック設定は、パートナーのポストバックと同じように設定します(「アトリビューションパートナーの設定方法」を参照)。
- SingularはJSON形式のデータペイロードでHTTP POSTリクエストを行います(下記の構造を参照)。
- Singularが500から599の間のHTTPSレスポンスコードを受け取った場合、ポストバックの送信を再試行します(最大5回まで再試行可能)。
- 再試行は最初の送信から1分、5分、15分、30分、60分後に行われます。
- ポストバックが送信されるIPアドレスの最新リストについては、ポストバックサーバーのIPアドレスを参照してください。
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 |
アプリ内(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__ポストバックを送信しており、アプリ内課金イベントに加えて広告収入イベントを開始する場合、パートナーネットワークが広告収入イベントを受信するように設定されていないか、別のイベントにマッピングする必要がある場合に問題が発生する可能性があります。広告収入のポストバックを送信すべきかどうか、またどのように送信すべきかについては、ネットワークに確認してください。