facebook-connector

A connector allowing users to send audience data to Facebook Custom Audiences inside their platform advertising account.

Architecture	Operations	Infra/Terraform
architecture.md	operations.md	infra/

Table of Contents

• facebook-connector
  • Project Structure
  • Workstation Setup
  • Build and Automated Tests
  • Running Locally
    • API
    • Worker
  • Manual Tests
  • Relevant Facebook Resources

Project Structure

• backend
• frontend

Workstation Setup

These setup instructions complement the general Dev Workstation Setup instructions.

asdf install

Build and Automated Tests

sbt test

Running Locally

API

• Run against dev DB:

DISABLE_JSON_LOGS=true \
TOKEN_KMS_KEY_ID=11bdad18-80b4-4107-a854-a643eee7c7cb \
STAGE=dev \
./run-api.sh

• Run against local DB:

DISABLE_JSON_LOGS=true \
TOKEN_KMS_KEY_ID=11bdad18-80b4-4107-a854-a643eee7c7cb \
API_PORT=9998 \
DB_USER=root \
DB_PASSWORD=narrative
DB_URL=jdbc:postgresql://localhost:5432/facebookconnector ./run-api.sh

See the API config for more configuration options.

Worker

• Run against dev DB:

DISABLE_JSON_LOGS=true \
TOKEN_KMS_KEY_ID=11bdad18-80b4-4107-a854-a643eee7c7cb \
STAGE=dev \
./run-worker.sh

• Run against local DB:

DISABLE_JSON_LOGS=true \
TOKEN_KMS_KEY_ID=11bdad18-80b4-4107-a854-a643eee7c7cb \
DB_USER=root \
DB_PASSWORD=narrative
DB_URL=jdbc:postgresql://localhost:5432/facebookconnector ./run-worker.sh

See the Worker config for more configuration options.

Relevant Facebook Resources

• Facebook Marketing API
• Facebook API Explorer
• Facebook Ad Account
• Facebook Access Tokens
• Facebook Custom Audiences