> 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 phase de revue finale et sera bientôt disponible.
{% endhint %}

[Nextdoor](https://nextdoor.com) exploite un service de réseau social hyperlocal pour les quartiers.\
En utilisant cette destination, vous pouvez envoyer des données marketing sous forme d'événements ou de conversions à Nextdoor et obtenir une vision 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 s'effectue automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique**: les informations sont hachées automatiquement conformément aux spécifications du partenaire.
* **Smart mapping**: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Mappage d'é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>Advertiser ID</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">LINK</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>Votre identifiant de jeton d'accès tel que 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">LINK</a>.</td></tr><tr><td><code>Correspondance des événements</code></td><td>Modifiez le mappage standard entre les événements de Nextdoor et les vôtres ou ajoutez de nouveaux mappages. Les noms d'é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 compris entre 1 et 10.</td></tr></tbody></table>

## Référence rapide

| Commanders Act Events | É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:bleu;">`Correspondance des événements`</mark> dans [Configuration](#configuration) pour plus de détails.
{% endhint %}

## Correspondances des champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Mappage intelligent](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>Advertiser ID</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>currency</code> + <code>valeur</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:bleu;">`Correspondance des événements`</mark> dans [Configuration](#configuration) pour plus de détails.\
**2.** Converti automatiquement dans [format ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).\
**3.** Lorsque Smart Mapping <mark style="color:bleu;">Source de l'action</mark> n'est pas défini, cette valeur est définie automatiquement en utilisant les informations suivantes dans l'ordre de priorité présenté : 1. champ Smart Mapping <mark style="color:bleu;">`Type d'expérience`</mark> 2. propriété <mark style="color:bleu;">`context.app`</mark> 3. champ Smart Mapping <mark style="color:bleu;">`Type de conversion`</mark> .\
**4.** Défini dans <mark style="color:bleu;">`customer`</mark> objet.\
**5.** Format pré-haché en minuscules.\
**6.** Haché automatiquement via SHA256 lorsqu’il est fourni en texte brut.\
**7.** Le format pré-haché doit comporter exactement dix chiffres, sans caractères spéciaux ni codes internationaux de pays.\
**8.** Format pré-haché <mark style="color:bleu;">`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é avec 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.** Cela permet à Nextdoor de dédupliquer les événements pour un annonceur qui envoie des événements à la fois via le CAPI et le pixel, ce qui le rend quasi indispensable pour une implémentation multi-pixel.\
**14.** C'est la même chose que <mark style="color:bleu;">`ndclid`</mark> paramètre attaché à l'URL de clic.\
**15.** Défini dans <mark style="color:bleu;">`personnalisé`</mark> .\
**16.** Défini dans <mark style="color:bleu;">`custom.product_context.X`</mark> .\
**17.** Défini dans <mark style="color:bleu;">`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, and the optional `goal` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/nextdoor-conversion-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.