Introduction

An Amazon Advertising account contains one or more profiles representing entities for which digital marketing campaigns are managed and monitored. Each profile is associated with a Profile ID which uniquely identifies the entity. Operations with the AAAPI Plugin are organized around these Profile IDs.

For each profile, a reports and snapshots are available via the AAAPI. Reports contain daily performance metrics and can be requested up to sixty days in the past. Snapshots contain information about the entities associated with the metrics at the time the snapshot was made.

Once credentials are provisioned, the plugin is usually configured to run daily in the following manner:

  1. Obtain all valid profile ids for the AAAPI account.

  2. For each profile id:

    1. For each report type configured for the profile id

      1. Request the report via the AAAPI, covering the period of time since the report last ran.

      2. Wait until the report completes and then download the report to Mitto.

      3. Load the data from the report into Mitto.

    2. For each snapshot type configured for the profile id

      1. Request the snapshot via the AAAPI.

      2. Wait until the snapshot completes and then download the snapshot to Mitto.

      3. Load the data from the snapshot into Mitto.