--- title: "Data Source - Apple Search Ads" slug: "data-source-apple-search-ads" updated: 2024-09-19T08:13:12Z published: 2024-09-19T08:13:12Z canonical: "documents.trocco.io/data-source-apple-search-ads" --- > ## Documentation Index > Fetch the complete documentation index at: https://documents.trocco.io/llms.txt > Use this file to discover all available pages before exploring further. # Data Source - Apple Search Ads ## summary Help Page for ETL Configuration of Report Data Settings for Apple Search Ads. ## Setting items ### STEP1 Basic settings | item name | default value | Contents | | --- | --- | --- | | Apple Search Ads Connection Configuration | - | Select the preregistered [Apple Search Ads Connection](/docs/connection-configuration-apple-search-ads) Configuration that has the necessary permissions for this ETL Configuration. | | campaign group ID | - | Enter the ID of the campaign group, which can be found in the Account Name menu in the left corner of the report screen. ![image.png](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/data-source-apple-search-ads-2024-08-29-22-59-0.png) | | Report Level | - | Select a report level from the following - `CAMPAIGNS` - `AD_GROUPS` - `KEYWORDS` - `SEARCH_TERMS` - `CREATIVE_SETS` | | particle size | - | Select the granularity from the following - `HOURLY` - `DAILY` - `WEEKLY` - `MONTHLY` | | Data acquisition period | - | Enter the start and end dates of the data acquisition period. Depending on the **granularity** selected, there are conditions on the period of time that can be obtained. See [Limitations on Data Acquisition Periods](/docs/en/data-source-apple-search-ads#%E3%83%87%E3%83%BC%E3%82%BF%E5%8F%96%E5%BE%97%E6%9C%9F%E9%96%93%E3%81%AE%E6%9D%A1%E4%BB%B6). | #### Conditions for data acquisition period There is a limit to the period of time that can be specified for **data acquisition**, **depending on the granularity of the****data**. - If `the`**granularity**`is HOURLY` The **start** date must be within 30 days from the time the ETL Job is executed, and the duration must be within 7 days. - When `the`**granularity**`is DAILY` The **start** date must be within 90 days from the time the ETL Job is executed, and the duration must be within 90 days. - If `the`**granularity**`is WEEKLY` The **start date** must be within 24 months from the time the ETL Job is executed, and the duration must be between 15 and 365 days. - If `the`**granularity**`is MONTHLY` The **start date** must be within 24 months from the time the ETL Job is executed and the duration must exceed 3 months. If you specify a time period that does not meet the above conditions, the following error will occur during run preview and job execution Example: The When `MONTHLY is` specified `for the`**granularity** and a period of less than 3 months is specified **for the data acquisition period** `400POST https://api.searchads.apple.com/api/v4/reports/campaigns/xxxxx/adgroups{"data":null,"pagination":null,"error":{"errors":[{"messageCode":"INVALID_INPUT","message":"Date range of 2023-08-01 to 2023-09-01 is not valid for granularity MONTHLY","field":"request.endTime"}]}}`