Ausrichtung

In diesem Leitfaden wird erläutert, wie Sie einer Anzeigenanfrage Targeting-Informationen zur Verfügung stellen.

Laden Sie die iOS API Demo App in Swift oder Objective-C herunter, um die Anzeigenausrichtung in Aktion zu sehen.

API-Demo herunterladen

Voraussetzungen

Arbeiten Sie den Startleitfaden durch.

GADRequestConfiguration

GADRequestConfiguration ist ein Objekt, das Targeting-Informationen erfasst, die global über die gemeinsam genutzte GADMobileAds-Instanz angewendet werden sollen. Sie können mit dem folgenden Code darauf zugreifen:

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Einstellung für Inhalte, die auf Kinder ausgerichtet sind

Im Rahmen des US-Gesetzes zum Schutz der Privatsphäre von Kindern im Internet (Children's Online Privacy Protection Act, COPPA) gibt es die Einstellung tagForChildDirectedTreatment.

Als App-Entwickler können Sie angeben, ob Google bei einer Anzeigenanfrage Ihre Inhalte als auf Kinder ausgerichtet einstufen soll. Wenn Sie angeben, dass Google Ihre Inhalte als auf Kinder ausgerichtet einstufen soll, deaktiviert Google die interessenbezogene Werbung und Remarketing-Anzeigen für diese Anzeigenanfrage. Folgende Einstellungsoptionen sind verfügbar:

• Setze tagForChildDirectedTreatment auf true, um anzugeben, dass deine Inhalte gemäß COPPA als auf Kinder ausgerichtet behandelt werden sollen. Dadurch wird die Übertragung der IDFA (Werbe-ID) verhindert.
• Setze tagForChildDirectedTreatment auf false, um anzugeben, dass du nicht möchtest, dass deine Inhalte gemäß den COPPA-Anforderungen als auf Kinder ausgerichtet behandelt werden.
• Lege tagForChildDirectedTreatment nicht fest, wenn du nicht angeben möchtest, wie deine Inhalte in Bezug auf COPPA behandelt werden sollen.

Im folgenden Beispiel möchten Sie, dass Ihre Inhalte gemäß COPPA als auf Kinder ausgerichtet behandelt werden:

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Durch Festlegen dieses Tags bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie berechtigt sind, im Namen des App-Inhabers zu handeln. Ihnen ist bewusst, dass der Missbrauch dieser Einstellung zur Kündigung Ihres Google-Kontos führen kann.

Nutzer, die das gültige Mindestalter noch nicht erreicht haben

Sie können Ihre Anzeigenanfragen zur Verarbeitung für minderjährige Nutzer im Europäischen Wirtschaftsraum (EWR) kennzeichnen. Mit dieser Funktion soll die Einhaltung der EU-Datenschutz-Grundverordnung (DSGVO) erleichtert werden. Möglicherweise gelten für Sie im Rahmen der DSGVO weitere rechtliche Verpflichtungen. Lesen Sie die Richtlinien der Europäischen Union und wenden Sie sich gegebenenfalls an Ihren Rechtsbeistand. Die Tools von Google sollen die Compliance erleichtern und entbinden einen bestimmten Publisher nicht von seinen gesetzlichen Verpflichtungen. Weitere Informationen zu den Auswirkungen der DSGVO auf Publisher

Wenn Sie diese Funktion verwenden, wird der Parameter „Tag für minderjährige Nutzer in Europa“ (TFUA) in alle zukünftigen Anzeigenanfragen aufgenommen. Mit diesem Parameter werden personalisierte Anzeigen, einschließlich Remarketing, für die jeweilige Anzeigenanfrage deaktiviert. Außerdem werden an Drittanbieter gerichtete Anfragen deaktiviert, z. B. Tracking-Pixel und Ad-Server eines Drittanbieters.

Die Einstellung kann mit allen Versionen des Google Mobile Ads SDK verwendet werden. Dazu legen Sie die Eigenschaft tagForUnderAgeOfConsent für das GADMobileAds.requestConfiguration-Objekt fest und übergeben true.

• Setzen Sie tagForUnderAgeOfConsent auf true, um anzugeben, dass Anzeigenanfragen so verarbeitet werden sollen, dass sie für minderjährige Nutzer geeignet sind. Dadurch wird auch die Übertragung der Werbe-ID, IDFA, verhindert.
• Wenn Sie tagForUnderAgeOfConsent nicht festlegen, werden Anzeigenanfragen nicht so verarbeitet, dass sie für minderjährige Nutzer geeignet sind.

Im folgenden Beispiel soll TFUA in Ihre Anzeigenanfrage aufgenommen werden:

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Die Tags zum Aktivieren der Einstellung für Inhalte für Kinder und tagForUnderAgeOfConsent sollten nicht gleichzeitig auf true gesetzt werden. Ist dies der Fall, hat die Einstellung für Inhalte, die auf Kinder ausgerichtet ist, Vorrang.

Wichtiger Hinweis :Dieser tagForUnderAgeOfConsent-Parameter wird nicht an Werbenetzwerkvermittlungsadapter weitergeleitet. Sie sind dafür verantwortlich, dass über jedes Drittanbieter-Werbenetzwerk in Ihrer App Anzeigen ausgeliefert werden, die gemäß DSGVO für minderjährige Nutzer geeignet sind.

Filterung von Anzeigeninhalten

In Apps kann für alle Anzeigenanfragen eine höchste Altersfreigabe für Anzeigeninhalte mit der Eigenschaft maxAdContentRating auf GADRequestConfiguration festgelegt werden. Diese Einstellung gilt für alle zukünftigen Anzeigenanfragen für den Rest der Sitzung. Die möglichen Werte für dieses Attribut basieren auf Klassifizierungen für Labels für digitale Inhalte und sollten eine der folgenden Konstanten sein:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

Mit dem folgenden Code werden alle Anzeigenanfragen so konfiguriert, dass der zurückgegebene Anzeigeninhalt einem Label für digitalen Content entsprechen muss, das nicht höher als GADMaxAdContentRatingGeneral ist.

Wichtiger Hinweis :Die über das SDK angegebenen Filtereinstellungen für die Altersfreigabe überschreiben alle über die Ad Manager Benutzeroberfläche konfigurierten Einstellungen.

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Datenschutzeinstellungen für Publisher (Beta)

Die Datenschutzeinstellungen für Publisher Die PPT API (PPT API) ist ein optionales Tool, mit dem in Apps über die Property publisherPrivacyPersonalizationState von GADRequestConfiguration angegeben wird, ob personalisierte Anzeigen für alle Anzeigenanfragen deaktiviert werden sollen. Wenn Sie diese Funktion verwenden, wird in allen zukünftigen Anzeigenanfragen für den Rest der Sitzung ein PPT-Parameter (die Datenschutzeinstellungen für Publisher) berücksichtigt.

Anzeigenanfragen an Google erhalten standardmäßig personalisierte Anzeigen. Mit dem folgenden Code wird personalisierte Werbung für alle Anzeigenanfragen deaktiviert:

Swift

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Hinweis :Bei Anzeigenanfragen mit mehreren Datenschutzsignalen für Nutzer hat das Signal mit der stärksten Einschränkung Vorrang. Konkrete Beispiele finden Sie in der Dokumentation zur Publisher Privacy Treatment API .

GAMRequest

Vom GAMRequest-Objekt werden Targeting-Informationen erfasst, die mit einer Anzeigenanfrage gesendet werden.

Inhalts-URL

Wenn eine Anzeige angefragt wird, können Apps die URL des bereitgestellten Inhalts übergeben. Dies ermöglicht das Keyword-Targeting, um die Anzeige an den Inhalt anzupassen.

Wenn Ihre App beispielsweise eine Anzeige anfordert, während Inhalte aus https://www.example.com zu sehen sind, können Sie diese URL übergeben, um die Kampagne auf relevante Keywords auszurichten:

Swift

let request = GAMRequest()
request.contentURL = "https://www.example.com"

Objective-C

GAMRequest *request = [GAMRequest request];
request.contentURL = @"https://www.example.com";

Benutzerdefinierte Ausrichtung

Nachdem Sie auf der Ad Manager-Benutzeroberfläche Schlüssel/Wert-Paare konfiguriert haben, legen Sie das benutzerdefinierte Targeting mit den Schlüssel/Wert-Paaren in einer Anzeigenanfrage fest. Werbebuchungen, die auf diese Schlüssel/Wert-Paare ausgerichtet sind, können dann für diese Anzeigenanfrage ausgeliefert werden. Wenn Sie mehrere Werte für einen Schlüssel verwenden möchten, geben Sie Werte als kommagetrennten String ein.

Swift

let request = GAMRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

Objective-C

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

Markensicherheit (Beta)

Bei Apps, die dynamische Inhalte für unterschiedliche Zielgruppen anzeigen, kann über die neighboringContentURLs-Eigenschaft eine kurze Liste von URLs bereitgestellt werden. Benachbarte Inhalts-URLs unterscheiden sich von der Property contentURL dadurch, dass sie nur für die Markensicherheit verwendet werden.

Angenommen, Ihre App zeigt Inhalte von vier URLs in einem Feed an, der auch Anzeigen enthält. Sie können Anzeigen anfordern, die eine ähnliche Altersfreigabe wie diese URLs haben, indem Sie sie so übergeben:

Swift

let request = GAMRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

Objective-C

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

Wichtiger Hinweis :Vom SDK werden nur die ersten vier URLs verwendet. Alle anderen werden ignoriert.

Publisher Provided Identifiers

Sie können eine PPID (Publisher Provided Identifier, vom Publisher bereitgestellte Kennung) zur Verwendung beim Frequency Capping, bei der Zielgruppensegmentierung und dem Targeting auf Zielgruppen, bei der sequenziellen Anzeigenrotation und bei anderen Funktionen zur zielgruppenbasierten Anzeigenauslieferung auf beliebigen Geräten festlegen.

Hinweis :Diese Funktion ist nicht für alle Verlage und Webpublisher verfügbar. Weitere Informationen findest du unter PPIDs (Publisher Provided Identifiers).

Das Festlegen der PPID erfolgt über GAMRequest:

Swift

let request = GAMRequest()
request.publisherProvidedID = "AB123456789"

Objective-C

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

Im Beispiel zu PPIDs in Ad Manager sehen Sie, wie vom Publisher bereitgestellte Kennungen (PPIDs) in der iOS API Demo App implementiert werden:

Swift Objective-C

Vom Publisher bereitgestellte Signale

Sie können Zielgruppen- und Kontextdaten als vom Publisher bereitgestellte Signale in Anzeigenanfragen senden. Mit PPS können Sie Ihre Nutzerdaten verwenden, um die programmatische Monetarisierung zu verbessern. Dazu teilen Sie Bietern in allen Transaktionstypen mithilfe von Standard-Taxonomien Ihre Zielgruppeneigenschaften mit, ohne dass Nutzerkennungen weitergegeben werden müssen. Zielgruppeneigenschaften können verhaltens- und interessenbezogene Daten (IAB Audience Taxonomy 1.1) und Kontextdaten (IAB Content Taxonomy 2.2) umfassen.

Swift

let extras = GADExtras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = GAMRequest()()
request.register(extras)

Objective-C

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

Häufig gestellte Fragen

Welche Ausrichtung wird verwendet, wenn eine Anzeige automatisch aktualisiert wird?

Bei der Anzeigenaktualisierung wird das zuvor angegebene GAMRequest-Objekt wieder für das Targeting verwendet. Wenn Sie ein neues Targeting festlegen möchten, rufen Sie mit einem neuen GAMRequest-Objekt explizit loadRequest für GAMBannerView auf.

Wie übergebe ich an Vermittlungsnetzwerke zusätzliche Ausrichtungsparameter?

Unter Vermittlung erfahren Sie, wie Targeting an Vermittlungsnetzwerke gesendet wird.