子商品とは何ですか？

一部の商品には親子関係があります。親商品があり、複数のバリエーションが子商品となります。広告主は、子商品レベルでキャンペーンを最適化し、最も関連性が高く、最高のパフォーマンスを発揮する商品を顧客に確実に宣伝したいと考えています。

他の商品にはこれらの関係がないため、プラットフォームに変更や影響はありません。

UI 機能

商品選択

商品を選択すると、親/子商品がグループ化されます。

親商品をクリックすると、子商品が拡大表示されます。これにより、広告主はキャンペーン内の固有の子商品レベルに合わせて最適化できます。

レポート

インプラットフォームレポートでは、商品に productCollection が関連づけられている場合、自動的に親商品でグループ化されます。

プラットフォームからの CSV エクスポートでは、商品コード用に新しい [親コード] 列があり、これが productCollection 値を追加します。

UI で商品コードでフィルタリングすると、親商品の指標は空白になるので、親商品をクリックして子商品のレポートを表示できます。

統合の要件

商品の更新

商品をCitrusAdと同期させると、商品のPOSTリクエストに新しい productCollection フィールドが表示されます。

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"
            ]
        }
    ]

このフィールドが存在する場合、商品選択およびレポート表は、同じ内容のすべての商品の商品コレクションレベルで集計されます productCollection.

ファイルごとに同期している場合は、 product_collection 列があり、商品ごとに任意に入力することができます。

広告レンダリング

CitrusAdから広告をレンダリングする場合、必要な変更はありません。この gtin API 応答で受け取るのは「子」商品の応答で、これをWebサイトで顧客に表示する必要があります。