> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/ja/generating-ads/banner-x-responsive/companion-products-banner-x.md).

# コンパニオン商品

{% hint style="info" %}
ベータ機能

この機能は現在ベータ版であり、変更される可能性があります。改善に役立てるため、フィードバックをお寄せいただくことをお勧めします。
{% endhint %}

同梱商品コンポーネントを使用すると、ブランドはバナーと一緒に購入可能な商品の順序付きリストを選択できます。これらをバナー内に描画することで、顧客がバナー内で直接買い物できるようになります。これにより、バナーのエンゲージメント向上とCTRの改善につながる可能性があります。

<figure><img src="/files/3hLrlaA4P0T8zHZ09rcp" alt="" width="100%"><figcaption></figcaption></figure>

## 仕様

* **同梱商品**セクションで利用可能な商品は、前の**商品**キャンペーン作成段階で選択されたものに限定されます。
* 各枠に対して、必要な**同梱商品**の数を指定できます。
* **同梱商品**はキャンペーン作成時に希望の順序に並べ替えることができ、この順序は広告レスポンス内で保持されます。

## 同梱商品の統合

同梱商品により、ブランドはバナーと一緒に購入可能な商品の順序付きリストを選択できるようになります。

### 統合する前に

* 同梱商品をサポートするために、バナー X レスポンス内の新しいフィールドの解析方法を更新します。
* 動画広告と一緒に同梱商品を統合する場合は、選択した動画プレーヤーをサイトまたはモバイルアプリに選択または統合します。
* 動画広告および同梱商品を追加するためのフィールドは、動画と商品の同梱が設定されているキャンペーンに対してのみ入力されます。有効化は統合が完了した後にのみ行われます。
* プレビューアを更新して、新しい同梱商品および動画機能を描画できるようにします。

### 同梱商品の広告レスポンス例

キャンペーンに同梱商品が設定されている場合、以下が表示されます `companionProducts` オブジェクトが返されました。

```
{
  "ads": [
    {
      "contentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
      "slotId": "Top_Banner",
      "banners": [
        {
          "citrusAdId": "shotgun_8SvgA7OvvuwtZkkOKR0vr8AXMvQKFgoURmluZ2VybGltZTI2LWZkeHZxMjcSABoMCO30r70GEKPplJQCIgIIAQ==",
          "citrusCampaignName": "Ads:74-330-96832622ed499dafb3da8de8b76340a2",
          "citrusContentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
          "citrusSlotId": "Top_Banner",
          "citrusExpiry": "2025-02-12T01:33:33.579155107Z",
          "headingText": "recusandae 3205",
          "bannerText": "placeat 2825",
          "bannerTextColour": "ffffff",
          "ctaFlag": true,
          "ctaText": "CTA text",
          "ctaTextAccessibility": "call to action accessibility text",
          "ctaLink": http://citrusad.com,
          "backgroundColour": "000000",
          "backgroundImage": https://dev3.flavedo.io./citrus/8de07ed9-60b4-4611-8bd5-3f1f0c0b6be4,
          "secondaryBackgroundImage": https://dev3.flavedo.io./citrus/b7a70785-1366-42c6-8134-c7fe47a30c34,
          "secondaryBackgroundImagePosition": "rightaligned",
          "heroImage": https://dev3.flavedo.io./citrus/26798ca9-1022-422d-9100-1a3687c88372,
          "heroImageAltText": "hero image alt text",
          "secondaryHeroImage": https://dev3.flavedo.io./citrus/c4ee18b4-bf51-44d7-9eb6-eeb1dc4c422f,
          "secondaryHeroImageAltText": "secondary hero image alt text",
          "secondaryHeroMode": "landscape",
          "tags": {},
          "additionalFields": [
            {
              "id": "text-1",
              "value": "sed 5731"
            }
          ],
          "gtins": [
            "Fingerlime26-fdxvq27",
            "Oranges5-qgxeb6",
            "Cherries9-adkoj11",
            "Incaberries20-ppscn21",
            "Banana14-simfk15"
          ],
          "sellerId": "seller_id_772_659",
          "position": 1,
          "metadata": {
            "advertiserInfo": {
             "advertiser": "Bob's advertising agency",
             "onBehalfOf": "Brand company inc"
            }
          },
          "companionProducts": [
            "Banana14-simfk15"
            "Oranges5-qgxeb6",
            "Incaberries20-ppscn21",
          ]
        }
      ]
    }
  ]
}
```


---

# 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://help.citrusad.com/retail-media-interface/integration/ja/generating-ads/banner-x-responsive/companion-products-banner-x.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.