> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/nextdoor-conversion-api.md).

# Nextdoor Conversion API

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

[Nextdoor](https://nextdoor.com) propose un service de réseau social hyperlocal pour les quartiers.\
Avec cette destination, vous pouvez envoyer des données marketing sous forme d'événements ou de conversions à Nextdoor et obtenir une vue plus complète de leurs résultats publicitaires sur Nextdoor. Ceci est basé sur [Nextdoor Conversion API](https://adsmanager.help.nextdoor.com/namhelpcenter/s/article/About-the-Nextdoor-Conversion-API?language=en_US).

## Fonctionnalités clés

La destination Nextdoor Conversion API offre les fonctionnalités clés suivantes :

* **Structure des événements**: notre [Référence des événements](https://doc.commandersact.com/developers/tracking/events-reference) correspond [événements Nextdoor](https://adsmanager.help.nextdoor.com/namhelpcenter/s/article/Conversion-API-request-parameters?language=en_US), ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique** : les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Smart Mapping**: le mappage des données peut être réajusté à l'aide de vos champs définis dans le data layer.
* **Mappage des événements**: modifiez le mappage standard entre les événements Nextdoor et les vôtres ou ajoutez de nouveaux mappages.
* **Prise en charge des données multi-items** : les informations incluses dans le [item](https://doc.commandersact.com/developers/tracking/events-reference#item) le tableau est envoyé à Nextdoor.

## Configuration de la destination

{% hint style="info" %}
Avant de configurer cette destination, vous devez avoir accès à [Nextdoor Ads Manager](https://ads.nextdoor.com).
{% endhint %}

### Configuration

<table><thead><tr><th width="300">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>ID de l’annonceur</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre identifiant d'annonceur NAM dans <a href="https://ads.nextdoor.com/v2/login">Nextdoor Ads Manager</a>. Plus de détails sont disponibles en suivant ce <a href="https://adsmanager.help.nextdoor.com/namhelpcenter/s/article/Conversion-API-request-parameters?language=en_US">LIEN</a> (Voir <code>client_id</code>).</td></tr><tr><td><code>Jeton d'accès</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>L'identifiant de votre jeton d'accès, généré en accédant à <a href="https://ads.nextdoor.com/v2/login">Nextdoor Ads Manager</a>. Plus de détails sont disponibles en suivant ce <a href="https://adsmanager.help.nextdoor.com/namhelpcenter/s/article/About-the-Nextdoor-Conversion-API?language=en_US&#x26;parentTab=Campaign-performance">LIEN</a>.</td></tr><tr><td><code>Mappage des événements</code></td><td>Modifiez le mappage standard entre les événements Nextdoor et les vôtres ou ajoutez de nouveaux mappages. Les noms des événements Nextdoor doivent être l'un des suivants : <code>conversion</code>, <code>lead</code>, <code>purchase</code>, <code>sign_up</code> et <code>custom_conversion_X</code>, où <code>X</code> est un nombre de 1 à 10.</td></tr></tbody></table>

## Référence rapide

| Propriétés Commanders Act | Événements Nextdoor                  |
| ------------------------- | ------------------------------------ |
| `purchase`                | `purchase`                           |
| `generate_lead`           | `lead`                               |
| `sign_up`                 | `sign_up`                            |
| `[Tout événement]`        | `[Tout événement autorisé]` **\[1]** |

{% hint style="info" %}
**1.** Voir <mark style="color:bleue;">`Mappage des événements`</mark> dans [Configuration](#configuration) pour plus de détails.
{% endhint %}

## Mappages de champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.
{% endhint %}

<table><thead><tr><th width="440.6685580062746">Propriétés Commanders Act</th><th>Propriétés Nextdoor</th></tr></thead><tbody><tr><td><code>ID de l’annonceur</code></td><td><code>client_id</code></td></tr><tr><td>(<code>event_name</code>)</td><td><code>event_name</code> <strong>[1]</strong></td></tr><tr><td><code>context.event_id</code></td><td><code>event_id</code></td></tr><tr><td><code>context.event_timestamp</code></td><td><code>event_time</code> <strong>[2]</strong></td></tr><tr><td><code>partners.nextdoor.event_timezone</code></td><td><code>event_timezone</code></td></tr><tr><td><code>partners.nextdoor.action_source</code></td><td><code>action_source</code> <strong>[3]</strong></td></tr><tr><td><code>context.page.url</code></td><td><code>action_source_url</code></td></tr><tr><td><code>partners.nextdoor.delivery_optimization</code></td><td><code>delivery_optimization</code></td></tr><tr><td><code>partners.nextdoor.test_event</code></td><td><code>test_event</code></td></tr><tr><td><code>user.email</code></td><td><code>email</code> <strong>[4][5][6]</strong></td></tr><tr><td><code>user.phone</code></td><td><code>phone_number</code> <strong>[4][6][7]</strong></td></tr><tr><td><code>user.firstname</code></td><td><code>first_name</code> <strong>[4][5][6]</strong></td></tr><tr><td><code>user.lastname</code></td><td><code>last_name</code> <strong>[4][5][6]</strong></td></tr><tr><td><code>user.birthdate</code></td><td><code>date_of_birth</code> <strong>[4][6][8]</strong></td></tr><tr><td><code>user.street</code></td><td><code>street_address</code> <strong>[4][6]</strong></td></tr><tr><td><code>user.city</code></td><td><code>city</code> <strong>[4][6][9]</strong></td></tr><tr><td><code>user.state_short</code></td><td><code>state</code> <strong>[4][6][10]</strong></td></tr><tr><td><code>user.zipcode</code></td><td><code>zip_code</code> <strong>[4][6][11]</strong></td></tr><tr><td><code>user.country</code></td><td><code>country</code> <strong>[4][6][12]</strong></td></tr><tr><td><code>context.device.ip</code></td><td><code>client_ip_address</code> <strong>[4]</strong></td></tr><tr><td><code>partners.nextdoor.pixel_id</code></td><td><code>pixel_id</code> <strong>[4][13]</strong></td></tr><tr><td><code>partners.nextdoor.click_id</code></td><td><code>click_id</code> <strong>[4][14]</strong></td></tr><tr><td><code>ID</code></td><td><code>order_id</code> <strong>[15]</strong></td></tr><tr><td><code>devise</code> + <code>value</code></td><td><code>order_value</code> <strong>[15]</strong></td></tr><tr><td><code>partners.nextdoor.delivery_category</code></td><td><code>delivery_category</code> <strong>[15]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>ID</code> <strong>[16]</strong></td></tr><tr><td><code>items.X.product.name</code></td><td><code>content_name</code> <strong>[16]</strong></td></tr><tr><td><code>items.X.product.price</code></td><td><code>item_price</code> <strong>[16]</strong></td></tr><tr><td><code>items.X.quantity</code></td><td><code>quantity</code> <strong>[16]</strong></td></tr><tr><td><code>context.app.namespace</code></td><td><code>app_id</code> <strong>[17]</strong></td></tr><tr><td><code>context.device.ad_tracking_enabled</code></td><td><code>app_tracking_enabled</code> <strong>[17]</strong></td></tr><tr><td><code>context.device.os.name</code></td><td><code>platform</code> <strong>[17]</strong></td></tr><tr><td><code>context.app.version</code></td><td><code>app_version</code> <strong>[17]</strong></td></tr></tbody></table>

{% hint style="info" %}
**1.** Voir <mark style="color:bleue;">`Mappage des événements`</mark> dans [Configuration](#configuration) pour plus de détails.\
**2.** Automatiquement converti en [format ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).\
**3.** Lorsque le Smart Mapping <mark style="color:bleue;">Source d'action</mark> n'est pas défini, cette valeur est automatiquement définie à l'aide des informations suivantes, dans l'ordre de priorité présenté : 1. Champ Smart Mapping <mark style="color:bleue;">`Type d'expérience`</mark> 2. propriété <mark style="color:bleue;">`context.app`</mark> 3. Champ Smart Mapping <mark style="color:bleue;">`Type de conversion`</mark> .\
**4.** Défini dans <mark style="color:bleue;">`customer`</mark> objet.\
**5.** Format pré-haché en minuscules.\
**6.** Haché automatiquement via SHA256 lorsqu'il est fourni en texte clair.\
**7.** Le format pré-haché doit comporter exactement dix chiffres, sans aucun caractère spécial ni code pays international.\
**8.** Format pré-haché <mark style="color:bleue;">`YYYYMMDD`</mark> .\
**9.** Format pré-haché en minuscules, sans caractères spéciaux.\
**10.** Format pré-haché en minuscules et sous forme de [code d'abréviation ANSI à deux lettres](https://en.wikipedia.org/wiki/Federal_Information_Processing_Standard_state_code).\
**11.** Format pré-haché à cinq chiffres pour les États-Unis.\
**12.** Format pré-haché sous forme de [code ISO 3166-1 alpha-2 à deux caractères](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).\
**13.** Permet à Nextdoor de dédupliquer les événements pour un annonceur qui envoie des événements via à la fois le CAPI et le pixel, ce qui en fait une exigence souple pour une implémentation multi-pixel.\
**14.** C'est la même chose que <mark style="color:bleue;">`ndclid`</mark> paramètre attaché à l'URL de clic.\
**15.** Défini dans <mark style="color:bleue;">`custom`</mark> .\
**16.** Défini dans <mark style="color:bleue;">`custom.product_context.X`</mark> .\
**17.** Défini dans <mark style="color:bleue;">`app`</mark> .
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/nextdoor-conversion-api.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.