Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

In order to avoid drastically limiting the number of bid requests sent to your bidder, you need to set the send_unaudited field on the bidder object to true using the Bidder Service. This is true even though there is a non_audited_url_action (which defaults to "include") on the Legacy Bidder Profile Service.

Code Block
$ cat send-unaudited.json
{
    "bidder": {
        "send_unaudited": true,
        "id": 497
    }
}
      

...

In this step, we'll create a segment and put ourselves in it to test the integration. Later on, we'll target this segment with the Bidder Profile during testing. This will serve several purposes:

...

Multiexcerpt
MultiExcerptNamecreate-a-bidder-profile

In the example below, the targeting breaks down like this:

  • We include (that is, target) the testing segment ID we just created.
  • Although we set the passthrough percent to 0, we should still receive bid requests for users in our members' segments. For details, see the docs for passthrough_percent on the Legacy Bidder Profile Service.
  • The segment boolean operator is set to "or" in case we'd like to add more testing segments later.
  • Finally, we target a few common mobile sizes just for fun.
Tip
title

This profile is meant to provide a simple example for onboarding use. It's unlikely to be appropriate for production scenarios. For more information about all of the options available with profiles, see the Legacy Bidder Profile Service and the Bidder Profile - FAQ.

Code Block
$ cat create-bidder-profile-json

{
    "profile": {
        "description": "Ethical Kangaroo Test Segment",
        "passthrough_percent": 0,
        "code": "ethical-kangaroo-00",
        "segment_targets": [
            {
                "id": 110944,
                "action": "include"
            }
        ],
        "segment_boolean_operator": "or",
        "size_targets": [
            {
                "width": 300,
                "height": 250
            },
            {
                "width": 300,
                "height": 50
            }
        ]
    }
}
      
Code Block
$ export IB_TESTING="http://api-test.adnxs.com";
$ curl -b cookies -X POST -d @create-bidder-profile.json $IB_TESTING/profile/497

{"response":{"status":"OK","count":1,"start_element":null,"num_elements":null,"id":431739,"profile":{"id":431739,"code":"ethical-kangaroo-00","description":"Ethical Kangaroo Test Segment","country_action":"exclude","region_action":"exclude","city_action":"exclude","browser_action":"exclude","use_inventory_attribute_targets":false,"last_activity":"2015-01-22 05:01:25","daypart_timezone":null,"dma_action":"exclude","domain_action":"exclude","domain_list_action":"exclude","inventory_action":"exclude","language_action":"exclude","segment_boolean_operator":"or","min_session_imps":null,"session_freq_type":"platform","carrier_action":"exclude","supply_type_action":"exclude","device_type_action":"exclude","screen_size_action":"exclude","device_model_action":"exclude","location_target_radius":null,"location_target_latitude":null,"location_target_longitude":null,"querystring_action":"exclude","querystring_boolean_operator":"and","is_expired":false,"non_audited_url_action":"include","member_id":null,"daypart_bitmap":null,"passthrough_percent":0,"country_targets":null,"region_targets":null,"city_targets":null,"inv_class_targets":null,"inventory_source_targets":null,"inventory_attribute_targets":null,"age_targets":null,"daypart_targets":null,"browser_targets":null,"browser_family_targets":null,"dma_targets":null,"domain_targets":null,"domain_list_targets":null,"language_targets":null,"size_targets":[{"width":300,"height":50},{"width":300,"height":250}],"postal_code_targets":null,"member_targets":[{"id":4782,"action":"include","third_party_auditor_id":null,"billing_name":"unexposed"}],"segment_group_targets":null,"carrier_targets":null,"supply_type_targets":null,"device_type_targets":null,"screen_size_targets":null,"device_model_targets":null,"querystring_targets":null,"gender_targets":null,"intended_audience_targets":null,"inventory_group_targets":null,"inventory_network_resold_targets":null,"ip_targets":null,"operating_system_targets":null,"operating_system_family_targets":null,"position_targets":null,"site_targets":null,"venue_targets":null,"operating_system_extended_targets":null,"segment_targets":[{"id":110944,"action":"include","start_minutes":null,"expire_minutes":null,"other_less":null,"other_greater":null,"other_equals":null,"code":"ethical-kangaroo-00","name":"ethical kangaroo segment 00","deleted":false,"other_in_list":null}]},"dbg":{"instance":"01.api.client03.lax1","slave_hit":false,"db":"master","time":301.28717422485,"version":"1.14.128","warnings":[],"start_microtime":1421903554.9082}}}
      

...

Multiexcerpt
MultiExcerptNameassociate-profile-with-bidder-object

The profile we've just configured can't take effect until it's associated with your bidder object. Since we're doing integration testing, we'll set the profile we just created as the parent profile.

Tip
title

Much more complex targeting configurations are possible in production settings with the right combination of parent and child profiles. For more information, see the Legacy Bidder Profile Service and the Bidder Profile - FAQ.

Code Block
$ cat update-bidder-with-bidder-profile-json
{
    "bidder": {
        "id": 497,
        "parent_profile_id" : 431739
    }
}
      
Code Block
$ export IB_TESTING="http://api-test.adnxs.com";
$ curl -b cookies -X PUT -d @update-bidder-with-bidder-profile.json $IB_TESTING/bidder/497
{"response":{"status":"OK","count":1,"start_element":null,"num_elements":null,"id":497,"bidder":{"id":497,"name":"Rich's Cool Bidder","short_name":"RCB","throttling":"none","active":false,"bid_uri":"\/bid","notify_uri":"\/notify","click_uri":"\/click","ready_uri":"\/ready","pixel_uri":"\/pixel","audit_notify_uri":null,"send_exelate":false,"send_ixi":false,"send_lucid":false,"send_datran":false,"send_class_2":true,"send_class_3":true,"notify_full_auction":false,"userdata_javascript":null,"userdata_entity_id":null,"send_owned_blacklist":false,"exclude_unowned":false,"send_unaudited":false,"lucid_level":0,"dongle":"ABFAB","num_conns":3,"bid_percent":100,"is_dp":false,"setuid_function":null,"parent_profile_id":431739,"last_activity":"2015-01-22 05:07:10","default_currency":"USD","max_allowed_profiles":5,"notify_lost":false,"notify_pending":false,"notify_no_bid":false,"always_send_owned_segments":true,"object_limit_notify_email":null,"account_owner_user_id":null,"protocol_id":1,"protocol_name":"none","child_profiles":null,"lifetime_budget":null,"lifetime_budget_imps":null,"daily_budget":null,"daily_budget_imps":null},"dbg":{"instance":"01.api.client03.lax1","slave_hit":false,"db":"master","time":56.746959686279,"version":"1.14.128","warnings":[],"start_microtime":1421903900.3984}}}
      

...

ProductProduct endpointClient Testing endpoint
Impbus

http://ib.adnxs.com

http://ib-test.adnxs.com

Impbus APIhttp://api.adnxs.com

http://api-test.adnxs.com

Read more about the Client Testing Environment.

Related Topics