Skip to main content

Overview

Create a 300×250 image banner and request it through the Decision API. Complete the Quickstart by checking the ad image, landing URL, and tracking identifier in an HTTP 200 response. Use an administrator account to create an advertiser, then configure a House ad, an image banner, and On Ad Response impression tracking. Use the ID of the AdUnit you create in requests.

Before you start

Obtain the test environment details from your deployment contact. Prepare the following items. Create the advertiser and ad in the steps below. Stay signed in as the administrator throughout; you do not need to sign in as the advertiser. Creating an order deducts its budget from the advertiser’s balance, so use the environment agreed for testing. The ad request in this exercise does not require an access token. Use the following names and settings. Work through advertiser → AdUnit → creative → order and line item → creative association → inventory allocation. Send only this exercise’s requests to the new AdUnit, and do not connect other ads or experiments to it.

Create an advertiser

Open Advertisers > Add Advertiser, enter these values, and select Register. Open Quickstart advertiser from the list and confirm its Active status. Use this advertiser for the exercise’s order and creative.

Prepare an AdUnit

Open AdUnits > Add AdUnit, enter the following settings, and register it. A new AdUnit is Active by default. Allocate the ad directly to this AdUnit without creating a Placement.
Ad and Recommendation options in the AdUnit creation form

Choose Ad as the AdUnit type.

Create an ad

1

Create a banner creative

In Creatives > New Creative, choose Banner and advertiser Quickstart advertiser in Type Selection, then select Next.
Banner creative type and the exercise advertiser selected together

Select Banner and the advertiser you created in the Type Selection step.

Enter the following values in Details and save.Activate the creative on its detail page. You will associate it after creating the order and line item.
2

Create an order and a House line item

Open Orders > Add Order, enter the following values, save, then Activate it.Confirm that the order is Active. An order groups line items. Next, open Orders > Quickstart order > Add Line Item to create a line item under this order.
Line item creation steps, ad type options, House selection, and Creation Summary

Select House when creating the line item. The Creation Summary also shows the selected ad type.

Immediately after creation, select Activate on the detail page and confirm the Ready status.House ads are for your own promotions and do not require a target impression count or line item budget. See Ad types for the differences between line item types. Allocate only this line item to the exercise’s AdUnit.
3

Associate the creative with the line item

In Ad Creatives > Link Creative, select the Quickstart creative you created earlier and link it. The association period is set to the line item’s period automatically. After saving, enable the row’s Link Status switch.Check creative activation and association activation separately.
4

Allocate and publish the ad

In Quickstart line item, open Inventory Assignment > + Add inventory assignment and use these settings.
The Quickstart banner selected as the allocation target with On Ad Response tracking

Select the Quickstart banner and keep On Ad Response impression tracking.

Save with Add assignment. From the allocation row’s actions, select Request approval, then Publish, and confirm each action. Verify the Published allocation status.After the line item’s start time passes, confirm that it is Delivering before continuing. Successfully saving the configuration does not make the ad available before its start time.
Congratulations! You have created and allocated your sample ad in Ad Manager. Next, use the AdUnit ID to request an ad through the Decision API and inspect the response.

Request an ad

Find the ID for requests Open Quickstart banner under AdUnits, then copy Settings > Basic Information > ID. Use this UUID as tagid in the request path. Do not substitute its display name, code quickstart_banner, or a line item ID.
The AdUnit UUID and copy button in Settings > Basic Information

Use the copy button next to ID in Settings > Basic Information. The code below it is a different value.

Replace <A2_API_URL> and <tagid> in the example and run it once in your terminal. See the Ad Request API reference for the request and response specification.

Inspect the response

An HTTP 200 response looks like this. This example shows the complete image banner response structure; only the long ext.ad_log value is shortened with .... Actual values vary by environment and request.
Response
HTTP 204 means no eligible ad was returned. Follow If no ad is returned and request the ad again.
With on_ad_response, A2 records an impression when it generates an ad response. This terminal response counts as one impression. Do not send an additional imp event.
Congratulations! You have received your first ad response from the Decision API. Once you have checked the ad image, landing URL, and ext.ad_log, your Quickstart is complete.

Troubleshooting

If no ad is returned

Check in this order.
  1. Use the AdUnit ID, rather than its code, in the request.
  2. Confirm the AdUnit is Active and its allocation is Published.
  3. Confirm the line item’s start time has passed and it is within its period.
  4. Match both AdUnit and banner creative sizes to 300×250.
  5. Confirm both the creative and its association are Active.
  6. Check for custom targeting, frequency caps, experiments, or other conditions outside this exercise.

Next steps

To display the banner and verify clicks and metrics, continue with the optional Web Integration Tutorial. Copy and save the shared HTML template from the page, then enter your server URL and AdUnit ID. To apply ads in your service, continue with Ad Event Tracking to record impressions, clicks, and conversions.