Skip to content

Commit 36fc82c

Browse files
FanJupsFanJups
authored
Merge pull request #1 from facebook/master
Syncing
2 parents 932bc32 + 5226059 commit 36fc82c

File tree

247 files changed

+81249
-46838
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

247 files changed

+81249
-46838
lines changed

‎.travis.yml

+11
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
language: java
2+
jdk:
3+
- oraclejdk8
4+
5+
dist: trusty
6+
7+
branches:
8+
only:
9+
- master
10+
11+
install: mvn package

‎CHANGELOG.md

+27
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,33 @@ All notable changes to this project will be documented in this file.
44

55

66
## Unreleased
7+
- Server-side API added search_string to CustomData.
8+
9+
## v5.0.3
10+
11+
- Added function `getHeader()` in APIException class which provides header information
12+
- Made `omit_response_on_success` configurable for addToBatch method in APIRequest
13+
## v5.0.1
14+
15+
### Added
16+
- Added `CrashRepoter`, more context available [here](https://developers.facebook.com/docs/business-sdk/guides/crash-reports)
17+
18+
## v5.0.0
19+
### Changed
20+
- Graph API call upgrade to [v5.0](https://developers.facebook.com/docs/graph-api/changelog/version5.0)
21+
22+
## v4.0.8
23+
24+
- Added strongly typed Server-Side API with normalization for Web (https://developers.facebook.com/docs/marketing-api/facebook-pixel/server-side-api/using-the-api)
25+
26+
## v4.0.6
27+
28+
### Fixed
29+
- Add back `source` param in `APIRequestCreateAdVideo`.
30+
31+
## v4.0.0
32+
### Changed
33+
- Graph API call upgrade to [v4.0](https://developers.facebook.com/docs/graph-api/changelog/version4.0)
734

835
## v3.3.1
936
### Changed

‎examples/AdAccountAdSetsPost2CreateMAIA.java

+60
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
/**
2+
* Copyright (c) 2015-present, Facebook, Inc. All rights reserved.
3+
*
4+
* You are hereby granted a non-exclusive, worldwide, royalty-free license to
5+
* use, copy, modify, and distribute this software in source code or binary
6+
* form for use in connection with the web services and APIs provided by
7+
* Facebook.
8+
*
9+
* As with any software that integrates with the Facebook platform, your use
10+
* of this software is subject to the Facebook Developer Principles and
11+
* Policies [http://developers.facebook.com/policy/]. This copyright notice
12+
* shall be included in all copies or substantial portions of the software.
13+
*
14+
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15+
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16+
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17+
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18+
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
19+
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
20+
* DEALINGS IN THE SOFTWARE.
21+
*
22+
*/
23+
24+
import com.facebook.ads.sdk.*;
25+
import java.io.File;
26+
import java.util.Arrays;
27+
28+
public class AdAccountAdSetsPost2CreateMAIA {
29+
public static void main (String args[]) throws APIException {
30+
31+
String access_token = "<ACCESS_TOKEN>";
32+
String app_secret = "<APP_SECRET>";
33+
String app_id = "<APP_ID>";
34+
String id = "<AD_ACCOUNT_ID>";
35+
APIContext context = new APIContext(access_token).enableDebug(true);
36+
37+
new AdAccount(id, context).createAdSet()
38+
.setName("Mobile App Installs Ad Set")
39+
.setDailyBudget(1000L)
40+
.setBidAmount(2L)
41+
.setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
42+
.setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_APP_INSTALLS)
43+
.setCampaignId("<adCampaignAppInstallsID>")
44+
.setPromotedObject("{\"application_id\":\"<appID>\",\"object_store_url\":\"<appLink>\"}")
45+
.setTargeting(
46+
new Targeting()
47+
.setFieldDevicePlatforms(Arrays.asList(Targeting.EnumDevicePlatforms.VALUE_MOBILE))
48+
.setFieldFacebookPositions(Arrays.asList("feed"))
49+
.setFieldGeoLocations(
50+
new TargetingGeoLocation()
51+
.setFieldCountries(Arrays.asList("US"))
52+
)
53+
.setFieldPublisherPlatforms(Arrays.asList("facebook", "audience_network"))
54+
.setFieldUserOs(Arrays.asList("IOS"))
55+
)
56+
.setStatus(AdSet.EnumStatus.VALUE_PAUSED)
57+
.execute();
58+
59+
}
60+
}

‎examples/AdAccountAdSetsPostAdSetCreateCpa.java

+3-2
Original file line numberDiff line numberDiff line change
@@ -38,14 +38,15 @@ public static void main (String args[]) throws APIException {
3838
.setName("A CPA Ad Set")
3939
.setCampaignId("<adCampaignLinkClicksID>")
4040
.setDailyBudget(5000L)
41-
.setStartTime("2019-05-06T08:46:40-0700")
42-
.setEndTime("2019-05-13T08:46:40-0700")
41+
.setStartTime("2019-12-12T23:42:39-0800")
42+
.setEndTime("2019-12-19T23:42:39-0800")
4343
.setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
4444
.setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_REACH)
4545
.setBidAmount(1000L)
4646
.setPromotedObject("{\"page_id\":\"<pageID>\"}")
4747
.setTargeting(
4848
new Targeting()
49+
.setFieldFacebookPositions(Arrays.asList("feed"))
4950
.setFieldGeoLocations(
5051
new TargetingGeoLocation()
5152
.setFieldCountries(Arrays.asList("US"))

‎examples/AdAccountAdSetsPostAdSetCreateCpaAppEvents.java

+3-2
Original file line numberDiff line numberDiff line change
@@ -38,15 +38,16 @@ public static void main (String args[]) throws APIException {
3838
.setName("A CPA Ad Set optimized for App Events")
3939
.setCampaignId("<adCampaignAppInstallsID>")
4040
.setDailyBudget(300L)
41-
.setStartTime("2019-05-06T08:48:58-0700")
42-
.setEndTime("2019-05-13T08:48:58-0700")
41+
.setStartTime("2019-12-12T23:43:36-0800")
42+
.setEndTime("2019-12-19T23:43:36-0800")
4343
.setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
4444
.setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_OFFSITE_CONVERSIONS)
4545
.setBidAmount(100L)
4646
.setStatus(AdSet.EnumStatus.VALUE_PAUSED)
4747
.setPromotedObject("{\"application_id\":\"<appID>\",\"object_store_url\":\"<appLink>\",\"custom_event_type\":\"PURCHASE\"}")
4848
.setTargeting(
4949
new Targeting()
50+
.setFieldFacebookPositions(Arrays.asList("feed"))
5051
.setFieldGeoLocations(
5152
new TargetingGeoLocation()
5253
.setFieldCountries(Arrays.asList("US"))

‎examples/AdAccountAdSetsPostBehaviorTargeting.java

+1
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,7 @@ public static void main (String args[]) throws APIException {
5252
.setFieldId(6004386044572L)
5353
.setFieldName("Android Owners (All)")
5454
))
55+
.setFieldFacebookPositions(Arrays.asList("feed"))
5556
.setFieldGeoLocations(
5657
new TargetingGeoLocation()
5758
.setFieldCountries(Arrays.asList("US"))

‎examples/AdAccountAdSetsPostBidMultiplier.java

+1
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,7 @@ public static void main (String args[]) throws APIException {
4545
.setPromotedObject("{\"product_set_id\":\"<productSetID>\",\"custom_event_type\":\"ADD_TO_CART\"}")
4646
.setTargeting(
4747
new Targeting()
48+
.setFieldFacebookPositions(Arrays.asList("feed"))
4849
.setFieldGeoLocations(
4950
new TargetingGeoLocation()
5051
.setFieldCountries(Arrays.asList("US"))

‎examples/AdAccountAdSetsPostCreateAdSet.java

+3-7
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ public static void main (String args[]) throws APIException {
3737
new AdAccount(id, context).createAdSet()
3838
.setName("My First AdSet")
3939
.setLifetimeBudget(20000L)
40-
.setStartTime("2019-05-06T08:44:23-0700")
41-
.setEndTime("2019-05-13T08:44:23-0700")
40+
.setStartTime("2019-12-12T23:41:41-0800")
41+
.setEndTime("2019-12-19T23:41:41-0800")
4242
.setCampaignId("<adCampaignLinkClicksID>")
4343
.setBidAmount(500L)
4444
.setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
@@ -52,6 +52,7 @@ public static void main (String args[]) throws APIException {
5252
.setFieldId(6002714895372L)
5353
.setFieldName("All travelers")
5454
))
55+
.setFieldFacebookPositions(Arrays.asList("feed"))
5556
.setFieldGenders(Arrays.asList(1L))
5657
.setFieldGeoLocations(
5758
new TargetingGeoLocation()
@@ -67,11 +68,6 @@ public static void main (String args[]) throws APIException {
6768
.setFieldKey("4081")
6869
))
6970
)
70-
.setFieldHomeOwnership(Arrays.asList(
71-
new IDName()
72-
.setFieldId(6006371327132L)
73-
.setFieldName("Renters")
74-
))
7571
.setFieldInterests(Arrays.asList(
7672
new IDName()
7773
.setFieldId("<adsInterestID>")

‎examples/AdAccountAdSetsPostCreateAudienceNetwork.java

+1
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,7 @@ public static void main (String args[]) throws APIException {
4444
.setTargeting(
4545
new Targeting()
4646
.setFieldDevicePlatforms(Arrays.asList(Targeting.EnumDevicePlatforms.VALUE_MOBILE))
47+
.setFieldFacebookPositions(Arrays.asList("feed"))
4748
.setFieldGeoLocations(
4849
new TargetingGeoLocation()
4950
.setFieldCountries(Arrays.asList("US"))

‎examples/AdAccountAdSetsPostDailyBudget20.java

+3-2
Original file line numberDiff line numberDiff line change
@@ -37,14 +37,15 @@ public static void main (String args[]) throws APIException {
3737
new AdAccount(id, context).createAdSet()
3838
.setName("My First Adset")
3939
.setDailyBudget(2000L)
40-
.setStartTime("2019-04-29T08:47:49-0700")
41-
.setEndTime("2019-05-06T08:47:49-0700")
40+
.setStartTime("2019-12-05T23:43:07-0800")
41+
.setEndTime("2019-12-12T23:43:07-0800")
4242
.setCampaignId("<adCampaignLinkClicksID>")
4343
.setBidAmount(100L)
4444
.setBillingEvent(AdSet.EnumBillingEvent.VALUE_LINK_CLICKS)
4545
.setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_LINK_CLICKS)
4646
.setTargeting(
4747
new Targeting()
48+
.setFieldFacebookPositions(Arrays.asList("feed"))
4849
.setFieldGeoLocations(
4950
new TargetingGeoLocation()
5051
.setFieldCountries(Arrays.asList("US"))

‎examples/AdAccountAdSetsPostDemographicTargeting.java

+87
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
/**
2+
* Copyright (c) 2015-present, Facebook, Inc. All rights reserved.
3+
*
4+
* You are hereby granted a non-exclusive, worldwide, royalty-free license to
5+
* use, copy, modify, and distribute this software in source code or binary
6+
* form for use in connection with the web services and APIs provided by
7+
* Facebook.
8+
*
9+
* As with any software that integrates with the Facebook platform, your use
10+
* of this software is subject to the Facebook Developer Principles and
11+
* Policies [http://developers.facebook.com/policy/]. This copyright notice
12+
* shall be included in all copies or substantial portions of the software.
13+
*
14+
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15+
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16+
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17+
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18+
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
19+
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
20+
* DEALINGS IN THE SOFTWARE.
21+
*
22+
*/
23+
24+
import com.facebook.ads.sdk.*;
25+
import java.io.File;
26+
import java.util.Arrays;
27+
28+
public class AdAccountAdSetsPostDemographicTargeting {
29+
public static void main (String args[]) throws APIException {
30+
31+
String access_token = "<ACCESS_TOKEN>";
32+
String app_secret = "<APP_SECRET>";
33+
String app_id = "<APP_ID>";
34+
String id = "<AD_ACCOUNT_ID>";
35+
APIContext context = new APIContext(access_token).enableDebug(true);
36+
37+
new AdAccount(id, context).createAdSet()
38+
.setName("My First AdSet")
39+
.setDailyBudget(10000L)
40+
.setBidAmount(300L)
41+
.setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
42+
.setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_REACH)
43+
.setCampaignId("<adCampaignLinkClicksID>")
44+
.setPromotedObject("{\"page_id\":\"<pageID>\"}")
45+
.setTargeting(
46+
new Targeting()
47+
.setFieldAgeMax(24L)
48+
.setFieldAgeMin(20L)
49+
.setFieldBehaviors(Arrays.asList(
50+
new IDName()
51+
.setFieldId(6002714895372L)
52+
.setFieldName("All travelers")
53+
))
54+
.setFieldDevicePlatforms(Arrays.asList(Targeting.EnumDevicePlatforms.VALUE_MOBILE))
55+
.setFieldFacebookPositions(Arrays.asList("feed"))
56+
.setFieldGenders(Arrays.asList(1L))
57+
.setFieldGeoLocations(
58+
new TargetingGeoLocation()
59+
.setFieldCities(Arrays.asList(
60+
new TargetingGeoLocationCity()
61+
.setFieldDistanceUnit("mile")
62+
.setFieldKey(777934L)
63+
.setFieldRadius(10L)
64+
))
65+
.setFieldCountries(Arrays.asList("US"))
66+
.setFieldRegions(Arrays.asList(
67+
new TargetingGeoLocationRegion()
68+
.setFieldKey("4081")
69+
))
70+
)
71+
.setFieldInterests(Arrays.asList(
72+
new IDName()
73+
.setFieldId("<adsInterestID>")
74+
.setFieldName("<adsInterestName>")
75+
))
76+
.setFieldLifeEvents(Arrays.asList(
77+
new IDName()
78+
.setFieldId(6002714398172L)
79+
.setFieldName("Newlywed (1 year)")
80+
))
81+
.setFieldPublisherPlatforms(Arrays.asList("facebook", "audience_network"))
82+
)
83+
.setStatus(AdSet.EnumStatus.VALUE_PAUSED)
84+
.execute();
85+
86+
}
87+
}

‎examples/AdAccountAdSetsPostInterestTargeting.java

+1
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,7 @@ public static void main (String args[]) throws APIException {
4747
.setFieldAgeMax(24L)
4848
.setFieldAgeMin(20L)
4949
.setFieldDevicePlatforms(Arrays.asList(Targeting.EnumDevicePlatforms.VALUE_MOBILE))
50+
.setFieldFacebookPositions(Arrays.asList("feed"))
5051
.setFieldFlexibleSpec(Arrays.asList(
5152
new FlexibleTargeting()
5253
.setFieldInterests(Arrays.asList(

‎examples/AdAccountAdSetsPostLifetimeBudget200Duration10Days.java

+2-2
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ public static void main (String args[]) throws APIException {
3737
new AdAccount(id, context).createAdSet()
3838
.setName("My First Adset")
3939
.setLifetimeBudget(20000L)
40-
.setStartTime("2019-04-29T08:48:12-0700")
41-
.setEndTime("2019-05-09T08:48:12-0700")
40+
.setStartTime("2019-12-05T23:43:17-0800")
41+
.setEndTime("2019-12-15T23:43:17-0800")
4242
.setCampaignId("<adCampaignLinkClicksID>")
4343
.setBidAmount(100L)
4444
.setBillingEvent(AdSet.EnumBillingEvent.VALUE_LINK_CLICKS)

‎examples/AdAccountAdSetsPostOfferClaim.java

+3-2
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ public static void main (String args[]) throws APIException {
3737
new AdAccount(id, context).createAdSet()
3838
.setName("My Offer Claim AdSet")
3939
.setLifetimeBudget(56000L)
40-
.setStartTime("2019-04-29T08:47:26-0700")
41-
.setEndTime("2019-05-06T08:47:26-0700")
40+
.setStartTime("2019-12-05T23:42:58-0800")
41+
.setEndTime("2019-12-12T23:42:58-0800")
4242
.setCampaignId("<adCampaignLinkClicksID>")
4343
.setBillingEvent(AdSet.EnumBillingEvent.VALUE_LINK_CLICKS)
4444
.setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_LINK_CLICKS)
@@ -48,6 +48,7 @@ public static void main (String args[]) throws APIException {
4848
new Targeting()
4949
.setFieldAgeMax(55L)
5050
.setFieldAgeMin(25L)
51+
.setFieldFacebookPositions(Arrays.asList("feed"))
5152
.setFieldGenders(Arrays.asList(1L))
5253
.setFieldGeoLocations(
5354
new TargetingGeoLocation()

‎examples/AdAccountAdSetsPostOptimizePostEngagement.java

+3-7
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ public static void main (String args[]) throws APIException {
3737
new AdAccount(id, context).createAdSet()
3838
.setName("My First Adset")
3939
.setLifetimeBudget(20000L)
40-
.setStartTime("2019-04-29T08:48:35-0700")
41-
.setEndTime("2019-05-09T08:48:35-0700")
40+
.setStartTime("2019-12-05T23:43:27-0800")
41+
.setEndTime("2019-12-15T23:43:27-0800")
4242
.setCampaignId("<adCampaignLinkClicksID>")
4343
.setBidAmount(500L)
4444
.setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
@@ -53,6 +53,7 @@ public static void main (String args[]) throws APIException {
5353
.setFieldName("All travelers")
5454
))
5555
.setFieldDevicePlatforms(Arrays.asList(Targeting.EnumDevicePlatforms.VALUE_DESKTOP))
56+
.setFieldFacebookPositions(Arrays.asList("feed"))
5657
.setFieldGenders(Arrays.asList(1L))
5758
.setFieldGeoLocations(
5859
new TargetingGeoLocation()
@@ -68,11 +69,6 @@ public static void main (String args[]) throws APIException {
6869
.setFieldKey("4081")
6970
))
7071
)
71-
.setFieldHomeOwnership(Arrays.asList(
72-
new IDName()
73-
.setFieldId(6006371327132L)
74-
.setFieldName("Renters")
75-
))
7672
.setFieldLifeEvents(Arrays.asList(
7773
new IDName()
7874
.setFieldId(6002714398172L)

‎examples/AdAccountAdSetsPostPageLikes.java

+1
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,7 @@ public static void main (String args[]) throws APIException {
4343
.setCampaignId("<adCampaignLinkClicksID>")
4444
.setTargeting(
4545
new Targeting()
46+
.setFieldFacebookPositions(Arrays.asList("feed"))
4647
.setFieldGeoLocations(
4748
new TargetingGeoLocation()
4849
.setFieldCountries(Arrays.asList("US"))

‎examples/AdAccountAdSetsPostPlacementTargeting.java

+1
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,7 @@ public static void main (String args[]) throws APIException {
4343
.setCampaignId("<adCampaignLinkClicksID>")
4444
.setTargeting(
4545
new Targeting()
46+
.setFieldFacebookPositions(Arrays.asList("feed"))
4647
.setFieldGeoLocations(
4748
new TargetingGeoLocation()
4849
.setFieldCountries(Arrays.asList("US"))

‎examples/AdAccountAdSetsPostReach.java

+1
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,7 @@ public static void main (String args[]) throws APIException {
5050
.setFieldKey("3847")
5151
))
5252
)
53+
.setFieldFacebookPositions(Arrays.asList("feed"))
5354
.setFieldGeoLocations(
5455
new TargetingGeoLocation()
5556
.setFieldCountries(Arrays.asList("US"))

0 commit comments

Comments
 (0)