広告費用データインポート

Adjustのデータインポートサービスを使用すると、広告費用データとキャンペーン情報をAdjustに直接アップロードできます。Adjustと連携していないパートナーとの広告費用を計測する場合に役立つ機能です。

広告費用データをAdjustのシステムにインポートすると、Adjustで計測したデータが統合され、より強力なインサイトとアクションにつながるレポートが得られます。

重要:
Adjustは、お客様が提供するデータの正確性を検証できません。広告費用のデータはお客様が責任を負うものとし、Adjustはそのデータに基づきAdjustのデータに紐づけ表示します。

事前準備

はじめに、以下の設定手順をご覧ください。

要件

  • 広告費用データインポートソリューションは、SpendWorks EnterpriseまたはCustomパッケージにご契約のお客様にご利用いただけます。
  • Adjustの管理者または編集者のアクセス権限

ファイル共有の方法を選択

以下の手順を使用して、Adjustに広告費用データを送信する方法を設定してください。

Google Sheets

広告費用データをAdjustに正確にインポートするには、データセットをGoogleスプレッドシートファイルで共有し、重要な情報を含める必要があります。

  1. [YourCompany]_[Network being integrated]_[Data type] data importというタイトルでGoogleスプレッドシートファイルを作成します。

    • 例:companyname_networkname_adspend_data_import
  2. 共有設定を次のように変更します。

    • automate.import@adjust.comのメールアドレスをViewと共有します。
  3. 広告費用データインポートテンプレートを使用して、正しいフォーマットでCSVレポートを作成します。

    • ドキュメントにはコンマ ( , ) またはドル記号 ( $ ) が含まれていないことを確認してください。インポート時にエラーが発生するためです。
    • データ行の間に空行を作らないでください。
    • データの行の外側にランダムなセルが埋まっていないことを確認してください。
  4. Adjustで広告費用データインポートを設定します。

Eメール | AWS Redshift |ダイレクトリンク

  1. 広告費用データインポートテンプレートを使用して、正しいフォーマットでCSVレポートを作成します。

  2. 担当のテクニカル アカウント マネージャーに、以下の情報をお知らせください:

    • レポートを送信するメールアドレス。

    • レポートを送信するメールアドレス。識別子を追加できるAdjustのテンプレートを使用すると、そのアドレスにのみレポートを送信することができます。

      • テンプレート:​ automate.import.sa+{your_recipient_identifier_here}@adjust.com
      • メールアドレスの例:automate.import.sa+14et85dc9ed48c0489ed4c@adjust.com``14et85dc9ed48c0489ed4cを任意のrecipient_identifierに差し替える。
    • レポートを送信する時間(タイムゾーン情報を含む)。

      • Adjustは情報を基に、データ取得のスケジュールを設定します。
  3. テクニカルアカウントマネージャーと定義し共有したAdjustメールアドレスにレポートを送信します。

列のフォーマット

CSVファイルには以下のパラメーターが含まれていることを確認してください。

  • 必須パラメーター - date, campaign_name, store_id, store_type, ad_spend

  • 推奨 - campaign_id

    • キャンペーンごとに一意のcampaign_idを指定してください。
  • ネットワークからデータを受け取らない場合、他のフィールドは全て空白のままにできます。

列タイトルデータタイプコメント
必須パラメーター
date文字列yyyy-mm-dd の形式の日付


  • 例: 2024-07-01
  • campaign_name文字列キャンペーン名
    store_id文字列Apple App Store ID、Google Play Store ID、またはWebアプリID


  • Webアプリの場合、store_idの値は次のフォーマットに従うこと: web_{adjust_app_token}
  • store_type文字列
    可能な値:「google_play」、「app_store」または「web」
    ad_spend10進数選択された「通貨」パラメーターに基づいた、レポートする広告費用の合計。区切り記号には小数点(カンマ)ではなく小数点を使用してください。

    このフィールドを空白のままにしないでください。値がない場合は`0`を使用してください。
    推奨パラメーター
    campaign_id文字列キャンペーンID
    • キャンペーンごとに一意の campaign_id を指定してください。
    オプションパラメーター
    country文字列2桁のISO 3166国コード

  • 例: FR
  • adgroup_name文字列アドグループ名
    adgroup_id文字列アドグループID
    ad_name文字列広告/クリエイティブ名
    ad_id文字列広告 / クリエイティブID
    source_name文字列ソース / サブパブリッシャーアプリ名
    source_id文字列ソース / サブパブリッシャーのアプリID
    data_type文字列データがSKAN固有かどうかを示す。

    選択可能な値: skan, non_skan, unknown.

    デフォルト: unknown
    currency文字列3文字のコード (ISO 4217)、デフォルトはUSD
    impressions整数アプリ内の広告インプレッション数


  • 例: 1000
  • clicks整数アプリ内の広告クリック数


  • 例: 10
  • installs整数アプリのインストール数


  • 例: 1000
  • 広告費用のデータインポートを設定

    Googleスプレッドシートを使用してAdjustに広告費用データを送信する場合は、このセクションの手順に従ってください。

    1. DataWorks(データ接続)​ で、 データインポート(Data imports)​ を選択します。

    2. 新規データインポート(New data import)​ を選択します。

    3. データタイプ (Data type )​ で、 広告費用 (Ad Spend)​ を選択します。

    4. リストからパートナーを選択します。

      • リストに希望のパートナーが見つからない場合は、アカウントマネージャーに連絡して、パートナーを追加してください。
    5. Googleスプレッドシートリンク​ のフィールドに、設定した正しいGoogleスプレッドシートのリンクをペーストします。

    6. 次に、 表を確認(Check table)​ を選択し、Googleスプレッドシートファイルを検証します。ファイルにエラーがある場合は、次のステップに進む前にエラーを修正する必要があります。

    7. 頻度(Frequency)​ で、データインポートのプロセスが自動的に実行される頻度を選択します。

      • 日次 (Daily)​ を選択し、UTC時間を選択します。日次インポートを実行する場合、データは毎日確認されます。インポートは、最後のインポートから24時間が経過した場合にのみ実行されます。
      • 週次(Weekly)​ を選択し、日にちを選択してからUTC時間を選択します。週次インポートを選択すると、選択した時刻に毎週データが確認されます。インポートプロセスは、最後のインポートから1週間が経過した場合にのみ実行されます。
    8. データインポートを作成(Create data import)​ を選択します。

    AdjustはDatascapeで広告費用データを自動的に表示します。アプリにAdjust SDKを連携したり、Campaign Labでパートナー用のAdjustリンクを作成する必要はありません。

    データのインポート設定の確認と管理

    1. DataWorks (データ接続)> データインポート(Data imports)​ に移動します。このページには、設定した全てのデータインポートのリストが表示されます。このページには、以下の概要が確認できます。

      • ID​ - データインポートの識別子。テクニカルアカウントマネージャーにお問合せの際は、このIDを共有してください。
      • パートナー​ - 広告費用データをインポートするアドネットワークの名前。
      • 広告アカウント​ - パートナーの広告アカウント。
      • 頻度​ - データインポートプロセスが自動的に実行される頻度。
      • データタイプ​ - データのタイプ。ここでは広告費用データです。
      • ソースタイプ​ - 広告費用データのソース。例:Googleスプレッドシート
      • 前回のインポート​ - データのインポートプロセスが正常に実行された最後。
      • 失敗したインポート​ - データのインポートプロセスが完了しなかった回数。
        • None - データのインポートプロセスが一度も失敗していないことを示します。
        • Failed - データのインポートプロセスが失敗した回数を示します。 アクション(Actions)​ にて (詳細アイコン) > 開く(Open)​ を選択すると、インポートが失敗した理由を表示します。
    2. データインポートページの アクション(Actions)​ で、 (詳細アイコン) >開く(Open)​ を選択し、特定のデータインポートを表示します。このデータのインポートには、以下のタスクを実行できます。

      • 選択 (削除アイコン)をクリックして、データインポート設定を削除します。
      • インポートを編集(Edit import)​ を選択し、インポート設定を編集します。
      • インポート設定​ では、以下のことができます。
        • インポート設定を表示し、自動データインポートプロセスをONまたはOFFにする。
        • 現在までに実行された全てのインポートプロセスの詳細を含むインポートログを表示する。このセクションには、インポートプロセスが実行された時刻と、データがインポートされた期間が表示されます。正常に完了した全てのインポートに関しては、 インポートしたデータを表示(View imported data)​ を選択すると、Datascapeのレポートでインポートされたデータが表示されます。失敗したインポートでに関しては、 エラーの詳細を確認(Check error details)​ を選択すると、データのインポートプロセスのエラー内容を表示します。
    3. データインポートページの アクション(Actions)​ で、 (詳細アイコン)を選択し、次の手順を実行します。

      • 編集(Edit)​ を選択して、既存のインポート設定の構成を編集します。
      • 削除(Delete)​ を選択して、データインポート設定を削除します。

    キャンペーンをマッピング

    Adjustは広告費用データを受信すると、それを利用可能なキャンペーンの集計データに紐付けようとします。アトリビューションデータと広告費用データをマッチングする方法として、自動マッチングサービスやカスタムマッピングなどがあります。

    自動マッピング

    Adjustの自動キャンペーンマッチングは、レポートサービスAPIからのデータを処理します。これには以下のデータが含まれます:

    • アトリビューションデータ
    • ネットワークAPIが報告した広告費用データ

    マッチングは、主に campaign IDcampaign nameを使用して行われます。このマッチングは自動的に行われるため、設定は不要です。

    カスタムマッピング

    自動マッチングを実行できない場合は、Adjustはカスタムマッピングを設定します。例えば、ネットワークAPIが campaign_id のみ を共有している場合、Adjustの campaign_nameと一致させることはできません。

    以下のいずれかの情報をAdjustのテクニカル アカウント マネージャーに提供してください。

    • ネットワークのキャンペーンIDまたはアドグループID
    • 対応するAdjustのキャンペーン名
    • Adjustのアドグループ名

    専任のテクニカル アカウント マネージャーが、Adjustでマッピングを設定します。これにより、全ての広告費用データを一元管理し、全ての広告費用情報の全体像を把握することができます。

    カスタムマッピングは、お客様が提供する情報を使用してAdjustで作成・管理されます。提供されたデータに応じて、Adjustは以下のうちいずれかの方法でデータを一致させます。

    Adjustの情報ネットワーク情報
    キャンペーン名キャンペーンID(Campaign ID)
    アドグループ名アドグループID(Adgroup ID)
    ヒント:
    最善の結果を得るために、キャンペーン名にキャンペーンIDを含めてください。これにより、Adjustは広告費用と集計データを自動的に一致させることができます。最良の結果を得るには、次の構造を使用します: {campaign_name}_{campaign_id}