# form for use in connection with the web services and APIs provided by # Facebook. # As with any software that integrates with the Facebook platform, your use # of this software is subject to the Facebook Developer Principles and # Policies [http://developers.facebook.com/policy/]. This copyright notice # shall be included in all copies or substantial portions of the software. # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL # THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER # DEALINGS IN THE SOFTWARE. from examples.docs import fixtures custom_audience_id = fixtures.create_custom_audience().get_id_assured() # _DOC open [CUSTOM_AUDIENCE_USERS_REMOVE_EMAILS] # _DOC vars [custom_audience_id:s] from facebookads.objects import CustomAudience audience = CustomAudience(custom_audience_id) users = ['*****@*****.**', '*****@*****.**', '*****@*****.**'] audience.remove_users(CustomAudience.Schema.email_hash, users) # _DOC close [CUSTOM_AUDIENCE_USERS_REMOVE_EMAILS]
# _DOC open [CUSTOM_AUDIENCE_CREATE_WCA] # _DOC vars [ad_account_id:s, pixel_id] from facebookads.objects import CustomAudience audience = CustomAudience(parent_id=ad_account_id) audience[CustomAudience.Field.name] = 'my audience' audience[CustomAudience.Field.subtype] = CustomAudience.Subtype.website audience[CustomAudience.Field.retention_days] = 15 audience[CustomAudience.Field.rule] = {'url': {'i_contains': 'shoes'}} audience[CustomAudience.Field.pixel_id] = pixel_id audience.remote_create() # _DOC close [CUSTOM_AUDIENCE_CREATE_WCA] custom_audience_id = fixtures.create_custom_audience().get_id_assured() # _DOC open [CUSTOM_AUDIENCE_DELETE] # _DOC vars [custom_audience_id:s] from facebookads.objects import CustomAudience audience = CustomAudience(custom_audience_id) audience.remote_delete() # _DOC close [CUSTOM_AUDIENCE_DELETE] custom_audience_id = fixtures.create_custom_audience().get_id_assured() # _DOC open [CUSTOM_AUDIENCE_READ_RULE] # _DOC vars [custom_audience_id:s] from facebookads.objects import CustomAudience
# shall be included in all copies or substantial portions of the software. # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL # THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER # DEALINGS IN THE SOFTWARE. from examples.docs import fixtures from facebookads import test_config ad_account_id = test_config.account_id campaign_id = fixtures.create_campaign().get_id_assured() custom_audience = fixtures.create_custom_audience() custom_audience_id = custom_audience['id'] audience_name = custom_audience['name'] # _DOC open [ADSET_CREATE_CUSTOM_AUDIENCE_PARTNER_CATEGORIES_TARGETING] # _DOC vars [ad_account_id:s, campaign_id, custom_audience_id, audience_name] from facebookads.objects import AdSet adset = AdSet(parent_id=ad_account_id) adset.update({ AdSet.Field.name: 'My AdSet', AdSet.Field.optimization_goal: AdSet.OptimizationGoal.reach, AdSet.Field.billing_event: AdSet.BillingEvent.impressions, AdSet.Field.bid_amount: 150, AdSet.Field.daily_budget: 2000, AdSet.Field.campaign_id: campaign_id,
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL # THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER # DEALINGS IN THE SOFTWARE. from examples.docs import fixtures from facebookads import test_config ad_account_id = test_config.account_id page_id = test_config.page_id campaign_id = fixtures.create_campaign().get_id() lookalike_audience_id = fixtures.create_custom_audience().get_id() # _DOC open [ADSET_CREATE_LOOKALIKE_TARGETING] # _DOC vars [ad_account_id:s, campaign_id:s, lookalike_audience_id] from facebookads.objects import AdSet adset = AdSet(parent_id=ad_account_id) adset.update({ AdSet.Field.name: 'My Adset', AdSet.Field.daily_budget: 10000, AdSet.Field.campaign_id: campaign_id, AdSet.Field.optimization_goal: AdSet.OptimizationGoal.link_clicks, AdSet.Field.billing_event: AdSet.BillingEvent.link_clicks, AdSet.Field.bid_amount: 150, AdSet.Field.daily_budget: 2000, AdSet.Field.targeting: {