InCost API：アドネットワーク向け

コストデータを送信するには、InCost uploadのメソッドを使用します。  

APIリクエストは、以下の条件を満たしている必要があります： 

• APIコールごとに1アプリのデータを送信してください。 
• Curlのサンプルに示されているように、データ形式はJSONで送信してください。
• 各JSONには、特定の日付のキャンペーンコストの詳細を記載してください。
• 必須のフィールドはすべて入力されている必要があります。(空のフィールドは送信しないでください。 )
• コスト情報を送信できるメディアソースは、あなたのアドネットワークアカウントに紐付いているメディアソースに限定されます。詳細は担当PDMに確認してください。
• キャンペーンのコストレポートの階層の一部ではない項目がある場合には、リクエスト内に含めないでください。例：adset ID / adset name / ad ID / ad name

curl --location --request POST 'https://hq1.appsflyer.com/api/incost-uploader/v1/data/app/<app_id_placeholder>'\
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <api_token_placeholder. Note the token has more than 700 characters.>'\
--data-raw
      '{
    "date": "2020-02-28",
    "app_id": "com.cost.app",
    "media_source": "example_int",
    "campaign_id": "1236678",
    "campaign_name": "example_campaign",
    "geo": "ZA",
    "currency": "ZAR",
    "spend": 123.12
  },
  {
    "date": "2020-02-29",
    "app_id": "com.cost.app",
    "media_source": "exmaple_int",
    "campaign_id": "123",
    "campaign_name": "Campaign123",
    "geo": "IL",
    "currency": "USD",
    //make sure the value for "spend" does NOT have quotation marks, as indicated below.
    "spend": 2400 
  }'

このメソッドは、これまでに送信したコストデータのコールのステータス/エラーのメッセージを、JSONで返します。

curl --location --request GET 'https://hq1.appsflyer.com/api/incost-mgmt/v1/data/app/<app_id_placeholder>/job/<job_idplaceholder>' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer '<api_token_placeholder.Note the token has more than 700 characters.>'

 Get job statusのレスポンス例

{ 
    "date_from": "2020-02-21",
    "date_to": "2020-02-28",    
    "matched_records_percentage" : 85,
    "app_id": "com.cost.app",
    "status": "Applied",
    "Uploaded request url": "https://domain/file.json"
}

{ 
      "id": "com.cost.app",

"status": "Failed",

      "Uploaded request url": "https://domain/file2.json",

"error" : [ {

      "af_error_code": “ic211”,

       "error_message" : "Incorrect date format. Use the format yyyy-mm-dd."

}

パートナーアカウント上で、以下アプリをテストに使用可能です。

• Android: com.cost.app
• iOS: id888123456

コスト連携をテストするには：

1. ［任意］End to Endでの計測テスト：
   1. 連携用に構成されたあなたのアドネットワークの計測リンクを使用して、テスト用アプリの計測リンクを準備してください。 
   2. コストデータとクリックデータを一致させるために、campaign、adset、ad IDを含めた状態でクリックのアトリビューショントラフィックを生成してください。
   3. 連携用に構成されたあなたのアドネットワークの計測リンクを使用して、テストアプリ用のクリックを生成してください。実際のトラフィックであるかのように、マクロに実際の値を入れることを忘れないでください。
2. ［必須］ベーシックなコスト連携：
   1. テストデータを準備してください。
   2. InCost uploaderを使って、コストデータを送信してください。
   3. 返ってきたjob IDを記録してください。
   4. 2分待ってください
   5. エラーが見つからなかったことを確認してください。get job statusのメソッドを使用してください。
      注意：アトリビューショントラフィック(＝クリック)がないため、一致した行数のスコアが100未満になります。 
   6. エラーが見つかった場合には、データを修正して再送信してください。
   7. 5時間以内にコストデータが管理画面に表示されるので、データが正しいことを確認してください。

以下のエラーコードとメッセージが返されます。

• 広告主は、以下の手順に沿ってAppsFlyerの管理画面上でコストデータの取得 を有効にします。 
• 広告主は、アプリ毎に個別にコストデータの取得設定を有効にする必要があります。InCostを有効にしたアプリの一覧を取得するAPIを使って、コストデータの取得設定が 有効になっていることを確認してください。

アドネットワークからのコストデータの取得を有効にするには： 

1. AppsFlyerにて、[設定] > [連携済みパートナー] へ進みます。
2. 任意のアドネットワーク名を検索、選択してください。
3. コストタブへ移動してください。
   

   

4. コストデータの取得を有効にしてください。
   これにより、AppsFlyerはパートナーから送信されたコストデータを記録することが許可されます。 
   疑義を避けるため、広告主アカウントのAPI トークンはアドネットワークに共有しないでください。彼らにとって広告主アカウントのAPIトークンは不要です。