> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# モバイルコンバージョン

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

<div id="mact-overview">
  ## MACT の概要
</div>

X の[モバイルアプリプロモーション](https://biz.x.com/mobile-app-promotion)の計測機能を利用すると、広告主は、インストールやその他のアプリ内コンバージョンの促進を目的として X 上で実施する広告キャンペーンの成果をトラッキングできます。X のモバイル測定パートナーは、広告主が X 上でプロモーションしているアプリについて、どのコンバージョンを計測するかを管理できるようにします。広告主が計測したいイベントの種類と計測期間を設定すると、モバイル測定パートナーはそれらすべてのイベントを X に送信し、コンバージョン発生につながったキャンペーンおよびクリエイティブを示すアトリビューションデータを即時に受け取ります。

<div id="conversion-events">
  ### Conversion Events
</div>

[conversion event](https://developer.x.com/en/docs/x-ads-api/measurement/api-reference/conversion-event) を X にレポートしてアトリビューションデータを取得するには、パートナーはモバイル App の ID、コンバージョンの種別 (type)、タイムスタンプに加えて、広告 ID／デバイス ID のハッシュ化された値を送信する必要があります。これらのデータを提供することで、X のプラットフォーム上にコンバージョンイベントが記録され、該当する場合にはアトリビューションが返されます。加えて、広告主は購入金額、商品の ID、登録方法など、コンバージョンイベントに関する追加のメタデータを任意で提供することもできます。

<div id="api-reference">
  ## APIリファレンス
</div>

<div id="conversion-event">
  ### コンバージョンイベント
</div>

<Button href="https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87">
  Postman で実行
</Button>

<div id="post-conversion_event">
  #### POST conversion\_event
</div>

モバイル計測のコンバージョンイベントを記録します。レスポンスには、X または X Audience Platform (TAP) のアトリビューションが示されます。

これは [GET conversion\_attribution](https://developer.x.com/en/docs/x-ads-api/measurement/api-reference/conversion-attribution#get-conversion-attribution) エンドポイントに対応しています。

レスポンスでは、X のアトリビューション、TAP のアトリビューション、またはいずれのアトリビューションも付与されない、のいずれかになります。`twitter_attribution` ノードは常に存在し、X のアトリビューションがない場合は値が `null` になります (以下のレスポンス例を参照してください) 。TAP のアトリビューションが付与される場合は、`tpn_attribution` ノードが存在し、適切な値が設定されます。詳細については [TAP overview](https://developer.x.com/en/docs/x-ads-api/measurement/overview/twitter-audience-platform) を参照してください。

各コンバージョンイベントに関連付けるメタデータを設定するために使用できるオプションパラメータがいくつかあります。これらのメタデータは、アトリビューション計算には影響しません。

##### リソースURL

`https://ads-api.x.com/12/conversion_event`

##### パラメーター

| Name                                             | Description                                                                                                                                                                                                                                                                                                                                                           |
| :----------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| app\_id  <br />*required*                        | 対応するアプリストアにおける一意の識別子。<br /><br />Type: int, string<br /><br />Example: `333903271`, `com.vine.android`                                                                                                                                                                                                                                                                |
| conversion\_time  <br />*required*               | コンバージョンイベントの発生時刻。ミリ秒付きの ISO-8601 タイムスタンプ形式。<br /><br />Type: string<br /><br />Example: `2014-05-22T02:38:28.103Z`                                                                                                                                                                                                                                                    |
| conversion\_type  <br />*required*               | コンバージョンイベントの種別。<br /><br />Type: enum<br /><br />Possible values: `PURCHASE`, `SIGN_UP`, `INSTALL`, `RE_ENGAGE`, `UPDATE`, `TUTORIAL_COMPLETE`, `RESERVATION`, `ADD_TO_CART`, `ADD_TO_WISHLIST`, `LOGIN`, `CHECKOUT_INITIATED`, `SEARCH`, `LEVEL_ACHIEVED`, `ACHIEVEMENT_UNLOCKED`, `CONTENT_VIEW`, `SHARE`, `INVITE`, `ADDED_PAYMENT_INFO`, `SPENT_CREDITS`, `RATED` |
| hashed\_device\_id  <br />*required*             | HMAC\_SHA-256 でハッシュ化された IDFA または AdID。<br /><br />Type: string<br /><br />Example: `ABCD1234XYZ`                                                                                                                                                                                                                                                                      |
| os\_type  <br />*required*                       | App の OS の種別。<br /><br />Type: enum<br /><br />Possible values: `IOS`, `ANDROID`                                                                                                                                                                                                                                                                                      |
| click\_window  <br />*optional*                  | このイベントに対するクリック計測期間 (日数) 。<br /><br />Type: int<br /><br />**Note**: `click_window` は view\_through\_window 以上である必要があります。<br /><br />Default: `14`  <br />Possible values: `1`, `7`, `14`, `30`                                                                                                                                                                        |
| device\_ip\_address  <br />*optional*            | コンバージョンイベント発生時のデバイスの IPv4 または IPv6 アドレス。<br /><br />Type: string<br /><br />Example: `192.133.78.1`                                                                                                                                                                                                                                                                   |
| level  <br />*optional*                          | このイベントに関連付けられたレベル。<br /><br />Type: int<br /><br />Example: `2`                                                                                                                                                                                                                                                                                                       |
| non\_twitter\_engagement\_time  <br />*optional* | コンバージョン前の、直近の X 以外でのエンゲージメントの時刻。<br /><br />Type: string<br /><br />Example: `2014-05-22T02:38:28.103Z`                                                                                                                                                                                                                                                               |
| non\_twitter\_engagement\_type  <br />*optional* | コンバージョンイベント前の、X 以外でのエンゲージメントの種別。<br /><br />Type: enum<br /><br />Possible values: `CLICK`, `VIEW`                                                                                                                                                                                                                                                                    |
| number\_items  <br />*optional*                  | このイベントに関連付けられたアイテム数。<br /><br />Type: int<br /><br />Example: `2`                                                                                                                                                                                                                                                                                                     |
| price\_currency  <br />*optional*                | このイベントに紐づく通貨を示す ISO 4217 コード。<br /><br />Type: String<br /><br />Examples: `EUR`,`USD`,`JPY`                                                                                                                                                                                                                                                                          |
| price\_micro  <br />*optional*                   | このイベントに関連付けられた価格 (マイクロ単位) 。<br /><br />Type: int<br /><br />Example: `123450000`                                                                                                                                                                                                                                                                                      |
| user\_payment\_info  <br />*optional*            | このイベントに関連付けられた App にユーザーの支払い情報が保存されているかどうかを示す boolean 値。<br /><br />Type: bool<br /><br />Possible values: `true` or `false`                                                                                                                                                                                                                                          |
| view\_through\_window  <br />*optional*          | このイベントのビュー計測期間 (日数) 。<br /><br />**Note**:<br /><br />`click_window` は view\_through\_window 以上である必要があります。<br /><br />Type: int<br /><br />Default: `1`  <br />Possible values: `0`, `1`, `7`, `14`, `30`                                                                                                                                                             |

<div id="example-request">
  ##### リクエスト例
</div>

`https://ads-api.x.com/12/conversion_event?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=1`

##### レスポンス例

```json theme={null}
    {
      "data": {
        "conversion_value_micro": 0,
        "view_through_window": 1,
        "tpn_attribution": null,
        "conversion_time": "2017-01-21T01:14:00.602Z",
        "click_window": 30,
        "limit_ad_tracking": false,
        "event_metadata": null,
        "non_twitter_engagement_type": null,
        "conversion_type": "INSTALL",
        "partner_client_id": "com.appname contact id",
        "app_id": "com.appname",
        "hashed_device_id": "lke1GZa3AseB343ZcCQq7svfHzLfuSqyYnE+Rf49MOI=",
        "twitter_attribution": {
          "country_code": "US",
          "engagement_time": "2017-01-21T01:13:00.602Z",
          "engagement_type": "CLICK",
          "attribution_type": "PROMOTED",
          "promoted_properties": {
            "campaign_id": "4ns44",
            "line_item_id": "3x44d",
            "publisher_app_id": "333903271"
            "account_id":"18ce11e3egb",
            "line_item_objective": "APP_INSTALLS",
            "campaign_name": null
          },
          "tweet_id": "11434635565377600"
        },
        "os_type": "ANDROID",
        "non_twitter_engagement_time": null
      },
      "request": {
        "params": {
          "version_number": "1",
          "app_id": "com.appname",
          "conversion_type": "INSTALL",
          "os_type": "ANDROID",
          "hashed_device_id": "lke1GZa3AseB343ZcCQq7svfHzLfuSqyYnE+Rf49MOI=",
          "conversion_time": "2017-01-21T01:14:00.602Z",
          "click_window": "30",
          "view_through_window": "1",
          "limit_ad_tracking": "false"
        }
      }
    }
```

<div id="app-event-tags">
  ### App イベントタグ
</div>

<Button href="https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87">
  Postman で実行
</Button>

<div id="get-accountsaccount_idapp_event_tags">
  #### GET accounts/:account\_id/app\_event\_tags
</div>

現在のアカウントに関連付けられている app event tag の一部またはすべての詳細を取得します。

これらのタグは、モバイルアプリコンバージョントラッキングにおいて、コンバージョンタイプごとに設定されるコンバージョンウィンドウを定義します。

<div id="resource-url">
  ##### リソース URL
</div>

`https://ads-api.x.com/12/accounts/:account_id/app_event_tags`

<div id="parameters">
  ##### Parameters
</div>

| Name                                   | Description                                                                                                                                                                                                                                                     |
| :------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required*          | 対象となるアカウントの識別子です。リソースのパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで一般的に必須のパラメータです。指定されたアカウントは認証済みユーザーに関連付けられている必要があります。<br /><br />Type: string<br /><br />Example: `18ce54d4x5t`                            |
| app\_event\_tag\_ids  <br />*optional* | コンマ区切りの識別子のリストを指定することで、レスポンスを希望する App イベントタグのみに絞り込みます。最大 200 個の ID を指定できます。<br /><br />Type: string<br /><br />Example: `jhp`                                                                                                                                   |
| count  <br />*optional*                | 各リクエストごとに取得を試みるレコード数を指定します。<br /><br />Type: int<br /><br />Default: `200`  <br />Min, Max: `1`, `1000`                                                                                                                                                         |
| cursor  <br />*optional*               | 次のページの結果を取得するためのカーソルを指定します。詳細は [Pagination](/ja/x-ads-api/introduction) を参照してください。<br /><br />Type: string<br /><br />Example: `8x7v00oow`                                                                                                                      |
| sort\_by  <br />*optional*             | サポートされている属性で、昇順または降順にソートします。詳細は [Sorting](/ja/x-ads-api/fundamentals/sorting) を参照してください。<br /><br />Type: string<br /><br />Example: `created_at-asc`                                                                                                           |
| with\_deleted  <br />*optional*        | リクエストに削除済みの結果を含めます。<br /><br />Type: boolean<br /><br />Default: `false`  <br />Possible values: `true`, `false`                                                                                                                                                |
| with\_total\_count  <br />*optional*   | `total_count` レスポンス属性を含めます。<br /><br />**Note**: このパラメータと `cursor` は排他的です。<br /><br />**Note**: `total_count` を含むリクエストには、現在 15 分あたり 200 に設定されている、より低いレート制限が適用されます。<br /><br />Type: boolean<br /><br />Default: `false`  <br />Possible values: `true`, `false` |

<div id="example-request">
  ##### リクエスト例
</div>

`GET https://ads-api.x.com/12/accounts/18ce54d4x5t/app_event_tags?app_event_tag_ids=jhp`

##### レスポンス例

```json theme={null}
    {
      "request": {
        "params": {
          "app_event_tag_ids": [
            "jhp"
          ],
          "account_id": "18ce54d4x5t"
        }
      },
      "next_cursor": null,
      "data": [
        {
          "provider_app_event_name": null,
          "app_store_identifier": "co.vine.android",
          "post_view_attribution_window": 1,
          "deep_link_scheme": "vine://",
          "id": "jhp",
          "retargeting_enabled": true,
          "conversion_type": "INSTALL",
          "created_at": "2016-12-08T07:49:58Z",
          "post_engagement_attribution_window": 14,
          "provider_app_event_id": null,
          "last_tracked_at": "2021-05-22T17:00:04Z",
          "status": "TRACKING",
          "updated_at": "2016-12-08T23:07:54Z",
          "os_type": "ANDROID",
          "deleted": false
        }
      ]
    }
```

<div id="get-accountsaccount_idapp_event_tagsapp_event_tag_id">
  #### GET accounts/:account\_id/app\_event\_tags/:app\_event\_tag\_id
</div>

現在のアカウントに紐づく特定の app event tag を取得します。

これらは、Mobile App Conversion Tracking において、各コンバージョン type ごとに設定されたコンバージョン ウィンドウを定義します。

<div id="resource-url">
  ##### リソース URL
</div>

`https://ads-api.x.com/12/accounts/:account_id/app_event_tags/:app_event_tag_id`

##### パラメーター

| Name                                  | Description                                                                                                                                                                                                                            |
| :------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required*         | レバレッジド・アカウントの識別子です。リソースのパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで通常必須のパラメーターです。指定されたアカウントは、認証済みユーザーに関連付けられている必要があります。<br /><br />Type: string<br /><br />Example: `18ce54d4x5t` |
| app\_event\_tag\_id  <br />*required* | リクエスト内で操作対象となる app event tag への参照です。<br /><br />Type: string<br /><br />Example: `jhp`                                                                                                                                                 |
| with\_deleted  <br />*optional*       | リクエストに削除済みの結果を含めます。<br /><br />Type: boolean<br /><br />Default: `false`  <br />Possible values: `true`, `false`                                                                                                                       |

#### リクエスト例

`GET https://ads-api.x.com/12/accounts/18ce54d4x5t/app_event_tags/jhp`

#### レスポンス例

```json theme={null}
    {
      "request": {
        "params": {
          "app_event_tag_id": "jhp",
          "account_id": "18ce54d4x5t"
        }
      },
      "data": {
        "provider_app_event_name": null,
        "app_store_identifier": "co.vine.android",
        "post_view_attribution_window": 1,
        "deep_link_scheme": "vine://",
        "id": "jhp",
        "retargeting_enabled": true,
        "conversion_type": "INSTALL",
        "created_at": "2016-12-08T07:49:58Z",
        "post_engagement_attribution_window": 14,
        "provider_app_event_id": null,
        "last_tracked_at": "2021-05-22T17:00:04Z",
        "status": "TRACKING",
        "updated_at": "2016-12-08T23:07:54Z",
        "os_type": "ANDROID",
        "deleted": false
      }
    }
```

<div id="post-accountsaccount_idapp_event_tags">
  #### POST accounts/:account\_id/app\_event\_tags
</div>

現在のアカウントに関連付けられた新しいアプリイベントタグを作成します。

<div id="resource-url">
  ##### リソース URL
</div>

`https://ads-api.x.com/12/accounts/:account_id/app_event_tags`

##### パラメーター

| Name                                                    | Description                                                                                                                                                                                                                                                                                                                                                           |
| :------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required*                           | 対象アカウントの識別子。リソースのパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで一般的に必須パラメーターです。指定されたアカウントは、認証済みユーザーに関連付けられている必要があります。<br /><br />Type: string<br /><br />Example: `18ce54d4x5t`                                                                                                                                      |
| app\_store\_identifier  <br />*required*                | アプリストアの識別子。<br /><br />Type: string<br /><br />Example: `com.twitter.android`                                                                                                                                                                                                                                                                                         |
| conversion\_type  <br />*required*                      | コンバージョンイベントの種別。<br /><br />Type: enum<br /><br />Possible values: `ACHIEVEMENT_UNLOCKED`, `ADDED_PAYMENT_INFO`, `ADD_TO_CART`, `ADD_TO_WISHLIST`, `CHECKOUT_INITIATED`, `CONTENT_VIEW`, `INSTALL`, `INVITE`, `LEVEL_ACHIEVED`, `LOGIN`, `PURCHASE`, `RATED`, `RESERVATION`, `RE_ENGAGE`, `SEARCH`, `SHARE`, `SIGN_UP`, `SPENT_CREDITS`, `TUTORIAL_COMPLETE`, `UPDATE` |
| os\_type  <br />*required*                              | App の OS 種別。<br /><br />Type: enum<br /><br />Possible values: `IOS`, `ANDROID`                                                                                                                                                                                                                                                                                       |
| provider\_app\_event\_id  <br />*required*              | プロバイダーのサイト上のコンバージョンタグの ID。<br /><br />Type: string<br /><br />Example: `provider_tag_j5394`                                                                                                                                                                                                                                                                           |
| provider\_app\_event\_name  <br />*required*            | プロバイダーのサイト上のコンバージョンタグの名前。<br /><br />Type: string<br /><br />Example: `provider_name_a4382`                                                                                                                                                                                                                                                                           |
| deep\_link\_scheme  <br />*optional*                    | このタグに関連付けられた App のディープリンク URI を指定します。<br /><br />Type: string<br /><br />Example: `twitter://`                                                                                                                                                                                                                                                                        |
| post\_engagement\_attribution\_window  <br />*optional* | これらのイベントのポストエンゲージメント用アトリビューションウィンドウを指定します。<br /><br />Type: int<br /><br />Default: 30  <br />Possible values: `1`, `7`, `14`, `30`                                                                                                                                                                                                                                   |
| post\_view\_attribution\_window  <br />*optional*       | これらのイベントのポストビュー用アトリビューションウィンドウを指定します。<br /><br />Type: int<br /><br />Default: 1  <br />Possible values: `0`, `1`, `7`, `14`, `30`                                                                                                                                                                                                                                    |
| retargeting\_enabled  <br />*optional*                  | この App イベントタグに対してリターゲティングを有効にするかどうかを指定します。<br /><br />Type: boolean<br /><br />Default: true  <br />Possible values: `true`, `false`                                                                                                                                                                                                                                  |

<div id="example-request">
  ##### リクエスト例
</div>

`POST https://ads-api.x.com/12/accounts/18ce54d4x5t/app_event_tags?app_store_identifier=com.twitter.android&os_type=ANDROID&conversion_type=PURCHASE&provider_app_event_id=abc123&provider_app_event_name=test-tag`

##### レスポンス例

```json theme={null}
    {
      "data": {
        "provider_app_event_name": "test-tag",
        "app_store_identifier": "com.twitter.android",
        "post_view_attribution_window": 1,
        "deep_link_scheme": "https://",
        "id": "3p3t",
        "retargeting_enabled": true,
        "conversion_type": "PURCHASE",
        "created_at": "2017-09-06T06:58:22Z",
        "post_engagement_attribution_window": 30,
        "provider_app_event_id": "abc123",
        "updated_at": "2017-09-06T06:58:22Z",
        "os_type": "ANDROID",
        "deleted": false
      },
      "request": {
        "params": {
          "provider_app_event_name": "test-tag",
          "app_store_identifier": "com.twitter.android",
          "account_id": "18ce54d4x5t",
          "conversion_type": "PURCHASE",
          "provider_app_event_id": "abc123",
          "os_type": "ANDROID"
        }
      }
    }
```

<div id="delete-accountsaccount_idapp_event_tagsid">
  #### DELETE accounts/:account\_id/app\_event\_tags/:id
</div>

現在のアカウントに属する指定の App イベントタグを削除します。

##### リソースURL

`https://ads-api.x.com/12/accounts/:account_id/app_event_tags/:id`

<div id="parameters">
  ##### Parameters
</div>

| Name                          | Description                                                                                                                                                                                                                             |
| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required* | レバレッジド・アカウントの識別子です。リソースのパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで原則として必須のパラメータです。指定されたアカウントは認証済みユーザーに関連付けられている必要があります。<br /><br />Type: string<br /><br />Example: `18ce54d4x5t` |
| id  <br />*required*          | リクエストで操作対象となる App Event Tag への参照です。<br /><br />Type: string<br /><br />Example: `jhp`                                                                                                                                                   |

<div id="example-request">
  ##### リクエスト例
</div>

`DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/app_event_tags/jhp`

<div id="example-response">
  ##### レスポンスの例
</div>

```json theme={null}
    {
      "data": {
        "provider_app_event_name": null,
        "app_store_identifier": "co.vine.android",
        "post_view_attribution_window": 1,
        "deep_link_scheme": "vine://",
        "id": "jhp",
        "retargeting_enabled": true,
        "conversion_type": "INSTALL",
        "created_at": "2016-12-08T07:49:58Z",
        "post_engagement_attribution_window": 14,
        "provider_app_event_id": null,
        "last_tracked_at": "2021-05-22T17:00:04Z",
        "status": "TRACKING",
        "updated_at": "2017-08-30T05:44:57Z",
        "os_type": "ANDROID",
        "deleted": true
      },
      "request": {
        "params": {
          "id": "jhp",
          "account_id": "5gvk9h"
        }
      }
    }
```

<div id="app-lists">
  ### App リスト
</div>

<Button href="https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87">
  Postman で実行する
</Button>

<div id="get-accountsaccount_idapp_lists">
  #### GET accounts/:account\_id/app\_lists
</div>

現在のアカウントに関連付けられている App リストの一部またはすべての詳細を取得します。

<div id="resource-url">
  ##### リソース URL
</div>

`https://ads-api.x.com/12/accounts/:account_id/app_lists`

#### Parameters

| Name                                 | Description                                                                                                                                                                                                                                                           |
| :----------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required*        | 利用するアカウントの識別子です。リソースのパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで通常、必須パラメータとなります。指定されたアカウントは、認証済みユーザーに関連付けられている必要があります。<br /><br />Type: string<br /><br />Example: `18ce54d4x5t`                                 |
| app\_list\_ids  <br />*optional*     | カンマ区切りの識別子のリストを指定することで、レスポンスを指定した App リストのみに絞り込みます。最大で 200 個の ID を指定できます。<br /><br />Type: string<br /><br />Example: `wm7x`                                                                                                                                          |
| count  <br />*optional*              | 各リクエストごとに取得を試みるレコード数を指定します。<br /><br />Type: int<br /><br />Default: `200`  <br />Min, Max: `1`, `1000`                                                                                                                                                               |
| cursor  <br />*optional*             | 結果の次のページを取得するためのカーソルを指定します。詳細は [Pagination](/ja/x-ads-api/introduction) を参照してください。<br /><br />Type: string<br /><br />Example: `8x7v00oow`                                                                                                                            |
| sort\_by  <br />*optional*           | サポートされている属性を指定し、昇順または降順でソートします。詳細は [Sorting](/ja/x-ads-api/fundamentals/sorting) を参照してください。<br /><br />Type: string<br /><br />Example: `created_at-asc`                                                                                                              |
| with\_deleted  <br />*optional*      | リクエストに削除済みの結果を含めます。<br /><br />Type: boolean<br /><br />Default: `false`  <br />Possible values: `true`, `false`                                                                                                                                                      |
| with\_total\_count  <br />*optional* | レスポンスに `total_count` 属性を含めます。<br /><br />**Note**: このパラメータと `cursor` は同時には使用できません。<br /><br />**Note**: `total_count` を含むリクエストはレート制限がより厳しくなり、現在は 15 分あたり 200 回に設定されています。<br /><br />Type: boolean<br /><br />Default: `false`  <br />Possible values: `true`, `false` |

<div id="example-request">
  ##### リクエスト例
</div>

`GET https://ads-api.x.com/12/accounts/18ce54d4x5t/app_lists?app_list_ids=wm7x`

##### レスポンス例

```json theme={null}
    {
      "request": {
        "params": {
          "app_list_ids": [
            "wm7x"
          ],
          "account_id": "18ce54d4x5t"
        }
      },
      "next_cursor": null,
      "data": [
        {
          "id": "wm7x",
          "name": "foo @ 14026528192426843"
        }
      ]
    }
```

<div id="get-accountsaccount_idapp_listsapp_list_id">
  #### GET accounts/:account\_id/app\_lists/:app\_list\_id
</div>

現在のアカウントに関連する特定の App リストを取得します。

<div id="resource-url">
  ##### リソース URL
</div>

`https://ads-api.x.com/12/accounts/:account_id/app_lists/:app_list_id`

##### パラメーター

| Name                            | Description                                                                                                                                                                                                                              |
| :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required*   | 対象アカウントを識別する ID です。リソースのパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで通常必須となるパラメーターです。指定されたアカウントは、認証済みユーザーに関連付けられている必要があります。<br /><br />Type: string<br /><br />Example: `18ce54d4x5t` |
| app\_list\_id  <br />*required* | リクエストで操作する App リストへの参照です。<br /><br />Type: string<br /><br />Example: `28ukf`                                                                                                                                                            |
| with\_deleted  <br />*optional* | 削除済みの結果を含めるかどうかを指定します。<br /><br />Type: boolean<br /><br />Default: `false`  <br />Possible values: `true`, `false`                                                                                                                      |

<div id="example-request">
  ##### リクエスト例
</div>

`GET https://ads-api.x.com/12/accounts/18ce54d4x5t/app_lists/28ukf`

##### レスポンス例

```json theme={null}
    {
      "data": {
        "name": "twitter @ 262689209670784",
        "id": "28ukf",
        "created_at": "2017-08-17T17:07:42Z",
        "updated_at": "2017-08-17T17:07:42Z",
        "deleted": false,
        "apps": [
          {
            "app_store_identifier": "com.twitter.android",
            "os_type": "Android"
          }
        ]
      },
      "request": {
        "params": {
          "app_list_id": "28ukf",
          "account_id": "18ce54d4x5t"
        }
      }
    }
```

<div id="post-accountsaccount_idapp_lists">
  #### POST accounts/:account\_id/app\_lists
</div>

現在のアカウントに関連付けられた `app_list` を作成します。

`account_id` ごとに `app_list` オブジェクトは最大 100 個まで、また `app_list` ごとに App は最大 500 個まで作成できます。

<div id="resource-url">
  ##### リソース URL
</div>

`https://ads-api.x.com/12/accounts/:account_id/app_lists`

<div id="parameters">
  ##### Parameters
</div>

| Name                                      | Description                                                                                                                                                                                                                           |
| :---------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| account\_id  <br />*required*             | 利用するアカウントを識別する ID です。リソースのパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで通常必須のパラメータです。指定したアカウントは認証済みユーザーに関連付けられている必要があります。<br /><br />Type: string<br /><br />Example: `18ce54d4x5t` |
| app\_store\_identifiers  <br />*required* | `app_list` に含めるアプリストアの識別子です。<br /><br />Type: string<br /><br />Example: `com.twitter.android`                                                                                                                                        |
| name  <br />*required*                    | `app_list` に割り当てる名前です。<br /><br />Type: string<br /><br />Example: `My First App List`                                                                                                                                                |

<div id="example-request">
  ##### リクエスト例
</div>

`POST https://ads-api.x.com/12/accounts/18ce54d4x5t/app_lists?name=app list&app_store_identifiers=com.twitter.android`

##### レスポンス例

```json theme={null}
    {
      "data": {
        "name": "app list",
        "id": "2a4um",
        "created_at": "2017-09-06T07:17:26Z",
        "updated_at": "2017-09-06T07:17:26Z",
        "deleted": false,
        "apps": [
          {
            "app_store_identifier": "com.twitter.android",
            "os_type": "Android"
          }
        ]
      },
      "request": {
        "params": {
          "app_store_identifiers": [
            "com.twitter.android"
          ],
          "name": "app list",
          "account_id": "18ce54d4x5t"
        }
      }
    }
```

<div id="delete-accountsaccount_idapp_listsapp_list_id">
  #### DELETE accounts/:account\_id/app\_lists/:app\_list\_id
</div>

現在のアカウントに関連付けられている指定された App リストを削除します。

##### リソースURL

`https://ads-api.x.com/12/accounts/:account_id/app_lists/:app_list_id`

##### パラメータ

| Name                            | Description                                                                                                                                                                                                                     |
| :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| account\_id  <br />*required*   | 対象アカウントの識別子です。リソースのパスに含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで、一般に必須パラメータとなります。指定したアカウントは、認証済みユーザーに紐づいている必要があります。<br /><br />Type: string<br /><br />Example: `18ce54d4x5t` |
| app\_list\_id  <br />*required* | このリクエストで操作する App リストを示します。<br /><br />Type: string<br /><br />Example: `28ukf`                                                                                                                                                  |

<div id="example-request">
  ##### リクエスト例
</div>

`DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/app_lists/28ukf`

<div id="example-response">
  ##### レスポンスの例
</div>

```json theme={null}
    {
      "data": {
        "name": "twitter @ 262689209670784",
        "id": "28ukf",
        "created_at": "2017-08-17T17:07:42Z",
        "updated_at": "2017-09-12T22:20:33Z",
        "deleted": true,
        "apps": [
          {
            "app_store_identifier": "com.twitter.android",
            "os_type": "Android"
          }
        ]
      },
      "request": {
        "params": {
          "app_list_id": "28ukf",
          "account_id": "18ce54d4x5t"
        }
      }
    }
```

<div id="app-event-provider-configurations">
  ### App イベントプロバイダー構成
</div>

<Button href="https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87">
  Postman で実行
</Button>

[ ❯]()

<div id="get-accountsaccount_idapp_event_provider_configurations">
  #### GET accounts/:account\_id/app\_event\_provider\_configurations[¶](#get-accounts-account-id-app-event-provider-configurations "Permalink to this headline")
</div>

現在のアカウントに関連付けられている app event provider configuration (Mobile Application Conversion Tracking のコア設定) の一部またはすべての詳細を取得します。

<div id="resource-url">
  ##### リソース URL
</div>

`https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations`

<div id="parameters">
  ##### Parameters
</div>

| Name                                 | Description                                                                                                                                                                                                                                                   |
| :----------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| account\_id  <br />*required*        | 対象となるアカウントの識別子です。リソースのパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで通常必須のパラメータです。指定されたアカウントは、認証済みユーザーに関連付けられている必要があります。<br /><br />Type: string<br /><br />Example: `18ce54d4x5t`                           |
| count  <br />*optional*              | 1 回のリクエストごとに取得を試みるレコード数を指定します。<br /><br />Type: int<br /><br />Default: `200`  <br />Min, Max: `1`, `1000`                                                                                                                                                    |
| cursor  <br />*optional*             | 次のページの結果を取得するためのカーソルを指定します。詳細は [Pagination](/ja/x-ads-api/introduction) を参照してください。<br /><br />Type: string<br /><br />Example: `8x7v00oow`                                                                                                                    |
| ids  <br />*optional*                | 識別子のカンマ区切りリストを指定して、レスポンスを指定した設定のみに絞り込みます。最大 200 個の ID を指定できます。<br /><br />Type: string<br /><br />Example: `25n`                                                                                                                                              |
| sort\_by  <br />*optional*           | サポートされている属性を基準に、昇順または降順でソートします。詳細は [Sorting](/ja/x-ads-api/fundamentals/sorting) を参照してください。<br /><br />Type: string<br /><br />Example: `created_at-asc`                                                                                                      |
| with\_deleted  <br />*optional*      | リクエストに削除済みの結果を含めます。<br /><br />Type: boolean<br /><br />Default: `false`  <br />Possible values: `true`, `false`                                                                                                                                              |
| with\_total\_count  <br />*optional* | レスポンスに `total_count` 属性を含めます。<br /><br />**注意**: このパラメータと `cursor` は排他的です。<br /><br />**注意**: `total_count` を含むリクエストには、現在 15 分あたり 200 に設定されている、より低いレート制限が適用されます。<br /><br />Type: boolean<br /><br />Default: `false`  <br />Possible values: `true`, `false` |

<div id="example-request">
  ##### リクエスト例
</div>

`GET https://ads-api.x.com/11/accounts/18ce54d4x5t/app_event_provider_configurations?ids=25n`

##### レスポンス例

```json theme={null}
    {
      "data": [
        {
          "provider_name": "Answers powered by Fabric",
          "id": "25n",
          "provider_advertiser_id": "54ac2766f0de9e1f7a00001a",
          "created_at": "2016-12-08T07:49:58Z",
          "provider_advertiser_identifier": "54ac2766f0de9e1f7a00001a",
          "updated_at": "2017-05-12T21:37:15Z",
          "deleted": false
        }
      ],
      "next_cursor": null,
      "request": {
        "params": {
          "ids": [
            "25n"
          ],
          "account_id": "18ce54d4x5t"
        }
      }
    }
```

<div id="get-accountsaccount_idapp_event_provider_configurationsid">
  #### GET accounts/:account\_id/app\_event\_provider\_configurations/:id
</div>

現在のアカウントに関連付けられているイベントプロバイダー構成 (Mobile Application Conversion Tracking のコア構成) の特定の id (識別子) を取得します。

<div id="resource-url">
  ##### リソース URL
</div>

`https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations/:id`

##### パラメーター

| Name                            | Description                                                                                                                                                                                                                               |
| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required*   | 対象となるアカウントを識別するための識別子です。リソースのパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで必須となるパラメーターです。指定したアカウントは認証済みユーザーに関連付けられている必要があります。<br /><br />Type: string<br /><br />Example: `18ce54d4x5t` |
| id  <br />*required*            | リクエスト内で操作対象とする app event provider configuration を参照するものです。<br /><br />Type: string<br /><br />Example: `25n`                                                                                                                              |
| with\_deleted  <br />*optional* | 削除済みの結果をリクエストに含めます。<br /><br />Type: boolean<br /><br />Default: `false`  <br />Possible values: `true`, `false`                                                                                                                          |

<div id="example-request">
  ##### リクエスト例
</div>

`GET https://ads-api.x.com/11/accounts/18ce54d4x5t/app_event_provider_configurations/25n`

##### レスポンス例

```json theme={null}
    {
      "data_type": "app_event_provider_configuration",
      "data": {
        "provider_name": "API McTestface",
        "id": "25n",
        "provider_advertiser_id": "123",
        "created_at": "2017-03-24T22:24:56Z",
        "provider_advertiser_identifier": "123",
        "updated_at": "2017-03-24T22:24:56Z",
        "deleted": false
      },
      "request": {
        "params": {
          "id": "25n",
          "account_id": "18ce54d4x5t"
        }
      }
    }
```

<div id="post-accountsaccount_idapp_event_provider_configurations">
  ##### POST accounts/:account\_id/app\_event\_provider\_configurations
</div>

現在のアカウントに関連付けられた新しいアプリイベントプロバイダー設定を作成します。特定の広告アカウントには、1 つの MACT プロバイダーしか関連付けることはできません。

<div id="resource-url">
  ##### リソース URL
</div>

`https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations`

<div id="parameters">
  ##### Parameters
</div>

| Name                                       | Description                                                                                                                                                                                                                          |
| :----------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required*              | レバレッジドアカウントの識別子です。リソースのパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで通常必須のパラメータです。指定されたアカウントは、認証済みユーザーに関連付けられている必要があります。<br /><br />Type: string<br /><br />Example: `18ce54d4x5t` |
| provider\_advertiser\_id  <br />*required* | プロバイダーのサイト上での広告主の識別子です。<br /><br />Type: string<br /><br />Example: `client1`                                                                                                                                                        |

<div id="example-request">
  ##### リクエスト例
</div>

`POST https://ads-api.x.com/11/accounts/18ce54d4x5t/app_event_provider_configurations?provider_advertiser_id=client1`

##### レスポンス例

```json theme={null}
    {
      "data": {
        "provider_name": "InternalTestProvider",
        "id": "e5g",
        "provider_advertiser_id": "client1",
        "created_at": "2017-08-30T05:40:07Z",
        "provider_advertiser_identifier": "client1",
        "updated_at": "2017-09-06T06:39:03Z",
        "deleted": false
      },
      "request": {
        "params": {
          "provider_advertiser_id": "client1",
          "account_id": "18ce54d4x5t"
        }
      }
    }
```

<div id="delete-accountsaccount_idapp_event_provider_configurationsid">
  #### DELETE accounts/:account\_id/app\_event\_provider\_configurations/:id\[¶]
</div>

現在のアカウントに属する指定されたアプリイベントプロバイダー設定を削除します。

<div id="resource-url">
  ##### リソース URL
</div>

`https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations/:id`

<div id="parameters">
  ##### Parameters
</div>

| Name                          | Description                                                                                                                                                                                                                           |
| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| account\_id  <br />*required* | 利用するアカウントの識別子です。リソースのパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで通常必須となるパラメーターです。指定されたアカウントは、認証済みユーザーに関連付けられている必要があります。<br /><br />Type: string<br /><br />Example: `18ce54d4x5t` |
| id  <br />*required*          | このリクエストで操作対象としている app event provider 構成を参照する id です。<br /><br />Type: string<br /><br />Example: `e5g`                                                                                                                                 |

<div id="example-request">
  ##### リクエスト例
</div>

`DELETE https://ads-api.x.com/11/accounts/18ce54d4x5t/app_event_provider_configurations/e5g`

##### レスポンス例

```json theme={null}
    {
      "data": {
        "provider_name": "InternalTestProvider",
        "id": "e5g",
        "provider_advertiser_id": "client1",
        "created_at": "2017-08-30T05:40:07Z",
        "provider_advertiser_identifier": "client1",
        "updated_at": "2017-08-30T05:40:26Z",
        "deleted": true
      },
      "request": {
        "params": {
          "id": "e5g",
          "account_id": "18ce54d4x5t"
        }
      }
    }
```

<div id="conversion-attribution">
  ### コンバージョンアトリビューション
</div>

<Button href="https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87">
  Postman で実行
</Button>

<div id="get-conversion_attribution">
  #### GET conversion\_attribution
</div>

コンバージョンイベントを書き込まずに、コンバージョンアトリビューションを確認するために X に問い合わせます。レスポンスには、X によるアトリビューションが示されます。

これは [POST conversion\_event](https://developer.x.com/en/docs/x-ads-api/measurement/api-reference/conversion-event#post-conversion-event) エンドポイントに対応します。

レスポンスでは、X、TAP、またはアトリビューションなしのいずれかが示されます。`twitter_attribution` ノードは常に存在し、X アトリビューションがない場合は `null` が設定され、下記の例のレスポンスのように値が設定されます。TAP アトリビューションが付与される場合は、`tpn_attribution` ノードが存在し、適切な値が設定されます。詳細については [TAP overview](https://developer.x.com/en/docs/twitter-ads-api/measurement/twitter-audience-platform/overview) を参照してください。

<div id="resource-url">
  ##### リソース URL
</div>

`https://ads-api.x.com/12/conversion_attribution`

<div id="parameters">
  ##### Parameters
</div>

| Name                                             | Description                                                                                                                                                                                                                                                                                                                                                           |
| :----------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| app\_id  <br />*required*                        | 対応するアプリストアにおける一意の識別子。<br /><br />Type: int, string<br /><br />Example: `333903271`, `com.vine.android`                                                                                                                                                                                                                                                                |
| conversion\_time  <br />*required*               | ISO-8601 タイムスタンプ形式 (ミリ秒付き) でのコンバージョンイベントの発生時刻。<br /><br />Type: string<br /><br />Example: `2014-05-22T02:38:28.103Z`                                                                                                                                                                                                                                                 |
| conversion\_type  <br />*required*               | コンバージョンイベントの種別。<br /><br />Type: enum<br /><br />Possible values: `ACHIEVEMENT_UNLOCKED`, `ADDED_PAYMENT_INFO`, `ADD_TO_CART`, `ADD_TO_WISHLIST`, `CHECKOUT_INITIATED`, `CONTENT_VIEW`, `INSTALL`, `INVITE`, `LEVEL_ACHIEVED`, `LOGIN`, `PURCHASE`, `RATED`, `RESERVATION`, `RE_ENGAGE`, `SEARCH`, `SHARE`, `SIGN_UP`, `SPENT_CREDITS`, `TUTORIAL_COMPLETE`, `UPDATE` |
| hashed\_device\_id  <br />*required*             | HMAC\_SHA-256 でハッシュ化された IDFA または AdID。<br /><br />Type: string<br /><br />Example: `ABCD1234XYZ`                                                                                                                                                                                                                                                                      |
| os\_type  <br />*required*                       | App の OS の種別。<br /><br />Type: enum<br /><br />Possible values: `IOS`, `ANDROID`                                                                                                                                                                                                                                                                                      |
| click\_window  <br />*optional*                  | このイベントのクリック計測ウィンドウ (日数) 。<br /><br />Type: int<br /><br />Default: `14`  <br />Possible values: `1`, `7`, `14`, `30`                                                                                                                                                                                                                                                  |
| extra\_device\_ids  <br />*optional*             | `hashed_device_id` で渡された device ID に対しまず SHA1 を適用し、その結果をさらに SHA256 でハッシュ化した値と、追加のハッシュ化済み device ID。<br /><br />Type: string<br /><br />Example: `ABCD1234XYZ`, `DCBA4321XYZ`                                                                                                                                                                                          |
| non\_twitter\_engagement\_time  <br />*optional* | コンバージョン前の直近の Twitter 以外のエンゲージメントの時刻。<br /><br />Type: string<br /><br />Example: `2014-05-22T02:38:28.103Z`                                                                                                                                                                                                                                                           |
| non\_twitter\_engagement\_type  <br />*optional* | コンバージョンイベント前の Twitter 以外のエンゲージメントの種別。<br /><br />Type: enum<br /><br />Possible values: `CLICK`, `VIEW`                                                                                                                                                                                                                                                               |
| view\_through\_window  <br />*optional*          | このイベントのビュースルー計測ウィンドウ (日数) 。<br /><br />Type: int<br /><br />Default: `1`  <br />Possible values: `0`, `1`, `7`, `14`, `30`                                                                                                                                                                                                                                            |

<div id="example-request">
  ##### リクエスト例
</div>

`GET https://ads-api.x.com/12/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`

##### レスポンス例

```json theme={null}
    {
      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
        }
      }
    }
```