Intégration des produits parents

Qu'est-ce qu'un produit enfant ?

Certains produits ont des relations parentales. Il y a un produit parent, puis plusieurs variantes qui sont des produits enfants. Les annonceurs veulent optimiser les campagnes au niveau des produits enfants pour s'assurer que la promotion qui est faite de leurs produits soit la plus pertinente et la plus performante possible pour les clients.

D'autres produits n'ont pas ces relations et ne verront donc aucun changement ou impact sur la plateforme.

Capacités de l'interface utilisateur

Sélection de produits

Lors de la sélection des produits, les produits parents/enfants seront regroupés.

Vous pouvez cliquer sur un produit parent et les produits enfants apparentés seront présentés également. Cela permettra à vos annonceurs d’optimiser leur campagne en atteignant un niveau unique.

Rapports

Les rapports intégrés à la plateforme seront automatiquement regroupés par produit parent lorsqu'un produit aura une productCollection associée.

Dans les exportations CSV à partir de la plateforme, pour les codes produits, il y a une nouvelle colonne « Code parent », qui remplira la valeur productCollection .

Si vous filtrez par code produit dans l'interface utilisateur, les métriques du produit parent sont vides et vous pouvez cliquer sur le produit parent pour afficher les rapports relatifs à tous les produits enfants.

Exigences d'intégration

Mise à jour des produits

Lorsque vous synchronisez des produits avec CitrusAd, il y a un nouveau champ productCollection dans la requête POST pour vos produits.

POST $BASE_URL/v1/catalog-products?teamId=<YOUR_TEAM_ID> HTTP/1.1 
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogProducts": [
        {
            "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
            "gtin": "23556578965543",
            "productCollection": "abc-123",
            "inventory": 50,
            "price": "19.99",
            "tags": [
                 "imageurl:https://your.image.host.com/image.jpg","name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL"
            ],
            "filters": [
                 "category:Health&Beauty","category:Grocery","Brand:Covergirl","Special_Flag:0"
            ]
        }
    ]

Lorsque ce champ est présent, les tableaux de sélection et de rapport des produits seront regroupés au niveau de la collection de produits pour tous les produits qui sont de la même productCollection.

Si vous effectuez une synchronisation par fichier, vous pouvez remplir une colonne product_collection par produit.

Rendu de l'annonce

Aucune modification n'est nécessaire pour le rendu des annonces émises à partir de CitrusAd. Le gtin que vous recevez dans la réponse de l'API sera celui du produit « enfant », et il faudra que ce soit diffusé sur votre site web.