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

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

Bu kılavuzda, şelale entegrasyonlarını kapsayan AdMob Uyumlulaştırma'yı kullanarak DT Exchange'ten reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu makalede, DT Exchange'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve DT Exchange SDK'sının ve bağdaştırıcının bir iOS uygulamasına nasıl entegre edileceği ele alınmaktadır.

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

iOS dağıtım hedefi 12.0 veya daha yeni bir sürüm olmalıdır.

En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlama Başlangıç kılavuzu

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

Yeni uygulama ve reklam yerleşimi ekleme

DT Exchange Console'a kaydolun veya giriş yapın.

Uygulamanızı eklemek için Uygulama Ekle düğmesini tıklayın.

Uygulamaları Yönet

Platformunuzu seçin, formun geri kalanını doldurun ve Yerleşim Ekle'yi tıklayın.

Yerleşiminizi adlandırın etiketli alana yeni yerleşimin adını girin ve açılır listeden istediğiniz Yerleşim Türü'nü seçin. Son olarak Yerleşimi Kaydet'i tıklayın.

Kurulum

Uygulama kimliği ve yerleşim kimliği

Farenizi üzerine getirerek sol gezinme çubuğunu açın. Ardından soldaki menüden Uygulamalar'ı tıklayın.

Uygulama Yönetimi sayfasında, uygulamanızın yanındaki Uygulama Kimliği'ni not edin.

Uygulama Kimliği

Uygulamanızı seçin, Yerleşimler sekmesine gidin ve Yerleşim Adı'nın yanındaki kopyalama simgesini tıklayın. Yerleşim kimliğini not edin.

Yerleşim Kimliği

Yayıncı kimliği, tüketici anahtarı ve tüketici gizli anahtarı

Soldaki menüden kullanıcı adınızı tıklayın ve Kullanıcı Profili'ni seçin.

Bir sonraki adımda yayıncı kimliği, tüketici anahtarı ve tüketici gizli anahtarı'na ihtiyacınız olacağından bunları not edin.

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

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

DT Exchange'i reklam biriminizin uyumlulaştırma yapılandırmasına eklemeniz gerekir.

Öncelikle 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 düzenlemek için ilgili uyumlulaştırma grubunun adını tıklayın ve DT Exchange'i reklam kaynağı olarak ekleme bölümüne geçin.

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

Reklam biçiminizi 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 Birimi Ekle'yi tıklayın.

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

Artık reklam birimleri kartının, seçtiğiniz reklam birimleriyle doldurulduğunu göreceksiniz:

DT Exchange'i reklam kaynağı olarak ekleme

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

DT Exchange'i seçin ve Optimize et anahtarını etkinleştirin. DT Exchange için reklam kaynağı optimizasyonunu ayarlamak üzere önceki bölümde elde edilen yayıncı kimliğini, tüketici gizli kodunu ve tüketici anahtarını girin. Ardından DT Exchange için bir eBGBM değeri girin ve Devam'ı tıklayın.

DT Exchange için zaten bir eşlemeniz varsa bu eşlemeyi seçebilirsiniz. Aksi takdirde Eşleme ekle'yi tıklayın.

Ardından, önceki bölümde elde edilen uygulama kimliğini ve yerleşim kimliğini girin. Ardından Bitti'yi tıklayın.

Not: Reklam kaynağı optimizasyonunun, bir uyumlulaştırma ağı için eBGBM'yi doğru şekilde hesaplayacak kadar veri toplaması birkaç gün sürer. Bu süre zarfında reklam kaynağı optimizasyon durumu PENDING olduğundan ağ için manuel olarak bir eBGBM değeri ayarlamanız gerekir. eBGBM hesaplandığında reklam kaynağı, eBGBM'yi sizin adınıza otomatik olarak güncellemeye başlar.

DT Exchange'i (Fyber Para Kazanma) GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme

DT Exchange (Fyber Monetization)'i AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için GDPR ayarlarındaki ve ABD eyalet düzenlemeleri ayarlarındaki adımları uygulayın.

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 dosyasına aşağıdaki satırı ekleyin:

pod 'GoogleMobileAdsMediationFyber'

Komut satırından şunu çalıştırın:

pod install --repo-update

Manuel entegrasyon

iOS için DT Exchange SDK'sının en son sürümünü indirin ve aşağıdaki çerçeveleri projenize bağlayın:
- IASDKCore.framework
- IASDKMRAID.framework
- IASDKVideo.framework
DT Exchange bağdaştırıcının en son sürümünü Değişiklikler Günlüğü'ndeki indirme bağlantısından indirin ve projenize bağlayınFyberAdapter.framework.
Projenize aşağıdaki çerçeveleri ekleyin:
- libxml2.2.tbd

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

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili belirli açıklamaların yapılmasını ve izinlerin alınmasını sağlamanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel veri toplayabilecek, alabilecek veya kullanabilecek her reklam ağını tanımlamanız ve her ağın kullanımı hakkında bilgi vermeniz gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak iletememektedir.

DT Exchange, kullanıcı rızasını SDK'larına iletmenize olanak tanıyan bir API içerir. Aşağıdaki örnek kodda, izin bilgilerinin DT Exchange SDK'sına manuel olarak nasıl iletileceği gösterilmektedir. İzin bilgilerini DT Exchange SDK'sına manuel olarak iletmeyi seçerseniz bu kodun Google Mobile Ads SDK'sı üzerinden reklam isteğinde bulunmadan önce çağrılması önerilir.

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"];

Daha fazla bilgi ve yöntemde sağlanabilecek değerler için DT Exchange'in GDPR Kaynak Sayfası'nı ve GDPR uygulama kılavuzunu ziyaret edin.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, kişisel bilgilerinin "satışının" (bu terimlerin yasalardaki tanımlarına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılıyor. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" gibi bir bağlantıyla sunulur. ABD eyalet gizlilik yasaları uygunluk kılavuzu, Google reklam sunumu için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar ancak Google bu ayarı uyumlulaştırma zincirinizdeki her reklam ağına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgilerin satışına katılabilir her reklam ağını tanımlamanız ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

Swift

import IASDKCore
// ...

IASDKCore.sharedInstance().ccpaString = "myCCPAConsentString"

Objective-C

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

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

Daha fazla bilgi ve yöntemde sağlanabilecek değerler için DT Exchange'in CCPA Kaynak Sayfası'nı ve CCPA uygulama kılavuzunu ziyaret edin.

5. adım: Gerekli kodu ekleyin

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için DT Exchange'in dokümanlarını inceleyin.

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

Test reklamlarını etkinleştirme

AdMob için test cihazınızı kaydettiğinizden emin olun.

Test reklamlarını doğrulama

DT Exchange'ten test reklamları aldığınızı doğrulamak için DT Exchange (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Ağa özgü parametreler

DT Exchange bağdaştırıcısı, GADMAdapterFyberExtras() kullanılarak bağdaştırıcının aktarılabileceği ek istek parametrelerini destekler. Adaptör, pakette aşağıdaki anahtarları arar:

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

Aşağıda, bu reklam isteği parametrelerinin nasıl ayarlanacağına dair 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];

Daha fazla bilgi için DT Exchange entegrasyon kılavuzuna bakın.

Hata kodları

Adaptör DT Exchange'ten reklam alamıyorsa aşağıdaki sınıf altında GADResponseInfo.adNetworkInfoArray kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

GADMediationAdapterFyber

Bir reklam yüklenemezse DT Exchange bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:

Hata kodu	Neden
0-10	DT Exchange SDK'sı hata döndürdü. Daha fazla ayrıntı için dokümanları inceleyin.
101	AdMob kullanıcı arayüzünde yapılandırılan DT Exchange sunucusu parametreleri 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ığından DT Exchange reklamları gösterilemedi.
105	DT Exchange SDK'sı bir ilk başlatma hatası döndürmüştür.