# Google Conversion Adjustments

{% hint style="info" %}
Cette destination est actuellement en phase de revue finale et sera bientôt disponible.
{% endhint %}

[Google](https://about.google/) est une entreprise technologique multinationale spécialisée dans la publicité en ligne, la technologie des moteurs de recherche, le cloud computing et les logiciels informatiques. En tirant parti de [Google Ads API Upload Conversion Adjustments](https://developers.google.com/google-ads/api/docs/conversions/upload-adjustments), vous pouvez modifier les valeurs de conversions initialement signalées par d'autres moyens (par exemple via des tags client-side).

## Configuration de la destination

Pour ajuster une conversion, vous devez d'abord disposer d'une conversion action [configurée](https://support.google.com/google-ads/answer/1722054), et les conversions doivent avoir été signalées dans l'interface Google Ads.

{% hint style="info" %}
Google recommande d'attendre 24 heures après qu'une conversion a été signalée avant d'envoyer des ajustements. Cela évitera[`CONVERSION_NOT_FOUND`](https://developers.google.com/google-ads/api/reference/rpc/v14/ConversionAdjustmentUploadErrorEnum.ConversionAdjustmentUploadError#conversion_not_found)ou[`TOO_RECENT_CONVERSION`](https://developers.google.com/google-ads/api/reference/rpc/v14/ConversionAdjustmentUploadErrorEnum.ConversionAdjustmentUploadError#too_recent_conversion) les erreurs d'envoi. Attendez également 4 à 6 heures après avoir créé une [conversion action](https://support.google.com/google-ads/answer/6032150?sjid=6242609434917944234-EU) avant d'ajuster ses conversions afin d'éviter une [`TOO_RECENT_CONVERSION_ACTION`](https://developers.google.com/google-ads/api/reference/rpc/v14/ConversionAdjustmentUploadErrorEnum.ConversionAdjustmentUploadError#too_recent_conversion_action) erreur d'envoi.
{% endhint %}

{% hint style="info" %}
Pour identifier la conversion et lorsqu'un identifiant de transaction n'est pas fourni, cette destination tentera d'inclure le [`gclid`](https://support.google.com/google-ads/answer/9744275?hl=en) si sa valeur est fournie dans le <mark style="color:bleu;">`Google Click Id`</mark> champ (voir [Configuration](#configuration) pour plus de détails). Si cela n'est pas défini, les cookies suivants, dans l'ordre de priorité présenté, sont utilisés pour récupérer une valeur appropriée :

1. `_gcl_aw`
2. `_gcl_dc`
3. `_gac_[GA_PROPERTY_ID]`

En revanche, lorsqu'un identifiant de transaction est présent, à la fois le [`gclid`](https://support.google.com/google-ads/answer/9744275?hl=en) et <mark style="color:bleu;">`conversionDateTime`</mark> sont supprimés de la requête afin d'éviter l' [`GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET`](https://developers.google.com/google-ads/api/reference/rpc/v14/ConversionAdjustmentUploadErrorEnum.ConversionAdjustmentUploadError#gclid_date_time_pair_and_order_id_both_set) erreur d'envoi. Plus de détails sur toutes les erreurs d'envoi sont disponibles en suivant ce [LIEN](https://developers.google.com/google-ads/api/reference/rpc/v14/ConversionAdjustmentUploadErrorEnum.ConversionAdjustmentUploadError).
{% endhint %}

{% hint style="warning" %}
Les ajustements de conversion ne fonctionnent pas avec des [conversion actions](https://support.google.com/google-ads/answer/6032150?sjid=6242609434917944234-EU) dont le type est [`UNKNOWN`](https://developers.google.com/google-ads/api/reference/rpc/v14/ConversionActionTypeEnum.ConversionActionType#unknown) . En outre, les ajustements pour une conversion dont le clic a un <mark style="color:bleu;">`gbraid`</mark> ou <mark style="color:bleu;">`wbraid`</mark> au lieu d'un [`gclid`](https://support.google.com/google-ads/answer/1033981) échoueront avec une [`CONVERSION_NOT_FOUND`](https://developers.google.com/google-ads/api/reference/rpc/v14/ConversionAdjustmentUploadErrorEnum.ConversionAdjustmentUploadError#conversion_not_found) erreur d'envoi.
{% endhint %}

### Configuration

<table><thead><tr><th width="325">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Authentication</code></td><td><p><em><strong><code>Requis</code></strong></em></p><p>Vos identifiants Google Ads, tels que définis dans l’interface Commanders Act, selon : <code>Administration</code> ➜ <code>Connector Credentials</code> ➜ <code>Ajouter des identifiants de connecteur</code> ➜ <code>Google Ads</code></p></td></tr><tr><td><code>Mapping</code></td><td><em><strong><code>Requis</code></strong></em><br>Associez vos Google Ads Conversion Name(s), où des ajustements de valeur de conversion sont appliqués, aux event(s) Commanders Act en configurant votre <code>Google Ads Conversion Name</code><br>et <code>Your event name</code> . Au moins une ligne est requise. Les noms de conversion se trouvent dans l’interface Google Ads en suivant : <code>TOOLS &#x26; SETTINGS</code> ➜ <code>Measurement</code> ➜ <code>Conversions</code> ➜ <code>Conversion action</code>.<br>Si aucune conversion action n'est trouvée, l'event sera ignoré.</td></tr><tr><td><code>Google Click Id</code></td><td>Google click Id (gclid) associé à la conversion d'origine. Ce champ a la priorité sur les cookies associés.</td></tr><tr><td><code>Google Analytics Property Id</code></td><td>L'ID de suivi GA est une chaîne comme "UA-XXXXXX-Y" ou "G-XXXXXXXXXX" pour Google Analytics 4. Il est utilisé comme méthode alternative pour récupérer le <a href="https://support.google.com/google-ads/answer/9744275?hl=en"><code>gclid</code></a> à partir des cookies. Voir <a href="#destination-setup">Configuration de la destination</a> pour plus de détails.</td></tr></tbody></table>

## Mappings des champs

{% hint style="info" %}
L'identifiant de transaction (`id`) est requis dans l'une des conditions suivantes :

1. Le type de [conversion action](https://support.google.com/google-ads/answer/6032150?sjid=6242609434917944234-EU) est égal à <mark style="color:bleu;">`Website`</mark> <mark style="color:bleu;">/</mark> [`WEBPAGE`](https://developers.google.com/google-ads/api/reference/rpc/v14/ConversionActionTypeEnum.ConversionActionType#webpage) .
2. La conversion d'origine que vous ajustez s'est vu attribuer un identifiant de transaction.

Si <mark style="color:bleu;">`Transaction Adjusted Timestamp (adjustmentDateTime)`</mark> le champ "Smart Mapping" n'est pas défini, cette destination utilisera l'horodatage actuel pour définir la propriété Google <mark style="color:bleu;">`conversionAdjustments.0.adjustmentDateTime`</mark> .\
Les propriétés Google sont définies à partir du chemin <mark style="color:bleu;">`conversionAdjustments.0`</mark> <mark style="color:bleu;">.</mark>
{% endhint %}

<table><thead><tr><th width="345">Propriétés Commanders Act</th><th>Google Properties</th></tr></thead><tbody><tr><td><code>value</code></td><td><code>restatementValue.adjustedValue</code> <strong>[*]</strong></td></tr><tr><td><code>id</code></td><td><code>orderId</code> <strong>[1]</strong></td></tr><tr><td><code>currency</code></td><td><code>restatementValue.currencyCode</code></td></tr><tr><td><code>context.event_timestamp</code></td><td><code>gclidDateTimePair.conversionDateTime</code></td></tr><tr><td><code>Google Click Id</code><br><code>cookie _gcl_aw</code><br><code>cookie _gcl_dc</code><br><code>cookie _gac_[GA_PROPERTY_ID]</code></td><td><code>gclidDateTimePair.gclid</code> <strong>[2]</strong></td></tr></tbody></table>

{% hint style="info" %}

> **\*** Propriété obligatoire.\
> **1.** Ceci est requis lorsque des conditions spécifiques sont vérifiées. Voir [Mappings des champs](#field-mappings) pour plus de détails.\
> **2.** Voir [Configuration de la destination](#destination-setup) pour plus de détails.
> {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/google/google-conversion-adjustments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.