コンバージョンアトリビューション

GET conversion_attribution

Twitterをクエリして、コンバージョンイベントを記述せずにコンバージョンアトリビューションを確認します。応答はTwitterアトリビューションを示します。

これはPOST conversion_eventエンドポイントに関連します。

Twitter、TAP、またはアトリビューションなしが応答で要求されます。Twitterアトリビューションがない場合、twitter_attributionノードは常に存在し、nullの値が含まれ、次の応答例のように入力されます。TAPアトリビューションが要求されると、tpn_attributionノードが存在し、それに従って入力されます。詳細については、「TAPの概要」を参照してください。

リソースURL

https://ads-api.x.com/10/conversion_attribution

パラメーター

名前 説明
app_id
必須

対応するアプリストアに一意のID。

タイプ: 整数、文字列

例: 333903271com.vine.android

conversion_time
必須

ミリ秒が追加された、ISO-8601のタイムスタンプ形式によるコンバージョンイベントの時間。

タイプ: 文字列

例: 2014-05-22T02:38:28.103Z

conversion_type
必須

コンバージョンイベントのタイプ。

タイプ: 列挙

使用可能な値: ACHIEVEMENT_UNLOCKEDADDED_PAYMENT_INFOADD_TO_CARTADD_TO_WISHLISTCHECKOUT_INITIATEDCONTENT_VIEWINSTALLINVITELEVEL_ACHIEVEDLOGINPURCHASERATEDRESERVATIONRE_ENGAGESEARCHSHARESIGN_UPSPENT_CREDITSTUTORIAL_COMPLETEUPDATE

hashed_device_id
必須

HMAC_SHA-256でハッシュ化されたIDFAまたはAdID。

タイプ: 文字列

例: ABCD1234XYZ

os_type
必須

アプリのOSタイプ。

タイプ: 列挙

使用可能な値: IOSANDROID

click_window
任意

このイベントのクリック期間(日単位)。

タイプ: 整数

デフォルト: 14
使用可能な値: 171430
extra_device_ids
任意

hashed_device_idで渡された端末IDのSHA1のSHA256と、ハッシュ化された任意の追加の端末ID。

タイプ: 文字列

例: ABCD1234XYZDCBA4321XYZ

non_twitter_engagement_time
任意

コンバージョン前のTwitter以外の最後のエンゲージメント時間。

タイプ: 文字列

例: 2014-05-22T02:38:28.103Z

non_twitter_engagement_type
任意

コンバージョンイベント前のTwitter以外のエンゲージメントタイプ。

タイプ: 列挙

使用可能な値: CLICKVIEW

view_through_window
任意

このイベントのビュースルー期間(日単位)。

タイプ: 整数

デフォルト: 1
使用可能な値: 0171430

リクエストの例

GET https://ads-api.x.com/10/conversion_attribution?app_id=333903271&os_type=IOS&hashed_device_id=ABCD1234XYZ&conversion_type=INSTALL&conversion_time=2013-04-16T07:00:00.123Z&click_window=14&view_through_window=0

応答の例

{
  data:{
    "app_id":"333903271",
    "os_type":"IOS",
    "hashed_device_id":"ABCD1234XYZ",
    "conversion_type":"INSTALL",
    "partner_client_id":"123abc",
    "conversion_time":"2013-04-16T07:00:00.123Z",
    "click_window":14,
    "view_through_window":0,
    "extra_device_ids":null,
    "twitter_attribution":{
      "engagement_type":"VIEW",
      "engagement_time":"2013-04-16T07:00:00.123Z",
      "country_code":"US",
      "tweet_id":"383034667764441088",
      "attribution_type":"PROMOTED",
      "promoted_properties":{
        "campaign_id”: “54a21",
        "campaign_name":"Vine_Contest",
        "line_item_id":"23ab2d4"
      }
    }
  },
  "data_type":"conversion_attribution",
  "request":{
    "params":{
      "app_id":"333903271",
      "os_type":"IOS",
      "hashed_device_id":"ABCD1234XYZ",
      "conversion_time":"2013-04-16T07:00:00.123Z",
      "conversion_type":"INSTALL",
      "click_window":14,
      "view_through_window":0
    }
  }
}