Facebook API Data Model

ad_account_id

string

☑

Facebook ads account ID including prefix 'act_'.

business_created_by

string

itgen_facebook_business_created_by

☐

Username and id who created this manager.

business_creation_time

string

itgen_facebook_business_creation_time

☐

Time this business created.

business_id

decimal

itgen_facebook_business_id

☐

The id of this person's user account. This ID is unique to each app and cannot be used across different apps.

business_name

string

itgen_facebook_business_name

☐

Name.

business_timezone_id

int32

itgen_facebook_business_timezone_id

☐

ID of the business's timezone.

business_update_time

string

itgen_facebook_business_update_time

☐

Last time this Business Manager was updated.

business_updated_by

string

itgen_facebook_business_updated_by

☐

Last user, by name and id, who have updated this manager.

canceled_time

datetime

itgen_facebook_canceled_time

☐

Time stamp when study was canceled.

cooldown_start_time

datetime

itgen_facebook_cooldown_start_time

☐

Cooldown start time.

created_by_birthday

string

itgen_facebook_created_by_birthday

☐

The person's birthday. This is a fixed format string, like MM/DD/YYYY. However, people can control who can see the year they were born separately from the month and day so this string can be only the year (YYYY) or the month + day (MM/DD).

created_by_can_review_measurement_request

boolean

itgen_facebook_created_by_can_review_measurement_request

☑

Can the person review brand polls.

created_by_email

string

itgen_facebook_created_by_email

☑

The User's primary email address listed on their profile. This field will not be returned if no valid email address is available.

created_by_first_name

string

itgen_facebook_created_by_first_name

☐

The person's first name.

created_by_gender

string

itgen_facebook_created_by_gender

☐

The gender selected by this person, male or female. If the gender is set to a custom value, this value will be based off of the preferred pronoun; it will be omitted if the preferred preferred pronoun is neutral.

created_by_id

decimal

itgen_facebook_created_by_id

☑

The id of this person's user account. This ID is unique to each app and cannot be used across different apps.

created_by_install_type

string

itgen_facebook_created_by_install_type

☐

Install type.

created_by_installed

string

itgen_facebook_created_by_installed

☐

Is the app making the request installed.

created_by_is_famedeeplinkinguser

boolean

itgen_facebook_created_by_is_famedeeplinkinguser

☑

If the user has used FAME deeplinking.

created_by_is_shared_login

boolean

itgen_facebook_created_by_is_shared_login

☑

Is this a shared login (e.g. a gray user).

created_by_last_name

string

itgen_facebook_created_by_last_name

☐

The person's last name.

created_by_link

string

itgen_facebook_created_by_link

☐

A link to the person's Timeline. The link will only resolve if the person clicking the link is logged into Facebook and is a friend of the person whose profile is being viewed.

created_by_middle_name

string

itgen_facebook_created_by_middle_name

☐

The person's middle name.

created_by_name

string

itgen_facebook_created_by_name

☑

The person's full name.

created_by_name_format

string

itgen_facebook_created_by_name_format

☐

The person's name formatted to correctly handle Chinese, Japanese, or Korean ordering.

created_by_public_key

string

itgen_facebook_created_by_public_key

☐

The person's PGP public key.

created_by_quotes

string

itgen_facebook_created_by_quotes

☐

The person's favorite quotes.

created_by_shared_login_upgrade_required_by

datetime

itgen_facebook_created_by_shared_login_upgrade_required_by

☐

The time that the shared loginneeds to be upgraded to Business Manager by.

created_by_short_name

string

itgen_facebook_created_by_short_name

☐

Shortened, locale-aware name for the person.

created_by_test_group

int32

itgen_facebook_created_by_test_group

☐

Platform test group.

created_by_viewer_can_send_gift

boolean

itgen_facebook_created_by_viewer_can_send_gift

☑

Can the viewer send a gift to this person?

created_time

datetime

Created

☐

When was the Lift study created.

description

string

Description

☐

Description.

end_time

datetime

itgen_facebook_end_time

☐

End time.

id

decimal

ID

☐

ID of the Lift study.

name

string

Name

☐

Name.

observation_end_time

datetime

itgen_facebook_observation_end_time

☐

Observation end time.

results_first_available_date

string

itgen_facebook_results_first_available_date

☐

When results for at least one objective of the study are available.

start_time

datetime

itgen_facebook_start_time

☐

Start time.

type

string

Type

☐

The type of study, either audience segmentation or lift.

updated_by_birthday

string

itgen_facebook_updated_by_birthday

☐

The person's birthday. This is a fixed format string, like MM/DD/YYYY. However, people can control who can see the year they were born separately from the month and day so this string can be only the year (YYYY) or the month + day (MM/DD).

updated_by_can_review_measurement_request

boolean

itgen_facebook_updated_by_can_review_measurement_request

☑

Can the person review brand polls.

updated_by_email

string

itgen_facebook_updated_by_email

☑

The User's primary email address listed on their profile. This field will not be returned if no valid email address is available.

updated_by_first_name

string

itgen_facebook_updated_by_first_name

☐

The person's first name.

updated_by_gender

string

itgen_facebook_updated_by_gender

☐

The gender selected by this person, male or female. If the gender is set to a custom value, this value will be based off of the preferred pronoun; it will be omitted if the preferred preferred pronoun is neutral.

updated_by_id

decimal

itgen_facebook_updated_by_id

☑

The id of this person's user account. This ID is unique to each app and cannot be used across different apps.

updated_by_install_type

string

itgen_facebook_updated_by_install_type

☐

Install type.

updated_by_installed

string

itgen_facebook_updated_by_installed

☐

Is the app making the request installed.

updated_by_is_famedeeplinkinguser

boolean

itgen_facebook_updated_by_is_famedeeplinkinguser

☑

If the user has used FAME deeplinking.

updated_by_is_shared_login

boolean

itgen_facebook_updated_by_is_shared_login

☑

Is this a shared login (e.g. a gray user).

updated_by_last_name

string

itgen_facebook_updated_by_last_name

☐

The person's last name.

updated_by_link

string

itgen_facebook_updated_by_link

☐

A link to the person's Timeline. The link will only resolve if the person clicking the link is logged into Facebook and is a friend of the person whose profile is being viewed.

updated_by_middle_name

string

itgen_facebook_updated_by_middle_name

☐

The person's middle name.

updated_by_name

string

itgen_facebook_updated_by_name

☑

The person's full name.

updated_by_name_format

string

itgen_facebook_updated_by_name_format

☐

The person's name formatted to correctly handle Chinese, Japanese, or Korean ordering.

updated_by_public_key

string

itgen_facebook_updated_by_public_key

☐

The person's PGP public key.

updated_by_quotes

string

itgen_facebook_updated_by_quotes

☐

The person's favorite quotes.

updated_by_shared_login_upgrade_required_by

datetime

itgen_facebook_updated_by_shared_login_upgrade_required_by

☐

The time that the shared loginneeds to be upgraded to Business Manager by.

updated_by_short_name

string

itgen_facebook_updated_by_short_name

☐

Shortened, locale-aware name for the person.

updated_by_test_group

int32

itgen_facebook_updated_by_test_group

☐

Platform test group.

updated_by_viewer_can_send_gift

boolean

itgen_facebook_updated_by_viewer_can_send_gift

☑

Can the viewer send a gift to this person?

updated_time

datetime

Updated

☐

Updated time.