Lettura dalle entità di Instagram Ads

Prerequisito

Un oggetto Instagram Ads da cui vorresti leggere. Avrai bisogno del nome dell'oggetto. Le tabelle seguenti mostrano le entità supportate.

Entità supportate per l'origine:

Entità	Può essere filtrato	Limite di supporto	Supporta Order by	Supporta Select *	Supporta il partizionamento
Campagna	Sì	Sì	No	Sì	Sì
Set di annunci	Sì	Sì	No	Sì	Sì
Annunci	Sì	Sì	No	Sì	Sì
Pubblicità creativa	No	Sì	No	Sì	No
Approfondimenti - Account	No	Sì	No	Sì	No
Immagine dell'annuncio	Sì	Sì	No	Sì	No
Approfondimenti - Annuncio	Sì	Sì	No	Sì	Sì
Approfondimenti - AdSet	Sì	Sì	No	Sì	Sì
Approfondimenti - Campagna	Sì	Sì	No	Sì	Sì

Esempio:

instagramAds_read = glueContext.create_dynamic_frame.from_options(
    connection_type="instagramads",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v20.0"
    }

Dettagli dell'entità e del campo di Instagram Ads

Per ulteriori informazioni sulle entità e sui dettagli dei campi, consulta:

• Campagna

• Set di annunci

• Annuncio

• Annuncio creativo

• Informazioni sull'account pubblicitario

• Immagine dell'annuncio

• Approfondimenti sugli annunci

• AdSets Approfondimenti

• Approfondimenti sulle campagne

Per ulteriori informazioni, consulta Marketing API.

Nota

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

Interrogazioni di partizionamento

Puoi fornire le opzioni Spark aggiuntive ePARTITION_FIELD, NUM_PARTITIONS se desideri LOWER_BOUNDUPPER_BOUND, utilizzare la concorrenza in Spark. Con questi parametri, la query originale verrebbe suddivisa in un NUM_PARTITIONS numero di sottoquery 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 Spark. SQL

  Esempio di valore valido:

  "2022-01-01T00:00:00.000Z"

• UPPER_BOUND: un valore limite superiore esclusivo del campo di partizione scelto.

  Esempio di valore valido:

  "2024-01-02T00:00:00.000Z"

• NUM_PARTITIONS: il numero di partizioni.

Esempio:

instagramADs_read = glueContext.create_dynamic_frame.from_options(
    connection_type="instagramads",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v20.0",
        "PARTITION_FIELD": "created_time"
        "LOWER_BOUND": "2022-01-01T00:00:00.000Z"
        "UPPER_BOUND": "2024-01-02T00:00:00.000Z"
        "NUM_PARTITIONS": "10"
    }