Этот документ обновлен.
Перевод (Русский) еще не готов.
Последнее обновление (английский): 8 сен 2021 г.
Последнее обновление (Русский): 27 мар 2017 г.

Audience Network FAQ

Visit the Audience Network Help Center for more guidance and instructions on working with Audience Network.

Implementation

Прежде чем выставлять приложение в магазине, очень важно убедиться в правильной работе интеграции. Ознакомьтесь с нашим руководством по тестированию интеграции. Справочную информацию по своей интеграции вы также можете найти в руководстве по началу работы. Когда мы проверим ваше приложение, вы автоматически получите возможность показывать настоящую рекламу.

При каждом запросе рекламы SDK будет передавать ID устройства (IDFA для iOS и рекламный ID для Android) на Facebook, чтобы мы могли определить, какую рекламу показывать. Издатель не получит никакой информации о владельце устройства.

На платформе iOS можно интегрировать SDK Audience Network с приложениями, предназначенными для iOS 9 и более поздних версий.

На платформе Android можно интегрировать SDK Audience Network с приложениями, предназначенными для Android SDK с API 15 и более поздних версий.

Yes, the Audience Network delivers ads for publishers using Unity within their iOS and Android app. The Unity SDK supports all of the format supported by the iOS and Android SDKs.

Да, вы можете интегрировать рекламу из другого класса, если этот класс содержит ссылку на поддерживающий его класс Activity. Вы должны передать этот класс Activity в качестве параметра при создании экземпляров рекламы.

Most mediation services have an option to integrate with 3rd party networks using adapters. The following describes the steps needed to setup such integrations:

  1. Add our SDK to your app
  2. Create a Placement ID on the Facebook app settings page. If you use a banner, make sure to select "None" as the refresh interval. The mediation layer will control the automatic refresh.
  3. Add or code the adapter according to your mediation service instructions. These can be either pre-built adapters (see below for Mopub, Admob and DFP) or a custom adapter that you will need to develop.
  4. Configure the adapter name and placement ID in your mediation server UI and allocate impressions to it

See tips for how to get more fill and revenue when using mediation.

Это значит, что мы не можем показать рекламу этому человеку. Это может произойти по следующим причинам:

  • тестировщик не вошел в нативное приложение Facebook на своем мобильном устройстве;
  • вы отключили показ персонализированной рекламы через Audience Network с помощью флага setAdvertiserTrackingEnabled;
  • пользователь не предоставил Facebook разрешение на использование информации об активности в других приложениях и на других сайтах для персонализации рекламы на Facebook;
  • у нас нет рекламных ресурсов, которые можно показать этому человеку.

Обратите внимание: если во время тестирования по инструкциям из нашего руководства отображается настоящая реклама, это свидетельствует о том, что ваше приложение работает правильно и люди смогут просматривать в нем рекламу, как только оно станет рабочим.

  • Заголовок: не более 30 символов
  • Обложка: 1200 x 627 пикселей
  • Значок: квадратный, 128 пикселей
  • Социальный контекст: 30 символов
  • Название кнопки (призыв к действию): менее 20 символов
  • Основной текст: 90 символов
  • Шкала оценок: 5
  • Мин./макс. оценка: 1/5

Чтобы загрузить новое объявление, создайте новый экземпляр нативной рекламы.

Yes, ads can be cached and re-used for up to 60 minutes. If you plan to use the ad after this time period, make a call to load a new ad. After this time passes, if the person has not clicked the ad, you must request a new ad.

После интеграции нашего SDK в ваше приложение для iOS вам нужно будет отправить приложение на проверку в Apple. При проверке у вас спросят, используется ли в приложении рекламный идентификатор (IDFA). Ответьте "Да". Затем вас спросят, как он используется в вашем приложении. Вопрос будет выглядеть так:

This app uses the Advertising Identifier to (select all that apply) (Это приложение использует рекламный идентификатор, чтобы (выберите все варианты применения))

  • Serve advertisements within the app (Показывать рекламу в приложении)
  • Attribute this app installation to a previously served advertisement (Связать эту установку приложения с ранее показанной рекламой)
  • Attribute an action taken within this app to a previously served advertisement (Связать действие, выполненное в этом приложении, с ранее показанной рекламой)

Если вы собираетесь использовать фреймворк Audience Network, нужно выбрать первый вариант. Если вы используете наш основной фреймворк для отслеживания атрибуции установок и событий в приложении, выберите второй и третий варианты. Если используются оба фреймворка, выберите все три варианта.

Да. SDK Audience Network для Android использует рекламный ID и учитывает его параметры минимального трекинга в соответствии с условиями использования Google Play. Мы рекомендуем (но не требуем) использовать для настройки проекта сервисы Google Play. Такой метод настройки приложения улучшает технические характеристики при работе с Audience Network.

1, What is the purpose of this guide?


This guide is intended to help mobile app developers and ad operation personals to validate ad request/response to and from Audience Network in cases such as:

  • Hassles for adding debugging code and investigating mobile device log
  • No clues for missing ad requests or impressions from dashboard
  • Audience Network ad requests are communicated between Audience Network SDK and Audience Network ad server through HTTPS. Testing and confirming ad requests and responses from the HTTPS network activity is the primary and direct step among many other steps.


    2, How to setup Charles Proxy?


    One of the tools to log the ad requests and responses information from the HTTPS is Charles, a web debugging proxy application https://www.charlesproxy.com.

    Charles is an HTTP proxy / HTTP monitor / Reverse Proxy that enables a developer to view all of the HTTP and SSL / HTTPS traffic between their machine and the internet. This includes requests, responses and the HTTP headers (which contain the cookies and caching information).

    It is found that Charles SSL Proxying is very useful and required for viewing all HTTPS ad requests traffic between iOS and Android app and FAN server.

    The SSL Proxying (https://www.charlesproxy.com/documentation/proxying/ssl-proxying/) shows how to setup Charles for iOS and Android device, and host machine running Windows and Mac OS.

    Once SSL Proxying is setup and tested properly, make sure Charles is able to proxy SSL requests and see request/response content.


    3, How to look up ad requests?


    3.1 Setup SSL Proxy for Audience Network

    Update Charles Proxy / SSL Proxying setting by adding Host: “graph.facebook.com” and Port: “8888”, Host: “graph.facebook.com” and Port: “443”.

    3.2 Read SSL Proxy request / response content for Audience Network

    Go to your mobile app and make ad requests, you should see ad request going to FAN server: https://graph.facebook.com/network_ads_common/ and ad response in JSON text form within HTTPS response contents.

    3.3 Confirming ad request sent to and received from Audience Network

    Ad request can be verified if the ad is filled successfully or returned with no fill based on the “code” in the JSON form. “Code” is “0” indicates the request is returned or filled with an ad, “code” is “1001” means no ad is available for the request and app can make another request after passing the specific time limit.

    Below is an example of successful ad response:

    { "type": "ads", "code": 0, "placements": [{ "definition": { "placement_id": "148789268824369_851969285173027", "type": "rewarded_video", "refresh": "0", "refresh_threshold": "-1", "min_viewability_percentage": "1", "viewability_check_ticker": "0", "viewability_check_interval": "100", "viewability_check_initial_delay": "0", "video_time_polling_interval": "200", "cacheable": true, "client_max_retry_count": "1", "invalidation_duration_in_seconds": "3600", "request_timeout": "30000" }, … }

    3.4 Unable to observe an SSL Proxy request for Audience Network

    If no entry point is observed from Charles Proxy for Audience Network end-point (https://graph.facebook.com/network_ads_common/), it should suggest that the primary reason is the mobile app did not make any ad requests to Audience Network server. For this case, re-examining the app integration and app logic is required for mobile developer or ad operation personal.

    4, What is the next step?

    This guide should help you through testing, troubleshooting ad request/response issues with Audience Network.

    If you have further questions on how to use this guide or unanswered questions on ad request/response, please contact our publisher support portal at https://www.facebook.com/business/publishersupport.

    • Маркер доступа системного пользователя позволяет отправлять запросы к API Facebook от имени приложения.
    • ID места размещения представляет собой уникальный для Audience Network идентификатор определенного места размещения в приложении.
    • ID приложения входит в состав ID места размещения. Например, в ID места размещения 1234567898765432_9876543212345678 цифры перед знаком подчеркивания — это ID приложения.
    • ID объекта монетизации — это уникальный для Audience Network идентификатор приложения. Один ID объекта монетизации можно использовать на нескольких платформах, например Android и iOS.

    Publisher Policies

    Мы хотим, чтобы людям было удобно пользоваться вашим приложением, поэтому просим вас соблюдать Политики Audience Network при интеграции рекламы.

    Мы оставляем за собой право по собственному усмотрению и по любым причинам отклонять, одобрять или удалять любых издателей, включая тех, кто вредит нашим отношениям с посетителями сайта или продвигает материалы, услуги или действия, подрывающие нашу конкурентоспособность или противоречащие нашим интересам и взглядам на рекламу. Приведенные здесь рекомендации могут быть изменены в любой момент.

    In order to ensure that our publishers are offering a high quality advertising experience, we require that all apps serving Facebook ads are in compliance with our Audience Network policies.

    All apps in our network will be reviewed by automated systems as well as manually checked for quality and compliance. We will have on-going quality review to ensure continued adherence to our policies and Audience Network design guidelines.

    Мы на Facebook уверены, что реклама не должна мешать пользователям работать с приложением. Мы преследуем эту цель как на Facebook, так и в Audience Network.

    Каждая реклама в Audience Network может быть показана и на Facebook. Поэтому она должна соответствовать строгим правилам Facebook и проходить предварительные и повторные проверки. Иными словами, партнерам-издателям Facebook предоставляется такая же защита, какую мы используем для собственного сайта. С нашими политиками в области рекламы можно ознакомиться здесь. Эти политики призваны обеспечить высокое качество рекламы, безопасность брендов и соответствие всем действующим законодательным требованиям.

    Мы признаем ваше право отказаться от показа в своем приложении конкретной рекламы или объявлений определенного типа, даже если они отвечают нашим политикам. Как партнер-издатель Audience Network вы можете отфильтровывать рекламодателей или категории рекламодателей (например, политическую рекламу) по своему усмотрению.

    Узнайте, как указать рекламодателей, которые могут показывать рекламу в вашем приложении или на сайте.

    Performance

    Реклама будет выглядеть практически так же, как существующая реклама Facebook для мобильных устройств. Клик по рекламе переместит пользователя в магазин для скачивания приложения, откроет веб-страницу в браузере или запустит существующее приложение на телефоне. Реклама будет состоять из баннеров, вставок и нативной рекламы в соответствии с плейсментами рекламы в вашем приложении. Она будет содержать те же элементы, что и стандартная реклама Facebook.

    Узнайте больше о том, какую рекламу можно запускать в Audience Network, и о том, что происходит, когда люди взаимодействуют с ней.

    Издателям никогда не предоставляется список рекламодателей, даже в издательских отчетах. Реклама, размещаемая в приложениях издателя, будет проверяться специалистами Facebook на соответствие руководству по рекламе на Facebook.

    Это непостоянные величины. Результативность рекламы будет меняться в зависимости от таких факторов, как аудитория, плейсменты рекламы и рекламные кампании, соответствующие базе ваших пользователей.

    Заполняемость может со временем меняться, так как наша сеть постоянно развивается. Количество рекламных объявлений, которые могут быть показаны в вашем приложении, зависит от множества факторов, таких как демографические данные базы пользователей, география и спрос рекламодателей.

    Если вы заметили внезапные изменения заполняемости, убедитесь, что:

    • Ваша интеграция работает правильно.
    • Вы добавили все мобильные свойства (мобильные приложения и сайты) во вкладку «Приложения и сайты», и команда Audience Network их одобрила.
    • Нет дополнительных фильтров
    • Используется последняя версия SDK
    • Запросы не отправляются слишком часто (например, реклама для одного и того же ID плейсмента не запрашивается несколько раз в течение 15 секунд).

    Ad refresh is not supported by Facebook Audience Network. In addition, disableAutoRefresh is deprecated from FBAdView (iOS) and AdView (Android) in the 4.99 release and above.

    Перейдите во вкладку «Фильтр» в разделе Audience Network, чтобы исключить приложения, рекламу которых вы не хотите видеть у себя. Если вы хотите также запретить показ рекламы с определенных сайтов, исключите соответствующие домены в этой вкладке.

    Помимо этого, Audience Network автоматически определяет мобильное приложение, которое вы добавили в настройки приложения на Facebook (developers.facebook.com/apps/[ID_ВАШЕГО_ПРИЛОЖЕНИЯ]>/settings/).

    Обратите внимание, что слишком большое количество ограничений негативно повлияет на показ рекламы и снизит заполняемость.

    Мы на Facebook заинтересованы в том, чтобы рекламодатели в Audience Network получали существенную прибыль на инвестированный капитал, и поэтому стремимся, чтобы каждый клик был подлинным и намеренным. Мы не прощаем издателям ни одного мошеннического клика. При обнаружении злоупотреблений доступ издателя немедленно блокируется. Мы тщательно отслеживаем все клики и показы в Audience Network, чтобы обнаружить модели поведения, характерные для мошенничества. Мы не берем плату с рекламодателей и не платим издателям за клики, которые мы считаем ненадлежащими.

    Заполняемость вычисляется как отношение общего числа полученных объявлений к сумме разрешенных запросов. Запрос не учитывается в следующих сценариях:

    • Слишком частые запросы рекламы. Например, если реклама с одним и тем же ID плейсмента запрашивается чаще одного раза в 15 секунд
    • IDFA (iOS) или рекламный идентификатор (Android) недоступен или не может использоваться для показа рекламы
    • В запрашивающем приложении не установлен Facebook или пользователь не входил в него в последнее время

    Reports

    Для доступа к отчетам добавьте членов своей команды в приложение как администраторов или пользователей статистики. Чтобы добавить или изменить назначение ролей, откройте настройки приложения на Facebook и выберите раздел «Роли».

    Чтобы найти отчеты, перейдите в раздел «Audience Network» в настройках приложения и выберите вкладку «Эффективность». В отчетах отображаются общие показатели эффективности и подробные данные за определенный период. Более углубленный анализ эффективности можно получить по стране или ID плейсмента.

    Чтобы просмотреть историю и данные выплат, перейдите в раздел «Audience Network» и выберите вкладку «Выплаты».

    Мы не разглашаем и не отображаем в отчетах информацию о рекламодателях. Если вы хотите отфильтровать определенного рекламодателя или категорию рекламодателей, перейдите в раздел «Audience Network» настроек приложения и выберите вкладку «Фильтр».

    Да. Подробнее о том, как считывать данные об эффективности приложения программным способом, см. здесь.

    Getting Paid

    You can set up payments by completing the publisher payout forms. The forms are located under the payout tab in the "Audience Network" section in your app settings page. We require your bank name, SSN/TIN and tax information in order to process your payouts.

    Note: You need to set up your payout information for ad delivery to start.

    Contact us by clicking on "Need Help?" button within Audience Network Dashboard if you are having problems completing the forms.

    For more information see Add Payout Information.

    You will receive payment on approximately the 21st of each month for the previous month's balance. Read our Audience Network Terms for more information.

    Contact us by clicking on "Need Help?" button within Audience Network Dashboard if you do not receive a payment or if you have questions about the payout process.

    Выплата производится, когда на вашем счету накапливается не менее 100 долларов. Выплаты за предыдущий месяц производятся 21 числа текущего месяца.

    Сначала перейдите в раздел Audience Network во вкладку «Выплата» и убедитесь, что вы полностью прошли процедуру выплаты.

    В случае проблем, связанных с выплатами, свяжитесь с нами, нажав кнопку «Нужна помощь?» в панели Audience Network.

    Чтобы изменить платежные данные, перейдите в раздел «Audience Network» настроек приложения и выберите вкладку «Выплаты».

    Мы считаем, что Audience Network улучшает рекламу для мобильных устройств и помогает издателям и разработчикам монетизировать свои приложения. Однако на данном этапе мы не можем принять на себя обязательства по выплатам определенной доли прибыли. Отчеты в реальном времени и суммы планируемой выручки можно найти в разделе «Audience Network» на странице настроек приложения.

    Managing your apps

    Чтобы добавить нового администратора или разработчика в существующее приложение Facebook, откройте вкладку «Роли» на Панели приложений и выберите команду «Добавить администраторов» или «Добавить разработчиков».

    In This Section

    Information for Child-Directed Apps and Services

    Explains your responsibilities under the U.S. Children's Online Privacy Protection Act (COPPA).

    California Consumer Privacy Act (CCPA) Compliance

    Describes how to limit your app or website's use of personal information to comply with the California Consumer Privacy Act (CCPA).