パートナーのコンフィギュレーションとポストバックよくある質問とトラブルシューティング

ドキュメント

パートナー設定ページでは、Singularトラッカーが様々な広告ネットワークやその他のパートナーと連携できるように設定します。これから始める方は、パートナー設定とポストバックの設定方法をご覧ください。

注:このガイドはSingularのお客様向けです。Singularのパートナーの方、またはパートナーになりたい方は、パートナー向け情報をご覧ください。

トラブルシューティング

ネットワークパートナーがポストバックを受信しないのはなぜですか?

パートナーネットワークが、インストール/コンバージョンやアプリ内イベントのポストバックを受信していないと回答した場合:

  1. Attribution> Export Logsに移動し、パートナーのポストバックログをダウンロードします。ログのダウンロードについては、ログとユーザーレベルデータのエクスポート FAQ を参照してください。
  • Response HTTP Code = 200 の postback をフィルタリングしてください。Response HTTP Codeが "200 "の場合は、パートナーがポストバックを受信したことを確認したことを意味します。
  • また、パートナー側の技術的な問題を特定するのに役立つ可能性があるため、Response HTTP Bodyフィールドも選択してください。
  • ログをパートナーと共有し、内部でデータを検証してください。他のレスポンスコードのポストバックが多数ある場合は、Singularからのポストバックを受信することに技術的な問題がある可能性があることをパートナーに伝えてください。
キャンペーンが終了したのに、パートナーネットワークがインストールやコンバージョン、アプリ内イベントのポストバックを受信しているのはなぜですか?

広告ネットワークのパートナーがインストールやアプリ内イベントのすべてのインスタンスを受信するように設定されていて、パートナーにイベントを「すべて送信」するように選択している場合、ポストバック設定はパートナーにポストバックを送信し続けます。このデータの送信を停止するには、ポストバックを削除するか、Partner Configuration内の "send all "ボックスのチェックを外す必要があります。Singularの用語集にあるReceiving all Installsの定義をご覧ください。

パートナーがポストバックとして受信したイベントの数と、Singularレポートのイベントの数が不一致な のはなぜですか?

考えられる理由は以下のとおりです:

  • ルックバックウィンドウ: ルックバックウィンドウ:1つまたは複数のイベントで、ポストバック用に設定されたルックバックウィンドウが異なる可能性があります。パートナー構成ページの設定を確認してください。
  • 技術的な問題:パートナー側の技術的な問題により、パートナーが1つまたは複数のポストバックを受信していない可能性があります。確認するには、「ネットワーク・パートナーがポストバックを受信しないのはなぜですか?
  • イベントが重複している: アプリのSingular SDKは__REVENUE__というイベントを自動生成します。また、アプリ内課金の種類に応じて独自のSDK収益イベントを作成することもできます。イベントのポストバックを設定する際は、__REVENUE__またはカスタム名の収益イベントのどちらか一方にポストバックを送信するようにしてください。両方は設定しないでください。そうしないと、Singularはアプリ内課金ごとに2つのポストバックを送信します。
イベント属性のないパートナーにポストバックが送信されるのはなぜですか?

ネットワークパートナーが、イベント属性のないポストバックを受信していると言っている場合:

  1. Attribution > Export Logsに行き、そのパートナーのポストバックログをダウンロードしてください。ポストバックのHTTP BodyまたはTarget URLフィールドにイベント属性が含まれているか確認してください。ログのダウンロードについては、ログとユーザレベルデータのエクスポート FAQ を参照してください。
  2. ログにイベント属性なしでポストバックが送信されていることが示されている場合は、Partner Configurationページのポストバック設定を再確認してください。イベントと共に送信される追加属性を設定していない場合は、今すぐ設定を変更してください。
  3. 設定が正しいにもかかわらず、属性のないポストバックが送信される場合は、Singularサポートにお問い合わせください。
ネットワークパートナーにどのポストバックが送信されたかをダブルチェックするにはどうすればよいですか?

ネットワークへの請求が、その期間にSingularがパートナーに送信したインストールやイベントのポストバックの数に基づいている場合、どのポストバックがパートナーに送信されたかを確認するには、属性 > ログをエクスポートで 生のポストバックログをダウンロードしてください。

ログのエクスポートページに関する一般的なヘルプは、ログのエクスポートとユーザーレベルデータに関するFAQをご覧ください。

ポストバックの検証には、以下の設定でログをダウンロードすることをお勧めします:

postback_log1.png

postback_log2.png

Postback Recipient が正常に受信したポストバックを表示するには、Response HTTP Codeの値が "200" であることを確認してください。

PartnerフィールドとPostback Recipientフィールドを混同しないでください:

  • Partnerはイベントの帰属先ネットワークです。
  • Postback Recipientはイベントのポストバックを受信したパートナーです。イベントは必ずしもそのパートナーに帰属するわけではありません(一部のパートナーは、そのパートナーに帰属するか別のネットワークに帰属するかに関わらず、あなたの全てのイベントのポストバックを受け取るように要求します。)

追加のフィールド "Is Attributed"は、ポストバックの受信者がイベントの帰属先ネットワークかどうかをさらに明確にします("Y "は同じネットワーク、"N "はイベントが別のパートナーに帰属していることを意味し、"Partner"フィールドで確認できます)。

注: Partners フィルタは、ポストバックを受信したパートナーの名前(パートナーネットワーク、社内 BI、サードパーティ分析ツールなど)でポストバックをフィルタリングします。

その他のログタイプでは、Partners フィルタは、コンバージョンやイベントが帰属するパートナー(広告ネットワーク)を意味します。

よくある質問

パートナー設定に関するFAQ

どのポストバックが必須で、どれがオプションですか?

アプリのインストールがそのネットワークに帰属する場合、Singularはすべてのパートナーネットワークにポストバックを送信します。これらのポストバックを無効にすることはできません。

その他のタイプのポストバックはオプションで、パートナーネットワークの設定に依存します:

  • リエンゲージメントポストバック
  • アプリ内イベントのポストバック
  • パートナーに帰属しないコンバージョン(インストール/リエンゲージメント)やイベントに関するポストバック
SingularのポストバックはどのIPから送信されますか?
Singularはいつ、どのくらいの頻度でポストバックの送信を再試行しますか?再試行までの待ち時間は?
  • 500から559の間のHTTPSレスポンスコードを受け取った場合、Singularはポストバックの送信を再試行します。
  • この仕組みでは最大5回のリトライが可能です。
  • 再試行は最初の試行から1分、5分、15分、30分、60分の間隔で行われる。

パートナーの種類と用語

パートナーとは

パートナー設定ページのパートナーとは、Singularのアトリビューションサービスと連携するように設定したネットワークやサービスのことです。

注意:このページでは、Singularレポートにデータを表示するために、どのソースからキャンペーンデータを取得するかをSingularに指示することはできません。そのためには、データコネクターページで広告ネットワークやその他のメディアソースを別途設定する必要があります(データコネクターFAQをご覧ください)。

パートナーに対してどのような設定ができますか?

パートナー設定]ページでは、パートナーおよびサイトごとに以下のことを設定できます:

  • クリックスルーアトリビューションのルックバックウィンドウ
  • どのポストバックをパートナーに送信するか
  • Singularがパートナーに接続するために必要な場合は、パートナーのプラットフォームへのログイン認証情報もここで入力します。これはパートナーによって異なります。

詳しくは下記の設定とポストバックの設定をご覧ください。

どのようなタイプのパートナーがありますか?
  • パートナーには広告ネットワークや広告代理店などがあります。これらのパートナーに対してアトリビューション設定を行い、パートナーのカスタムマクロを組み込んだトラッキングリンクを作成します。また、Singularにこれらのパートナーに、自動ポストバックの形でアトリビューションされたインストールや不正判定などの情報を送信させることができます。

  • その他のパートナーには、サードパーティのBIシステムや不正分析サービスなどがあります。このようなサービスと連携している場合は、パートナー設定ページで設定して、ポストバックを受け取れるようにします。
内部」パートナー(内部BI)とは何ですか?

「内部BI "は特別なタイプのパートナーで、アトリビューションの決定や不正の決定などに関するポストバックを社内のプラットフォームで受け取りたい場合に設定できます。詳細については、内部BIポストバックの設定を参照してください。

サイトとは何ですか?

サイト(またはアプリ サイト)は、特定のプラットフォーム用に開発されたアプリのバージョンです。各アプリ サイトのパートナー設定は個別に構成します。

たとえば、AndroidとiOSで動作するアプリがある場合、2つのアプリサイトがあり、それぞれにパートナー設定を構成できます。

こちらもご覧ください:アプリ設定FAQ

Singularはどのようにして各パートナーに送信するデータを知るのですか?

アトリビューションパートナーとの統合を開発するプロセスの一環として、Singularはパートナーがサポートするすべてのフィールドを含むポストバックテンプレートを作成します。新しいパートナー設定を保存すると、Singularはそのテンプレートに基づいてポストバックの作成を開始します。

パートナー設定をエクスポートするにはどうすればいいですか?パートナーに設定されているポストバックの全リストを取得するにはどうすればいいですか?

すべてのパートナーのポストバック設定をエクスポートするには

  • パートナー設定ページの右上にある「すべてエクスポート」をクリックします。
  • 選択したパートナーのポストバック設定をエクスポートするには、まずパートナーの左側にあるチェックボックスをクリックして1つ以上のパートナーを選択し、[Export Selected]をクリックします。

これにより、設定されている各ポストバックに関する情報が記載されたCSVファイルがダウンロードされます。

注意

  • CSVファイルの各行は、パートナーに設定された1つのポストバックを表します。
  • 2023年5月現在、エクスポートされたファイルには新しいフィールドが追加されています。
カラム 説明
パートナー パートナーの名前
エージェンシー [新しいフィールド] 設定するエージェンシーの名前(関連する場合)
アプリ アプリの表示名
バンドル ID アプリの長い名前またはバンドル ID
サイト公開ID [新しいフィールド] Apple App StoreまたはGoogle PlayにおけるアプリのID、またはウェブサイトのURL。
OS アプリのOS(iOSまたはAndroid)
ビュースルーポストバックの送信
[NEW FIELD] パートナーがビュースルーに関するポストバックを受信するように設定されている場合、Trueになります。
クリックスルー属性ルックバックウィンドウ このパートナーとアプリサイトに設定されているルックバックウィンドウ
ポストバックタイプ この行に記述されている特定のポストバックがインストールまたはイベントのどちらであるか。
イベントルックバックタイプ ルックバックウィンドウのオプション:
- タッチポイント:タッチポイント:インストールが行われた広告のクリック/ビューから開始します。
- インストール:インストールから開始します。
- なし:イベントポストバックの時間制限なし。
イベント・ルックバック・ウィンドウ イベント・ルックバック・タイプに従って、イベント・ポストバックを指定された時間枠に制限するためのルックバック・ウィンドウ(日単位)。
イベントSDK名
[FIELD NAME CHANGED: FORMERLY "EVENTS"] この行のポストバックがイベントの場合、そのイベントのSDK名。
イベントパートナー名
[新しいフィールド] この行に記述されているポストバックがイベントの場合、イベントのパートナー名。
属性のみ このタイプのすべてのイベントに対してポストバックを送信するか、イベントが特定のパートナーに帰属している場合にのみ送信するかを指定します。
ポストバックURL Singularマクロを含む、ポストバックの完全なURL。
作成日
[新しいフィールド]コンフィギュレーションの作成日。
最終更新日
[新しいフィールド] コンフィギュレーションの最終更新日
カスタマイズされたポストバックURL [NEW FIELD] Yes/no (このフィールドはフレキシブルポストバック機能が有効になっている場合のみ使用可能)
トラッカー名フィルター
[新しいフィールド] フィルタ名または "フィルタなし"(このフィールドはこのSingularカスタマーでフレキシブルポストバック機能が有効になっている場合のみ利用可能)。
限定データ共有制限 [NEW FIELD] True/False(このフィールドはこのSingularカスタマーで限定データ共有機能が有効になっている場合のみ利用可能)。
限定データ共有デフォルト [NEW FIELD] True/False(このフィールドは、このSingular顧客で限定データ共有機能が有効になっている場合にのみ使用できます)。
国制限タイプ [新しいフィールド] "含む "または "含まない"(このフィールドは、このSingularカスタマーで関連する機能が有効になっている場合にのみ使用できます)。
国の制限 [新しいフィールド]カンマで区切られた国名(国コードではなくフルネーム)のリスト(このフィールドは、このSingularカスタマーで関連する機能が有効になっている場合にのみ使用できます)。

設定とポストバック

どのポストバックがネットワークパートナーに送信されたかをダブルチェックするには?
なぜパートナーを設定する際にアプリとアプリサイトを選択する必要があるのですか?

パートナー設定はアプリサイトごとに個別に設定されます。

入力が求められるセキュリティキー/トークン/パスワードは何ですか?

Singularは通常、パートナーにポストバックを送信するために特定の認証情報を要求します。適切な認証情報はパートナーにお尋ねください。

リエンゲージメントポストバックとは何ですか?

リエンゲージメントが成功したことをパートナーに通知するポストバックです。これらのポストバックを有効にするオプションは、リエンゲージメントキャンペーン(リターゲティングキャンペーン)をサポートするパートナーでのみ利用可能です。

ビュースルーアトリビューションとは何ですか?

ビュースルーアトリビューションとは、広告のクリックではなく、広告の閲覧に基づいて決定されるアトリビューションです。ビュースルーキャンペーンを実施する場合は、ビュースルーアトリビューションを含めるを選択すると、これらのアトリビューションについてもSingularからパートナーにポストバックが送信されます(そうでない場合は、クリックスルーのアトリビューションについてのみポストバックが送信されます)。

注意 - アプリ内イベントのビュースルーアトリビューションは、インストールまたはリエンゲージメントアトリビューション設定によって決定されます。つまり、ビュースルーがアプリ内イベントに適用されるのは、インストールまたはリエンゲージメントが有効になっている場合のみです。

不正ポストバックとは何ですか?

不正のポストバックには、Singularの不正検知システムによる決定に関する情報が含まれます。詳しくは不正のポストバックをご覧ください。また、Singularの高度な不正検知方法については、Singular不正防止をご覧ください。

アトリビューション・ルックバック・ウィンドウとは何ですか?
ポストバックウィンドウの開始点とは何ですか?

これは、イベントのポストバックを指定された期間(例えば、インストールから5日後)に 制限するためのルックバックウィンドウです。指定された日数が経過した後にイベントが発生した場合, ポストバックは送信されません.帰属するインストール後イベントを送信する際のデフォルトは、帰属するタッチポイントから7日間です(下記の "タッチポイント "の定義を参照)。

アプリ内イベントとは

アプリ内イベントとは、アプリ内でコンバージョン後に発生するユーザーイベントのことです。例えば、アプリをインストールしたユーザーは、その後プラットフォームにログインしたり登録したり、チュートリアルを見たり、ゲームアプリであればレベルアップしたりするかもしれません。パートナーによっては、Singularのアトリビューションサービスからこれらのイベントに関するポストバックを受け取りたいと考えています。

イベントのポストバックはどのように設定できますか?

image4.png

まず、どのポストバックを送信するかを選択します:

オプション 意味
すべて 全てのアプリ内イベントに関するポストバックをこのパートナーに送信します。
インストールが X に帰属する場合のみ アプリのインストールがこのパートナーに帰属する場合にのみ、アプリ内イベントに関するポストバックをこのパートナーに送信します。
オフ このパートナーにアプリ内イベントのポストバックを送信しない。

次に、アプリ内イベントを以下のように追加します:

フィールド 意味
アプリ内(SDK)イベント名 アプリからSingular SDKインテグレーションを通して送信されるイベント名。
イベント名 パートナーが認識するイベント名またはID(パートナーは通常、認識できるイベントのリストを持っています)。

ポストバックウィンドウの開始ポイント

(以前はルックバック)

ルックバック・ウィンドウを設定して、イベントのポストバックを指定した時間枠(たとえば、インストールから5日後)に制限します。指定した日数が経過した後にイベントが発生した場合、ポストバックは送信されません。帰属するインストール後のイベントを送信する際のデフォルトは、帰属するタッチポイントから7日間です(以下の "タッチポイント "の定義を参照)。

オプション
- タッチポイントインストールがアトリビュートされた広告クリック/ビューから開始します。
- インストールインストールから開始します。
- 無制限(エンタープライズのみ):イベントポストバックの時間制限なし。メディアソースに帰属するイベントは、インストールまたはリエンゲージメント帰属が30日以上前であっても送信されます。このオプションを使用すると、Analytics --> Reportsで「実績」カウントがプルされたときに、CPE(イベント単価)キャンペーン目標のメディアソース報告数が広告主の単一レポートと一致するようになります。

注:ポストインストールイベントは、イベントが発生したときに送信されます。

日数 ルックバックウィンドウの長さを日数で指定します。
収益値を含める 収益イベントの場合、ポストバックに収益情報を含めます(このチェックボックスにチェックを入れない場合、Singularはイベントのカウントのみを送信します)。
異なる収益イベント(__IAP __、__REVENUE __、__ADMON_USER_LEVEL_REVENUE__)とは何ですか?どれをポストバックに設定すればいいですか?

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

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

収益イベント名
説明

IAP__

SDK/S2S実装でカスタム名が与えられていないアプリ内課金によってトリガーされるイベント。

(カスタム収益イベント)

SDK/S2S実装でカスタム名が与えられているアプリ内課金イベントもリストに表示されます。
__admon_user_level_revenue__。 広告収益によって得られた収益によってトリガーされるイベントです(SDKイベントを送信する方法を使用して広告収益のアトリビューションを設定している場合)。
レヴェニュー__REVENUE

アプリに入る収益によってトリガーされるイベント(__IAP__、カスタム名の購入イベント、広告収益イベントを含む)。以下の警告を参照してください。

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

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

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

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

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

パートナー統合とポストバック設定を更新するには?

Singularの統合チームはパートナーと常に連絡を取り合い、可能な限り最高の統合ができるようにしています。パートナーがSingularからのポストバックを受け取る方法を変更した場合など、パートナーから統合の更新を求められることがあります。

ほとんどの場合、Singularにログインし、パートナー設定ページを開き、統合を開き、保存し直すことで統合を更新することができます。

まれに、以前は存在しなかった新しいフィールドや設定を提供するなど、更新に多くの手順を必要とする場合があります。そのような場合は、パートナーまたはSingularからご連絡させていただきます。

パートナーの統合をグローバルに変更できますか?パートナー設定のデフォルト設定を更新できますか?

パートナー設定の設定は似ているように見えますが、各設定はSingular内で独自に統合されています。現時点では複数の設定を同時に更新することはできません。