Aperçu de haut niveau
Dans le cadre de cette intégration, vous devrez effectuer les opérations suivantes
- Implémenter une demande d'annonce supplémentaire pour l'emplacement des ventes croisées par catégorie.
- Cela comprend le travail de positionnement et de rendu des publicités sur votre site, ainsi que l'établissement de rapports sur les clics et les impressions
- Les commandes doivent être fournies à CitrusAd dans le cadre de votre intégration standard
- Si vous synchronisez les ID de catégorie avec CitrusAd, vous devrez utiliser l’API filterMapping pour fournir des valeurs lisibles par l’homme pour la sélection de la catégorie de l’interface utilisateur
- Cela ne s'applique que si vous êtes intégré(e) aux ID de catégorie au lieu de noms. (par exemple, lorsque vous demandez des annonces, vos filtres sont
category:123j-dsef-erplutôt quecategory:Milk
- Cela ne s'applique que si vous êtes intégré(e) aux ID de catégorie au lieu de noms. (par exemple, lorsque vous demandez des annonces, vos filtres sont
- (Conseillé) - Synchronisez les mappages de ventes croisées par catégorie pour automatiser l'approbation et réduire le chargement de la gestion des campagnes.
Requête d'annonce et intégration du site
Demande d'annonce
Comme la vente croisée par catégorie nécessite un emplacement autonome, vous devrez intégrer une requête d'annonce supplémentaire par type d'annonce pour lequel vous intégrez la vente croisée par catégorie.
Le format de votre requête doit correspondre à celui de la requête d'annonces de ventes croisées, comme indiqué ci-dessous
- Annonce de produit - requête d'annonces de vente croisée par catégorie
- Bannière publicitaire - requête d'annonces de vente croisée par catégorie
- Bannière X - requête d'annonces de vente croisée par catégorie
Comptabiliser les impressions et les clics
Une fois que vous avez intégré votre requête d'annonce, vous devez également vous assurer que vous comptabilisez correctement les clics et les impressions pour chaque annonce affichée. Assurez-vous de bien lire Comptabiliser les impressions et les clics.
Comptabiliser les commandes
En général, la plupart des intégrations transmettent toutes les informations relatives aux commandes à CitrusAd, conformément à une intégration standard. Vous devez vous assurer que vous comptabilisez correctement toutes les commandes à CitrusAd, conformément aux Données de commande.
Mappages des filtres
Le point de terminaison de mappage de filtre peut être utilisé pour mapper vos ID de catégorie en valeurs lisibles par l'homme. Ceci est nécessaire si vous synchronisez les ID de catégorie car l'interface utilisateur affiche les valeurs à vos utilisateurs.
Si vous synchronisez les catégories lisibles par l'homme dans votre catalogue de produits avec CitrusAd, cette étape ne sera pas requise.
Les utilisateurs ne comprendront pas category:12345-abcde est. L'API filterMapping peut être utilisée pour faire correspondre la valeur au nom de la catégorie correspondante sur votre site, par exemple category:Pantry.
Il n'existe aucune méthode basée sur des fichiers pour synchroniser ces informations, cela doit se faire via l'API filterMapping.
Au fur et à mesure que vous créez des catégories supplémentaires sur votre site, vous devez vous assurer que l'API filterMapping est utilisée pour mettre à jour les catégories.
Mappages de ventes croisées par catégorie (conseillé)
Lors de l'intégration de ce type d'emplacement, il est vivement conseillé de fournir un mappage des catégories autorisées à se cibler mutuellement. Cela permet de rationaliser vos opérations après les premiers travaux d'intégration. L'expérience des annonceurs est rationalisée pour ne permettre que la sélection des catégories déjà autorisées.
En outre, il est également possible de configurer l'approbation automatique pour les campagnes de ventes croisées par catégorie, lorsque des mappages de vente croisée sont fournis.
Méthodes d'intégration
- Vous pouvez utiliser l'API crossSellCategory pour créer et gérer des mappages selon vos besoins.
- Vous pouvez également fournir un fichier TSV à une base de données GCS hébergée par CitrusAd dans le format indiqué ci-dessous.
Intégration d'API
Vous trouverez toutes les informations nécessaires dans la référence API de crossSellCategory.
Intégration de fichiers
En cas d'intégration par fichier, CitrusAd exige un fichier par catalogue, dont les catégories sont autorisées à se cibler entre elles.
Chaque ligne du fichier représente un mappage unique d'une catégorie et la catégorie qu'elle peut cibler. Chaque mappage est unidirectionnel (si vous synchronisez chocolat > lait, les produits chocolatés peuvent apparaître dans la catégorie lait. Si les produits laitiers doivent apparaître sur le chocolat (et qu'une ligne supplémentaire est requise).
Nous avons besoin d'un flux de données au format TSV correspondant aux spécifications ci-dessous :
| Nom de la colonne | Obligatoire | Type de données | Description | Exemple |
|---|---|---|---|---|
category | Obligatoire | Texte | Il s'agit d'un ID de catégorie unique identifiant la catégorie du produit annoncé. | category:cookies |
cross_category_id | Obligatoire | Texte | Il s'agit d'un ID de catégorie unique qui identifie une catégorie admissible dans laquelle les produits de category_id peuvent être vendus de manière croisée. | category:milk |
Les spécifications supplémentaires des fichiers sont les suivantes :
- Seuls les fichiers TSV sont pris en charge
- Le TSV doit être en LF et non CRLF
- Le TSV doit être encodé en UTF-8, tout type entraînera l'échec du flux
- Convention de dénomination requise :
^cross_sell_category.*.tsv$
Voici un exemple d'extrait de code :
| Catégorie | cross_category_id |
|---|---|
| category:cookies | category:milk |
| category:cookies | category:chocolate |
| category:milk | category:cookies |
Cet extrait ci-dessus permet à la catégorie cookies de réaliser des ventes croisées dans les catégories lait et chocolat. La catégorie lait peut effectuer des ventes croisées dans la catégorie cookies. La catégorie chocolat peut être ciblée, mais ne peut pas cibler d'autres catégories.
Chaque ligne est une combinaison de mappage unique
Vous devez synchroniser des lignes uniques pour chaque mappage unique de ventes croisées par catégorie. Si vous tentez de synchroniser plusieurs cross_category_id sur une seule ligne, l'ingestion du fichier échouera.
Processus d'activation des fonctionnalités
Une fois que vous êtes prêt(e) à synchroniser votre flux de termes de recherche suggérés, CitrusAd vous configure un compartiment GCS dans lequel déposer vos fichiers.
Cette fonctionnalité n'est prise en charge que sur les compartiments GCS. Les compartiments externes comme AWS/Azure/other ne sont pas pris en charge.
Votre responsable de compte technique pourra vous guider dans l'activation de cette fonctionnalité. L'équipe d'exploitation de la plateforme CitrusAd devant procéder à une configuration, veuillez noter qu'il y a un délai d'exécution supplémentaire pour l'activation.