> ## 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.

# Conversions mobiles

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">
  ## Présentation de MACT
</div>

La mesure de la [promotion d’app mobile](https://biz.x.com/mobile-app-promotion) sur X permet aux annonceurs de suivre le succès des campagnes publicitaires sur X conçues pour générer des installations ou d’autres conversions in‑app. Un partenaire X de mesure mobile offre à un annonceur la possibilité de gérer les conversions qu’il souhaite suivre à partir des apps qu’il promeut sur X. Une fois que l’annonceur a défini le type et les fenêtres temporelles des événements qu’il veut suivre, le partenaire de mesure mobile enverra tous ces événements à X et recevra immédiatement des données d’attribution indiquant la campagne et la création publicitaire avec lesquelles l’utilisateur a interagi pour générer la conversion.

<div id="conversion-events">
  ### Événements de conversion
</div>

Pour pouvoir signaler un [événement de conversion](https://developer.x.com/en/docs/x-ads-api/measurement/api-reference/conversion-event) à X et obtenir des données d’attribution, le partenaire doit envoyer l’id de l’App mobile, le type et l’horodatage de la conversion, ainsi qu’une valeur hachée de l’id publicitaire/de l’appareil. Le fait de fournir ces données permet d’enregistrer l’événement de conversion sur la plateforme de X et de renvoyer les données d’attribution lorsque cela est approprié. De plus, l’annonceur peut choisir de fournir des métadonnées supplémentaires sur l’événement de conversion, comme la valeur d’un achat, l’id d’un produit ou une méthode d’inscription.

<div id="api-reference">
  ## Référence de l’API
</div>

<div id="conversion-event">
  ### Événement de conversion
</div>

<Button href="https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87">
  Exécuter dans Postman
</Button>

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

Enregistrer un événement de conversion pour la mesure mobile. La réponse indiquera une attribution X ou X Audience Platform (TAP).

Cela est lié à l’endpoint [GET conversion\_attribution](https://developer.x.com/en/docs/x-ads-api/measurement/api-reference/conversion-attribution#get-conversion-attribution).

Une attribution X, TAP ou aucune attribution sera indiquée dans la réponse. Le nœud `twitter_attribution` sera toujours présent et aura la valeur `null` lorsqu’il n’y a pas d’attribution X (voir l’exemple de réponse ci‑dessous). Si une attribution TAP est indiquée, un nœud `tpn_attribution` sera présent et renseigné en conséquence. Veuillez consulter la [présentation de TAP](https://developer.x.com/en/docs/x-ads-api/measurement/overview/twitter-audience-platform) pour plus d’informations.

Plusieurs paramètres optionnels sont disponibles pour définir les métadonnées associées à chaque événement de conversion. Ces métadonnées n’ont aucun effet sur les calculs d’attribution.

<div id="resource-url">
  ##### URL de la ressource
</div>

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

<div id="parameters">
  ##### Paramètres
</div>

| Name                                             | Description                                                                                                                                                                                                                                                                                                                                                                                  |
| :----------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| app\_id  <br />*required*                        | L’identifiant unique correspondant dans le magasin d’applications.<br /><br />Type : int, string<br /><br />Exemple : `333903271`, `com.vine.android`                                                                                                                                                                                                                                        |
| conversion\_time  <br />*required*               | L’heure de l’événement de conversion au format d’horodatage ISO-8601, avec les millisecondes ajoutées.<br /><br />Type : string<br /><br />Exemple : `2014-05-22T02:38:28.103Z`                                                                                                                                                                                                              |
| conversion\_type  <br />*required*               | Le type d’événement de conversion.<br /><br />Type : enum<br /><br />Valeurs possibles : `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*             | L’IDFA ou l’AdID haché avec HMAC\_SHA-256.<br /><br />Type : string<br /><br />Exemple : `ABCD1234XYZ`                                                                                                                                                                                                                                                                                       |
| os\_type  <br />*required*                       | Le type de système d’exploitation pour l’application.<br /><br />Type : enum<br /><br />Valeurs possibles : `IOS`, `ANDROID`                                                                                                                                                                                                                                                                 |
| click\_window  <br />*optional*                  | La fenêtre de clic pour cet événement, en jours.<br /><br />Type : int<br /><br />**Remarque** : `click_window` doit être supérieur ou égal à view\_through\_window<br /><br />Valeur par défaut : `14`  <br />Valeurs possibles : `1`, `7`, `14`, `30`                                                                                                                                      |
| device\_ip\_address  <br />*optional*            | Adresse IPv4 ou IPv6 de l’appareil au moment où l’événement de conversion s’est produit.<br /><br />Type : string<br /><br />Exemple : `192.133.78.1`                                                                                                                                                                                                                                        |
| level  <br />*optional*                          | Un niveau associé à cet événement.<br /><br />Type : int<br /><br />Exemple : `2`                                                                                                                                                                                                                                                                                                            |
| non\_twitter\_engagement\_time  <br />*optional* | L’heure du dernier engagement en dehors de X avant la conversion.<br /><br />Type : string<br /><br />Exemple : `2014-05-22T02:38:28.103Z`                                                                                                                                                                                                                                                   |
| non\_twitter\_engagement\_type  <br />*optional* | Le type d’engagement en dehors de X avant l’événement de conversion.<br /><br />Type : enum<br /><br />Valeurs possibles : `CLICK`, `VIEW`                                                                                                                                                                                                                                                   |
| number\_items  <br />*optional*                  | Nombre d’éléments associés à cet événement.<br /><br />Type : int<br /><br />Exemple : `2`                                                                                                                                                                                                                                                                                                   |
| price\_currency  <br />*optional*                | Doit être un code ISO 4217 indiquant la devise associée à cet événement.<br /><br />Type : String<br /><br />Exemples : `EUR`, `USD`, `JPY`                                                                                                                                                                                                                                                  |
| price\_micro  <br />*optional*                   | Un montant de prix associé à cet événement, en micro-unités.<br /><br />Type : int<br /><br />Exemple : `123450000`                                                                                                                                                                                                                                                                          |
| user\_payment\_info  <br />*optional*            | Une valeur booléenne indiquant si les informations de paiement de l’utilisateur sont stockées dans l’application associée à cet événement.<br /><br />Type : bool<br /><br />Valeurs possibles : `true` ou `false`                                                                                                                                                                           |
| view\_through\_window  <br />*optional*          | La fenêtre d’attribution après affichage pour cet événement, en jours.<br /><br />**Remarque** :<br /><br />`click_window` doit être supérieur ou égal à view\_through\_window.<br /><br />Type : int<br /><br />Valeur par défaut : `1`  <br />Valeurs possibles : `0`, `1`, `7`, `14`, `30`                                                                                                |

<div id="example-request">
  ##### Exemple de requête
</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`

<div id="example-response">
  ##### Exemple de réponse
</div>

```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">
  ### Tags d’événements d’App
</div>

<Button href="https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87">
  Exécuter dans Postman
</Button>

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

Récupérer les détails de certaines ou de toutes les balises d'événement d'app associées au compte actuel.

Elles définissent les fenêtres de conversion configurées pour chaque type de conversion dans le cadre du suivi des conversions d'app mobile.

<div id="resource-url">
  ##### URL de la ressource
</div>

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

<div id="parameters">
  ##### Paramètres
</div>

| Nom                                    | Description                                                                                                                                                                                                                                                                                                                                                                  |
| :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required*          | L'identifiant du compte utilisé. Apparaît dans le chemin de la ressource et est généralement un paramètre obligatoire pour toutes les requêtes de l'API Advertiser, à l'exception de [GET accounts](/fr/x-ads-api/campaign-management#accounts). Le compte spécifié doit être associé à l'utilisateur authentifié.<br /><br />Type: string<br /><br />Example: `18ce54d4x5t` |
| app\_event\_tag\_ids  <br />*optional* | Limite la réponse aux app event tags souhaités en spécifiant une liste d'identifiants séparés par des virgules. Jusqu'à 200 ID peuvent être fournis.<br /><br />Type: string<br /><br />Example: `jhp`                                                                                                                                                                       |
| count  <br />*optional*                | Indique le nombre d'enregistrements à récupérer par requête distincte.<br /><br />Type: int<br /><br />Default: `200`  <br />Min, Max: `1`, `1000`                                                                                                                                                                                                                           |
| cursor  <br />*optional*               | Indique un curseur pour obtenir la page de résultats suivante. Voir [Pagination](/fr/x-ads-api/introduction) pour plus d'informations.<br /><br />Type: string<br /><br />Example: `8x7v00oow`                                                                                                                                                                               |
| sort\_by  <br />*optional*             | Trie selon un attribut pris en charge, par ordre croissant ou décroissant. Voir [Sorting](/fr/x-ads-api/fundamentals/sorting) pour plus d'informations.<br /><br />Type: string<br /><br />Example: `created_at-asc`                                                                                                                                                         |
| with\_deleted  <br />*optional*        | Inclut les résultats supprimés dans votre requête.<br /><br />Type: boolean<br /><br />Default: `false`  <br />Possible values: `true`, `false`                                                                                                                                                                                                                              |
| with\_total\_count  <br />*optional*   | Inclut l'attribut de réponse `total_count`.<br /><br />**Note**: Ce paramètre et `cursor` sont exclusifs.<br /><br />**Note**: Les requêtes qui incluent `total_count` auront des limites de taux plus faibles, actuellement définies à 200 toutes les 15 minutes.<br /><br />Type: boolean<br /><br />Default: `false`  <br />Possible values: `true`, `false`              |

<div id="example-request">
  ##### Exemple de requête
</div>

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

<div id="example-response">
  ##### Exemple de réponse
</div>

```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>

Récupérer une balise d’événement d’app spécifique associée au compte en cours.

Elles définissent les fenêtres de conversion configurées pour chaque type de conversion dans le cadre du suivi des conversions d’app mobile.

##### URL de ressource

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

<div id="parameters">
  ##### Paramètres
</div>

| Nom                                   | Description                                                                                                                                                                                                                                                                                                                                                              |
| :------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required*         | Identifiant du compte concerné. Apparaît dans le chemin de la ressource et est généralement un paramètre requis pour toutes les requêtes de l’API Advertiser, à l’exception de [GET accounts](/fr/x-ads-api/campaign-management#accounts). Le compte spécifié doit être associé à l’utilisateur authentifié.<br /><br />Type : string<br /><br />Exemple : `18ce54d4x5t` |
| app\_event\_tag\_id  <br />*required* | Référence à la balise d’événement d’App utilisée dans la requête.<br /><br />Type : string<br /><br />Exemple : `jhp`                                                                                                                                                                                                                                                    |
| with\_deleted  <br />*optional*       | Inclure les résultats supprimés dans votre requête.<br /><br />Type : boolean<br /><br />Valeur par défaut : `false`  <br />Valeurs possibles : `true`, `false`                                                                                                                                                                                                          |

#### Exemple de requête

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

#### Exemple de réponse

```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>

Crée une nouvelle balise d’événement d’application associée au compte en cours.

<div id="resource-url">
  ##### URL de la ressource
</div>

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

<div id="parameters">
  ##### Paramètres
</div>

| Name                                                    | Description                                                                                                                                                                                                                                                                                                                                                                                  |
| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required*                           | L’identifiant du compte utilisé. Apparaît dans le chemin de la ressource et est généralement un paramètre requis pour toutes les requêtes de l’API Advertiser, à l’exception de [GET accounts](/fr/x-ads-api/campaign-management#accounts). Le compte spécifié doit être associé à l’utilisateur authentifié.<br /><br />Type : string<br /><br />Exemple : `18ce54d4x5t`                    |
| app\_store\_identifier  <br />*required*                | L’identifiant de l’App Store.<br /><br />Type : string<br /><br />Exemple : `com.twitter.android`                                                                                                                                                                                                                                                                                            |
| conversion\_type  <br />*required*                      | Le type d’événement de conversion.<br /><br />Type : enum<br /><br />Valeurs possibles : `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*                              | Le type de système d’exploitation pour l’application.<br /><br />Type : enum<br /><br />Valeurs possibles : `IOS`, `ANDROID`                                                                                                                                                                                                                                                                 |
| provider\_app\_event\_id  <br />*required*              | L’identifiant de la balise de conversion sur le site du fournisseur.<br /><br />Type : string<br /><br />Exemple : `provider_tag_j5394`                                                                                                                                                                                                                                                      |
| provider\_app\_event\_name  <br />*required*            | Le nom de la balise de conversion sur le site du fournisseur.<br /><br />Type : string<br /><br />Exemple : `provider_name_a4382`                                                                                                                                                                                                                                                            |
| deep\_link\_scheme  <br />*optional*                    | Indiquez l’URI de deep link pour l’application associée à cette balise.<br /><br />Type : string<br /><br />Exemple : `twitter://`                                                                                                                                                                                                                                                           |
| post\_engagement\_attribution\_window  <br />*optional* | La fenêtre d’attribution post-engagement pour ces événements.<br /><br />Type : int<br /><br />Valeur par défaut : 30  <br />Valeurs possibles : `1`, `7`, `14`, `30`                                                                                                                                                                                                                        |
| post\_view\_attribution\_window  <br />*optional*       | La fenêtre d’attribution post-view pour ces événements.<br /><br />Type : int<br /><br />Valeur par défaut : 1  <br />Valeurs possibles : `0`, `1`, `7`, `14`, `30`                                                                                                                                                                                                                          |
| retargeting\_enabled  <br />*optional*                  | Indique si le reciblage doit être activé pour cette balise d’événement d’application.<br /><br />Type : boolean<br /><br />Valeur par défaut : true  <br />Valeurs possibles : `true`, `false`                                                                                                                                                                                               |

<div id="example-request">
  ##### Exemple de requête
</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`

<div id="example-response">
  ##### Exemple de réponse
</div>

```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>

Supprime la balise d’événement d’App spécifiée pour le compte actuel.

<div id="resource-url">
  ##### URL de la ressource
</div>

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

##### Parameters

| Name                          | Description                                                                                                                                                                                                                                                                                                                                                                |
| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required* | L’identifiant du compte concerné. Apparaît dans le chemin de la ressource et est généralement un paramètre requis pour toutes les requêtes de l’API Advertiser, à l’exception de [GET accounts](/fr/x-ads-api/campaign-management#accounts). Le compte spécifié doit être associé à l’utilisateur authentifié.<br /><br />Type : string<br /><br />Exemple : `18ce54d4x5t` |
| id  <br />*required*          | Une référence à la balise d’événement d’app que vous utilisez dans la requête.<br /><br />Type : string<br /><br />Exemple : `jhp`                                                                                                                                                                                                                                         |

<div id="example-request">
  ##### Exemple de requête
</div>

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

<div id="example-response">
  ##### Exemple de réponse
</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">
  ### Listes d’App
</div>

<Button href="https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87">
  Lancer dans Postman
</Button>

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

Récupérer les détails de certaines ou de toutes les listes d’applications associées au compte actuel.

<div id="resource-url">
  ##### URL de la ressource
</div>

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

#### Paramètres

| Name                                 | Description                                                                                                                                                                                                                                                                                                                                                                                               |
| :----------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required*        | Identifiant du compte concerné. Apparaît dans le chemin de la ressource et est généralement un paramètre requis pour toutes les requêtes de l'API Advertiser, à l'exception de [GET accounts](/fr/x-ads-api/campaign-management#accounts). Le compte spécifié doit être associé à l'utilisateur authentifié.<br /><br />Type : string<br /><br />Exemple : `18ce54d4x5t`                                  |
| app\_list\_ids  <br />*optional*     | Limite la réponse aux seules listes d'applications souhaitées en spécifiant une liste d'identifiants séparés par des virgules. Jusqu'à 200 identifiants peuvent être fournis.<br /><br />Type : string<br /><br />Exemple : `wm7x`                                                                                                                                                                        |
| count  <br />*optional*              | Spécifie le nombre d'enregistrements à tenter de récupérer par requête.<br /><br />Type : int<br /><br />Valeur par défaut : `200`  <br />Min, Max : `1`, `1000`                                                                                                                                                                                                                                          |
| cursor  <br />*optional*             | Spécifie un curseur pour obtenir la page suivante de résultats. Voir [Pagination](/fr/x-ads-api/introduction) pour plus d'informations.<br /><br />Type : string<br /><br />Exemple : `8x7v00oow`                                                                                                                                                                                                         |
| sort\_by  <br />*optional*           | Trie selon un attribut pris en charge, par ordre croissant ou décroissant. Voir [Sorting](/fr/x-ads-api/fundamentals/sorting) pour plus d'informations.<br /><br />Type : string<br /><br />Exemple : `created_at-asc`                                                                                                                                                                                    |
| with\_deleted  <br />*optional*      | Inclut les résultats supprimés dans votre requête.<br /><br />Type : boolean<br /><br />Valeur par défaut : `false`  <br />Valeurs possibles : `true`, `false`                                                                                                                                                                                                                                            |
| with\_total\_count  <br />*optional* | Inclut l'attribut de réponse `total_count`.<br /><br />**Remarque** : Ce paramètre et `cursor` sont mutuellement exclusifs.<br /><br />**Remarque** : Les requêtes qui incluent `total_count` auront des limites de taux plus faibles, actuellement définies à 200 par tranche de 15 minutes.<br /><br />Type : boolean<br /><br />Valeur par défaut : `false`  <br />Valeurs possibles : `true`, `false` |

<div id="example-request">
  ##### Exemple de requête
</div>

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

<div id="example-response">
  ##### Exemple de réponse
</div>

```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>

Récupérer une App List spécifique associée au compte actuel.

<div id="resource-url">
  ##### URL de la ressource
</div>

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

<div id="parameters">
  ##### Paramètres
</div>

| Nom                             | Description                                                                                                                                                                                                                                                                                                                                                      |
| :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required*   | Identifiant du compte utilisé. Apparaît dans le chemin de la ressource et est généralement un paramètre requis pour toutes les requêtes de l’Ads API, à l’exception de [GET accounts](/fr/x-ads-api/campaign-management#accounts). Le compte spécifié doit être associé à l’utilisateur authentifié.<br /><br />Type : string<br /><br />Exemple : `18ce54d4x5t` |
| app\_list\_id  <br />*required* | Référence à la liste d’App avec laquelle vous interagissez dans la requête.<br /><br />Type : string<br /><br />Exemple : `28ukf`                                                                                                                                                                                                                                |
| with\_deleted  <br />*optional* | Inclure les résultats supprimés dans votre requête.<br /><br />Type : boolean<br /><br />Valeur par défaut : `false`  <br />Valeurs possibles : `true`, `false`                                                                                                                                                                                                  |

<div id="example-request">
  ##### Exemple de requête
</div>

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

<div id="example-response">
  ##### Exemple de réponse
</div>

```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>

Créer un objet `app_list` associé au compte actuel.

Il existe actuellement une limite de 100 objets `app_list` par `account_id` et de 500 applications par `app_list`.

<div id="resource-url">
  ##### URL de la ressource
</div>

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

<div id="parameters">
  ##### Paramètres
</div>

| Name                                      | Description                                                                                                                                                                                                                                                                                                                                                               |
| :---------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| account\_id  <br />*required*             | L'identifiant du compte concerné. Apparaît dans le chemin de la ressource et est généralement un paramètre requis pour toutes les requêtes de l'API Advertiser, à l'exception de [GET accounts](/fr/x-ads-api/campaign-management#accounts). Le compte spécifié doit être associé à l'utilisateur authentifié.<br /><br />Type: string<br /><br />Exemple : `18ce54d4x5t` |
| app\_store\_identifiers  <br />*required* | Les identifiants de l'App Store à inclure dans la `app_list`.<br /><br />Type: string<br /><br />Exemple : `com.twitter.android`                                                                                                                                                                                                                                          |
| name  <br />*required*                    | Le nom que vous donnerez à la `app_list`.<br /><br />Type: string<br /><br />Exemple : `My First App List`                                                                                                                                                                                                                                                                |

<div id="example-request">
  ##### Exemple de requête
</div>

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

<div id="example-response">
  ##### Exemple de réponse
</div>

```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>

Supprime la liste d’App indiquée, associée au compte actuel.

<div id="resource-url">
  ##### URL de la ressource
</div>

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

<div id="parameters">
  ##### Paramètres
</div>

| Nom                           | Description                                                                                                                                                                                                                                                                                                                                                               |
| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| account\_id  <br />*requis*   | L’identifiant du compte utilisé. Apparaît dans le chemin de la ressource et est généralement un paramètre requis pour toutes les requêtes de l’API Advertiser, à l’exception de [GET accounts](/fr/x-ads-api/campaign-management#accounts). Le compte spécifié doit être associé à l’utilisateur authentifié.<br /><br />Type : string<br /><br />Exemple : `18ce54d4x5t` |
| app\_list\_id  <br />*requis* | Une référence à la liste d’apps que vous utilisez dans la requête.<br /><br />Type : string<br /><br />Exemple : `28ukf`                                                                                                                                                                                                                                                  |

<div id="example-request">
  ##### Exemple de requête
</div>

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

<div id="example-response">
  ##### Exemple de réponse
</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">
  ### Configurations du fournisseur d'événements de l'App
</div>

<Button href="https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87">
  Exécuter dans 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 "Lien permanent vers ce titre")
</div>

Récupérer les détails relatifs à certaines ou à l’ensemble des configurations de fournisseur d’événements d’application (configuration principale pour le suivi des conversions d’applications mobiles) associées au compte actuel.

<div id="resource-url">
  ##### URL de la ressource
</div>

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

<div id="parameters">
  ##### Paramètres
</div>

| Nom                                  | Description                                                                                                                                                                                                                                                                                                                                                                             |
| :----------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required*        | L’identifiant du compte utilisé. Apparaît dans le chemin de la ressource et est généralement un paramètre requis pour toutes les requêtes de l’API Advertiser, à l’exception de [GET accounts](/fr/x-ads-api/campaign-management#accounts). Le compte spécifié doit être associé à l’utilisateur authentifié.<br /><br />Type: string<br /><br />Exemple: `18ce54d4x5t`                 |
| count  <br />*optional*              | Spécifie le nombre d’enregistrements à récupérer par requête distincte.<br /><br />Type: int<br /><br />Valeur par défaut: `200`  <br />Min, Max: `1`, `1000`                                                                                                                                                                                                                           |
| cursor  <br />*optional*             | Spécifie un curseur pour obtenir la page de résultats suivante. Voir [Pagination](/fr/x-ads-api/introduction) pour plus d’informations.<br /><br />Type: string<br /><br />Exemple: `8x7v00oow`                                                                                                                                                                                         |
| ids  <br />*optional*                | Restreint la réponse aux seules configurations souhaitées en spécifiant une liste d’identifiants séparés par des virgules. Jusqu’à 200 identifiants peuvent être fournis.<br /><br />Type: string<br /><br />Exemple: `25n`                                                                                                                                                             |
| sort\_by  <br />*optional*           | Trie selon un attribut pris en charge, par ordre croissant ou décroissant. Voir [Sorting](/fr/x-ads-api/fundamentals/sorting) pour plus d’informations.<br /><br />Type: string<br /><br />Exemple: `created_at-asc`                                                                                                                                                                    |
| with\_deleted  <br />*optional*      | Inclut les résultats supprimés dans votre requête.<br /><br />Type: boolean<br /><br />Valeur par défaut: `false`  <br />Valeurs possibles: `true`, `false`                                                                                                                                                                                                                             |
| with\_total\_count  <br />*optional* | Inclut l’attribut de réponse `total_count`.<br /><br />**Remarque** : ce paramètre et `cursor` sont exclusifs.<br /><br />**Remarque** : les requêtes qui incluent `total_count` auront des limites de taux plus faibles, actuellement fixées à 200 par période de 15 minutes.<br /><br />Type: boolean<br /><br />Valeur par défaut: `false`  <br />Valeurs possibles: `true`, `false` |

<div id="example-request">
  ##### Exemple de requête
</div>

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

<div id="example-response">
  ##### Exemple de réponse
</div>

```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>

Récupérer un id spécifique de configuration de fournisseur d’événements (configuration principale pour Mobile Application Conversion Tracking) associée au compte en cours.

<div id="resource-url">
  ##### URL de la ressource
</div>

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

<div id="parameters">
  ##### Paramètres
</div>

| Nom                             | Description                                                                                                                                                                                                                                                                                                                                                                |
| :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required*   | L’identifiant du compte exploité. Apparaît dans le chemin de la ressource et est généralement un paramètre requis pour toutes les requêtes de l’API Advertiser, à l’exception de [GET accounts](/fr/x-ads-api/campaign-management#accounts). Le compte spécifié doit être associé à l’utilisateur authentifié.<br /><br />Type : string<br /><br />Exemple : `18ce54d4x5t` |
| id  <br />*required*            | Une référence à la configuration du fournisseur d’événements d’App avec laquelle vous travaillez dans la requête.<br /><br />Type : string<br /><br />Exemple : `25n`                                                                                                                                                                                                      |
| with\_deleted  <br />*optional* | Inclure les résultats supprimés dans votre requête.<br /><br />Type : boolean<br /><br />Valeur par défaut : `false`  <br />Valeurs possibles : `true`, `false`                                                                                                                                                                                                            |

<div id="example-request">
  ##### Exemple de requête
</div>

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

<div id="example-response">
  ##### Exemple de réponse
</div>

```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>

Créez une nouvelle configuration de fournisseur d’événements d’app associée au compte actuel. Un seul fournisseur MACT peut être associé à un compte publicitaire donné.

<div id="resource-url">
  ##### URL de la ressource
</div>

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

<div id="parameters">
  ##### Paramètres
</div>

| Nom                                           | Description                                                                                                                                                                                                                                                                                                                                                                         |
| :-------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*obligatoire*              | Identifiant du compte concerné. Apparaît dans le chemin d’accès à la ressource et est généralement un paramètre obligatoire pour toutes les requêtes de l’API Advertiser, à l’exception de [GET accounts](/fr/x-ads-api/campaign-management#accounts). Le compte indiqué doit être associé à l’utilisateur authentifié.<br /><br />Type : string<br /><br />Exemple : `18ce54d4x5t` |
| provider\_advertiser\_id  <br />*obligatoire* | Identifiant de l’annonceur sur le site du fournisseur<br /><br />Type : string<br /><br />Exemple : `client1`                                                                                                                                                                                                                                                                       |

<div id="example-request">
  ##### Exemple de requête
</div>

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

<div id="example-response">
  ##### Exemple de réponse
</div>

```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>

Supprime la configuration du fournisseur d’événements d’application spécifiée pour le compte actuel.

<div id="resource-url">
  ##### URL de la ressource
</div>

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

<div id="parameters">
  ##### Paramètres
</div>

| Nom                           | Description                                                                                                                                                                                                                                                                                                                                                                    |
| :---------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id  <br />*required* | L'identifiant du compte concerné. Apparaît dans le chemin de la ressource et est généralement un paramètre obligatoire pour toutes les requêtes de l'API Advertiser, à l'exception de [GET accounts](/fr/x-ads-api/campaign-management#accounts). Le compte spécifié doit être associé à l'utilisateur authentifié.<br /><br />Type: string<br /><br />Exemple : `18ce54d4x5t` |
| id  <br />*required*          | Une référence à la configuration du fournisseur d'événements d'app utilisée dans la requête.<br /><br />Type: string<br /><br />Exemple : `e5g`                                                                                                                                                                                                                                |

<div id="example-request">
  ##### Exemple de requête
</div>

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

<div id="example-response">
  ##### Exemple de réponse
</div>

```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">
  ### Attribution des conversions
</div>

<Button href="https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87">
  Lancer dans Postman
</Button>

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

Interrogez X pour vérifier l’attribution de conversion sans enregistrer d’événement de conversion. La réponse indiquera l’attribution X.

Cela est lié à l’endpoint [POST conversion\_event](https://developer.x.com/en/docs/x-ads-api/measurement/api-reference/conversion-event#post-conversion-event).

Dans la réponse, l’attribution sera soit X, soit TAP, soit aucune attribution. Le nœud `twitter_attribution` sera toujours présent et aura la valeur `null` lorsqu’il n’y a pas d’attribution X, et sera renseigné comme indiqué dans l’exemple de réponse ci‑dessous. Si une attribution TAP est revendiquée, un nœud `tpn_attribution` sera présent et renseigné en conséquence. Reportez-vous à la [présentation de TAP](https://developer.x.com/en/docs/twitter-ads-api/measurement/twitter-audience-platform/overview) pour plus d’informations.

<div id="resource-url">
  ##### URL de la ressource
</div>

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

##### Parameters

| Name                                             | Description                                                                                                                                                                                                                                                                                                                                                                                  |
| :----------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| app\_id  <br />*required*                        | Identifiant unique auprès du magasin d’applications correspondant.<br /><br />Type : int, string<br /><br />Exemple : `333903271`, `com.vine.android`                                                                                                                                                                                                                                        |
| conversion\_time  <br />*required*               | L’heure de l’événement de conversion au format d’horodatage ISO-8601, avec les millisecondes incluses.<br /><br />Type : string<br /><br />Exemple : `2014-05-22T02:38:28.103Z`                                                                                                                                                                                                              |
| conversion\_type  <br />*required*               | Le type d’événement de conversion.<br /><br />Type : enum<br /><br />Valeurs possibles : `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*             | L’IDFA ou l’AdID haché avec HMAC\_SHA-256.<br /><br />Type : string<br /><br />Exemple : `ABCD1234XYZ`                                                                                                                                                                                                                                                                                       |
| os\_type  <br />*required*                       | Le type de système d’exploitation de l’application.<br /><br />Type : enum<br /><br />Valeurs possibles : `IOS`, `ANDROID`                                                                                                                                                                                                                                                                   |
| click\_window  <br />*optional*                  | La fenêtre de clic pour cet événement, en jours.<br /><br />Type : int<br /><br />Valeur par défaut : `14`  <br />Valeurs possibles : `1`, `7`, `14`, `30`                                                                                                                                                                                                                                   |
| extra\_device\_ids  <br />*optional*             | Un SHA256 du SHA1 de l’ID de l’appareil transmis dans `hashed_device_id`, plus tout ID d’appareil supplémentaire haché.<br /><br />Type : string<br /><br />Exemple : `ABCD1234XYZ`, `DCBA4321XYZ`                                                                                                                                                                                           |
| non\_twitter\_engagement\_time  <br />*optional* | L’heure de la dernière interaction hors de Twitter avant la conversion.<br /><br />Type : string<br /><br />Exemple : `2014-05-22T02:38:28.103Z`                                                                                                                                                                                                                                             |
| non\_twitter\_engagement\_type  <br />*optional* | Le type d’interaction hors de Twitter avant l’événement de conversion.<br /><br />Type : enum<br /><br />Valeurs possibles : `CLICK`, `VIEW`                                                                                                                                                                                                                                                 |
| view\_through\_window  <br />*optional*          | La fenêtre d’affichage pour cet événement, en jours.<br /><br />Type : int<br /><br />Valeur par défaut : `1`  <br />Valeurs possibles : `0`, `1`, `7`, `14`, `30`                                                                                                                                                                                                                           |

<div id="example-request">
  ##### Exemple de requête
</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`

<div id="example-response">
  ##### Exemple de réponse
</div>

```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
        }
      }
    }
```
