How do App campaigns work?

Integrer Google Mobile Ads SDK i din iOS App

25/04/2023

★★★★★Rating: 4.52 (9737 votes)
Indholdsfortegnelse

Kom i gang med Google Mobile Ads SDK til iOS

At integrere Google Mobile Ads SDK i din iOS-app er det første afgørende skridt for at kunne vise annoncer og dermed generere indtægter. Når SDK'en er integreret, åbner der sig en verden af muligheder for at implementere forskellige annonceformater, der kan berige brugeroplevelsen og samtidig bidrage til din app's økonomi. Uanset om du er nybegynder eller en erfaren udvikler, guider denne artikel dig igennem processen med at få Google Mobile Ads SDK op at køre i dit Xcode-projekt.

How does Google Ads work?
Google Ads for Universal App Campaigns works by trying to show your ad to enough people to achieve your daily budget. For instance, if your daily budget is $50 and there's no target bid set, Google will run a "maximize conversions" campaign. Google Ads will calculate the best bid to get you the most installs it can. If you input a target bid, Google will aim to spend that amount per install.

Forudsætninger

Før du går i gang, er det vigtigt at sikre dig, at dit udviklingsmiljø lever op til de nødvendige krav:

  • Xcode: Brug Xcode version 16.0 eller en nyere version. Sørg altid for at have den seneste stabile version installeret for at drage fordel af de nyeste funktioner og fejlrettelser.
  • iOS Målversion: Din app's minimums målversion skal være iOS 12.0 eller nyere. Dette sikrer kompatibilitet med en bred vifte af enheder og iOS-versioner.

Importér Google Mobile Ads SDK

Der er flere metoder til at importere Google Mobile Ads SDK i dit projekt. Vælg den metode, der passer bedst til din workflow:

1. Swift Package Manager (Anbefalet for nye projekter)

Swift Package Manager er den foretrukne metode til at håndtere afhængigheder i moderne Swift-projekter. Det gør processen med at tilføje og opdatere biblioteker enkel og effektiv.

Vigtig bemærkning: I øjeblikket er mediationsadapterbiblioteker endnu ikke tilgængelige via Swift Package Manager. Hvis du planlægger at bruge mediation, anbefales det at integrere med CocoaPods.

Følg disse trin for at tilføje SDK'en via Swift Package Manager:

  1. Åbn dit Xcode-projekt.
  2. Gå til File > Add Package Dependencies….
  3. I det vindue, der popper op, skal du søge efter Google Mobile Ads Swift Package Manager-repository ved at indtaste følgende URL: https://github.com/googleads/swift-package-manager-google-mobile-ads.git
  4. Vælg den ønskede version af Google Mobile Ads SDK. For nye projekter anbefales det at vælge Up to Next Major Version for automatisk at opdatere til de seneste kompatible versioner.

2. CocoaPods

CocoaPods er en populær dependency manager til Swift og Objective-C Cocoa-projekter. Hvis du allerede bruger CocoaPods, er dette en velkendt metode.

Før du fortsætter, bør du sætte dig ind i Hvordan man bruger CocoaPods for information om oprettelse og brug af Podfiles.

Følg disse trin for at integrere via CocoaPods:

  1. Åbn din projekts Podfile.
  2. Tilføj følgende linje til din apps target build-konfiguration:
    pod 'Google-Mobile-Ads-SDK'
  3. Åbn din terminal, naviger til din projekts rodmappe, og kør følgende kommando:
    pod install --repo-update

3. Manuel Download

Du kan også downloade SDK'en manuelt og integrere den direkte i dit projekt.

Følg disse trin:

  1. Download Google Mobile Ads SDK.
  2. Embed og signér følgende frameworks i dit Xcode-projekt:
    • GoogleMobileAds.xcframework
    • UserMessagingPlatform.xcframework
  3. I din projekts build-indstillinger skal du foretage følgende ændringer:
    • Tilføj stien /usr/lib/swift til Runpath Search Paths.
    • Tilføj linker-flagget -ObjC til Other Linker Flags.

Konfigurer Info.plist

Det er essentielt at opdatere din apps Info.plist fil for at inkludere specifikke nøgler, der er nødvendige for Google Mobile Ads SDK:

  • GADApplicationIdentifier: Tilføj denne nøgle med en strengværdi, der repræsenterer dit Ad Manager App ID. Dette ID kan findes i Ad Manager-brugergrænsefladen og har typisk formatet ca-app-pub-################~##########.
  • SKAdNetworkItems: Tilføj denne nøgle med en array af SKAdNetworkIdentifier værdier. Inkluder ID'erne for både Google (cstr6suwn9.skadnetwork) og udvalgte tredjeparts købere, som Google har angivet.

Her er et eksempel på et uddrag, der kan indsættes i din Info.plist:

<key>GADApplicationIdentifier</key> <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~1458002511 --> <string>SAMPLE_APP_ID</string> <key>SKAdNetworkItems</key> <array> <dict> <key>SKAdNetworkIdentifier</key> <string>cstr6suwn9.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>4fzdc2evr5.skadnetwork</string> </dict> <!-- Tilføj flere SKAdNetworkIdentifiers efter behov --> <dict> <key>SKAdNetworkIdentifier</key> <string>2fnua5tdw4.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>ydx93a7ass.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>p78axxw29g.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>v72qych5uu.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>ludvb6z3bs.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>cp8zw746q7.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>3sh42y64q3.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>c6k4g5qg8m.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>s39g8k73mm.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>3qy4746246.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>f38h382jlk.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>hs6bdukanm.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>mlmmfzh3r3.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>v4nxqhlyqp.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>wzmmz9fp6w.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>su67r6k2v3.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>yclnxrl5pm.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>t38b2kh725.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>7ug5zh24hu.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>gta9lk7p23.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>vutu7akeur.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>y5ghdn5j9k.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>v9wttpbfk9.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>n38lu8286q.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>47vhws6wlr.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>kbd757ywx3.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>9t245vhmpl.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>a2p9lx4jpn.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>22mmun2rn5.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>44jx6755aq.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>k674qkevps.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>4468km3ulz.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>2u9pt9hc89.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>8s468mfl3y.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>klf5c3l5u5.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>ppxm28t8ap.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>kbmxgpxpgc.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>uw77j35x4d.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>578prtvx9j.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>4dzt52r2t5.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>tl55sbb4fm.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>c3frkrj4fj.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>e5fvkxwrpn.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>8c4e2ghe7u.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>3rd42ekr43.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>97r2b46745.skadnetwork</string> </dict> <dict> <key>SKAdNetworkIdentifier</key> <string>3qcr597p9d.skadnetwork</string> </dict> </array>

Husk: Erstat SAMPLE_APP_ID med dit faktiske Ad Manager App ID. Under testfasen kan du med fordel anvende det eksempel-App ID, der er angivet i kommentaren.

For at opnå optimal initialiseringsydelse er det vigtigt at knytte dine performancegrupper til de specifikke apps, de bruges i. Hvis performancegrupper for iOS ikke er knyttet til en specifik app, vil de blive sendt til alle iOS-apps i din konto, hvilket potentielt kan forlænge initialiseringstiden.

Initialiser Google Mobile Ads SDK

Før du kan begynde at indlæse annoncer, skal du kalde start()-metoden på GADMobileAds.sharedInstance. Dette initialiserer SDK'en og giver en callback med en afsluttende handler, når initialiseringen er fuldført (eller efter en timeout på 30 sekunder). Det anbefales at kalde start() så tidligt som muligt i din app's livscyklus.

Advarsel: Annoncer kan blive forudindlæst af Mobile Ads SDK eller af tredjeparts medierings-SDK'er efter et kald til startWithCompletionHandler:. Hvis du har brug for at indhente brugerens samtykke i Det Europæiske Økonomiske Samarbejdsområde (EØS), skal du konfigurere de nødvendige specifikke anmodningsmarkører (f.eks. tagForChildDirectedTreatment eller tag_for_under_age_of_consent) eller udføre den relevante handling, før du indlæser annoncer. Sørg for at gøre dette, før du initialiserer Mobile Ads SDK.

Her er kodeeksempler på, hvordan du initialiserer SDK'en:

Swift:

// Initialiser Google Mobile Ads SDK. MobileAds.sharedInstance.start(completionHandler: nil) // I din ViewController: // MobileAds.sharedInstance.start(completionHandler: nil)

SwiftUI:

// Initialiser Google Mobile Ads SDK. MobileAds.sharedInstance.start(completionHandler: nil) // I din ContentView eller App struct: // MobileAds.sharedInstance.start(completionHandler: nil) // Eller brug GoogleMobileAdsConsentManager til samtykkehåndtering.

Objective-C:

// Initialiser Google Mobile Ads SDK. [[GADMobileAds sharedInstance] startWithCompletionHandler:nil]; // I din ViewController: // [[GADMobileAds sharedInstance] startWithCompletionHandler:nil];

Bemærk: Hvis du anvender mediation, skal du vente på, at afsluttende handler kaldes, før du indlæser annoncer. Dette sikrer, at alle medieringsadaptere er korrekt initialiseret.

Vælg et annonceformat

Når Google Mobile Ads SDK er importeret og initialiseret, er du klar til at implementere annoncer. Google Ad Manager tilbyder en række forskellige annonceformater, så du kan vælge det, der passer bedst til din app's brugeroplevelse og indtjeningsstrategi:

Bannere

Bannerannoncer er rektangulære annoncer, der optager en del af din apps layout. De kan automatisk opdateres med jævne mellemrum, hvilket betyder, at brugerne ser nye annoncer, selvom de forbliver på den samme skærm. Bannerannoncer er generelt de nemmeste at implementere.

  • Implementering: Se guiden til implementering af bannerannoncer for detaljerede instruktioner.

Interstitial Annoncer

Interstitial annoncer vises som helsidesannoncer i din app. Placer dem strategisk ved naturlige pauser og overgange i brugerflowet, f.eks. efter afslutning af et niveau i et spil eller før en vigtig handling.

  • Implementering: Følg guiden til implementering af interstitial annoncer.

Native Annoncer

Native annoncer giver dig mulighed for at tilpasse visningen af annonceelementer som overskrifter og calls-to-action fuldstændigt. Ved at anvende dit eget design kan du skabe en mere naturlig og integreret annonceoplevelse.

Google Ad Manager tilbyder to metoder til implementering af native annoncer:

  • Native Styles: Designet til at forenkle implementeringen af native annoncer. Et godt valg, hvis du er ny til formatet.
  • Standard Native Ads (Custom Rendering): Giver maksimal frihed til at skabe brugerdefinerede annoncevisninger.
  • Implementering: Se guiden til implementering af native styles eller guiden til implementering af native annoncer med custom rendering.

Rewarded Annoncer

Rewarded annoncer giver brugerne mulighed for at optjene belønninger i appen (f.eks. mønter, ekstra liv) ved at se annoncer, udføre opgaver eller deltage i undersøgelser. Du kan definere specifikke belønninger for hver annonceenhed.

  • Implementering: Se guiden til implementering af rewarded annoncer.

Rewarded Interstitial Annoncer

Dette er en ny type incentiveret annonceformat, der giver belønninger, men vises automatisk under naturlige app-overgange uden at kræve brugerens aktive accept. I stedet præsenteres brugeren for en introduktionsskærm, der annoncerer belønningen og giver mulighed for at fravælge annoncen.

  • Implementering: Se guiden til implementering af rewarded interstitial annoncer.

App Open Annoncer

App Open annoncer vises, når brugere åbner din app eller vender tilbage til den. Annoncen lægges oven på appens indlæsningsskærm.

  • Implementering: Se guiden til implementering af app open annoncer.

Opsummering

Ved at følge disse trin kan du succesfuldt integrere Google Mobile Ads SDK i dit iOS-projekt. Husk at vælge den installationsmetode, der passer bedst til dig, konfigurere din Info.plist korrekt, og initialisere SDK'en tidligt i din app. Derefter kan du begynde at udforske de forskellige annonceformater og finde den bedste måde at monetarisere din app på.

Ofte Stillede Spørgsmål (FAQ)

  • Hvilken installationsmetode er bedst? Swift Package Manager anbefales generelt for nye projekter på grund af dens enkelhed. CocoaPods er et godt alternativ, især hvis du allerede bruger det, eller hvis du har brug for mediationsadaptere. Manuel download er en mulighed, men ofte mere omfangsrig.
  • Hvad er et Ad Manager App ID? Det er en unik identifikator for din app i Google Ad Manager-systemet, som er nødvendig for at kunne vise annoncer.
  • Hvorfor skal jeg tilføje SKAdNetworkIdentifiers? Disse identifikatorer er nødvendige for Apples SKAdNetwork framework, som hjælper med at måle annoncekonverteringer på en privatlivsbevarende måde.
  • Hvornår skal jeg initialisere SDK'en? Initialiser SDK'en så tidligt som muligt, typisk i din app's startfunktion eller når appen lanceres, og før du indlæser annoncer. Hvis du håndterer bruger-samtykke i EØS, skal dette ske før initialisering.
  • Kan jeg bruge SDK'en med ældre iOS-versioner? Minimumskravet er iOS 12.0. Hvis din app understøtter ældre versioner, skal du muligvis overveje alternative løsninger eller opdatere din minimums målversion.

Hvis du vil læse andre artikler, der ligner Integrer Google Mobile Ads SDK i din iOS App, kan du besøge kategorien Teknologi.

Go up