Dieses Dokument wurde aktualisiert.
Die Übersetzung ins Deutsche ist noch nicht fertig.
Englisch aktualisiert: 22.08.2022

FAQ zu Audience Network

Im Audience Network-Hilfebereich findest du weitere Hinweise und Anweisungen zur Arbeit mit Audience Network.

Implementierung

Bevor du deine App im Store veröffentlichst, ist es überaus wichtig, dass du die Integration getestet hast und sie ordnungsgemäß funktioniert. In unserem Leitfaden erfährst du, wie du deine Implementierung testen kannst. Du kannst auch unseren Leitfaden mit Ersten Schritten befolgen, wenn du Hilfe bei der Integration benötigst. Nachdem wir deine App überprüft haben, kannst du automatisch echte Werbeanzeigen bereitstellen.

Bei jeder Werbeanzeigenanfrage leitet das SDK die Geräte-ID (IDFA bei iOS und Werbe-ID bei Android) an Facebook weiter, damit wir eine geeignete Werbeanzeige zum Anzeigen auswählen können. Personenbezogene Informationen werden nicht an den Herausgeber weitergegeben.

Auf iOS kannst du das Audience Network-SDK in Apps integrieren, die für iOS 9 oder höher entwickelt wurden.

Unter Android kann das neueste Audience Network-SDK mit Apps für API-Version 15 des Android-SDK oder höher integriert werden.

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.

Ja, du kannst Werbeanzeigen von einer Nicht-Aktivität-Klasse implementieren, solange sich die Klasse auf die Holding-Aktivität bezieht. Beim Erstellen von Werbeanzeigeninstanzen musst du diese Aktivität als Parameter einfügen.

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.

Es bedeutet, dass wir dieser Person keine Werbeanzeigen bereitstellen können. Dies kann verschiedene Ursachen haben, unter anderem:

  • Die testende Person hat sich auf ihrem Mobilgerät nicht bei der nativen Facebook-App angemeldet.
  • Du hast Facebook über das Flag setAdvertiserTrackingEnabled informiert, keine personalisierten Werbeanzeigen über das Audience Network bereitzustellen.
  • Die Person hat Facebook keine Erlaubnis erteilt, ihre Aktivität zu nutzen, die andere Apps und Websites an Facebook senden, um die von Facebook dieser Person bereitgestellten Werbeanzeigen zu personalisieren.
  • Wir haben keinen Werbeanzeigenbestand, den wir der Person zeigen könnten.

Hinweis: Wenn du beim Testen gemäß unserem Testleitfaden echte Werbeanzeigen sehen kannst, funktioniert deine Implementierung einwandfrei und andere können Werbeanzeigen in deiner App sehen, sobald sie live geschaltet wurde.

  • Titel: maximal 30 Zeichen
  • Titelbild: 1.200 x 627 Pixel
  • Symbol: 128 Pixel, quadratisch
  • Sozialer Kontext: 30 Zeichen
  • Titel für Button (Call to Action): weniger als 20 Zeichen
  • Haupttext: 90 Zeichen
  • Bewertungsskala: 5
  • Bewertung min./max.: 1/5

Erstelle eine neue Native Ad-Instanz, um eine neue Werbeanzeige zu laden.

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.

Nachdem du unser SDK in deine iOS-App integriert hast, musst du deine App zur Prüfung an Apple senden. Im Rahmen dieses Prüfungsverfahrens wirst du gefragt, ob deine App den Advertising Identifier (IDFA) verwendet. Markiere bitte „Ja“. Anschließend wirst du gefragt, wie deine App ihn nutzt. Die Frage wird in etwa wie folgt lauten:

Diese App nutzt den Advertising Identifier zum … (alles Zutreffende auswählen)

  • Bereitstellen von Werbeanzeigen in der App
  • Zuordnen dieser App-Installation zu einer zuvor bereitgestellten Werbeanzeige
  • Zuordnen einer in dieser App durchgeführten Aktion zu einer zuvor bereitgestellten Werbeanzeige

Falls du das Audience Network-Framework nutzt, musst du die erste Option auswählen. Falls du unser Core Framework nutzt, um Installationsattributionsereignisse und App-Events zu verfolgen, wähle bitte die zweite und die dritte Option aus. Falls du beides nutzt, wähle bitte alle drei aus.

Ja, das Audience Network-SDK für Android verwendet die Werbe-ID und respektiert die Option zur eingeschränkten Nachverfolgung gemäß den Nutzungsbedingungen von Google Play. Wir empfehlen dir, dass du dein Projekt über die Google Play Services einrichtest. Die Entscheidung liegt aber bei dir. Wenn du deine App auf diese Weise einrichtest, funktioniert das Audience Network effizienter.

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.

    • Systemnutzer Zugriffsschlüssel: Damit werden Anfragen im Namen einer App an Facebook-APIs gesendet.
    • Placement ID: Eindeutige Audience Network-ID für eine bestimmte Anzeigenplatzierung in deiner App.
    • App-ID: Die App-ID ist Teil der Placement ID. In der Placement ID 1234567898765432_9876543212345678 beispielsweise sind die Zahlen vor dem Unterstrich die App-ID.
    • Asset-ID: Eindeutige Audience Network-ID deiner App. Du kannst dieselbe Asset-ID für mehrere Plattformen wie Android und iOS verwenden.

    Richtlinien für Herausgeber

    Um den Nutzern deiner App die bestmögliche Erfahrung zu garantieren, musst du bei der Integration deiner Werbeanzeigen unsere Audience Network-Richtlinien beachten.

    Wir behalten uns das Recht vor, einen Publisher nach alleinigem Ermessen aus beliebigen Gründen zu akzeptieren, abzulehnen oder zu entfernen. Dies gilt insbesondere für Publisher, die die Beziehung zu unseren Kunden und Partnern belasten oder Inhalte, Dienste oder Aktivitäten fördern, die nicht mit unserer Wettbewerbsposition, unseren Interessen oder unserer Werbephilosophie übereinstimmen. Diese Richtlinien können jederzeit ohne Ankündigung geändert werden.

    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.

    Bei Facebook sind wir davon überzeugt, dass Werbeanzeigen die allgemeine Nutzererfahrung bereichern und nicht beeinträchtigen sollten. Wir möchten dieses Ziel sowohl auf Facebook als auch im Audience Network realisieren.

    Jede Werbeanzeige im Audience Network kann auch auf Facebook geschaltet werden. Das bedeutet wiederum, dass jede Werbeanzeige unseren strengen Richtlinien für Werbeanzeigen unterliegt und unseren proaktiven und reaktiven Überprüfungsprozess durchlaufen muss. Einfach gesagt bietet Facebook seinen Publisherpartnern genau den gleichen Schutz, den wir für unsere eigene Webseite verwenden. Unsere Richtlinien für Werbeanzeigen findest du hier. Diese Richtlinien sollen sicherstellen, dass Werbeanzeigen qualitativ hochwertig und markensicher sowie mit allen geltenden Gesetzen konform sind.

    Wir sind uns bewusst, dass du möglicherweise eine bestimmte Werbeanzeige oder eine Werbeanzeigenart nicht in deiner App anzeigen möchtest, unabhängig davon, ob sie unseren Richtlinien entspricht. Als Publisherpartner im Audience Network hast du die Möglichkeit, bestimmte Werbekunden oder Werbekategorien nach Belieben herauszufiltern (z. B. politische Werbeanzeigen).

    Finde heraus, wie du die Werbekunden einschränkst, die Werbeanzeigen in deiner App oder auf deiner Webseite schalten können.

    Performance

    Die Werbeanzeigen sind unseren bestehenden mobilen Werbeanzeigen auf Facebook sehr ähnlich. Wenn ein Nutzer auf eine Werbeanzeige klickt, wird entweder der App Store zum Herunterladen einer App aufgerufen, eine Webseite öffnet sich im Browser oder eine bereits vorhandene App wird auf dem Gerät gestartet. Die Werbeanzeigen bestehen aus Banner, Interstitial und Native Ads – je nachdem, welche Werbeanzeigenplatzierungen du in deiner App verwendest. Die Werbeanzeigen enthalten dieselben Elemente wie Standard-Facebook-Werbeanzeigen.

    Erfahre mehr darüber, welche Werbeanzeigen im Audience Network angezeigt werden können und was passiert, wenn Personen damit interagieren.

    Publisher erhalten zu keinem Zeitpunkt eine Liste der Werbekunden, auch nicht in Publisherberichten. Werbeanzeigen, die in den Apps von Herausgebern angezeigt werden, werden von Facebook überprüft und sind mit den Werberichtlinien von Facebook konform.

    Das ist unterschiedlich, da die Performance von vielen Faktoren abhängt, zum Beispiel von der Zielgruppe, der Werbeanzeigenplatzierung und den Werbekampagnen, die auf deine Nutzerbasis ausgerichtet sind.

    Deine Füllrate kann sich verändern, da wir unser Netzwerk permanent weiterentwickeln. Viele Faktoren, wie die Demografie deiner Nutzerbasis, ihr Standort und die Nachfrage von Werbekunden, können sich verändern und sich auf die Anzahl der Werbeanzeigen auswirken, die in deiner App angezeigt werden.

    Wenn sich deine Füllrate plötzlich stark verändert, solltest du Folgendes sicherstellen:

    • dass deine Implementierung korrekt ist
    • dass du alle mobilen Ressourcen (mobilen Apps und Webseiten) im Tab „Apps und Webseiten“ hinzugefügt hast und diese vom Audience Network genehmigt wurden
    • dass du keine zusätzlichen Filter anwendest
    • dass du das neueste SDK verwendest
    • dass du nicht zu viele Anfragen abschickst (z. B. wenn du eine Werbeanzeige für dieselbe Placement ID mehrmals innerhalb von 15 Sekunden anforderst).

    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.

    Verwende den Filter-Tab im Audience Network-Abschnitt, um Apps auszuschließen, deren Werbeanzeigen nicht in deiner App angezeigt werden sollen. Du kannst auch Webdomains ausschließen, wenn keine Werbeanzeigen von bestimmten Webseiten geschaltet werden sollen.

    Zusätzlich zu diesen Einstellungen erkennt das Audience Network automatisch die mobile App, die du in deinen Facebook-App-Einstellungen hinzugefügt hast (developers.facebook.com/apps/[YOUR_APP_ID]>/settings/).

    Wenn du die Einstellungen zu sehr einschränkst, würde das die Auslieferung der Werbeanzeige beeinträchtigen und die Füllrate verschlechtern.

    Facebook möchte, dass Werbekunden im Audience Network von ihrer Werbung profitieren. Deshalb stellen wir sicher, dass Klicks authentisch und beabsichtigt sind. Klickbetrug durch Publisher wird von uns in keiner Weise toleriert. Sollten wir Betrug feststellen, entfernen wir die entsprechenden Publisher mit sofortiger Wirkung aus dem Netzwerk. Wir überwachen alle Klicks und Impressionen im Audience Network mit größter Sorgfalt, um Klickbetrüger zu entlarven. Wir stellen keine Rechnungen an Werbekunden und bezahlen Publisher nicht für Klicks, die wir als unrechtmäßig betrachten.

    Die Füllrate wird anhand der Gesamtzahl der gefüllten Werbeanzeigen und der Gesamtzahl der qualifizierten Anfragen ermittelt. Unter folgenden Bedingungen kann eine Anfrage nicht gewertet werden:

    • Die Anfrage für eine Werbeanzeige wurde zu häufig gestellt (z. B. wenn du eine Werbeanzeige mit der gleichen Placement ID innerhalb von 15 Sekunden mehrfach angefragt hast).
    • Die IDFA (iOS)- oder Werbe-ID (Android) ist nicht verfügbar oder kann nicht für die Auslieferung der Werbeanzeige verwendet werden.
    • Facebook ist nicht auf der anfragenden App installiert oder der Nutzer hat sich länger nicht angemeldet

    Berichte

    Füge deine Teammitglieder als Administratoren oder Statistiknutzer hinzu, damit sie Zugriff erhalten. Eine Rollenzuweisung kannst du in den Facebook-App-Einstellungen im Bereich „Rollen“ hinzufügen oder ändern.

    Die Berichte findest du, indem du „Audience Network“ in deinen App-Einstellungen aufrufst und dort den Tab „Performance“ auswählst. Die Berichte geben dir einen Überblick über deine Performance und enthalten außerdem Performance-Details für bestimmte Zeiträume. Du kannst dir auch deine Performance nach Land und Placement ID ansehen, wenn du noch genauere Informationen haben möchtest.

    Deinen Zahlungsverlauf und deine Zahlungsdetails findest du im „Audience Network“ auf dem Tab „Auszahlung“.

    In deinen Berichten erhältst du keine spezifischen Informationen über Werbekunden. Wenn du nach einem bestimmten Werbekunden oder einer Kategorie von Werbekunden filtern möchtest, rufe das Audience Network über die App-Einstellungen auf und wähle den Tab „Filter“ aus.

    Ja. Lies dir diesen Leitfaden durch, um weitere Informationen darüber zu erhalten, wie du die Performance-Daten deiner App programmgesteuert lesen kannst.

    Auszahlungen

    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.

    Du erhältst Auszahlungen, sobald du 100 $ Umsatz verbucht hast. Am 21. jedes Monats erhältst du das Geld, das du im Vormonat verdient hast.

    Prüfe zunächst auf dem Audience Network-Tab „Auszahlung“, ob du den Auszahlungsvorgang abgeschlossen hast.

    Klicke auf den Button „Benötigst du Hilfe?“ im Audience Network-Dashboard, wenn du dich mit zahlungsbezogenen Problemen an uns wenden möchtest.

    Wenn du deine Zahlungsinformationen ändern möchtest, rufe das Audience Network über die App-Einstellungen auf und wähle den Tab „Auszahlung“ aus.

    Wir sind davon überzeugt, dass Herausgeber und Entwickler vom Audience Network und seinen Funktionen profitieren, können aber aktuell noch keiner festen Umsatzbeteiligung zustimmen. Die Echtzeit-Reports und die erwartungsgemäße Auszahlung findest du im Bereich „Audience Network“ in den App-Einstellungen.

    Deine Apps verwalten

    Um eine Person als Administrator oder Entwickler zu einer vorhandenen Facebook-App hinzuzufügen, navigiere zum Tab „Rollen“ im App-Dashboard und wähle „Administratoren hinzufügen“ oder „Entwickler hinzufügen“ aus.

    In diesem Abschnitt

    Informationen zu Apps und Diensten, die sich an Kinder richten

    Erläutert deine Pflichten im Rahmen des US-amerikanischen Children's Online Privacy Protection Act (COPPA).

    California Consumer Privacy Act (CCPA) Compliance

    Beschreibt, wie du die Nutzung personenbezogener Daten durch deine App oder Website zur Einhaltung des California Consumer Privacy Act (CCPA) begrenzt.