Docs: Update Source Facebook Marketing docs #29053
Conversation
ChristoGrab
changed the title
octavia-squidington-iii
added
the
area/documentation
| 5. To authenticate the connection: | ||
|
|
||
| <!-- env:cloud --> | ||
| **For Airbyte Cloud**: Click **Authenticate your account** to authorize your [Meta for Developers](https://developers.facebook.com/) account. Airbyte will authenticate the account you are already logged in to. Make sure you are logged into the right account. |
There was a problem hiding this comment.
why Meta For Developers account? do I need to be registered as a meta developer to use on Airbyte Cloud? That doesn't sound right
There was a problem hiding this comment.
Sorry bout that, got my Metas and Facebooks mixed up!
There was a problem hiding this comment.
oh it wasn't about fb vs meta I just meant that the user shouldn't need to be a developer to use the connector. I can just be a casual
| Pay attention, that not all fields (e.g. conversions, conversion_values) will be returned for AdInsights, see [docs](https://developers.facebook.com/docs/marketing-api/reference/ads-action-stats/). | ||
| To get all fields You should use custom insights with **breakdowns**. | ||
|
|
||
| Please note that not all fields, such as `conversions` and `conversion_values`, will be returned when accessing AdInsights. Refer to the [Facebook documentation](https://developers.facebook.com/docs/marketing-api/reference/ads-action-stats/) for more information. To retrieve all available fields, it is recommended to use Custom Insights and specify the necessary **breakdowns**. |
There was a problem hiding this comment.
What is AdInsights referring to here? the casing makes it sound like a specific thing like a class or specific stream. Should it be ad insights?
Why would conversions not be returned? That seems weird given that conversions are an important part of ad analytics. Can we give the user a bit more info about when & why this happens? The link didn't provide more clarity for me personally
There was a problem hiding this comment.
Hmm, I've looked into this further and can't find any relevant information in the API docs. There's a ticket in Stack Overflow about missing conversion data in Ad Insights, but it's not much to go by and doesn't seem to be directly related to the note in the docs:
I've commented out the note for now since I can't find anything to back it up, and it doesn't seem to be an issue that crops up in the Airbyte Slack channels. I'll keep looking into this!
| 3. (Optional) For **Fields**, use the dropdown list to select the fields you want to pull from the Facebook Marketing API. | ||
| 4. (Optional) For **Breakdowns**, use the dropdown list to select the breakdowns you want to configure. | ||
| 5. (Optional) For **Action Breakdowns**, use the dropdown list to select the action breakdowns you want to configure. | ||
| 6. (Optional) For **Action Report Time**, enter the action report time you want to configure. This value determines the timing used to report action statistics. For example, if a user sees an ad on Jan 1st but converts on Jan 2nd, this value will determine how the action is reported. |
There was a problem hiding this comment.
Great clarifications added here!
Co-authored-by: Sherif A. Nada <snadalive@gmail.com>
* update setup steps * more updates to setup steps * formatting fixes * minor fixes * add action report time values * rewrite lookback * update descriptions of lookback windows * last update * small fix * remove unverified ad insights note * Update docs/integrations/sources/facebook-marketing.md Co-authored-by: Sherif A. Nada <snadalive@gmail.com> --------- Co-authored-by: Sherif A. Nada <snadalive@gmail.com>
What
Updated the docs page for Facebook Marketing source.
How