Class Index: amazon_advertising.io.input.AmazonAdvertisingReportCreateAndLoad

AmazonAdvertisingCredentials

Credentials used to access the Amazon Advertising API

type

object

properties

  • scope

Scope of access permissions

type

string

minLength

1

default

cpc_advertising:campaign_management

  • client_id

Client ID

type

string

examples

amzn1.application-oa2-client.8407ff6236bf028baa1d8a947c0898cf

minLength

1

  • client_secret

Client Secret

type

string

examples

bda137c73f33a83d3d4d57e70b8f96d77e5a8e70 …truncated…

minLength

1

  • refresh_token

Refresh Token

type

string

examples

Atzr|IwEBICqc0ic8xYl1f2SE …truncated…

minLength

1

AmazonAdvertisingApiEndpoints

GET/POST endpoints for a report, snapshot, or other entity. In the get and post examples below, {record_type} and {report_id} must be replaced with their actual values.

type

object

properties

  • base_url

Base Url

Base URL for Amazon Advertising API.

type

string

minLength

1

default

https://advertising-api.amazon.com/v2

  • post

Post

Endpoint for POST requests.

type

string

examples

/sp/{record_type}/report

/sp/adGroups/report

/hsa/{record_type}/report

/hsa/campaigns/report

minLength

1

  • get

Get

Endpoint for GET requests.

type

string

examples

/sp/reports/{report_id}

/sp/reports/5E728286.27a56924-ee1d-42a5-86ec-9af491dbd1a1

/hsa/reports/{report_id}

/hsa/reports/5E73800F.8f3be3ef-8070-49f2-9103-4ab1abf1da60

minLength

1

Report

Represents a AAAPI report that has been or will be created. Information identifying report content is encoded in the report’s file name.

Because there are many permutations of the various parameters, only some of which are valid, the set of parameters provided for a report are validated prior to running the job.

type

object

properties

  • profile_id

Profile Id

The AAAPI Profile ID associated with the report.

type

integer

examples

1907360808850690

  • profile_tz

Profile Tz

Timezone associated with profile_id. This value is automatically set by the plugin and should amost never be set via job config.

type

string

examples

America/Chicago

America/Los_Angeles

  • cls

Cls

Class of the entity this represents.

type

string

examples

report

snapshot

minLength

1

  • sponsored

Sponsored

The entity being sponsored.

type

string

examples

brands

products

minLength

1

  • record_type

Record Type

AAAPI recordType – the type of report or snapshot this represents.

type

string

examples

adGroups

campaigns

keywords

productAds

targets

minLength

1

  • url

FIXME: correct type

Url

examples

  • download_dir

Download Dir

Directory containing downloaded reports and snapshots.

type

string

default

/var/mitto/data/reports/amazon_advertising

format

path

  • date

Date

Date of data contained in report.

Important: this field’s value is set by the plugin, do not provide a value for it via the job config.

type

string

examples

2020-01-12

format

date

  • run_date

Run Date

Date on which report was run.

Important: this field’s value is set by the plugin, do not provide a value for it via the job config.

type

string

examples

2020-01-12

format

date

  • report_spec

Will contain all valid values for this report type.

Important: this field’s value is set by the plugin, do not provide a value for it via the job config.

Report Spec

  • report_id

Report Id

Assigned by API after successful POST requesting report creation.

Important: this field’s value is set by the plugin, do not provide a value for it via the job config.

type

string

examples

5E6A5CB3.39ce2551-4a7e-4753-ade1-b21c227cdc8d

minLength

1

  • segment

Segment

The segment/dimension, if any, to apply to this report.

type

string

examples

placement

query

minLength

1

  • metrics

Metrics

The metrics to include in the report. By default, the plugin automatically requests all possible metrics. Only provide metrics here if, for some reason, only a subset of the metrics are to be requested.

type

array

examples

attributedSales14dOtherSKU

attributedSales1dOtherSKU

attributedSales30dOtherSKU

attributedSales7dOtherSKU

attributedUnitsOrdered14d

attributedUnitsOrdered14dOtherSKU

attributedUnitsOrdered1d

attributedUnitsOrdered1dOtherSKU

minLength

1

items

type

string

minLength

1