> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiderx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Retailer Quick Start

> Create your first ad placement in 5 minutes

## Goal of this guide

In 5 minutes:

* ✅ Create your first ad placement
* ✅ Check the placement tag
* ✅ Get ready to serve ads

***

## Prerequisites

<Note>
  **What you need**:

  * An A2 Retailer account (ask your Admin if you don't have one)
  * A website or app where ads will be shown
</Note>

***

## Step 1: Log in (1 min)

Open the A2 admin console.

```
https://{customer_id}.a2cloud.aiderx.app
```

<Tip>
  Your initial password is sent by email. Be sure to change it after your first login.
</Tip>

***

## Step 2: Create a placement (2 min)

Click the **Placement** menu in the left sidebar.

1. Click the **Create New Placement** button
2. **Select a category**: Choose Ads (ADS) or Recommendation (RECO)
3. **Select creative types**: Toggle the types you want, such as display, video, or native (multiple selections allowed)
4. Enter basic information:
   * **Placement name**: `main_top_banner`
   * **Width**: `1200`
   * **Height**: `120`
5. Click the **Save** button

<Tip>
  Include the location and size in the placement name so it's easy to find later.
</Tip>

***

## Step 3: Activate the placement (1 min)

New placements are **inactive** by default. In the placement list, click the placement you just created.

1. Turn on the **Activate** toggle in the placement detail settings
2. Save your changes

<Warning>
  Ads are not shown while a placement is inactive.
</Warning>

***

## Step 4: Check the placement tag (1 min)

On the placement detail page, check the **Placement ID (Tag ID)**.

Use this ID to integrate the SDK into your website.

```html theme={null}
<!-- Load the A2 SDK -->
<div id="a2-placement"></div>
<script src="https://{sdk_host}/a2.iife.js"></script>
<script>
  // Initialize the SDK
  let app = new A2_SDK.A2({
    base_url: "https://{edge_host}",
    port: 8000,
  });
  // Register the ad placement
  let placement = document.getElementById("a2-placement");
  app.register_ad("your-tagid", placement, 1200, 120, "fixed");
</script>
```

<Tip>
  `{sdk_host}` and `{edge_host}` vary by environment. Check the exact URLs with your Admin.
  Replace `your-tagid` with the Tag ID of the placement you created in Step 2.
</Tip>

***

## Done! 🎉

You've successfully created your first ad placement!

### Next steps

<CardGroup cols={2}>
  <Card title="Placement settings" icon="sliders" href="/guides/for-retailers/en/placement">
    Learn about detailed options such as placement size, responsiveness, and eCPM settings
  </Card>

  <Card title="External ad integration" icon="plug" href="/guides/for-retailers/en/ad-sources">
    Connect external ad networks such as SSPs
  </Card>

  <Card title="Allocation Review" icon="check-circle" href="/guides/for-retailers/en/allocation-review">
    Approve or reject advertisers' allocation requests
  </Card>

  <Card title="Performance Analytics" icon="chart-line" href="/guides/for-retailers/en/analytics">
    View impressions, clicks, and revenue by placement
  </Card>
</CardGroup>

***

## FAQ

<AccordionGroup>
  <Accordion title="Can I create multiple placements?">
    Yes, you can create multiple placements. However, the number of placements you can create may vary by plan. For details, see the [pricing page](https://aiderx.io/en/pricing). Each placement has a unique ID and is managed independently.
  </Accordion>

  <Accordion title="Can I change the placement size later?">
    Yes, you can change the size at any time in the placement settings. However, if ads are already allocated to it, it's a good idea to let the advertisers know.
  </Accordion>

  <Accordion title="Will ads show right away?">
    Creating a placement doesn't make ads show right away. An advertiser must create a campaign and request an allocation to this placement.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.