

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Lettura dalle entità di Facebook Ads
<a name="facebook-ads-reading-from-entities"></a>

**Prerequisito**

Un oggetto di Facebook Ads da cui desideri leggere. È necessario il nome dell'oggetto. Le tabelle seguenti mostrano le entità supportate.

**Entità supportate come origine**:


| Entità | Può essere filtrato | Supporta limite | Supporta Ordina per | Supporta Seleziona \$1 | Supporta il partizionamento | 
| --- | --- | --- | --- | --- | --- | 
| Campagna | Sì  | Sì | No | Sì | Sì | 
| Set di annunci | Sì  | Sì | No | Sì | Sì | 
| Inserzioni | Sì  | Sì | No | Sì | Sì | 
| Creative Ad | No | Sì | No | Sì | No | 
| Informazioni approfondite: conto | No | Sì | No | Sì | No | 
| Account pubblicitari | Sì  | Sì | No | Sì | No | 
| Informazioni approfondite: inserzione | Sì  | Sì | No | Sì | Sì | 
| Approfondimenti - AdSet | Sì  | Sì | No | Sì | Sì | 
| Informazioni approfondite: campagna | Sì  | Sì | No | Sì | Sì | 

**Esempio**:

```
FacebookAds_read = glueContext.create_dynamic_frame.from_options(
    connection_type="FacebookAds",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v20.0"
    }
```

## Dettagli sull'entità e sul campo di Facebook Ads
<a name="facebook-ads-reading-entity-and-field-details"></a>

Per ulteriori informazioni sui dettagli dell'entità e del campo, consultare:
+ [Account pubblicitario](https://developers.facebook.com/docs/marketing-api/reference/ad-account)
+ [Campagna](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group)
+ [Set di annunci](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign)
+ [Inserzione](https://developers.facebook.com/docs/marketing-api/reference/adgroup)
+ [Creative Ad](https://developers.facebook.com/docs/marketing-api/reference/ad-creative)
+ [Informazioni approfondite sull'account pubblicitario](https://developers.facebook.com/docs/marketing-api/reference/ad-account/insights)
+ [Informazioni approfondite sulle inserzioni](https://developers.facebook.com/docs/marketing-api/reference/adgroup/insights/)
+ [Approfondimenti AdSets](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign/insights)
+ [Informazioni approfondite sulle campagne](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group/insights)

Per ulteriori informazioni, consulta [l'API Marketing](https://developers.facebook.com/docs/marketing-api/reference/v21.0).

**Nota**  
I tipi di dati Struct e List vengono convertiti in tipo di dati String nella risposta dei connettori.

## Query di partizionamento
<a name="facebook-ads-reading-partitioning-queries"></a>

Puoi fornire le opzioni Spark aggiuntive `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND` e `NUM_PARTITIONS` se desideri utilizzare la concorrenza in Spark. Con questi parametri, la query originale viene suddivisa in `NUM_PARTITIONS` query secondarie che possono essere eseguite contemporaneamente dalle attività Spark.
+ `PARTITION_FIELD`: il nome del campo da utilizzare per partizionare la query.
+ `LOWER_BOUND`: un valore limite inferiore **inclusivo** del campo di partizione scelto.

  Per il DateTime campo, accettiamo il formato di timestamp Spark utilizzato nelle query SQL di Spark.

  Esempio di valore valido:

  ```
  "2022-01-01"
  ```
+ `UPPER_BOUND`: un valore limite superiore **esclusivo** del campo di partizione scelto.
+ `NUM_PARTITIONS`: il numero di partizioni.

Esempio:

```
FacebookADs_read = glueContext.create_dynamic_frame.from_options(
    connection_type="FacebookAds",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v20.0",
        "PARTITION_FIELD": "created_time"
        "LOWER_BOUND": "2022-01-01"
        "UPPER_BOUND": "2024-01-02"
        "NUM_PARTITIONS": "10"
    }
```