どのようにお手伝いできますか?

検索

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

  • 更新

概要：AppsFlyer の ROI360 の機能の一部である InCost API を使用することで、アドネットワークは広告のコストデータを AppsFlyer へ送信できるようになります。そうすることで、広告主に集計コストデータが提供され、あなたのアドネットワークの本当のパフォーマンスを理解してもらえるようになります。

InCost API について

InCost API は、アドネットワークが AppsFlyer へコストデータを送信するためのソリューションです。アドネットワークは、API を使用して広告の詳細なコストデータを AppsFlyer へ送信します。 AppsFlyer がそのデータを取り込んで処理するので、管理画面やレポート上で広告主やパートナーが利用できるようになります。

メリット

  • スムーズなコストレポートにより、広告主があなたのアドネットワークの本当のパフォーマンスを理解するのを助けます。コストデータがなければ、広告主は計測データの重要な部分を見逃してしまい、ROAS を正確に計測することができません。そのため、誤って他のメディアソースに投資し、収益に悪影響を及ぼす可能性があります。
  • 正確でリアルタイムなコスト計測を担保するこのソリューションで、 ROI を証明してください。
  • InCost API は迅速かつ簡単に実装でき、利用開始までの期間も短いです。また、最大で過去90日間のコストデータを送り返す機能など、データをいつどのように送信するかを完全に制御できます。
  • InCost APIでは、CPI（クリックURL経由でコスト情報を共有する場合は唯一対応）だけでなく、すべてのコスト形式をサポートしています。
  • Stand out in the AppsFlyer Partner Marketplace with a “Cost” badge that indicates this is a feature you support.

InCost API の実装

前提条件：InCost API の実装を行うには、以下の条件を満たす必要があります。

  • That 90% of campaigns contain the Campaign ID in attribution.
  • データの鮮度向上のために、1日に6回以上コストデータを送信できること。 The specific times are up to the ad network.
  • [If the ad network updates data retroactively] The ability to send data for the last 7 days every time, for increased data completion.

InCost API を実装して、コストデータの送信を始めるには：

  • 以下の手順に従ってください。
ステップ # Action 
1

InCost API連携の申請：

  1. パートナーアカウントで管理画面に入り、上部メニューの［ヘルプ］>［チームへのお問い合わせ / サポートチケットの提出］を選択してください。
    パートナーアシスタントのウィジェットが開きます。
  2. [コスト計測を有効にする(Enabling cost measurement)] を選択して、各種情報を送信してください。
    フォーム送信後にチケットが作成され、AppsFlyerのパートナーソリューションエンジニアから連絡があります。
2 あなたのアドネットワークの90%以上のトラフィックにおいて、計測データにキャンペーン階層の情報（af_c_id（キャンペーン ID）は必須、af_adset_id（アドセットID）、af_ad_id（アドID）は任意です）の情報が含まれていることを確認してください。
3 AppsFlyerの管理画面から APIトークンを取得してください。
4

API 認証ヘッダーで使用する APIトークンを開発担当者に共有し、以下の3つの APIを各指示に従って実装するよう依頼してください。

  1. https://dev.appsflyer.com/hc/reference/app-list-ad-nets-api-get
  2. InCost upload（コスト情報のアップロード）： JSON にどの項目を入力するかを開発担当者に伝えてください：
    • Mandatory fields must be populated. Meaning, don't send empty fields. 
    • メディアソースの項目は、そのアドネットワークアカウントに紐づけられているメディアソースのみに制限されます。 Get the list from your partner development manager.
    • コストデータの日付とアプリの日付を揃えるために、Get app permission APIで取得できるアプリ毎のタイムゾーンを考慮してください。
    • あなたのキャンペーントラフィックにおいてコスト計測の階層に含まれていない項目がある場合は、APIリクエストにも含めないでください。例：af_adset_id（広告セットID）/ af_adset（広告セット名）/ af_ad_id（広告ID） / af_ad（広告名）
  3. https://dev.appsflyer.com/hc/reference/incost-jobstatus-get
5

連携テスト：

  1. ステップ1から続くチケットスレッド内で、APIの実装が完了したことをAppsFlyerへ連絡し、実データではなくAPIテストに使用できる以下アプリの権限を付与してもらってください。
    • com.cost.app
    • id888123456
  2. パートナーアカウントで管理画面に入り、左メニューの連携 > Partner Marketplaceを選択し、自社媒体を選択してください。
  3. 連携設定をクリックしてください。
  4. テストアプリを1つ選択してください。
  5. 連携画面のコストタブを開いてください。
  6. コストデータを取得のトグルをオンにしてください。
  7. コストを保存をクリックしてください。
  8. 接続テストをクリックします。
    これでAPIが有効になります。
6 In the ticket thread (from step 1), confirm with AppsFlyer that your integration is operational.
7 連携完了後、広告主にAppsFlyer の連携ページのコストタブで、コストデータの取得を有効にしてもらってください。以降、コストデータの受信が開始されます。

Note

Best practice: only resend data for a given date if its cost has changed. You can send the last 7 days on every call, but you don't need to resend unchanged records.

InCost アップロード JSON の項目

Field 必須 Remarks
date Yes
  • Spend date
  • 形式：YYYY-MM-DD
  • 例：2019-12-30
app_id Yes
  • AppsFlyer プラットフォームに表示されてるアプリ ID
  • 形式：文字列250文字まで
  • 例： Android：com.app.name, iOS：id123456789
media_source Yes
  • AppsFlyer のアドネットワークパートナーアカウントが紐づいている、アドネットワークID（PID）
  • 形式：文字列50文字まで
  • 例：network_int
af_prt No*
  • Required for agency attribution and cost data. 
  • Agency name as it displays on the attribution link and is associated with the agency account in AppsFlyer. 
  • 形式：文字列50文字まで 
  • 計測しているキャンペーンの90%において、計測データにaf_c_id（キャンペーンID）が含まれていること。 
  • If cost data is resent for the same dates and af_prt is included in a subsequent API call when it was absent in the original, resulting in duplicated cost data.
campaign_id Yes
  • 例：agencya
  • 空 (empty) の文字列は送付しないでください。
  • 形式：文字列24文字まで
  • 例：123abc
campaign_name Yes
  • 形式：文字列100 文字まで
  • 例：my_campaign123
adset_id No*
  • adset_nameを送信する場合は必須です。
  • 代理店識別子は計測URL内のaf_prtのパラメータへ渡されており、代理店アカウント毎に一意な値を所有しています。
  • あなたのコストレポート側でadset_idをサポートしていない場合には、送信しないでください。
  • 形式：文字列24文字まで
  • 例：123A
adset_name No
  • この項目を送信する場合は、adset_idも送信する必要があります。
  • 形式：文字列100 文字まで
  • 例：my_adset_name
ad_id No*
  • ad_nameを送信する場合は、この項目も必須です。
  • 計測リンクで送信されるaf_adset_idパラメータと同じ値である必要があります
  • あなたのコストレポート側でadset_idをサポートしていない場合には、送信しないでください。
  • 形式：文字列24文字まで
  • 例：123AB
site_id No
  • 広告を表示している配信面毎のID
  • 形式：文字列24文字まで
ad_name No
  • この項目を送信する場合は、ad_idも送信する必要があります。
  • 形式：文字列100 文字まで
  • 例：Ad-name
geo No
  • コストに関連付けて記録された国情報
  • 可能であれば、広告が表示された国情報の送付が推奨です。
  • 形式： ISO 3166の2文字の国コード
  • 例：US, CN, ZA
currency Yes
  • Spend currency type
  • 形式： ISO 4217の3文字の通貨コード
  • 例： USD, EUR, ZAR
spend Yes
  • 指定した通貨単位におけるコスト金額 
  • 小数点以下5桁まで入力可能です。
  • 0 (ゼロ)の値も入力可能です。
  • マイナスの値は入力できません。
  • ,(区切り文字)をつけて送信しないでください。
  • 引用符をつけて値を送信しないでください。 
  • 形式：10進数
  • 値の例：1 / 1.2 / 1234.20
channel No
  • 計測リンクで送信されるaf_channel パラメータと同じ値である必要があります。
  • 形式：文字列20文字まで
  • 例：my_channel
keywords No
  • 形式：文字列100 文字まで
  • 例：abc app
reported_clicks No
  • Number of clicks reported by the network for this record.
  • Format: Non-negative integer.
  • AppsFlyerのPartner Marketplace上でも、InCost APIの連携が完了すれば「コスト」のバッジが付与されます。
  • Optional. If empty or omitted, reported as 0.
  • Decimal or negative values are rejected (error 422: Reported clicks can be positive integer).
reported_impressions No
  • Number of impressions reported by the network for this record.
  • Format: Non-negative integer.
  • 項目
  • Optional. If empty or omitted, reported as 0.
  • Decimal or negative values are rejected (error 422: Reported impression can be positive integer).
* この項目を送信する必要がある場合もあるので、必ず備考欄を参照してください。

Tags