ドキュメント

インテグレーション トラブルシューティング

一般的なモバイル測定パートナー (MMP) インテグレーション エラーのトラブルシューティングを行います。
読み終わるまでの所要時間 15 分最終更新 9日前

モバイル計測パートナー(MMP)をユーザー獲得キャンペーンと統合すると、ダッシュボードでキャンペーンのデータが正常に受信されているかどうかが確認されます。ダッシュボードでは、以下のデータ共有インジケーターが検証されます。
  • キャンペーンは、開始から 2 日以内にインストールデータを受け取ります。
  • キャンペーンは、開始から 7 日以内にインストール後のイベントデータを受け取ります。
キャンペーンがこれらの検証チェックのいずれかに合格しなかった場合、ダッシュボードはキャンペーンにインテグレーションエラーメッセージのフラグを立てます。これらのエラーを解決する方法については、以下のセクションを参照してください。
重要
このトラブルシューティング ガイドでは、以下の MMP のインテグレーション問題について説明します。
  • Adjust
  • Airbridge
  • AppsFlyer
  • Bytebrew
  • Singular
  • Tenjin AppsFlyerとのインテグレーションに関するその他の問題については、AppsFlyerインテグレーション検証のドキュメントを参照してください。

2 日間にインストールデータなし

キャンペーンがローンチから 2 日以内にインストールデータを受信しない場合は、パフォーマンスとアトリビューションに悪影響を与える可能性があります。ダッシュボードボードでは、この問題に対して以下のエラーメッセージでフラグを立てます。
1 つ以上のキャンペーンでインテグレーションブロッキングの問題が検出されました。これらの問題は、パフォーマンスに深刻な影響を与える可能性があります。この問題を解決して、正確な追跡と配信を保証します。キャンペーンは、ローンチから 2 日以内に、少なくとも 1 つのインストールポストバックを受け取る必要があります。

原因

MMP インテグレーションの設定に誤りがあると、キャンペーンでインストールデータの蓄積に失敗することがあります。インテグレーションのステップバイステップ手順については、MMP 固有のインテグレーションガイドを参照してください。

解決

キャンペーンでインストールデータを確実に受信するには、以下の両方の解決策を検討してください。

すべてのソースからのインストールデータを共有する

Unity とインストールデータを共有する際は、Unity アトリビュート、非アトリビュート、オーガニックインストールを含むユーザーベース全体からのデータを必ず加えてください。各アトリビューショの種類の定義については、アトリビューションの概要 を参照してください。
この設定には 各 MMP 固有の用語が使用されています。サポートされている MMP ダッシュボードですべてのソースからのインストールデータを共有する方法を示す、以下の例を参照してください。
すべてのユーザーベースのインストールデータを共有するには、Adjust ダッシュボードで以下の手順に従います。
  1. Campaign Lab タブ > Partners ページに移動します。
  2. What sources of data do you want to share のオプションから Data from all attribution sources を選択します。

インテグレーション設定の確認

希望する MMP のインテグレーション ガイドを調べて、正しく設定されていることを確認します。パートナーのインテグレーション ガイドで、インテグレーションのアクティベーション、広告主の認証情報、データ共有設定を確認します。
以下の手順を実行して、Adjustをユーザー獲得キャンペーンに正しく統合し、データを共有します。
1

Activate Unity Ads in the Adjust dashboard

Unity Ads との統合をアクティブ化するには、以下の手順を実行します。
  1. Adjust ダッシュボード で、Campaign Lab > Partners に移動します。
  2. + New partner を選択し、Unity Ads を検索します。
  3. アプリケーションを選択し、Next を選択します。
  4. GAME ID フィールドに広告主の ゲーム ID を入力します。
User Acquisition (ユーザー獲得) ダッシュボードに表示されているゲーム ID を正確に入力してください。ゲーム ID が一致しない場合、Unity でイベントを正しく受信できません。
2

Configure data-sharing settings

データ共有設定を行うには、以下の手順を実行します。
  1. What sources of data do you want to share のオプションから Data from all attribution sources を選択します。
  2. What other data do you want to share? のオプションから、SessionsIn-app revenue (from in app purchases) の両方を選択します。
重要
ROAS およびイベントキャンペーンを有効にするには、これらのデータ共有設定を使用する必要があります。
3

Map events and parameters

アプリ内イベントをユーザー獲得キャンペーンと共有するには、データ共有 > イベントマップ で以下の手順を実行します。
  1. + マップイベント を選択します。
  2. Adjust と Unity で共有するイベントを Adjust イベント リストから選択します。
    Adjust インテグレーション設定の Unity と共有するマップイベント

    Map Adjust events

  3. 以下の表に示すように、適切な Adjust イベントに対応する Unity Ads イベントを選択または入力します。
重要
Adjust アカウントで広告収益データの共有がサポートされている場合、このデータを専用の
ad_revenue
イベントとして送信してください。 そうでない場合は、広告収益イベントを送信しないでください。広告収益イベントを他のイベントの種類 (
purchase
など) としてマッピングすると、キャンペーンの最適化が停止する可能性があります。

Adjust アプリケーションイベント

Unity Ads パートナーイベント

purchase
purchase
ad_revenue
ad_revenue
{milestone_event}
level_complete
  • session
  • launch
session
  1. 同じイベントをすべてのプラットフォームに対してマップする場合は、Use global mapping を選択してください。

インストール後イベントデータが7日間ない

キャンペーンがローンチから7日以内にインストール後のイベント データを受信しない場合は、パフォーマンスと最適化に悪影響を与える可能性があります。ダッシュボードボードでは、この問題に対して以下のエラーメッセージでフラグを立てます。
1 つ以上のキャンペーンでインテグレーションブロッキングの問題が検出されました。これらの問題は、パフォーマンスに深刻な影響を与える可能性があります。この問題を解決して、正確な追跡と配信を保証します。キャンペーンは、ローンチから7日以内に、インストール後イベントのポストバックを少なくとも1回受信する必要があります。

原因

以下のようなインテグレーション設定によっては、MMP からキャンペーンへのインストール後イベントデータの送信が妨げられる場合があります。

アトリビューションが正しく設定されていない

トラッキング リンクが正しく設定されていないと、MMP はインストール後のイベント データを Unity と共有できません。

広告収益レポートが無効

MMP で Purchase (購入) イベントと Ad Revenue (広告収益) イベントの値と収益の両方を送信できるようにしないと、ダッシュボードに以下の最適化されたキャンペーン目標に必要なデータがありません。
  • アプリ内課金 (IAP) 広告費回収率 (ROAS)
  • 広告収益 ROAS
  • ハイブリッド ROAS
  • 課金ユーザーイベント最適化
この問題の解決方法の詳細については、「 データ共有を正しく設定する 」セクションを参照してください。

解決

キャンペーンでインストール後のイベントデータを確実に受信するには、以下の解決策を検討してください。

インストール後イベントを正しくマップする

インストール後イベントデータをキャンペーンと共有する際は、インストール後イベントを正しくマップしてください。正しいマッピングとは、Unity Ads のイベント名と MMP のイベント名を適切に対応させることを指します。
注意
Singular 以外の MMP を使用している場合、広告収益イベントとアプリ内課金 (IAP) イベントを組み合わせないでください。
以下の正しくマップされたイベント名の例を参照してください。
Adjust インテグレーション設定の Map events to share with Unity Ads セクションで、インストール後イベントを以下のようにマップします。
重要
Adjust アカウントで広告収益データの共有がサポートされている場合、このデータを専用の
ad_revenue
イベントとして送信してください。そうでない場合は、広告収益イベントを送信しないでください。広告収益イベントを他のイベントの種類 (
purchase
など) としてマッピングすると、キャンペーンの最適化が停止する可能性があります。

イベントタイプ

Unity Ads イベント名

イベント名の調整

アプリ内課金 (IAP)
purchase
purchase
広告収益
ad_revenue
ad_revenue
マイルストーン達成
level_complete
達成
{milestone_event_name}
達成
セッション
session
session

データ共有を正しく設定する

キャンペーンとインストール後イベント データを共有する場合は、データ共有設定が正しく設定されていることを確認してください。
インストールおよびインストール後のイベント データを Unity に送信するには、以下のパートナー固有の手順の「データ共有設定の設定」セクションを参照してください。
以下の手順を実行して、Adjustをユーザー獲得キャンペーンに正しく統合し、データを共有します。
1

Activate Unity Ads in the Adjust dashboard

Unity Ads との統合をアクティブ化するには、以下の手順を実行します。
  1. Adjust ダッシュボード で、Campaign Lab > Partners に移動します。
  2. + New partner を選択し、Unity Ads を検索します。
  3. アプリケーションを選択し、Next を選択します。
  4. GAME ID フィールドに広告主の ゲーム ID を入力します。
User Acquisition (ユーザー獲得) ダッシュボードに表示されているゲーム ID を正確に入力してください。ゲーム ID が一致しない場合、Unity でイベントを正しく受信できません。
2

Configure data-sharing settings

データ共有設定を行うには、以下の手順を実行します。
  1. What sources of data do you want to share のオプションから Data from all attribution sources を選択します。
  2. What other data do you want to share? のオプションから、SessionsIn-app revenue (from in app purchases) の両方を選択します。
重要
ROAS およびイベントキャンペーンを有効にするには、これらのデータ共有設定を使用する必要があります。
3

Map events and parameters

アプリ内イベントをユーザー獲得キャンペーンと共有するには、データ共有 > イベントマップ で以下の手順を実行します。
  1. + マップイベント を選択します。
  2. Adjust と Unity で共有するイベントを Adjust イベント リストから選択します。
    Adjust インテグレーション設定の Unity と共有するマップイベント

    Map Adjust events

  3. 以下の表に示すように、適切な Adjust イベントに対応する Unity Ads イベントを選択または入力します。
重要
Adjust アカウントで広告収益データの共有がサポートされている場合、このデータを専用の
ad_revenue
イベントとして送信してください。 そうでない場合は、広告収益イベントを送信しないでください。広告収益イベントを他のイベントの種類 (
purchase
など) としてマッピングすると、キャンペーンの最適化が停止する可能性があります。

Adjust アプリケーションイベント

Unity Ads パートナーイベント

purchase
purchase
ad_revenue
ad_revenue
{milestone_event}
level_complete
  • session
  • launch
session
  1. 同じイベントをすべてのプラットフォームに対してマップする場合は、Use global mapping を選択してください。