ingestr 0.7.7__tar.gz → 0.8.1__tar.gz

{ingestr-0.7.7 → ingestr-0.8.1}/.gitignore

@@ -13,4 +13,5 @@ pipeline_data
 dist
 docs/.vitepress/dist
 docs/.vitepress/cache
-node_modules
+node_modules
+*.duckdb

{ingestr-0.7.7 → ingestr-0.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: ingestr
-Version: 0.7.7
+Version: 0.8.1
 Summary: ingestr is a command-line application that ingests data from various sources and stores them in any database.
 Project-URL: Homepage, https://github.com/bruin-data/ingestr
 Project-URL: Issues, https://github.com/bruin-data/ingestr/issues
@@ -14,11 +14,13 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Database
 Requires-Python: >=3.9
+Requires-Dist: confluent-kafka>=2.3.0
 Requires-Dist: cx-oracle==8.3.0
 Requires-Dist: databricks-sql-connector==2.9.3
 Requires-Dist: dlt==0.5.1
 Requires-Dist: duckdb-engine==0.11.5
 Requires-Dist: duckdb==0.10.2
+Requires-Dist: facebook-business==20.0.0
 Requires-Dist: google-api-python-client==2.130.0
 Requires-Dist: google-cloud-bigquery-storage==2.24.0
 Requires-Dist: mysql-connector-python==9.0.0
@@ -42,6 +44,7 @@ Requires-Dist: sqlalchemy==1.4.52
 Requires-Dist: stripe==10.7.0
 Requires-Dist: tqdm==4.66.2
 Requires-Dist: typer==0.12.3
+Requires-Dist: types-requests==2.32.0.20240907
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -176,15 +179,28 @@ Join our Slack community [here](https://join.slack.com/t/bruindatacommunity/shar
     <tr>
         <td colspan="3" style='text-align:center;'><strong>Platforms</strong></td>
     </tr>
+    <td>Adjust</td>
+        <td>✅</td>
+        <td>-</td>
     <tr>
         <td>Airtable</td>
         <td>✅</td>
         <td>-</td>
+    </tr>
+     <tr>
+        <td>AppsFlyer</td>
+        <td>✅</td>
+        <td>-</td>
     </tr>
     <tr>
         <td>Chess.com</td>
         <td>✅</td>
         <td>-</td>
+    </tr>
+     <tr>
+        <td>Facebook Ads</td>
+        <td>✅</td>
+        <td>-</td>
     </tr>
     <tr>
         <td>Gorgias</td>
@@ -200,6 +216,11 @@ Join our Slack community [here](https://join.slack.com/t/bruindatacommunity/shar
         <td>HubSpot</td>
         <td>✅</td>
         <td>-</td>
+    </tr>
+     <tr>
+        <td>Klaviyo</td>
+        <td>✅</td>
+        <td>-</td>
     </tr>
     <tr>
         <td>Notion</td>

{ingestr-0.7.7 → ingestr-0.8.1}/README.md

@@ -130,15 +130,28 @@ Join our Slack community [here](https://join.slack.com/t/bruindatacommunity/shar
     <tr>
         <td colspan="3" style='text-align:center;'><strong>Platforms</strong></td>
     </tr>
+    <td>Adjust</td>
+        <td>✅</td>
+        <td>-</td>
     <tr>
         <td>Airtable</td>
         <td>✅</td>
         <td>-</td>
+    </tr>
+     <tr>
+        <td>AppsFlyer</td>
+        <td>✅</td>
+        <td>-</td>
     </tr>
     <tr>
         <td>Chess.com</td>
         <td>✅</td>
         <td>-</td>
+    </tr>
+     <tr>
+        <td>Facebook Ads</td>
+        <td>✅</td>
+        <td>-</td>
     </tr>
     <tr>
         <td>Gorgias</td>
@@ -154,6 +167,11 @@ Join our Slack community [here](https://join.slack.com/t/bruindatacommunity/shar
         <td>HubSpot</td>
         <td>✅</td>
         <td>-</td>
+    </tr>
+     <tr>
+        <td>Klaviyo</td>
+        <td>✅</td>
+        <td>-</td>
     </tr>
     <tr>
         <td>Notion</td>

{ingestr-0.7.7 → ingestr-0.8.1}/docs/.vitepress/config.mjs

@@ -64,6 +64,7 @@ export default defineConfig({
                 text: "Google BigQuery",
                 link: "/supported-sources/bigquery.md",
               },
+              { text: "Kafka", link: "/supported-sources/kafka.md" },
               { text: "Local CSV Files", link: "/supported-sources/csv.md" },
               {
                 text: "Microsoft SQL Server",
@@ -83,11 +84,18 @@ export default defineConfig({
             text: "Platforms",
             collapsed: false,
             items: [
+              { text: "Adjust", link: "/supported-sources/adjust.md" },
               { text: "Airtable", link: "/supported-sources/airtable.md" },
+              { text: "AppsFlyer", link: "/supported-sources/appsflyer.md" },
               { text: "Chess.com", link: "/supported-sources/chess.md" },
+              {
+                text: "Facebook Ads",
+                link: "/supported-sources/facebook-ads.md",
+              },
               { text: "Google Sheets", link: "/supported-sources/gsheets.md" },
               { text: "Gorgias", link: "/supported-sources/gorgias.md" },
               { text: "HubSpot", link: "/supported-sources/hubspot.md" },
+              { text: "Klaviyo", link: "/supported-sources/klaviyo.md" },
               { text: "Notion", link: "/supported-sources/notion.md" },
               { text: "Shopify", link: "/supported-sources/shopify.md" },
               { text: "Slack", link: "/supported-sources/slack.md" },

ingestr-0.8.1/docs/supported-sources/adjust.md

@@ -0,0 +1,30 @@
+# Adjust
+
+[Adjust](https://www.adjust.com/) is a mobile marketing analytics platform that provides solutions for measuring and optimizing campaigns, as well as protecting user data.
+
+ingestr supports Adjust as a source.
+
+## URI Format
+
+The URI format for Adjust is as follows:
+
+```plaintext
+adjust://?api_key=<api-key-here>
+```
+
+An API token is required to retrieve reports from the Adjust reporting API. please follow the guide to [obtain a API key](https://dev.adjust.com/en/api/rs-api/authentication/).
+
+Once you complete the guide, you should have an API key. Let's say your API key is `nr_123`, here's a sample command that will copy the data from Adjust into a duckdb database:
+
+```sh
+ingestr ingest --source-uri 'adjust://?api_key=nr_123' --source-table 'campaigns' --dest-uri duckdb:///adjust.duckdb --dest-table 'adjust.output' --interval-start '2024-09-05' --interval-end '2024-09-08'
+```
+
+The result of this command will be a table in the `adjust.duckdb` database
+
+Available Source Table:
+Adjust source allows ingesting the following source into separate tables:
+
+-`Campaigns`: Retrieves data for a campaign, showing the app's revenue and network costs over multiple days.
+
+--`Creatives`: Retrieves data for a creative assest, detailing the app's revenue and network costs across multiple days

ingestr-0.8.1/docs/supported-sources/appsflyer.md

@@ -0,0 +1,28 @@
+# AppsFlyer
+
+[AppsFlyer](https://www.appsflyer.com/) is a mobile marketing analytics and attribution platform that helps businesses track, measure, and optimize their app marketing efforts across various channels.
+
+ingestr supports AppsFlyer as a source.
+
+The URI format for AppsFlyer is as follows:
+
+```plaintext
+appsflyer://?api_key=<api-key>
+```
+
+An API token is required to retrieve reports from the AppsFlyer API. Please follow the guide to [obtain a API key](https://support.appsflyer.com/hc/en-us/articles/360004562377-Managing-AppsFlyer-tokens)
+
+Once you complete the guide, you should have an API key. Let's say your API key is ey123, here's a sample command that will copy the data from AppsFlyer into a duckdb database:
+
+ingestr ingest --source-uri 'appsflyer://?api_key=ey123' --source-table 'campaigns' --dest-uri duckdb:///appsflyer.duckdb --dest-table 'appsflyer.output' --interval-start '2024-08-01' --interval-end '2024-08-28'
+
+The result of this command will be a table in the appsflyer.duckdb database
+
+Available Source Table:
+AppsFlyer source allows ingesting the following source into separate tables:
+
+-Campaigns: Retrieves data for campaigns, detailing the app's costs, loyal users, total installs, and revenue over multiple days.
+
+-Creatives: Retrieves data for a creative asset, including revenue and cost.
+
+Use these as `--source-table` parameter in the `ingestr ingest` command.

ingestr-0.8.1/docs/supported-sources/facebook-ads.md

@@ -0,0 +1,51 @@
+# Facebook Ads
+
+Facebook Ads is the advertising platform that helps users to create targeted ads on Facebook, Instagram and Messenger.
+
+ingestr supports Facebook Ads as a source.
+
+## URI Format
+
+The URI format for Facebook Ads is as follows:
+
+```plaintext
+facebookads://?access_token=<access_token>&account_id=<account_id>
+```
+
+URI parameters:
+
+- `access_token` is associated with Business Facebook App.
+- `account_id` is associated with Ad manager.
+
+Both are used for authentication with Facebook Ads API.
+
+The URI is used to connect to Facebook Ads API for extracting data.
+
+## Setting up a Facebook Ads Integration
+
+Facebook Ads requires a few steps to set up an integration, please follow the guide dltHub [has built here](https://dlthub.com/docs/dlt-ecosystem/verified-sources/facebook_ads#setup-guide).
+
+Once you complete the guide, you should have an Access_Token and Account ID . Let's say your access_token is `abcdef` and account_id is `1234` , here's a sample command that will copy the data from Facebook Ads into a duckdb database:
+
+```sh
+ingestr ingest \
+  --source-uri 'facebookads://?access_token=easdyh&account_id=1234' \
+  --source-table 'campaigns' \
+  --dest-uri 'duckdb:///facebook.duckdb' \
+  --dest-table 'dest.campaigns'
+```
+
+The result of this command will be a table in the `facebook.duckdb` database.
+
+## Available Tables
+
+Facebook Ads source allows ingesting the following sources into separate tables:
+
+- `campaigns`: Retrieves all DEFAULT_CAMPAIGN_FIELDS.
+- `ad_sets`: Retrieves all DEFAULT_ADSET_FIELDS.
+- `leads`: Retrieves all DEFAULT_LEAD_FIELDS.
+- `ads_creatives`: Retrieves all DEFAULT_ADCREATIVE_FIELDS.
+- `ads`: Retrieves all DEFAULT_ADS_FIELDS.
+- `facebook_insights`: Retrieves all DEFAULT_INSIGHTS_FIELDS.
+
+Use these as `--source-table` parameter in the `ingestr ingest` command.

ingestr-0.8.1/docs/supported-sources/kafka.md

@@ -0,0 +1,38 @@
+# Apache Kafka
+[Apache Kafka](https://kafka.apache.org/) is a distributed event streaming platform used by thousands of companies for high-performance data pipelines, streaming analytics, data integration, and mission-critical applications.
+
+ingestr supports Apache Kafka as a source.
+
+## URI Format
+The URI format for Apache Kafka is as follows:
+
+```plaintext
+kafka://?bootstrap_servers=localhost:9092&group_id=test_group&security_protocol=SASL_SSL&sasl_mechanisms=PLAIN&sasl_username=example_username&sasl_password=example_secret&batch_size=1000&batch_timeout=3
+```
+
+URI parameters:
+- `bootstrap_servers`: The Kafka server(s) to connect to, typically in the form of a host and port (e.g., `localhost:9092`).
+- `group_id`: The consumer group ID used for identifying the client when consuming messages.
+- `security_protocol`: The protocol used to communicate with brokers (e.g., `SASL_SSL` for secure communication).
+- `sasl_mechanisms`: The SASL mechanism to be used for authentication (e.g., `PLAIN`).
+- `sasl_username`: The username for SASL authentication.
+- `sasl_password`: The password for SASL authentication.
+- `batch_size`: The number of messages to fetch in a single batch, defaults to 3000.
+- `batch_timeout`: The maximum time to wait for messages, defaults to 3 seconds.
+
+The URI is used to connect to the Kafka brokers for ingesting messages.
+
+### Group ID
+The group ID is used to identify the consumer group that reads messages from a topic. Kafka uses the group ID to manage consumer offsets and assign partitions to consumers, which means that the group ID is the key to reading messages from the correct partition and position in the topic.
+
+Once you have your Kafka server, credentials, and group ID set up, here's a sample command to ingest messages from a Kafka topic into a duckdb database:
+
+```sh
+ingestr ingest \
+    --source-uri 'kafka://?bootstrap_servers=localhost:9092' \
+    --source-table 'my-topic' \
+    --dest-uri duckdb:///kafka.duckdb \
+    --dest-table 'kafka.my_topic'
+```
+
+The result of this command will be a table in the `kafka.duckdb` database with JSON columns.

ingestr-0.8.1/docs/supported-sources/klaviyo.md

@@ -0,0 +1,64 @@
+# Klaviyo
+
+[Klaviyo](https://www.klaviyo.com/) is a marketing automation platform that helps businesses build and manage smarter digital relationships with their customers by connecting through personalized email and enhancing customer loyality.
+
+ingestr supports Klaviyo as a source.
+
+## URI Format
+
+The URI format for Klaviyo is as follows:
+
+```plaintext
+klaviyo://?api_key=<api-key>
+```
+
+URI parameters:
+
+- `api_key`: The API key used for authentication with the Klaviyo API.
+
+The URI is used to connect to the Klaviyo API for extracting data.
+
+```bash
+ingestr ingest --source-table 'events' --source-uri 'klaviyo://?api_key=pk_test' --dest-uri duckdb:///klaviyo.duckdb --interval-start 2022-01-01 --dest-table 'klaviyo.events' --extract-parallelism 20
+```
+
+This command fethes all the events that are created/updated since 2022-01-01 and writes them to `klaviyo.events` table on DuckDB, using 20 parallel threads to improve performance and efficiently handle large data .
+
+## Available Tables
+
+Klaviyo source allows ingesting the following sources into separate tables:
+
+[events](https://developers.klaviyo.com/en/reference/events_api_overview): Retrieves all events in an account where each event represents an action taken by a profile such as a password reset or a product order.
+
+[profiles](https://developers.klaviyo.com/en/reference/profiles_api_overview): Retrieves all profiles in an account where each profile includes details like organization, job title, email and other attributes.
+
+[campaigns](https://developers.klaviyo.com/en/reference/campaigns_api_overview): Retrieves all campaigns in an account where each campaign is a targeted message sent to a specific audience.
+
+[metrics](https://developers.klaviyo.com/en/reference/metrics_api_overview): Retrieves all metrics in an account where each metric represents a category of events or actions a person can take.
+
+[tags](https://developers.klaviyo.com/en/reference/get_tags): Retrieves all tags in an account.
+
+[coupons](https://developers.klaviyo.com/en/reference/get_coupons): Retrieves all coupons in an account.
+
+[catalog-variants](https://developers.klaviyo.com/en/reference/get_catalog_variants): Retrieves all variants in an account.
+
+[catalog-categories](https://developers.klaviyo.com/en/reference/get_catalog_categories): Retrieves all catalog categories in an account.
+
+[catalog-items](https://developers.klaviyo.com/en/reference/get_catalog_items): Retrieves all catalog items in an account.
+
+[flows](https://developers.klaviyo.com/en/reference/get_flows): Retrieves all flows in an account where flow is a sequence of automated actions that is triggered when a person performs a specific action.
+
+[lists](https://developers.klaviyo.com/en/reference/get_lists): Retrieves all lists in an account.
+
+[images](https://developers.klaviyo.com/en/reference/get_images): Retrieves all images in an account..
+
+[segments](https://developers.klaviyo.com/en/reference/get_segments): Retrieves all segments in an account where segment is a dynamic list that contains profiles meeting a certain set of conditions.
+
+[forms](https://developers.klaviyo.com/en/reference/get_forms): Retrieves all forms in an account.
+
+[templates](https://developers.klaviyo.com/en/reference/get_templates): Retrieves all templates in an account.
+
+Use these as `--source-table` parameter in the `ingestr ingest` command.
+
+> [!WARNING]
+> Klaviyo does not support incremental loading for many endpoints in its APIs, which means ingestr will load endpoints incrementally if they support it, and do a full-refresh if not.

{ingestr-0.7.7 → ingestr-0.8.1}/docs/supported-sources/shopify.md

@@ -32,6 +32,12 @@ The result of this command will be a table in the `shopify.duckdb` database with
 Shopify source allows ingesting the following sources into separate tables:
 - `orders`
 - `customers`
+- `discounts`: Uses the GraphQL API, `discountNodes` query, take a look at the [Shopify docs](https://shopify.dev/docs/api/admin-graphql/2024-07/queries/discountNodes) for more details.
 - `products`
+- `inventory_items`
+- `transactions`
+- `balance`
+- `events`
+- `price_rules`: this is a deprecated table, please use `discounts` instead.
 
 Use these as `--source-table` parameter in the `ingestr ingest` command.

{ingestr-0.7.7 → ingestr-0.8.1}/ingestr/main.py

@@ -244,6 +244,13 @@ def ingest(
             envvar="PIPELINES_DIR",
         ),
     ] = None,  # type: ignore
+    extract_parallelism: Annotated[
+        Optional[int],
+        typer.Option(
+            help="The number of parallel jobs to run for extracting data from the source, only applicable for certain sources",
+            envvar="EXTRACT_PARALLELISM",
+        ),
+    ] = 5,  # type: ignore
 ):
     track(
         "command_triggered",
@@ -252,7 +259,10 @@ def ingest(
         },
     )
 
+    dlt.config["data_writer.buffer_max_items"] = page_size
     dlt.config["data_writer.file_max_items"] = loader_file_size
+    dlt.config["extract.workers"] = extract_parallelism
+    dlt.config["extract.max_parallel_items"] = extract_parallelism
     if schema_naming != SchemaNaming.default:
         dlt.config["schema.naming"] = schema_naming.value
 

ingestr-0.8.1/ingestr/src/.gitignore

@@ -0,0 +1,10 @@
+# ignore secrets, virtual environments and typical python compilation artifacts
+secrets.toml
+# ignore basic python artifacts
+.env
+**/__pycache__/
+**/*.py[cod]
+**/*$py.class
+# ignore duckdb
+*.duckdb
+*.wal

ingestr-0.8.1/ingestr/src/adjust/_init_.py

@@ -0,0 +1,31 @@
+from typing import Sequence
+
+import dlt
+from dlt.sources import DltResource
+
+from .helpers import DEFAULT_DIMENSIONS, AdjustAPI
+
+
+@dlt.source(max_table_nesting=0)
+def adjust_source(
+    start_date: str,
+    end_date: str,
+    api_key: str,
+) -> Sequence[DltResource]:
+    @dlt.resource(write_disposition="merge", merge_key="day")
+    def campaigns():
+        adjust_api = AdjustAPI(api_key=api_key)
+        yield from adjust_api.fetch_report_data(
+            start_date=start_date,
+            end_date=end_date,
+        )
+
+    @dlt.resource(write_disposition="merge", merge_key="day")
+    def creatives():
+        dimensions = DEFAULT_DIMENSIONS + ["adgroup", "creative"]
+        adjust_api = AdjustAPI(api_key=api_key)
+        yield from adjust_api.fetch_report_data(
+            start_date=start_date, end_date=end_date, dimensions=dimensions
+        )
+
+    return campaigns, creatives

ingestr-0.8.1/ingestr/src/adjust/helpers.py

@@ -0,0 +1,82 @@
+import requests
+from dlt.sources.helpers.requests import Client
+from requests.exceptions import HTTPError
+
+DEFAULT_DIMENSIONS = ["campaign", "day", "app", "store_type", "channel", "country"]
+
+DEFAULT_METRICS = [
+    "network_cost",
+    "all_revenue_total_d0",
+    "ad_revenue_total_d0",
+    "revenue_total_d0",
+    "all_revenue_total_d1",
+    "ad_revenue_total_d1",
+    "revenue_total_d1",
+    "all_revenue_total_d3",
+    "ad_revenue_total_d3",
+    "revenue_total_d3",
+    "all_revenue_total_d7",
+    "ad_revenue_total_d7",
+    "revenue_total_d7",
+    "all_revenue_total_d14",
+    "ad_revenue_total_d14",
+    "revenue_total_d14",
+    "all_revenue_total_d21",
+]
+
+
+class AdjustAPI:
+    def __init__(self, api_key):
+        self.api_key = api_key
+        self.uri = "https://automate.adjust.com/reports-service/report"
+
+    def fetch_report_data(
+        self,
+        start_date,
+        end_date,
+        dimensions=DEFAULT_DIMENSIONS,
+        metrics=DEFAULT_METRICS,
+        utc_offset="+00:00",
+        ad_spend_mode="network",
+        attribution_source="first",
+        attribution_type="all",
+        cohort_maturity="immature",
+        reattributed="all",
+        sandbox="false",
+    ):
+        headers = {"Authorization": f"Bearer {self.api_key}"}
+        comma_separated_dimensions = ",".join(dimensions)
+        comma_separated_metrics = ",".join(metrics)
+        params = {
+            "date_period": f"{start_date}:{end_date}",
+            "dimensions": comma_separated_dimensions,
+            "metrics": comma_separated_metrics,
+            "utc_offset": utc_offset,
+            "ad_spend_mode": ad_spend_mode,
+            "attribution_source": attribution_source,
+            "attribution_type": attribution_type,
+            "cohort_maturity": cohort_maturity,
+            "reattributed": reattributed,
+            "sandbox": sandbox,
+        }
+
+        def retry_on_limit(
+            response: requests.Response, exception: BaseException
+        ) -> bool:
+            return response.status_code == 429
+
+        request_client = Client(
+            request_timeout=8.0,
+            raise_for_status=False,
+            retry_condition=retry_on_limit,
+            request_max_attempts=12,
+            request_backoff_factor=2,
+        ).session
+
+        response = request_client.get(self.uri, headers=headers, params=params)
+        if response.status_code == 200:
+            result = response.json()
+            items = result.get("rows", [])
+            yield items
+        else:
+            raise HTTPError(f"Request failed with status code: {response.status_code}")

ingestr-0.8.1/ingestr/src/appsflyer/_init_.py

@@ -0,0 +1,24 @@
+from typing import Iterable
+
+import dlt
+from dlt.common.typing import TDataItem
+from dlt.sources import DltResource
+
+from ingestr.src.appsflyer.client import AppsflyerClient
+
+
+@dlt.source(max_table_nesting=0)
+def appsflyer_source(
+    api_key: str, start_date: str, end_date: str
+) -> Iterable[DltResource]:
+    client = AppsflyerClient(api_key)
+
+    @dlt.resource(write_disposition="merge", merge_key="install_time")
+    def campaigns() -> Iterable[TDataItem]:
+        yield from client.fetch_campaigns(start_date, end_date)
+
+    @dlt.resource(write_disposition="merge", merge_key="install_time")
+    def creatives() -> Iterable[TDataItem]:
+        yield from client.fetch_creatives(start_date, end_date)
+
+    return campaigns, creatives

ingestr-0.8.1/ingestr/src/appsflyer/client.py

@@ -0,0 +1,106 @@
+from typing import Optional
+
+import requests
+from dlt.sources.helpers.requests import Client
+from requests.exceptions import HTTPError
+
+DEFAULT_GROUPING = ["c", "geo", "app_id", "install_time"]
+DEFAULT_KPIS = [
+    "impressions",
+    "clicks",
+    "installs",
+    "cost",
+    "revenue",
+    "average_ecpi",
+    "loyal_users",
+    "uninstalls",
+    "roi",
+]
+
+
+class AppsflyerClient:
+    def __init__(self, api_key: str):
+        self.api_key = api_key
+        self.uri = "https://hq1.appsflyer.com/api/master-agg-data/v4/app/all"
+
+    def __get_headers(self):
+        return {
+            "Authorization": f"{self.api_key}",
+            "accept": "text/json",
+        }
+
+    def _fetch_data(
+        self,
+        from_date: str,
+        to_date: str,
+        maximum_rows=1000000,
+        dimensions=DEFAULT_GROUPING,
+        metrics=DEFAULT_KPIS,
+    ):
+        params = {
+            "from": from_date,
+            "to": to_date,
+            "groupings": ",".join(dimensions),
+            "kpis": ",".join(metrics),
+            "format": "json",
+            "maximum_rows": maximum_rows,
+        }
+
+        def retry_on_limit(
+            response: Optional[requests.Response], exception: Optional[BaseException]
+        ) -> bool:
+            return (
+                isinstance(response, requests.Response) and response.status_code == 429
+            )
+
+        request_client = Client(
+            request_timeout=10.0,
+            raise_for_status=False,
+            retry_condition=retry_on_limit,
+            request_max_attempts=12,
+            request_backoff_factor=2,
+        ).session
+
+        try:
+            response = request_client.get(
+                url=self.uri, headers=self.__get_headers(), params=params
+            )
+
+            if response.status_code == 200:
+                result = response.json()
+                yield result
+            else:
+                raise HTTPError(
+                    f"Request failed with status code: {response.status_code}"
+                )
+
+        except requests.RequestException as e:
+            raise HTTPError(f"Request failed: {e}")
+
+    def fetch_campaigns(
+        self,
+        start_date: str,
+        end_date: str,
+    ):
+        metrics = DEFAULT_KPIS + [
+            "cohort_day_1_revenue_per_user",
+            "cohort_day_1_total_revenue_per_user",
+            "cohort_day_3_revenue_per_user",
+            "cohort_day_3_total_revenue_per_user",
+            "cohort_day_7_total_revenue_per_user",
+            "cohort_day_7_revenue_per_user",
+            "cohort_day_14_total_revenue_per_user",
+            "cohort_day_14_revenue_per_user",
+            "cohort_day_21_total_revenue_per_user",
+            "cohort_day_21_revenue_per_user",
+            "retention_day_7",
+        ]
+        return self._fetch_data(start_date, end_date, metrics=metrics)
+
+    def fetch_creatives(
+        self,
+        start_date: str,
+        end_date: str,
+    ):
+        dimensions = DEFAULT_GROUPING + ["af_adset_id", "af_adset", "af_ad_id"]
+        return self._fetch_data(start_date, end_date, dimensions=dimensions)