facebook api之Ad

Ad

Contains information to display an ad and associate it an ad set. Each ad is associated with an ad set and all ads in a set have the same daily or lifetime budget, schedule, and targeting. Creating multiple ads in an ad set helps optimize their delivery based on variations in images, links, video, text or placements.

 

 

You can still create Event Ads and Link Ads if you provide a valid actor_id in the ad creative's object_story_id or object_story_spec fields

 

These options used together are valid:

• Event Ads
  • Objective: EVENT_RESPONSES
  • Creative fields: object_story_id or object_story_spec
• Link Ads
  • Objective: LINK_CLICKS
  • Creative fields: object_story_id or object_story_spec

 

The nodes, edges and requests impacted are:

• ad_ACCOUNT_ID/ads, Create
• ad_ACCOUNT_ID/adcreatives, Create
• /ad_ID, Update

Any pre-existing Event or Link Ads continue to run but you cannnot modify these ad's creatives or create new ads with the invalid options once the change goes in effect.

 

 

 

#Creating an ad:

# Upload image for your ad creative
curl \
-F "image.jpg=@myimage.jpg" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adimages"

# Provide ad creative with image hash ID returned in previous call
curl \
-F "name=sample creative" \ 
-F "title=hello world" \
-F "body=hi i'm an ad" \
-F "object_url=www.facebook.com" \ 
-F "image_hash=<IMAGE_HASH>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives"

# Create ad with ad creative. 
curl \
-F "name=my ad" \
-F "adset_id=<AD_SET_ID>" \
-F "creative={'creative_id':<AD_CREATIVE_ID>}" \
-F "status=PAUSED" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads"

# Asynchronous creation.
curl \
-F "name=testasyncset" \
-F "ad_specs=
[{'name':'name 1', 
  'adset_id':'<AD_SET_ID>', 
  'creative':{'creative_id':<AD_CREATIVE_ID>}},
{'name':'name 2', 
  'adset_id':'<AD_SET_ID>',  
  'creative':{'creative_id':<AD_CREATIVE_ID>}}]" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/asyncadrequestsets"

detail more……

 

See:

• Ad Campaign, Ad Set, and Ad Creative
• Ad Statistics
• Storing Ad Objects

 

 

An ad object contains the data necessary to visually display an ad and associate it with a corresponding ad set.

 

 

Permissions

Developers usually request these permissions for this endpoint:

Marketing Apps

• ads_management
• ads_read

Page management Apps

　　No data

Other Apps

　　No data

 

#By ad ID
curl -G \
-d "fields=name" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_ID>"


#By ad account
curl -G \
-d "fields=name" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads"


#By ad campaign
curl \
-F "fields=name" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<CAMPAIGN_ID>/ads"


#By ad set
curl \
-F "fields=name" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>/ads"

detail more……

 

 

 

Creating

Before you create an ad, you need an existing ad set and ad creative. You can create ads synchronously and asynchronously.

New ads are in pending state and do not run until Facebook approves or rejects them. After we approve an ad it runs. If you do not want an ad to automatically run after approval, create it and set it to paused, see ad set. Run the set when you are ready.

#Synchronous Creation
#Creates one ad at a time:
curl \
  -F 'name=My Ad' \
  -F 'adset_id=<AD_SET_ID>' \
  -F 'creative={"creative_id":"<CREATIVE_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/ads


#Asynchronous Creation
#Create multiple ads at a time asynchronously. Receive a notification when all the ads in the request exist. 
#Make an HTTP POST to: https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/asyncadrequestsets



#Download details for an ad:
curl \
-F "name=my ad" \
-F "adset_id=<AD_SET_ID>" \
-F "creative={'creative_id':<AD_CREATIVE_ID>}" \
-F "redownload=true" \
-F "status=PAUSED" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads"




#You can make a POST request to copies edge from the following paths:
#/{ad_id}/copies
#When posting to this edge, an Ad will be created.

detail more……　

 

Permissions

Developers usually request these permissions for this endpoint:

Marketing Apps

• ads_management
• ads_read
• manage_pages
• pages_show_list
• business_management

Page management Apps

　　No data

Other Apps

　　No data

 

 

 

You can make a POST request to ads edge from the following paths:

• /act_{ad_account_id}/ads

 

#
curl -X POST \
     -d "name=My+Ad" \
     -d "adset_id=%7Bad-campaign-group-id%7D" \
     -d "creative=%7B%22creative_id%22%3A%22%7Bi-ent-ad-creative-core-id%7D%22%7D" \
     -d "status=PAUSED" \
        https://graph.facebook.com/v2.12/act_{ad-account-id}/ads

　　

 

 

You may perform a POST request to the following edges from this node:

• /{ad_id}/leads
• /{ad_id}/insights

 

#Updating


#Update certain fields:
curl \
-F "name=New Ad Name" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_ID>"



#Update the name
curl \
-F "name=newname" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_ID>"




#Update the status:
curl \
-F "status=ADGROUP_PAUSED" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_ID>"




curl -X POST \
     -d "name=My+New+Ad" \
        https://graph.facebook.com/v2.12/{adgroup-id}/

detail more……　

　

 

You can update an Ad by making a POST request to /{ad_id}.

 

You may perform a POST request to the following edge from this node:

• /{ad_id}/adlabels

 

 

 

#Deleting

#Deleting an ad
#You can remove values for any optional fields by updating the value to empty. 
#You cannot delete ads in ad set with creative_sequence settings.
curl \
-F "status=DELETED" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_ID>"

　　

You can delete an Ad by making a DELETE request to /{ad_id}.

 

 

You may perform a DELETE request to the following edge from this node:

• /{ad_id}/adlabels