Bu sayfa, Cloud Translation API ile çevrilmiştir.

DT Exchange'i uyumlulaştırma ile entegre etme

Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanan DT Exchange reklamları AdMob Uyumlulaştırması, ele alacağız. DT Exchange'in bir reklama nasıl ekleneceğini ele almaktadır birimin uyumlulaştırma yapılandırması ve DT Exchange SDK'sı ile entegrasyon bir uygulamaya entegre iOS edebilirsiniz.

Desteklenen entegrasyonlar ve reklam biçimleri

DT Exchange için uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif verme
Şelale
Formatlar
Banner
Geçiş reklamı
Ödüllü
Yerel biçim

Şartlar

12.0 veya sonraki bir iOS dağıtım hedefi

En son Google Mobile Ads SDK'sı
Arabuluculuğu tamamlama Başlangıç kılavuzu

1. Adım: DT Exchange kullanıcı arayüzünde yapılandırmaları ayarlayın

Add new app and ad placement

Click on the Add App button to add your app.

Manage Apps

Select your Platform, fill out the rest of the form, and click Add Placements.

Enter a name for the new placement in the field labeled Name your Placement and select your desired Placement Type from the dropdown list. Finally, click Save Placement.

Setup

App ID and Placement ID

Open the left navigation bar by hovering your mouse over it. Then click Apps from the left menu.

On the App Management page, take note of the App ID next to your app.

App ID

Select your app, navigate to the Placements tab, and click on the copy icon next to Placement Name. Take note of the Placement ID.

Placement ID

Publisher ID, Consumer Key and Consumer Secret

Click on your username from the left menu and select User Profile.

Take note of the Publisher ID, Consumer Key, and Consumer Secret as these are needed in the next step.

2. Adım: Kullanıcı arayüzünde DT Exchange talebini AdMob ayarlayın

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

Reklam biriminizin uyumlulaştırma yapılandırmasına DT Exchange 'ı eklemeniz gerekiyor.

İlk olarak, AdMob hesabınızda oturum açın. Ardından Uyumlulaştırma sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa bu uyumlulaştırma grubunu düzenlemek için grubun adını tıklayın ve Reklam kaynağı olarak DT Exchange ekle bölümüne atlayın.

Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma Grubu Oluştur'u seçin.

Reklam biçimini ve platformunuzu girip Devam'ı tıklayın.

Uyumlulaştırma grubunuza bir ad verin ve hedeflenecek konumları seçin. Ardından, uyumlulaştırma grubu durumunu Etkin olarak ayarlayın ve Reklam Birimleri Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut bir veya daha fazla AdMob reklam biriminizle ilişkilendirin. Ardından Bitti'yi tıklayın.

Şimdi, seçtiğiniz reklam birimleriyle doldurulmuş reklam birimleri kartını görmeniz gerekir:

Reklam kaynağı olarak DT Exchange ekleyin

Reklam Kaynakları bölümündeki Şelale kartının altından Reklam Kaynağı Ekle'yi seçin. Ardından DT Exchange simgesini seçin.

DT Exchange'i seçin ve Optimize et anahtarını etkinleştirin.DT Exchangeiçin reklam kaynağı optimizasyonunu ayarlamak üzere önceki bölümde belirtilen Publisher ID, Consumer Secret and Consumer Keydeğerini girin. ArdındanDT Exchange için bir eBGBM değeri girip Devam'ı tıklayın.

DT Exchangeiçin zaten bir eşlemeniz varsa bunu seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.

Sonra, önceki bölümde aldığınız Application ID and Placement ID kodunu girin. Ardından Bitti'yi tıklayın.

GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Fyber ekleyin

GDPR ayarları ve ABD eyalet düzenlemeleri ayarları bölümündeki adımları uygulayarak AdMob kullanıcı arayüzünde GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Fyber ekleyin.

3. Adım: DT Exchange SDK'sını ve bağdaştırıcısını içe aktarın

CocoaPods'u kullanma (önerilir)

Projenizin Podfile'ına aşağıdaki satırı ekleyin:

pod 'GoogleMobileAdsMediationFyber'

Komut satırında şu komutu çalıştırın:

pod install --repo-update

Manuel entegrasyon

Son sürümünü indirin iOS için DT Exchange SDK'sı ve şu çerçeveleri projenize bağlayın:
- IASDKCore.framework
- IASDKMRAID.framework
- IASDKVideo.framework
İndirme dosyasındaki DT Exchange bağdaştırıcısının son sürümünü indirin Değişiklik günlüğü'ndeki ve bağlantıdaki FyberAdapter.framework adlı projenizde.
Projenize aşağıdaki çerçeveleri ekleyin:
- libxml2.2.tbd

4. Adım: Gizlilik ayarlarını DT Exchange SDK'sında uygulayın

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı İzni kapsamında Politika uyarınca, belirli bilgilerin ifşa edildiğinden emin olmalısınız. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcıların cihaz tanımlayıcılarının ve kişisel verilerin kullanımı. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma şartları Düzenleme (GDPR). Rıza isterken her reklam ağını tanımlamanız gerekir kişisel verileri toplayabilecek, alabilecek veya kullanabilen uyumlulaştırma zincirinizde her ağın kullanımıyla ilgili bilgi sağlar. Google şu anda Kullanıcının izin seçimini bu tür ağlara otomatik olarak iletmelidir.

DT Exchange, kullanıcı rızasını SDK'sına yönlendirmenize olanak tanıyan bir API içerir. İlgili içeriği oluşturmak için kullanılan aşağıdaki örnek kod, izin bilgilerinin DT Exchange'e nasıl iletileceğini gösterir SDK'yı manuel olarak ekleyin. İzin bilgilerini DT Exchange'e aktarmayı seçerseniz SDK manuel olarak gösteriliyorsa, reklam isteğinde bulunmadan önce bu kodun çağrılması önerilir Google Mobile Ads SDK'sı aracılığıyla yükleyebilirsiniz.

Swift

import IASDKCore
// ...

IASDKCore.sharedInstance().gdprConsent = IAGDPRConsentType.given
IASDKCore.sharedInstance().gdprConsentString = "myGdprConsentString"

Objective-C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setGDPRConsent:YES];
[IASDKCore.sharedInstance setGDPRConsentString:@"myGdprConsentString"];

DT Exchange'in GDPR Kaynak Sayfasını ve GDPR uygulama kılavuzu 'na bakın.

ABD eyalet gizlilik yasaları

. ABD eyalet gizlilik yasaları kullanıcılara, doğru zamanda "indirimi" devre dışı bırakmak "kişisel bilgilerinin” (kanunların bu konudaki hariç tutmanın, öne çıkan bir "Do Not Sell My Personal My Personal (Kişisel Bilgilerimi Kesinlikle Satmayın) Bilgiler" bağlantısını ile başlar. İlgili içeriği oluşturmak için kullanılan ABD eyalet gizliliği yasalara uygunluk rehberi, yasalarca belirlenen kısıtlanmış veri işleme kullanılabilir ancak Google, bu ayarı her reklama uygulayamaz. ağda yer alır. Bu nedenle, reklam ağlarının her birini kişisel satışlarına katılabilecek uyumlulaştırma zincirinizde ağlarla ilgili bilgileri takip edin ve bu ağların yönlendirmelerini izleyerek uygunluk açısından önemlidir.

Swift

import IASDKCore
// ...

IASDKCore.sharedInstance().ccpaString = "myCCPAConsentString"

Objective-C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setCCPAString:@"myCCPAConsentString"];

DT Exchange'in CCPA Kaynak Sayfası'nı ve CCPA uygulama kılavuzu 'na bakın.

5. Adım: Gerekli kodu ekleyin

SKAdNetwork entegrasyonu

DT Exchange'in dokümanlarını uygulayın kullanarak projenizin Info.plist dosyasına SKAdNetwork tanımlayıcılarını ekleyin.

6. Adım: Uygulamanızı test edin

Test reklamlarını etkinleştir

AdMob.

Test reklamlarını doğrulama

DT Exchangereklam kaynağından test reklamları aldığınızı doğrulamak için DT Exchange (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Ağa özel parametreler

DT Exchange bağdaştırıcısı, aşağıdaki ek istek parametrelerini destekler: GADMAdapterFyberExtras() kullanılarak adaptöre aktarılır. Adaptör görünüyor (pakette şu anahtarlar için):

İstek parametreleri ve değerler
`setUserData` Kullanıcının yaşı, cinsiyeti ve posta kodu.	`IAUserData`
`setMuteAudio`	Boole. Videonun sesini kapat veya aç

Aşağıda, bu reklam isteği parametrelerinin nasıl ayarlanacağına ilişkin bir kod örneği verilmiştir:

Swift

let userData = IAUserData.build({ builder in
  builder.age = 23
  builder.gender = IAUserGenderType.male
  builder.zipCode = "1234"
}];

let request = GADRequest()
let extras = GADMAdapterFyberExtras()
extras.userData = userData
extras.muteAudio = true
request.register(extras)

Objective-C

IAUserData *userData = [IAUserData build:^(id<IAUserDataBuilder> _Nonnull builder) {
    builder.age = 23;
    builder.gender = IAUserGenderTypeMale;
    builder.zipCode = @"1234";
}];

GADRequest *request = [GADRequest request];
GADMAdapterFyberExtras *extras = [[GADMAdapterFyberExtras alloc] init];
extras.userData = userData;
extras.muteAudio = YES;
[request registerAdNetworkExtras:extras];

Destek için: DT Exchange entegrasyon kılavuzu konulu videomuzu izleyin.

Hata kodları

Bağdaştırıcı, DT Exchange'den reklam alamazsa kullanarak reklam yanıtından gelen temel hata GADResponseInfo.adNetworkInfoArray altında:

GADMediationAdapterFyber

DT Exchange bağdaştırıcısı tarafından gönderilen kodlar ve beraberindeki iletiler Reklam yüklenemedi:

Hata kodu	Neden
101	Kullanıcı arayüzünde yapılandırılan DT Exchange sunucusu parametreleri AdMob eksik/geçersiz.
103	İstenen reklam boyutu, DT Exchange tarafından desteklenen bir banner boyutuyla eşleşmiyor.
105	DT Exchange SDK'sı bir reklam yükledi ancak beklenmeyen bir denetleyici döndürdü.
106	Reklam görüntülenmeye hazır değil.
200-399	DT Exchange SDK'sı hata döndürdü. Kodu inceleyin inceleyebilirsiniz.
0-10	DT Exchange SDK'sı hata döndürdü. Belgelere göz atın inceleyebilirsiniz.
101	Kullanıcı arayüzünde yapılandırılan DT Exchange sunucusu parametreleri AdMob eksik/geçersiz.
102	İstenen reklam boyutu, DT Exchange tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103	Reklam nesnesi zaten kullanıldığı için reklam gösterilemedi.
104	Reklam hazır olmadığı için DT Exchange reklamları gösterilemedi.
105	DT Exchange SDK'sı başlatma hatası döndürdü.