Amazon Ads
A Ruby client for the Amazon Ads API.
Installation
Add to your Gemfile:
gem "amazon-ads"Or install directly:
gem install amazon-adsConfiguration
Set your app credentials at the module level or via environment variables:
AmazonAds.client_id = "your_client_id"
AmazonAds.client_secret = "your_client_secret"Or set AMAZON_ADS_CLIENT_ID and AMAZON_ADS_CLIENT_SECRET.
Usage
Request an access token via Login with Amazon (LWA):
data = AmazonAds::LWA.request(refresh_token: "your_refresh_token")
access_token = data.fetch("access_token")The caller owns token caching. Store and reuse the token until it expires.
Make requests:
# List advertising profiles
profiles = AmazonAds::Profiles.new(region: "NA", access_token:)
profiles.list_profiles
# List campaigns under a profile
campaigns = AmazonAds::Campaigns.new(
region: "NA",
access_token:,
profile_id: "123456789",
)
campaigns.list_campaignsDevelopment
See AGENTS.md.