# Bing Ads

The tap-bing-ads extractor pulls raw data from the Bing Ads API.

For more details, refer to the repository at https://github.com/singer-io/tap-bing-ads.

# Installation

# Using the Command Line Interface

  1. Add the tap-bing-ads extractor to your project using meltano add:

    meltano add extractor tap-bing-ads
    
  2. Configure the settings below using meltano config.

# Using Meltano UI

  1. Start Meltano UI using meltano ui:

    meltano ui
    
  2. Open the Extractors interface at http://localhost:5000/extractors.

  3. Click the "Add to project" button for "Bing Ads".

  4. Configure the settings below in the "Configuration" interface that opens automatically.

# Settings

tap-bing-ads requires the configuration of the following settings:

# Developer Token

See https://docs.microsoft.com/en-us/advertising/guides/get-started#get-developer-token.

# How to use

Manage this setting using meltano config or an environment variable:

meltano config tap-bing-ads set developer_token <token>

export OAUTH_BING_ADS_DEVELOPER_TOKEN=<token>

# OAuth Client ID

See https://docs.microsoft.com/en-us/advertising/guides/get-started#quick-start-production.

# How to use

Manage this setting using meltano config or an environment variable:

meltano config tap-bing-ads set oauth_client_id <id>

export OAUTH_BING_ADS_CLIENT_ID=<id>

# OAuth Client Secret

See https://docs.microsoft.com/en-us/advertising/guides/get-started#quick-start-production.

# How to use

Manage this setting using meltano config or an environment variable:

meltano config tap-bing-ads set oauth_client_secret <secret>

export OAUTH_BING_ADS_CLIENT_SECRET=<secret>

# Customer ID

See https://docs.microsoft.com/en-us/advertising/guides/get-started#get-ids.

# How to use

Manage this setting using Meltano UI, meltano config, or an environment variable:

meltano config tap-bing-ads set customer_id <id>

export TAP_BING_ADS_CUSTOMER_ID=<id>

# Account IDs

See https://docs.microsoft.com/en-us/advertising/guides/get-started#get-ids.

# How to use

Manage this setting using Meltano UI, meltano config, or an environment variable:

meltano config tap-bing-ads set account_ids <id>

export TAP_BING_ADS_ACCOUNT_IDS=<id>

# Refresh Token

See https://docs.microsoft.com/en-us/advertising/guides/get-started#quick-start-production.

# How to use

Manage this setting using Meltano UI, meltano config, or an environment variable:

meltano config tap-bing-ads set refresh_token <token>

export TAP_BING_ADS_REFRESH_TOKEN=<token>

# Start Date

This property determines how much historical data will be extracted.

Please be aware that the larger the time period and amount of data, the longer the initial extraction can be expected to take.

# How to use

Manage this setting using Meltano UI, meltano config, or an environment variable:

meltano config tap-bing-ads set start_date <date>

export TAP_BING_ADS_START_DATE=<date>